Some customers choose to sync their imSMART application with a separate file management system. Occasionally, something goes wrong with this sync, which causes an Asset (or its metadata) to not be properly transmitted to the imSMART database.
To resolve these issues, the CMS includes a set of "Developer Configuration" tools, which are available in the CMS for CMS Super Admins and CMS System Admins.
This section provides detailed information about each of these tools.
Asset Tools
When you are viewing the Asset management page in the CMS, you can access the following administrative tools:
- General Configurations
- Re-Calculate All Checksums
- External File Configurations
- Re-Download Asset
- Retrieve Celum Asset Details
- Make Asset Inactive and Ready
- Image Cropper Configurations
- Stop Pending Image Crops
- Preview Image Configurations
- Re-download Image Preview
- Auto Thumbnail Configurations
- Re-Download Auto Thumbnail
- Stop Pending Auto Thumbnail
- Icon by URL Configurations
- Re-Download Images by URL
- Stop Pending Download of Images by URL
- Re-Download Image Preview
Note You may not see all of these tools listed on your screen at all times because we have added business logic to hide certain options when we can determine that the Asset isn't experiencing that particular issue. |
General Configurations
Re-Calculate All Checksums
This function enables a CMS Admin to re-calculate all checksums for the main file and all types of image files.
- This function is permanently visible in the UI, but is typically only used when there is an issue with an iOS sync
Purpose |
This function enables a CMS Admin to re-calculate all checksums for the main file and all types of image files.
|
Common Uses |
Generally speaking, you will know which files have issues by looking at the Error Log on the mobile device after performing a Content Sync.
|
Image(s) | |
Use-Case Example |
An Asset may get "skipped" during a sync (on iOS, Android, and Windows) if there is a difference in the checksum value stored in the CMS database versus the checksum of the actual file on the local device.
To be more specific,
|
Resolution Notes |
A Support Team will typically only use this button if an Asset was skipped in an iOS Sync.
|
... |
External File Configurations
- Re-Download Asset
- Retrieve Celum Asset Details
- Make Asset Inactive and Ready
Re-Download Asset
This function enables a CMS Admin to re-download the asset from an external source, such as Celum or AEM (ie, an external digital asset management tool).
Purpose |
This option is only visible if the Asset is external.
|
Common Uses |
To be more specific, we use the external URL of the Asset to download a soft copy of the file into the CMS Database. |
Image(s) | |
Use-Case Example |
Generally speaking, this button is used in the following scenarios:
We do not automate the reactivation of the Asset (as an extended function of this button) because in some cases, the attempt to re-download the file fails, and therefore the file itself needs to remain inactive. |
Resolution Notes |
This option is typically used by a Support person to manually force the CMS to re-download the file from the external URL.
|
... |
Retrieve Celum Asset Details
This function is included to support the "Make Asset Inactive and Ready" option and enables a User to perform a search in Elastic. (This option is not visible to Customers who do not have Elastic Search integrated into their imSMART instance.)
- This option is only visible to Customers who use Celum for digital asset management.
Purpose | This button opens a modal that enables the User to to perform a search for terms like "orig" or "1024" to get the URL for the Asset so that the URL can be checked and verified to determine if it is working correctly. |
Common Uses |
Primarily used to obtain the image thumbnail URL for an Asset to determine if the thumbnail itself is missing, improperly formatter, or has other issues. |
Image(s) | n/a |
Use-Case Example |
To perform a search in the modal, follow these steps:
|
Resolution Notes | If the URL for the image is not working properly, you can then correct the issue in the CMS and/or your file management system, as needed. |
... |
Make Asset Inactive and Ready
This function is visible if the Asset is active and external, but is not ready to be synced to a mobile device.
~ Clicking this button does not fix the problem! ~
Purpose | Generally speaking, this button is used for "stuck files", which are visible when there is a message in the top-left corner of the CMS UI that says "x number of files pending" (just below the customer's logo, as shown below). |
Common Uses |
This function sets the Asset as inactive so it will no longer be synced.
|
Image(s) |
You will typically only see this option when you can see that files are stuck loading in the background. |
Use-Case Example |
Essentially, this button hides the Asset from view until the issue can be resolved by the customer and/or the CN Development Team, depending on the nature of the issue.
If a User clicks this button, they will then determine the cause of the problem by using the Retrieve Asset Details button (noted above) to perform a search for one of the following:
|
Resolution Notes |
If a Support person clicks this button, it does not fix the issue. After pressing this button, the Support Team will notify the customer to help them fix the issue.
|
... |
Image Cropper Configurations
Stop Pending Image Crops
This option is visible if the Asset has a pending CMS Image Cropper (ie, the Image Cropper tool in the CMS gets "hung up" and is unable to display the three cropped thumbnail types.
When this occurs, the CMS User will see a "spinner" where the thumbnail would normally be, as shown below.
Purpose |
This option is used by the Support Team when they open an Asset record and the grey overly for Pending (shown below) continues to remain visible for more than 5 minutes. |
Common Uses |
Generally speaking, this button is used only when the Image Cropper is displaying a "Pending" overlay (shown below) . |
Image(s) | |
Use-Case Example | Typically used when the CMS User sees a "spinner" where the thumbnail would normally be, as shown above. |
Resolution Notes |
In some cases, the Image Cropper may display the Processing overlay for 1 or 2 minutes - but if it the overlay remains visible for much longer than that, then we know there is an issue with the Image Cropper. |
... |
Preview Image Configurations
Re-Download Image Preview
This function enables an Admin to force an Asset to re-download the Asset item's preview image.
Purpose | Enables an Admin to force an image preview to be re-downloaded. |
Common Uses |
In some cases, the Image Preview (located in the right-hand gutter of the Asset page, as shown below) does not get displayed correctly.
|
Image(s) | |
Use-Case Example |
|
Resolution Notes |
Once you click the Re-Download Image Preview button, the image should immediately begin to download.
|
... |
Auto-Thumbnail Configurations
Re-Download Auto Thumbnail
This function enables a CMS Admin to automatically create a thumbnail image for an Asset.
Purpose |
We use a service to create these images.
|
Common Uses |
This function is used when the Asset Thumbnail is stuck in a "pending" state and needs to be re-downloaded (shown below). |
Image(s) | |
Use-Case Example |
Click this button to manually force the CMS to re-download the thumbnail for the file. |
Resolution Notes |
If the Support person clicks this button and it does not resolve the issue (or cannot successfully download the image), then the Support person will need to click on the Stop Pending Auto Thumbnail button, which is defined below. |
... |
Stop Pending Auto Thumbnail
This option is visible if there is an Auto-Thumbnail Image that is stuck in a "pending" state.
Note: Some customers do not use the auto-generated thumbnail if the Thumbnail images come from a separate file management system such as Celum or AEM.
Purpose |
Generally speaking, a Support Person will only click on this button if they have previously clicked the "Re-Download Auto Thumbnail" noted above, but that didn't correct the problem.
|
Common Uses |
In some cases, an auto-generated thumbnail does not load correctly in the CMS and becomes "stuck"
|
Image(s) |
When the "Generate Thumbnails from Asset" button is checked, the system will auto-create a Thumbnail for the Asset record.
Note that an image can be created for many different file types:
|
Use-Case Example | Generally speaking, a Support Person will only click on this button if they have previously clicked the "Re-Download Auto Thumbnail" noted above, but that didn't correct the problem. |
Resolution Notes |
If the Asset displays a "Pending" message for more than 3-5 hours, then the Support Team will need to follow these steps:
|
... |
Icon by URL Configurations
Re-Download Small Rectangle Images by URL
This function enables an Admin to force a re-download if any image from URL is pending. (The image is downloaded directly from the external URL.)
Purpose |
Enables an Admin to re-download an image. |
Common Uses |
This function is used when the Image is stuck in a "pending" state and needs to be re-downloaded. |
Image(s) |
When the "Generate Thumbnails from Asset" button is checked, the system will auto-create a Thumbnail for the Asset record.
Note that an image can be created for many different file types:
|
Use-Case Example | |
Resolution Notes | |
... |
Stop Pending Small Rectangle Image by URL
This function enables an Admin to stop any image from a URL that is pending.
Purpose |
Generally speaking, a CN Support Person will only click on this button if they have previously clicked the "Re-Download Auto Thumbnail" noted above, but that didn't correct the problem.
|
Common Uses |
This button will stop the service that is attempting to download the image, so that it can be investigated and/or re-downloaded. |
Image(s) | |
Use-Case Example |
In some cases, the image is not loaded correctly from the external URL and becomes "stuck"
|
Resolution Notes |
If the Asset displays a "Pending" message for more than 3-5 hours, then CN Support will need to follow these steps:
|
... |
Folder Tools
When you are viewing the Folder management page in the CMS, you can access the following administrative tools:
- General Configurations
- Re-Calculate All Checksums
- External File Configurations
- Re-Download Asset
- Retrieve Celum Asset Details
- Make Asset Inactive and Ready
- Image Cropper Configurations
- Stop Pending Image Crops
- Preview Image Configurations
- Re-download Image Preview
- Auto Thumbnail Configurations
- Re-Download Auto Thumbnail
- Stop Pending Auto Thumbnail
- Icon by URL Configurations
- Re-Download Images by URL
- Stop Pending Download of Images by URL
- Re-Download Image Preview
Note You may not see all of these tools listed on your screen at all times because we have added business logic to hide certain options when we can determine that the Asset isn't experiencing that particular issue. |
Tools for Folders
Purpose | |
Common Uses |
|
Image(s) | |
Use-Case Example | |
Resolution Notes | |
Something Else |
Comments
0 comments
Please sign in to leave a comment.