KB-1269 Missing default system icons in end user interface

pauline.delacruz — Wed, 05 Jun 2024 19:14:03 GMT

Current Revision posted to Appian Knowledge Base by pauline.delacruz on 6/5/2024 7:14:03 PM

Symptoms

There are missing system icons when browsing Tempo (News, Records, Reports etc.) and the icon’s associated .png file is missing from the <APPIAN_HOME>/_admin/accdocs* directory. An example of what a missing “default record icon” could look like is pictured below.

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

The application server is not able to to find and display the icon in the browser because the icon’s associated .png file is either missing entirely from the <APPIAN_HOME>/_admin/accdocs* directory or it is present but has an outdated file name (meaning the application server will be referencing the wrong filename for the icon).

Action

Action 1

Prepare the appropriate import package.
1. Locate the relevant zip file from the <APPIAN_HOME>/deployment/web.war/WEB-INF/bundled-apps/ directory. (e.g. Use records.zip for a missing default icon in Records)
2. Unzip the file contents and add the directory <APPIAN_HOME>/deployment/web.war/META-INF/ and its contents to the base folder.
3. Zip the modified files once again.
Import the prepared package through Appian Designer.
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 2

Prepare the appropriate import package.
1. Locate the relevant zip file from the <APPIAN_HOME>/deployment/web.war/WEB-INF/bundled-apps/ directory. (e.g. Use records.zip for a missing default icon in Records)
2. Unzip the file contents and add the directory <APPIAN_HOME>/deployment/web.war/META-INF/ and its contents to the base folder.
3. Zip the modified files once again.
Import the prepared package in the following manner:
1. Upload the prepared package.
2. Select the "Include related import customization file" checkbox.
3. Within the "Import Customization File (PROPERTIES)" section, upload an import.properties file which has the following contents:
```
## Import Setting: Force Update
## Forces the import of objects that were detected to be Not Changed on inspect/import
importSetting.FORCE_UPDATE=true
```
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 3

If you have a backup of icon(s) elsewhere, do the following:

Perform a network capture on the browser page where the missing icon(s) is located.
Identify the file name of the missing icon(s) and the source folder the file is supposed to be inside of.
Place the backup of the icon(s) within that folder.
Rename the backup of the file so that it matches the name of the missing icon(s).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

If the above actions do not resolve the issue please create a support case with Appian Technical Support to determine the best path forward.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2024

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Maggie Deppe-Walker — Mon, 16 Oct 2023 00:50:06 GMT

Revision 7 posted to Appian Knowledge Base by Maggie Deppe-Walker on 10/16/2023 12:50:06 AM

Symptoms

There are missing system icons when browsing Tempo (News, Records, Reports etc.) and the icon’s associated “PNG” file is missing from the <APPIAN_HOME>/_admin/accdocs* directory. An example of what a missing “default record icon” could look like is pictured below.

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

The application server is not able to to find and display the icon in the browser because the icon’s associated PNG file is either missing entirely from the <APPIAN_HOME>/_admin/accdocs* directory or it is present but has an outdated file name (meaning the application server will be referencing the wrong filename for the icon).

Action

Action 1

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 2

Import the following:
1. The specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
2. Select the "Include related import customization file" checkbox.
3. Within the "Import Customization File (PROPERTIES)" section, upload an import.properties file which has the following contents:
```
## Import Setting: Force Update
## Forces the import of objects that were detected to be Not Changed on inspect/import
importSetting.FORCE_UPDATE=true
```
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 3

If you have a backup of icon(s) elsewhere, do the following:

Perform a network capture on the browser page where the missing icon(s) is located.
Identify the file name of the missing icon(s) and the source folder the file is supposed to be inside of.
Place the backup of the icon(s) within that folder.
Rename the backup of the file so that it matches the name of the missing icon(s).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

If the above actions do not resolve the issue please create a support case with Appian Technical Support to determine the best path forward.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2019

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Jordan Horwat — Fri, 03 May 2019 20:33:17 GMT

Revision 6 posted to Appian Knowledge Base by Jordan Horwat on 5/3/2019 8:33:17 PM

Symptoms

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

Action

Action 1

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 2

Import the following:
1. The specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
2. Select the "Include related import customization file" checkbox.
3. Within the "Import Customization File (PROPERTIES)" section, upload an import.properties file which has the following contents:
```
## Import Setting: Force Update
## Forces the import of objects that were detected to be Not Changed on inspect/import
importSetting.FORCE_UPDATE=true
```
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 3

If you have a backup of icon(s) elsewhere, do the following:

Perform a network capture on the browser page where the missing icon(s) is located.
Identify the file name of the missing icon(s) and the source folder the file is supposed to be inside of.
Place the backup of the icon(s) within that folder.
Rename the backup of the file so that it matches the name of the missing icon(s).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

If the above actions do not resolve the issue please create a support case with Appian Technical Support to determine the best path forward.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2019

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Jordan Horwat — Fri, 03 May 2019 20:32:38 GMT

Revision 5 posted to Appian Knowledge Base by Jordan Horwat on 5/3/2019 8:32:38 PM

Symptoms

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

Action

Action 1

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 2

Import the following:
1. The specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
2. Select the "Include related import customization file" checkbox.
3. Within the "Import Customization File (PROPERTIES)" section, upload a import.properties file which has the following contents:
```
## Import Setting: Force Update
## Forces the import of objects that were detected to be Not Changed on inspect/import
importSetting.FORCE_UPDATE=true
```
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 3

If you have a backup of icon(s) elsewhere, do the following:

Perform a network capture on the browser page where the missing icon(s) is located.
Identify the file name of the missing icon(s) and the source folder the file is supposed to be inside of.
Place the backup of the icon(s) within that folder.
Rename the backup of the file so that it matches the name of the missing icon(s).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

If the above actions do not resolve the issue please create a support case with Appian Technical Support to determine the best path forward.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2019

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Jordan Horwat — Fri, 03 May 2019 20:31:18 GMT

Revision 4 posted to Appian Knowledge Base by Jordan Horwat on 5/3/2019 8:31:18 PM

Symptoms

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

Action

Action 1

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 2

Import the following:
1. The specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
2. Select the "Include related import customization file" checkbox.
3. Within the "Import Customization File (PROPERTIES)" section, upload a import.properties file which has the following contents:
```
## Import Setting: Force Update
## Forces the import of objects that were detected to be Not Changed on inspect/import
importSetting.FORCE_UPDATE=true
```
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 3

If you have a backup of icon(s) elsewhere, do the following:

Perform a network capture on the browser page where the missing icon(s) is located.
Identify the file name of the missing icon(s) and the source folder the file is supposed to be inside of.
Place the backup of the icon(s) within that folder.
Rename the backup of the file so that it matches the name of the missing icon(s).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

If the above actions do not resolve the issue please create a support case with Appian Technical Support to determine the best path forward.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2019

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Jordan Horwat — Fri, 03 May 2019 20:24:45 GMT

Revision 3 posted to Appian Knowledge Base by Jordan Horwat on 5/3/2019 8:24:45 PM

Symptoms

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

Action

Action 1

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 2

Import the following:
1. The specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
2. Select the "Include related import customization file" checkbox.
3. Within the "Import Customization File (PROPERTIES)" section, upload a import.properties file which has the following contents:
```
## Import Setting: Force Update
## Forces the import of objects that were detected to be Not Changed on inspect/import
importSetting.FORCE_UPDATE=true
```

Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

Action 3

If you have a backup of icon(s) elsewhere, do the following:

Perform a network capture on the browser page where the missing icon(s) is located.
Identify the file name of the missing icon(s) and the source folder the file is supposed to be inside of.
Place the backup of the icon(s) within that folder.
Rename the backup of the file so that it matches the name of the missing icon(s).
Shut down the application server.
Clear the application server cache as per KB-1232.
Start the application server.

If the above actions do not resolve the issue please create a support case with Appian Technical Support to determine the best path forward.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: May 2019

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Jordan Horwat — Mon, 23 Jul 2018 17:46:51 GMT

Revision 2 posted to Appian Knowledge Base by Jordan Horwat on 7/23/2018 5:46:51 PM

Symptoms

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

Action

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Restart the application server.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: March 2017

Tags: user interface, application server, infrastructure

KB-1269 Missing default system icons in end user interface

Nick Vigilante — Tue, 07 Mar 2017 15:28:48 GMT

Revision 1 posted to Appian Knowledge Base by Nick Vigilante on 3/7/2017 3:28:48 PM

Symptoms

Note: Different browsers may use different icons to symbolize a missing or broken picture (in this case the black box with an x in the middle):

If you perform a network capture on the browser page containing the missing icon(s), you will see a REST call for the icon in question return with a 404 error (indicating the file was not found).

Cause

Action

Import the specific bundled app zip file from the <APPIAN_HOME>/ear/suite.ear/web.war/WEB-INF/bundled-apps/ directory through Appian Designer. (e.g., import records.zip for a missing default icon in Records).
Restart the application server.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: March 2017

Tags: user interface, application server