Ed.jamer@genesys.com: Ed.jamer@genesys.com moved page PEC-ROU/Current/Designer/CustomService to DES/Current/Designer/CustomService: Text replacement - "PEC-ROU/Current/Designer/" to "DES/Current/Designer/"

2021-04-21T13:58:59Z

Ed.jamer@genesys.com moved page PEC-ROU/Current/Designer/CustomService to DES/Current/Designer/CustomService: Text replacement - "PEC-ROU/Current/Designer/" to "DES/Current/Designer/"

WikiSysop: Text replacement - "\|Platform=([^\|])GenesysEngage-onpremises([\|])" to "|Platform=$1GenesysEngage-cloud$2"

2020-07-25T02:34:01Z

Text replacement - "\|Platform=([^\|]*)GenesysEngage-onpremises([\|]*)" to "|Platform=$1GenesysEngage-cloud$2"

WikiSysop: Text replacement - "\|Platforms?=([^\|])PureEngage([\|])" to "|Platform=$1GenesysEngage-onpremises$2"

2020-07-15T11:46:23Z

Text replacement - "\|Platforms?=([^\|]*)PureEngage([\|]*)" to "|Platform=$1GenesysEngage-onpremises$2"

Bgrenon: Published

2020-06-08T15:21:44Z

Published

New page

{{Article
|Standalone=No
|DisplayName=Custom Service Block
|TocName=Custom Service Block
|Context=Use this block to access a custom service that was created for you by Genesys.
|ComingSoon=No
|Platform=PureEngage
|Role=Administrator
|Application=Designer
|Section={{Section
|alignment=Vertical
|structuredtext=You can use the '''Custom Service''' block to access a custom service that was created by Genesys for your company.

You can provide input to the service. The resulting variable from the block is true if the service request is successful, otherwise the result is false. This result is available for use in later blocks.
|Status=No
}}{{Section
|sectionHeading=Service Details tab
|anchor=ServiceDetailstab
|alignment=Vertical
|structuredtext=Select the service name and action to use in this '''Custom Service''' block.

Select '''Disable DTMF buffering''' if you want to prevent any DTMF inputs made during fetch audio playback from being buffered and carried forward into subsequent {{Link-SomewhereInThisManual|topic=UserInput|anchor=top|display text=User Input}} or {{Link-SomewhereInThisManual|topic=Menu|anchor=top|display text=Menu}} blocks.

If you enable the '''Play fetch audio''' check box, you can specify an audio resource to play to the caller while the custom service is being fetched.

{{NoteFormat|Only Announcements containing audio files are supported. TTS audio will not be played.}}

<ul>
<li>Enable the check box beside the '''Play fetch audio''' check box to specify a variable.</li>
<li>In the '''Play fetch audio minimum for''' field, you can enter the minimum length of time to play the audio, even if the custom service has arrived in the meantime.</li>
<li>In the '''Start fetch audio after''' field, you can enter a period of time to wait before audio is played.</li>
</ul>

{{NoteFormat|In the '''Self Service''' phase, fetch audio playback stops when the end of the audio file is reached, even if the service request is still in progress. In the '''Assisted Service''' phase, fetch audio playback loops until the service request times out.}}

====Input Parameters====
In the '''Input Parameters''' tab, specify the input expected by the custom service.
<ul>
<li>'''Name''' - Specify the name of the parameter expected by the custom service.</li>
<li>'''Type''' - The type of parameter (variable or literal).</li>
<li>'''Value''' - Specify the parameter value to pass to the input.</li>
</ul>

====Output Parameters====
In the '''Output Parameters''' tab, specify how and where to store the results of the custom service.
<ul>
<li>'''Variable Name''' - Select the application variable in which to store the data.</li>
<li>'''JSON Expression''' - Specify the key in which you expect the result to be in the response object. See the code sample and table below for an example.</li>

<source lang="java">
{
"thing": {
"otherthing": "abc"
},
"arrayofthings": [
"thing1", "thing2"
]
}
</source>

{{{!}}
!'''JSON Expression'''
!'''Result'''
{{!}}-
{{!}}<tt>thing.otherthing</tt>
{{!}}'''abc'''
{{!}}-
{{!}}<tt>arrayofthings[1]</tt>
{{!}}'''thing2'''
{{!}}}
</ul>

[[file:des_customservice_service.png]]
|Status=No
}}{{Section
|sectionHeading=Results tab
|anchor=Resultstab
|alignment=Vertical
|structuredtext=Select a variable to store the outcome status ('''true''' or '''false''') of the Custom Service request.

You must also select an action to take if the fetch operation is not successful. You can choose to "Continue with normal processing" or "Execute error handler blocks".

If you select "Execute error handler blocks", an '''Error Handler''' child block appears under the '''Custom Service''' block.

Use the '''Error Handler''' block to send the application to another target block that you select from the '''Navigation''' tab, or add child blocks that will perform the actual error handling.

=====Examples=====
In this example, the '''Navigation''' tab is used to specify a target block. If there is an error, the application will go to the '''Play Message''' block and play an error message:

[[file:des_custom_service_error_navigation.png]]

In this example, a child block is used to invoke a module that will perform the error handling:

[[file:des_custom_service_error_child.png]]

{{NoteFormat|
* If you select a target block from the '''Navigation''' tab, then any child blocks you've added to the '''Error Handler''' parent block are ignored.
* Standard validation rules still apply — any child blocks that you add to the '''Error Handler''' block must be valid for the application phase in which they are being used.
|2}}
|Status=No
}}
}}

← Older revision	Revision as of 13:58, April 21, 2021
(No difference)

@@ Line 5: / Line 5: @@
 |Context=Use this block to access a custom service that was created for you by Genesys.
 |ComingSoon=No
-|Platform=GenesysEngage-onpremises
+|Platform=GenesysEngage-cloud
 |Role=Administrator
 |Application=Designer

DES/Current/Designer/CustomService - Revision history

Ed.jamer@genesys.com: Ed.jamer@genesys.com moved page PEC-ROU/Current/Designer/CustomService to DES/Current/Designer/CustomService: Text replacement - "PEC-ROU/Current/Designer/" to "DES/Current/Designer/"

WikiSysop: Text replacement - "\|Platform=([^\|]*)GenesysEngage-onpremises([\|]*)" to "|Platform=$1GenesysEngage-cloud$2"

WikiSysop: Text replacement - "\|Platforms?=([^\|]*)PureEngage([\|]*)" to "|Platform=$1GenesysEngage-onpremises$2"

Bgrenon: Published

WikiSysop: Text replacement - "\|Platform=([^\|])GenesysEngage-onpremises([\|])" to "|Platform=$1GenesysEngage-cloud$2"

WikiSysop: Text replacement - "\|Platforms?=([^\|])PureEngage([\|])" to "|Platform=$1GenesysEngage-onpremises$2"