DES/Current/Designer/MediaResources - Revision history

WikiSysop at 19:45, June 7, 2022

2022-06-07T19:45:42Z

Brian.Marshall.IX: Published

2022-01-26T16:00:27Z

Published

Brian.marshall@genesys.com: Published

2021-11-10T14:46:07Z

Published

Brian.marshall@genesys.com: Published

2021-10-22T19:02:29Z

Published

Brian.marshall@genesys.com: Published

2021-10-22T18:10:46Z

Published

Brian.marshall@genesys.com: Published

2021-10-20T15:49:06Z

Published

Brian.marshall@genesys.com: Published

2021-10-20T15:14:39Z

Published

Brian.marshall@genesys.com: Published

2021-10-20T15:08:20Z

Published

Show changes

Brian.marshall@genesys.com: Published

2021-06-22T19:39:01Z

Published

Brian.marshall@genesys.com: Published

2021-06-18T02:34:36Z

Published

@@ Line 77: / Line 77: @@
 |anchor=ar_add
 |alignment=Vertical
-|structuredtext=After you've created a media resource collection, you can add media resources to it by clicking its link. You can then click '''Add Media Resource''' to upload a media resource to the collection.
+|structuredtext=After you've created a media collection, you can add media resources to it. This video shows an example of how to add a media resource:
 {{NoteFormat|If the collection was previously published, you can also {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_csv|display text=export}} the collection for offline management and then {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_bulk|display text=import}} the files back into Designer.|2}}
-This video shows an example of how to add a media resource:
+Give the resource a unique '''Name''' and click '''OK'''. Your new resource will appear in the list of resources. Select it to view the the resource properties in the '''Media Resource details''' section. You can enter an optional '''Description''' for the resource, or add '''Tags''' to associate it with other media resources that share the same tags.
-{{#widget:Vimeo|id=527368300|width=600|Description=Adding a media resource}}
+Next, click '''Manage Languages''' and then '''Add Language''' to select a language to use for this resource. You can then set up the '''Audio''' and '''Message''' properties of the resource, as described below.
 ===Audio properties===
-If this resource is only to be played as TTS (Text-to-Speech), select '''This announcement plays TTS only'''.
+If adding an audio recording, make sure that the '''This announcement plays TTS only''' box is NOT selected.
-[[file:des_audio_tts.png]]
+[[File:Des_media_resources_recorded.png]]
-In the '''TTS Text''' field, enter the text to be spoken by the TTS engine. You can also use '''Speech Synthesis Markup Language''' (SSML) in TTS prompts. For more information about SSML, see  {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ssml|display text=Speech Synthesis Markup Language (SSML)}}. After you have entered the TTS text, click '''Save'''.{{AnchorDiv}}If adding an audio recording, make sure that the '''This announcement plays TTS only''' box is NOT selected. There are a few requirements for audio files:
+There are a few requirements for audio files:
 *The file size must not exceed 10 MB.
@@ Line 98: / Line 108: @@
 *Audio files must be recorded in (or converted to) the G711 u-Law 8 kHz (also known as G.711Mu or G.711μ) audio codec. They must also be single-channel (mono) and saved as a .wav file.
-Click the '''File''' button to select and upload your recording. A checkmark appears if the file is uploaded successfully. After you have saved the audio resource, you can click the play button to listen to the audio file.
+Click the '''File''' button to select and upload the recording. A checkmark appears if the file is uploaded successfully. After you have saved the audio resource, you can click the play button to listen to the audio file.
 ===Message properties===
-If the media resource is going to be used for chats, you can enter text to display in the '''Alternate Text''' field or select a '''Standard Response''' message.
+If the media resource is also going to be used for chats, you can enter text to display in the '''Alternate Text''' field or select a '''Standard Response''' message.
 [[File:Des media resources standard response.png|border]]

@@ Line 95: / Line 95: @@
 *The file size must not exceed 10 MB.
-*Files should be named as follows: <''media resource name''>_<''short language name''>.<''file extension''>. Example: welcome_en-US.wav. The file name must only contain alphanumeric characters, underscores (_), hyphens (-), or dots (.). File names with special characters are not supported.
+*Files should be named as follows: <''media resource name''>_<''short language name''>.<''file extension''>. Example: welcome_en-US.wav. The file name must only contain alphanumeric characters, underscores (_), hyphens (-), or dots (.) and cannot be longer than 50 characters. File names with special characters are not supported.
 *Audio files must be recorded in (or converted to) the G711 u-Law 8 kHz (also known as G.711Mu or G.711μ) audio codec. They must also be single-channel (mono) and saved as a .wav file.

@@ Line 77: / Line 77: @@
 |anchor=ar_add
 |alignment=Vertical
-|structuredtext=After you've created a media resource collection, you can add media resources to it by clicking its link. There are two ways you can add media resources to a collection:
+|structuredtext=After you've created a media resource collection, you can add media resources to it by clicking its link. You can then click '''Add Media Resource''' to upload a media resource to the collection.
-*Upload a single resource.
+{{NoteFormat|If the collection was previously published, you can also {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_csv|display text=export}} the collection for offline management and then {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_bulk|display text=import}} the files back into Designer.|2}}
-To add a single resource, click '''Add Media Resource''' and enter a name for the media resource. Make sure to use a unique name, as you won't be able to add it if it has the same name as an existing system resource. Click '''OK'''.
+This video shows an example of how to add a media resource:
-Properties of the new media resource are displayed to the right of the list. You can choose to add a '''Description''' to describe the purpose of this resource. You can also add '''Tags''' to associate this resource with media resources that share the same tags.
+{{#widget:Vimeo|id=527368300|width=600|Description=Adding a media resource}}
-Click '''Manage Languages''' to continue setting up the resource. Select the language to be used for this resource (you can click '''Add Language''' if you want to add more). You can then set up the '''Audio''' and '''Message''' properties of the resource.{{AnchorDiv}}
+Click '''Add Media Resource''' and enter a unique name for the media resource. In the resource properties, you can enter an optional '''Description''' for the resource, or add '''Tags''' to associate it with other media resources that share the same tags. Next, click '''Manage Languages''' and then '''Add Language''' to select a language to use for this resource. You can then set up the '''Audio''' and '''Message''' properties of the resource, as described below.
 ===Audio properties===
 If this resource is only to be played as TTS (Text-to-Speech), select '''This announcement plays TTS only'''.
@@ Line 101: / Line 101: @@
 [[File:des_audio_upload_audio.png]]
 ===Message properties===
 If the media resource is going to be used for chats, you can enter text to display in the '''Alternate Text''' field or select a '''Standard Response''' message.
 [[File:Des media resources standard response.png|border]]
 |Status=No
 }}{{Section

@@ Line 29: / Line 29: @@
 |anchor=assign
 |alignment=Vertical
-|structuredtext=You can assign media collections to applications and shared modules from the {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=assign|display text=Media tab}} of the application settings. Each application or shared module can be linked to a single media collection. If you don't specify a collection for a shared module, it inherits the collection of the invoking application.{{NoteFormat|To improve media resources management, consider linking shared modules to their own media collections.|2}}
+|structuredtext=You can assign media collections to applications and shared modules from the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationSettings|anchor=media|display text=Media tab}} of the application settings. Each application or shared module can be linked to a single media collection. If you don't specify a collection for a shared module, it inherits the collection of the invoking application.{{NoteFormat|To improve media resources management, consider linking shared modules to their own media collections.|2}}
 |Status=No
 }}{{Section

@@ Line 10: / Line 10: @@
 |Section={{Section
 |alignment=Vertical
-|structuredtext=From the '''Media Collections''' page, you can centrally manage media resources and collections for applications and shared modules. Collections can be {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=assign|display text=assigned}} to applications or shared modules.
+|structuredtext=From the '''Media Collections''' page, you can centrally manage the media collections and resources that are being used in your applications and shared modules.
-Each collection contains '''Media resources''', which are TTS (Text-to-Speech) prompts and recorded audio files that you can use in any block that supports the playing of audio or the display of text and standard response messages for chat prompts. For example, a company might have a media collection that contains media resources for each locale in which they operate, with language-specific audio for greeting customers, communicating announcements, and offering special promotions.
+Each collection contains '''media resources'''. These are TTS (Text-to-Speech) prompts and recorded audio files that you can use in any block that supports the playing of audio or the display of text and standard response messages for chat prompts. For example, a company might have a media collection that contains media resources for each locale in which they operate, with language-specific audio and/or messages for greeting customers, communicating announcements, and offering special promotions.
 Designer includes the following media collections:
@@ Line 21: / Line 21: @@
 *{{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=MusicOnHold|display text=Music On Hold}} contains the default audio file played for music on hold. You can {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=MusicOnHold|display text=change the audio}} that is played, but the collection cannot be modified or deleted.
 You can also {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_create|display text=create}} your own media collections.
 <br />
 |Status=No
 }}{{Section
-|sectionHeading=Assigning a media collection to an application or shared module
+|sectionHeading=Assigning a media collection to an application
 |anchor=assign
 |alignment=Vertical
-|structuredtext=You can assign a media collection to an application or a shared module by going to the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationSettings|anchor=media|display text=Media tab}} of the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationSettings}} and selecting the collection. Each application or shared module can be linked to a single media collection. If you don't specify a collection for a shared module, it inherits the collection of the invoking application.{{NoteFormat|To improve media resources management, consider linking shared modules to their own media collections.|2}}
+|structuredtext=You can assign media collections to applications and shared modules from the {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=assign|display text=Media tab}} of the application settings. Each application or shared module can be linked to a single media collection. If you don't specify a collection for a shared module, it inherits the collection of the invoking application.{{NoteFormat|To improve media resources management, consider linking shared modules to their own media collections.|2}}
 |Status=No
 }}{{Section

@@ Line 46: / Line 46: @@
 {{AnchorDiv|ac_export}}
 ===Export a media collection===
-Use this option to download a zip file containing all of the media files in the collection. The zip file includes a CSV file that you can edit to {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|display text=make offline changes to the media collection|anchor=ac_csv}} before importing the collection back into Designer.
+Use this option to download a zip file containing all of the media files in the collection. The zip file includes a CSV file that you can edit to {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|display text=make changes to the media collection offline|anchor=ac_csv}} before {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_bulk|display text=importing}} the collection back into Designer.
 {{AnchorDiv|ac_delete}}
 ===Delete a media collection===
@@ Line 177: / Line 177: @@
 |Status=No
 }}{{Section
-|sectionHeading=Offline management of exported collections (CSV file)
+|sectionHeading=Managing exported media collections offline (CSV file)
 |anchor=ac_csv
 |alignment=Vertical
-|structuredtext=You can export a media collection to make changes to it offline. The collection can then be {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_bulk|display text=imported}} back into Designer.
+|structuredtext=You can {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_export|display text=export}} a media collection to make changes to it offline. The collection can then be {{Link-SomewhereInThisVersion|manual=Designer|topic=MediaResources|anchor=ac_bulk|display text=imported}} back into Designer.
 When you export a media collection, a CSV file is included with the exported zip file. You can use an application like Microsoft Excel to edit this file and make changes to the media collection. For example, you can {{Link-SomewhereInThisManual|topic=MediaResources|anchor=ar_csvadd|display text=add new resources}}, {{Link-SomewhereInThisManual|topic=MediaResources|anchor=ar_csvremove|display text=mark existing resources for removal}}, or modify certain resource properties.

@@ Line 54: / Line 54: @@
 Watch an example of how to add a media resource to a collection:
-{{Video|id=527368300|width=600}}
+<br />
 Properties of the new media resource are displayed to the right of the list. You can choose to add a '''Description''' to describe the purpose of this resource. You can also add '''Tags''' to associate this resource with media resources that share the same tags.

@@ Line 23: / Line 23: @@
 *'''Shared Resources''' contains media resources that can be used in any application or module. You can make changes to this collection.
 *'''System Resources''' is a read-only collection that is managed by Designer. You cannot make any changes to this collection.
 See the {{Link-SomewhereInThisManual|topic=ApplicationsBar|anchor=top|display text=Applications}} or {{Link-SomewhereInThisManual|topic=SharedModulesBar|anchor=top|display text=Shared Modules}} page for more information on how to assign a media collection to an application or shared module.
@@ Line 122: / Line 123: @@
 ===Delete a media collection===
 Click the trash icon to delete a media collection. Designer will ask you to confirm this action, and display a list of applications and modules that are using any of the media resources contained in the collection.
 |Status=No
 }}{{Section