Difference between revisions of "DES/Current/Designer/Resources"
(Published) |
(Published) |
||
Line 112: | Line 112: | ||
}}{{Section | }}{{Section | ||
|sectionHeading=File size limitations | |sectionHeading=File size limitations | ||
− | |anchor= | + | |anchor=FileSizes |
|alignment=Vertical | |alignment=Vertical | ||
|structuredtext=When managing files for resources in Designer, note the following size limitations. | |structuredtext=When managing files for resources in Designer, note the following size limitations. | ||
Line 127: | Line 127: | ||
*Exported {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_export|display text=audio collections}} cannot be larger than '''100MB'''. | *Exported {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_export|display text=audio collections}} cannot be larger than '''100MB'''. | ||
− | === My file is too large - what can I do? === | + | ===My file is too large - what can I do?=== |
If your file exceeds the size limit, Designer will not complete the operation. If this happens, you can try the following options to decrease the file size: | If your file exceeds the size limit, Designer will not complete the operation. If this happens, you can try the following options to decrease the file size: | ||
Revision as of 04:27, February 26, 2021
Contents
Learn about the types of resources that you can use in your Designer applications.
Types of resources
From the main Designer navigation menu, you can access and manage a variety of resources that can be used in your applications, such as:
- Business Controls, to set up and manage your hours of business, holidays (and other special days), emergency flags, and data tables.
- Bot Registry, to add the bot resources you want to use in your applications.
- Speech Grammars, to define lists of phrases or options that a customer can provide as input to an application.
- Media Collections, to manage voice recordings and other audio-related settings.
- Digital Resources, to manage resources related to digital applications, such as standard responses and customized messages for chats.
- Shared Modules, which are smaller applications that you can use in other applications.
- Admin resources, to manage resources available to users with Designer Administrator role privileges (if you are not assigned this role, you will not see this item in the navigation bar).
Actions toolbar
Many of the resource pages in Designer have an Actions toolbar:
The action items on the toolbar will vary based on the resource page you are viewing. Depending on the functions available for that particular resource, you can do the following:
Button | Description |
---|---|
![]() |
Displays the history (or audit log) for a resource. For more information, see Resource history. |
![]() |
Displays a list of the applications and modules that are using a particular media or message collection. |
![]() |
Clones the resource. You'll need to assign the cloned resource a unique name. Note that a cloned resource does not inherit the history and published versions of the original resource. |
![]() |
Displays the version history for a shared module. You can then choose to make a version public, or view a version (in read-only mode) as it appeared at a particular time. |
![]() |
Exports the resource for use in another Designer workspace. When you export a resource, all versions of that resource are exported, including the unpublished version. If you are using a Safari browser when performing the export, the exported file is downloaded as unknown. The file is valid and can be imported successfully, but you can rename it to something more meaningful. |
![]() |
Imports the contents of a CSV file into a selected data table. For more information, see Import on the Data Tables page. |
![]() |
Deletes all versions of the resource. However, note that published applications that were already using the resource (i.e. applications that had previously generated their code) are not affected. |
Valid naming characters
When naming your resources, you can use the following characters (except where otherwise noted):
Character or Symbol | Description | Exceptions |
---|---|---|
A-Z
|
uppercase alphabetical | |
a-z
|
lowercase alphabetical | |
0-9
|
numeric | |
.
|
period (or dot) | |
:
|
colon | Not valid for bot resources. |
-
|
hyphen | |
_
|
underscore | |
@
|
"at" sign | Not valid for bot resources. |
!
|
exclamation mark | Not valid for bot resources. |
+
|
plus sign |
File size limitations
When managing files for resources in Designer, note the following size limitations.
Uploads and imports
- Files for audio or speech grammar resources cannot exceed 10MB.
- Imported applications or shared modules cannot exceed 10MB.
- Imported audio collections cannot exceed 15MB.
Downloads and exports
- Applications or shared modules exported from Designer cannot exceed 150MB (with audio) or 50MB (without audio).
- Exported audio collections cannot be larger than 100MB.
My file is too large - what can I do?
If your file exceeds the size limit, Designer will not complete the operation. If this happens, you can try the following options to decrease the file size:
- For importing zip files that contain multiple (bulk) audio files, you can split the file into multiple smaller zip files and upload each file separately.
- For audio or speech grammar files, you can try compressing the files before uploading.
- For .dar files that are too large to import, you can try reducing the file size by deleting large binaries or files that are not needed.
Resource history
The history view enables you to see a list of events for a resource that provide details about each time it was accessed or changed. You can see details such as the ID of the user who initiated the event and the new and previous values of any resource properties that were changed.
Resources that provide this option include Applications, Shared Modules, Announcements, Grammars, and Business Controls.
Depending on the resource you are viewing, there are a few different ways you can access the history view. You can select the History button from the resource properties:
Or, if you are viewing a resources page, you can select a resource and click the History button on the Actions toolbar:
For applications, you can view the history by selecting that option from the application properties.
For example, here is the history view for an application:You can use the buttons on the history page to filter the results for a specific time period (for example, last 1W to see the results for previous week), or use the date fields to specify a custom date range (you can go back up to a maximum of one year from the current date). Results can be sorted or searched.
To download the results, click Export to generate and save the results as a CSV file.
You can drill-down further into an historical event by double-clicking it. This displays the audit details for that particular event:
The Values tab displays information about the event, such as the resource type, the type of action taken, and the unique IDs of data relevant to the event.
If applicable, the Diff tab shows you information about the specific objects or properties that were impacted by that particular event. For some items, you can expand the item to display additional details: