Difference between revisions of "DES/Current/Designer/SdrRef"
(Published) |
|||
(8 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
|DisplayName=Session Detail Record (SDR) Fields Reference | |DisplayName=Session Detail Record (SDR) Fields Reference | ||
|TocName=Session Detail Record (SDR) Fields Reference | |TocName=Session Detail Record (SDR) Fields Reference | ||
− | |Context=This page lists some of the most commonly used Session Detail Record (SDR) fields | + | |Context=This page lists some of the most commonly used Session Detail Record (SDR) fields. |
|ComingSoon=No | |ComingSoon=No | ||
− | |Platform= | + | |Platform=GenesysEngage-cloud |
|Role=Administrator | |Role=Administrator | ||
|Application=Designer | |Application=Designer | ||
− | |||
|Section={{Section | |Section={{Section | ||
− | |||
− | |||
|alignment=Vertical | |alignment=Vertical | ||
− | + | |structuredtext=This page lists some of the most commonly used Session Detail Record (SDR) fields. It is not intended as a comprehensive list of all SDR fields used by Designer. Each entry notes whether the value is set by '''Designer''' (i.e. system-generated) or provided by the application '''Developer'''. | |
− | |||
− | |structuredtext= | ||
− | The | + | The '''Category''' associates each field with the source of its value. For example, it indicates if the value was pulled from '''Session Information''' (captured during application runtime) or from certain types of blocks that were encountered, such as '''Routing''' or '''Business Controls'''. |
− | {{NoteFormat| | + | You can click the arrows in the column headers to sort the items alphabetically. |
− | + | ||
− | + | {{NoteFormat|'''Internal Designer system variables in SDRs'''</br> | |
− | + | During an application session, Designer adds certain internal system variables at various stages. These internal variables are recorded in Designer Analytics at the end of the application, along with other system and user-defined variables. Thus, it is possible to see new variables in Analytics that are not listed in the '''Initialize''' phase block. Although these variables may appear in variable or call data objects in Session Detail Records (SDR), they are intended only for internal use by Designer and should not be used in blocks for driving application logic. These variables can change or be removed at any time, so attempting to use them in applications can affect application resiliency and cause unexpected behavior. This type of usage is not supported or recommended. If your business operations require new functionality, contact your Genesys representative.|}} | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | {{ | + | {{NoteFormat|To quickly check if a field is listed on this page, you can use the search function in your browser. For example, in Chrome, press '''CTRL + F''' to open the search tool.|2}} |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
− | |sectionHeading= | + | |sectionHeading=List of Session Detail Record fields |
− | |anchor= | + | |anchor=sdr |
|alignment=Vertical | |alignment=Vertical | ||
− | + | |structuredtext={{{!}} class="sortable" | |
− | + | !'''Field''' | |
− | |structuredtext= | ||
− | {{{!}} | ||
− | |||
!'''Description''' | !'''Description''' | ||
− | {{!}}- | + | !'''Category''' |
− | {{!}} | + | !'''Set by''' |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}ANI |
− | {{!}} | + | {{!}}The {{Glossaryterm|term=Automatic Number Identification|addlink=true}} is the customer's phone number (or Caller ID). |
− | + | {{!}}Call Information | |
− | {{!}} | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{ | + | {{!}}DNIS |
− | {{!}} | + | {{!}}The {{Glossaryterm|term=Dialed Number Identification Service|addlink=true}} is the phone number that the customer dialed. |
− | {{!}} | + | {{!}}Call Information |
− | {{!}} | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}applicationName |
− | {{!}} | + | {{!}}The name of the application, as provided by the application Developer when {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationsBar|anchor=appcreate|display text=creating a new application}}. |
− | {{!}} | + | {{!}}Application Settings |
− | {{ | + | {{!}}Developer |
− | {{!}} | + | {{!}}- |
− | {{!}}- | + | {{!}}applicationID |
− | {{!}} | + | {{!}}The unique internal ID that Designer assigned to the application. |
− | + | ||
− | {{!}} | + | {{NoteFormat|You can quickly view an application ID by mousing over the application link on the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationsBar}} page and checking the target URL that appears in the browser window. |
− | {{!}} | + | |
− | {{!}} | + | [[File:des_sdr_ref_applicationID.png]].|2}} |
− | {{!}} | + | {{!}}Application Settings |
− | {{ | + | {{!}}Designer |
− | | | + | {{!}}- |
− | | | + | {{!}}ApplicationType |
− | | | + | {{!}}The application type, as selected by the application developer when the application was created (see {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationsBar|anchor=appcreate|display text=creating a new application}}). The values are as follows: |
− | }}{{ | + | |
− | + | *application = Default | |
− | + | *eservices = Digital | |
− | + | *callback = Callback | |
− | + | {{!}}Application Settings | |
− | + | {{!}}Developer | |
− | + | {{!}}- | |
− | + | {{!}}applicationVersion | |
− | + | {{!}}Optional custom ''version'' of the application to use for reporting purposes, as specified by the application developer on the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationSettings|anchor=general|display text=General tab}} in the application settings. | |
− | + | {{!}}Application Settings | |
− | {{!}} | + | {{!}}Developer |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}ApplicationReportingTitle |
− | {{!}} | + | {{!}}Optional custom ''title'' of the application for reporting purposes, as specified by the application developer on the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationSettings|anchor=general|display text=General tab}} in the application settings. |
− | {{!}} | + | {{!}}Application Settings |
− | {{!}} | + | {{!}}Developer |
− | {{ | + | {{!}}- |
− | {{!}}- | + | {{!}}SessionID |
− | {{!}} | + | {{!}}The unique internal ID that Designer assigned to the session. |
− | {{!}} | + | {{!}}Session Information |
− | {{!}}- | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}InteractionID |
− | {{!}} | + | {{!}}The unique internal ID that Designer assigned to the interaction. |
− | {{!}} | + | {{!}}Session Information |
− | {{!}} | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | + | {{!}}InteractionCategory | |
− | | | + | {{!}}The channel type that was used for the interaction. For example: voice, chat, or email. |
− | | | + | {{!}}Session Information |
− | | | + | {{!}}Designer |
− | }}{{ | + | {{!}}- |
− | | | + | {{!}}ConnectionID |
− | | | + | {{!}}The connection ID that Designer assigned to the interaction. For example: <tt>016202fe11099003</tt> |
− | | | + | {{!}}Session Information |
− | | | + | {{!}}Designer |
− | + | {{!}}- | |
− | + | {{!}}finalDisposition | |
− | + | {{!}}Disposition code indicating the status of the interaction at the time it exited the application flow. For example, this value can indicate if the interaction was routed to an agent or the customer disconnected from the call. Disposition codes can be enabled in the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=finalize|display text=Finalize}} phase. For more information, see {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=dispositions|display text=disposition codes}}. | |
− | + | {{!}}Session Information | |
− | + | {{!}}Designer | |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}LanguageName |
− | {{ | + | {{!}}The language that was set for the application at the time when the interaction ended. |
− | {{!}}- | + | {{NoteFormat|Note that {{Link-SomewhereInThisVersion|manual=Designer|topic=ChangeLang}} blocks can be used to change the language at select points in an application flow. This value always reflects the ''last'' language that was set for the application when the interaction ended.|2}} |
− | {{!}} | + | {{!}}Session Information |
− | {{!}} | + | {{!}}Developer |
− | {{!}} | + | {{!}}- |
− | {{!}}<tt> | + | {{!}}@endtime |
− | {{!}} | + | {{!}}Timestamp to indicate when the interaction ended. Example: <tt>2017-03-08T01:56:26.085Z</tt> |
− | {{ | + | {{!}}Session Information |
− | + | {{!}}Designer | |
− | + | {{!}}- | |
− | {{ | + | {{!}}@timestamp |
− | + | {{!}}Timestamp to indicate when the interaction started. Example: <tt>2017-03-08T01:56:12.037Z</tt> | |
− | | | + | {{!}}Session Information |
− | | | + | {{!}}Designer |
− | | | + | {{!}}- |
− | }}{{ | + | {{!}}duration |
− | + | {{!}}Duration of the total session, in milliseconds (ms). | |
− | + | {{NoteFormat|To calculate the duration of blocks execution and exclude session wrap-up time, subtract the value of the {{Link-SomewhereInThisVersion|manual=Designer|topic=SdrRef|anchor=operationalOverheadDuration|display text=operationalOverheadDurationz}} field from this value.|2}} | |
− | | | + | {{!}}Session Information |
− | | | + | {{!}}Designer |
− | | | + | {{!}}- |
− | + | {{!}}{{AnchorDiv|operationalOverheadDuration}}operationalOverheadDuration | |
+ | {{!}}Total amount of time, in milliseconds (ms), that the application was in an idle state. Typically, this state occurs just before the session enters the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=finalize|display text=Finalize}} phase. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}ssduration | ||
+ | {{!}}Amount of time (in milliseconds) that the customer spent in the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=selfservice|display text=Self Service}} phase of the application. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}ssstart | ||
+ | {{!}}Timestamp to indicate when the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=selfservice|display text=Self Service}} phase of the application started. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}ssend | ||
+ | {{!}}Timestamp to indicate when the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=selfservice|display text=Self Service}} phase of the interaction ended. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}asduration | ||
+ | {{!}}Length of time (in milliseconds) that the customer spent in the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=assistedservice|display text=Assisted Service}} phase. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}asstart | ||
+ | {{!}}Timestamp to indicate when the interaction entered the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=assistedservice|display text=Assisted Service}} phase. Example: <tt>2017-03-08T01:56:20.933Z</tt> | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}asend | ||
+ | {{!}}Timestamp to indicate when the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=assistedservice|display text=Assisted Service}} of the interaction ended. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}variables | ||
+ | {{!}}List of all user and system {{Link-SomewhereInThisVersion|manual=Designer|topic=Variables|display text=variables}} that contain values. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}survey | ||
+ | {{!}}List of survey-related variables. For more information, see the '''survey_*''' variables listed in {{Link-SomewhereInThisVersion|manual=Designer|topic=Variables|anchor=SystemVariables|display text=system variables}} and the {{Link-SomewhereInThisVersion|manual=Designer|topic=Survey}} page. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}calldata | ||
+ | {{!}}List of all call data Key-Value Pairs (KVPs) encountered by the application. For more information, see the {{Link-SomewhereInThisVersion|manual=Designer|topic=CallData|display text=Call Data}} block page. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}callAbandonedBlock | ||
+ | {{!}}If the customer leaves the session (for example, hangs up), this field contains the ID of the block that was being processed when they left. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}callEndState | ||
+ | {{!}}Indicates if the call ended in the {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=assistedservice|display text=Assisted Service}} or {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationPhases|anchor=selfservice|display text=Self Service}} phase. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}callEndParty | ||
+ | {{!}}Indicates the party that ended the call, i.e. Application, Caller, or System. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}callEndReason | ||
+ | {{!}}Indicates the reason that the call ended. For example, it might have been routed to an agent, abandoned, triggered a {{Link-SomewhereInThisVersion|manual=Designer|topic=BusinessObjectsBar|display text=Business Controls}} condition, such as an emergency flag, business hours, or special day exception, or the caller selected a menu option that ended the call. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}callEndType | ||
+ | {{!}}Indicates the conditions under which the call was ended, i.e. Normal or Error. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}dtmfpath | ||
+ | {{!}}The menu path (via the pressing of DTMF keys) that the customer took through the application. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}menucount | ||
+ | {{!}}The number of {{Link-SomewhereInThisVersion|manual=Designer|topic=Menu|display text=Menu}} blocks the customer encountered during the session. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}inputcount | ||
+ | {{!}}Total number of {{Link-SomewhereInThisVersion|manual=Designer|topic=UserInput|display text=User Input}} blocks the customer encountered during the session. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}blockpath | ||
+ | {{!}}An ordered list of the names of all blocks that were encountered throughout the course of the interaction. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}blockidpath | ||
+ | {{!}}An ordered list of IDs for all blocks that were encountered throughout the interaction. For more information about block IDs, see {{Link-SomewhereInThisVersion|manual=Designer|topic=Blocks|display text=Using the blocks}}. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}blocks* | ||
+ | {{!}}List of detailed information about the individual blocks that were encountered, such as: | ||
− | + | *name of the block | |
− | + | *unique ID of the block | |
− | + | *type of block | |
− | + | *duration of time that was spent inside the block | |
− | + | *timestamps of when the application entered and exited the block | |
− | + | {{!}}Session Information | |
− | {{!}} | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}inputs* |
− | {{!}} | + | {{!}}List of detailed information about the various {{Link-SomewhereInThisVersion|manual=Designer|topic=UserInput|display text=User Input}} blocks that were encountered, such as: |
− | {{!}} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | *name of the block | |
− | + | *unique ID of the block | |
− | + | *timestamps of when the application entered and exited the block | |
− | {{!}}- | + | {{!}}Session Information |
− | {{!}} | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}externalrequests* |
− | {{!}} | + | {{!}}List containing detailed information about {{Link-SomewhereInThisVersion|manual=Designer|topic=ExtServBlocks}} that were encountered. |
− | {{!}} | + | {{!}}Session Information |
− | {{!}} | + | {{!}}Designer |
− | {{ | + | {{!}}- |
+ | {{!}}{{AnchorDiv|milestones}}milestones | ||
{{!}}List containing the system milestones that were encountered. Milestones indicate special points or transitions in the application, such as phases starting, phases ending, or an application terminating. | {{!}}List containing the system milestones that were encountered. Milestones indicate special points or transitions in the application, such as phases starting, phases ending, or an application terminating. | ||
− | + | {{!}}Session Information | |
− | {{!}}- | + | {{!}}Designer and Developer |
− | {{!}} | + | {{!}}- |
− | {{!}}Milestones that were defined in {{Link- | + | {{!}}usermilestonecount |
− | ''' | + | {{!}}Number of user-defined milestones that were hit. These are milestones that were defined in {{Link-SomewhereInThisVersion|manual=Designer|topic=Milestone|display text=Milestone}} blocks or set in other blocks, such as {{Link-SomewhereInThisVersion|manual=Designer|topic=Menu|display text=Menu}}. |
− | {{!}}- | + | {{!}}Session Information |
− | {{!}} | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{!}}- | + | {{!}}userMilestones* |
− | {{!}}<tt> | + | {{!}}Milestones that were defined in {{Link-SomewhereInThisVersion|manual=Designer|topic=Milestone|display text=Milestone}} blocks or set in other blocks, such as {{Link-SomewhereInThisVersion|manual=Designer|topic=Menu|display text=Menu}}. |
− | {{!}} | + | {{!}}Session Information |
− | {{!}}- | + | {{!}}Designer and Developer |
− | {{!}}} | + | {{!}}- |
− | | | + | {{!}}userMilestonesPath |
− | | | + | {{!}}Names of all milestones that were encountered by the application during the session. |
− | | | + | {{!}}Session Information |
− | }}{{ | + | {{!}}Designer |
− | | | + | {{!}}- |
− | | | + | {{!}}FinalUserMilestone |
− | | | + | {{!}}The last user-defined milestone that was encountered during the application session (if the value of '''usermilestonecount''' is greater than 0). |
− | | | + | {{!}}Session Information |
− | | | + | {{!}}Designer |
− | | | + | {{!}}- |
+ | {{!}}LastMilestone | ||
+ | {{!}}The most recent milestone that was encountered during the session. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}activities* | ||
+ | {{!}}List of activities that were encountered during the session. Activities are defined in an {{Link-SomewhereInThisVersion|manual=Designer|topic=Activity|display text=Activity}} or automatically captured when an interaction enters or exits a {{Link-SomewhereInThisVersion|manual=Designer|topic=SharedModulesBar|display text=Shared Module}}. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Developer | ||
+ | {{!}}- | ||
+ | {{!}}activitycount | ||
+ | {{!}}Total number of activities that were encountered during the session. Activities are defined in an {{Link-SomewhereInThisVersion|manual=Designer|topic=Activity|display text=Activity}} block or automatically captured when an interaction enters or exits a {{Link-SomewhereInThisVersion|manual=Designer|topic=SharedModulesBar|display text=Shared Module}}. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}utcstart | ||
+ | {{!}}Starting time of the interaction in Universal Coordinated Time (UTC). Example: <tt>1454643744261</tt> | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}SessionType | ||
+ | {{!}}The type of session. Example: '''inbound''' | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}CountryName | ||
+ | {{!}}Name of the country. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}Region | ||
+ | {{!}}Name of the region. | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}childIxns* | ||
+ | {{!}}This field only applies to {{Link-SomewhereInThisVersion|manual=Designer|topic=ApplicationsBar|anchor=apptypes|display text=Digital }} type applications and contains a list of details about new child interactions that were created by the session. The details include information about the block that initiated the child interactions (i.e. blockid, blockname, and blocktype). It can also indicate if the child interaction was created by a busy treatment (isTreatment: Y). | ||
+ | {{!}}Session Information | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}attributeslist | ||
+ | {{!}}Object with each key-value pair (KVP) appearing as a property that is set to the KVP value. (See also: {{Link-SomewhereInThisVersion|manual=Designer|topic=ECMAScript|anchor=setAttributes|display text=setAttributes}}) | ||
+ | {{!}}Generic Attributes | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}businesshourserrcount | ||
+ | {{!}}Number of times a {{Link-SomewhereInThisVersion|manual=Designer|topic=BusinessHrs|display text=Business Hours}} was accessed during the interaction. | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}businesshoursextcount | ||
+ | {{!}}Total number of external {{Link-SomewhereInThisVersion|manual=Designer|topic=DesBusinessHours}} checks that occurred within a session, if you are controlling Business Hours from a web service (for example, via an {{Link-SomewhereInThisVersion|manual=Designer|topic=HTTPREST|display text=HTTP Rest}} block.) | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}businesshoursreqcount | ||
+ | {{!}}Total number of requests for {{Link-SomewhereInThisVersion|manual=Designer|topic=DesBusinessHours}} checks that occurred within a session. | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}emergencieserrcount | ||
+ | {{!}}Total number of {{Link-SomewhereInThisVersion|manual=Designer|topic=EmergencyFlags}} checks within a session. | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}emergenciesextcount | ||
+ | {{!}}Total number of external {{Link-SomewhereInThisVersion|manual=Designer|topic=EmergencyFlags}} checks within a session, if you are controlling emergency modes from a web service (for example, via an {{Link-SomewhereInThisVersion|manual=Designer|topic=HTTPREST|display text=HTTP Rest}} block.) | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}specialdayserrcount | ||
+ | {{!}}Total number of {{Link-SomewhereInThisVersion|manual=Designer|topic=SpecialDays|display text=Special Days}} checked within a session. All checks in a single {{Link-SomewhereInThisVersion|manual=Designer|topic=SpecialDay|display text=Special Day block}} count as one check. | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}specialdaysextcount | ||
+ | {{!}}Total number of {{Link-SomewhereInThisVersion|manual=Designer|topic=SpecialDays|display text=Special Days}} checked externally within a session, if you are controlling these from a web service (for example, via an {{Link-SomewhereInThisVersion|manual=Designer|topic=HTTPREST|display text=HTTP Rest}} block). All checks in a single {{Link-SomewhereInThisVersion|manual=Designer|topic=SpecialDay|display text=Special Day block}} count as one check. | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}specialdaysreqcount | ||
+ | {{!}}Total number of exceptions that were encountered when the application was performing Special Day checks. All errors encountered in a single {{Link-SomewhereInThisVersion|manual=Designer|topic=SpecialDay|display text=Special Day block}} count as one check. | ||
+ | {{!}}Business Controls | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}routingAttempts | ||
+ | {{!}}Each routing attempt is captured as an entry in the array. Some of the properties captured in each routing attempt include: | ||
− | {{{!}} | + | *blockID and blockName |
− | ! | + | *priority - value of the priority used for the last queue submit call made by this block (applies only when priority routing is enabled). |
− | + | {{!}}Routing | |
− | {{!}}- | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
− | {{!}} | + | {{!}}routingBlockCount |
− | {{!}}- | + | {{!}}Number of {{Link-SomewhereInThisVersion|manual=Designer|topic=RoutingBlocks|display text=Routing}} blocks that were encountered within a session. |
− | {{!}} | + | {{!}}Routing |
− | {{!}}Number of | + | {{!}}Designer |
− | {{!}} | + | {{!}}- |
+ | {{!}}routingBlockTimeoutCount | ||
+ | {{!}}Number of times that routing blocks timed out. | ||
+ | {{NoteFormat|A high number here can indicate that customers are waiting too long in the queue for some reason. For example, skill levels might be set too high or there are not enough agents available.|2}} | ||
+ | {{!}}Routing | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}routingCallHandlingType | ||
+ | {{!}}Indicates the type of routing used for the call. For example: '''default''' or '''consult''' | ||
+ | {{!}}Routing | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}routingLCAAttempted | ||
+ | {{!}}Indicates if '''Last Called Agent''' routing was attempted. This option can be enabled on the {{Link-SomewhereInThisVersion|manual=Designer|topic=RouteAgent|anchor=AgentRoutingtab|display text=Agent Routing tab}} of the {{Link-SomewhereInThisVersion|manual=Designer|topic=RouteAgent|display text=Route Agent}} block. | ||
+ | {{!}}Routing | ||
+ | {{!}}Designer | ||
+ | {{!}}- | ||
+ | {{!}}routingSkillRelaxationCount | ||
+ | {{!}}Number of {{Link-SomewhereInThisVersion|manual=Designer|topic=RoutingBlocks|display text=Routing}} blocks that used skill relaxation as a routing option. The required skill level is gradually reduced until a specified minimum skill level is reached, which allows you to expand the group of agents that can receive this call if other agents are busy. | ||
+ | {{!}}Routing | ||
+ | {{!}}Designer | ||
{{!}}} | {{!}}} | ||
− | |||
− | |||
|Status=No | |Status=No | ||
}} | }} | ||
}} | }} |
Latest revision as of 02:30, April 15, 2022
This page lists some of the most commonly used Session Detail Record (SDR) fields.
This page lists some of the most commonly used Session Detail Record (SDR) fields. It is not intended as a comprehensive list of all SDR fields used by Designer. Each entry notes whether the value is set by Designer (i.e. system-generated) or provided by the application Developer.
The Category associates each field with the source of its value. For example, it indicates if the value was pulled from Session Information (captured during application runtime) or from certain types of blocks that were encountered, such as Routing or Business Controls.
You can click the arrows in the column headers to sort the items alphabetically.
During an application session, Designer adds certain internal system variables at various stages. These internal variables are recorded in Designer Analytics at the end of the application, along with other system and user-defined variables. Thus, it is possible to see new variables in Analytics that are not listed in the Initialize phase block. Although these variables may appear in variable or call data objects in Session Detail Records (SDR), they are intended only for internal use by Designer and should not be used in blocks for driving application logic. These variables can change or be removed at any time, so attempting to use them in applications can affect application resiliency and cause unexpected behavior. This type of usage is not supported or recommended. If your business operations require new functionality, contact your Genesys representative.
List of Session Detail Record fields
Field | Description | Category | Set by |
---|---|---|---|
ANI | The Automatic Number Identification is the customer's phone number (or Caller ID). | Call Information | Designer |
DNIS | The Dialed Number Identification Service is the phone number that the customer dialed. | Call Information | Designer |
applicationName | The name of the application, as provided by the application Developer when creating a new application. | Application Settings | Developer |
applicationID | The unique internal ID that Designer assigned to the application.
Tip You can quickly view an application ID by mousing over the application link on the Applications page and checking the target URL that appears in the browser window.
. |
Application Settings | Designer |
ApplicationType | The application type, as selected by the application developer when the application was created (see creating a new application). The values are as follows:
|
Application Settings | Developer |
applicationVersion | Optional custom version of the application to use for reporting purposes, as specified by the application developer on the General tab in the application settings. | Application Settings | Developer |
ApplicationReportingTitle | Optional custom title of the application for reporting purposes, as specified by the application developer on the General tab in the application settings. | Application Settings | Developer |
SessionID | The unique internal ID that Designer assigned to the session. | Session Information | Designer |
InteractionID | The unique internal ID that Designer assigned to the interaction. | Session Information | Designer |
InteractionCategory | The channel type that was used for the interaction. For example: voice, chat, or email. | Session Information | Designer |
ConnectionID | The connection ID that Designer assigned to the interaction. For example: 016202fe11099003 | Session Information | Designer |
finalDisposition | Disposition code indicating the status of the interaction at the time it exited the application flow. For example, this value can indicate if the interaction was routed to an agent or the customer disconnected from the call. Disposition codes can be enabled in the Finalize phase. For more information, see disposition codes. | Session Information | Designer |
LanguageName | The language that was set for the application at the time when the interaction ended.
Tip Note that Change Language Block blocks can be used to change the language at select points in an application flow. This value always reflects the last language that was set for the application when the interaction ended. |
Session Information | Developer |
@endtime | Timestamp to indicate when the interaction ended. Example: 2017-03-08T01:56:26.085Z | Session Information | Designer |
@timestamp | Timestamp to indicate when the interaction started. Example: 2017-03-08T01:56:12.037Z | Session Information | Designer |
duration | Duration of the total session, in milliseconds (ms).
Tip To calculate the duration of blocks execution and exclude session wrap-up time, subtract the value of the operationalOverheadDurationz field from this value. |
Session Information | Designer |
operationalOverheadDuration |
Total amount of time, in milliseconds (ms), that the application was in an idle state. Typically, this state occurs just before the session enters the Finalize phase. | Session Information | Designer |
ssduration | Amount of time (in milliseconds) that the customer spent in the Self Service phase of the application. | Session Information | Designer |
ssstart | Timestamp to indicate when the Self Service phase of the application started. | Session Information | Designer |
ssend | Timestamp to indicate when the Self Service phase of the interaction ended. | Session Information | Designer |
asduration | Length of time (in milliseconds) that the customer spent in the Assisted Service phase. | Session Information | Designer |
asstart | Timestamp to indicate when the interaction entered the Assisted Service phase. Example: 2017-03-08T01:56:20.933Z | Session Information | Designer |
asend | Timestamp to indicate when the Assisted Service of the interaction ended. | Session Information | Designer |
variables | List of all user and system variables that contain values. | Session Information | Designer |
survey | List of survey-related variables. For more information, see the survey_* variables listed in system variables and the Setup Survey Block page. | Session Information | Designer |
calldata | List of all call data Key-Value Pairs (KVPs) encountered by the application. For more information, see the Call Data block page. | Session Information | Designer |
callAbandonedBlock | If the customer leaves the session (for example, hangs up), this field contains the ID of the block that was being processed when they left. | Session Information | Designer |
callEndState | Indicates if the call ended in the Assisted Service or Self Service phase. | Session Information | Designer |
callEndParty | Indicates the party that ended the call, i.e. Application, Caller, or System. | Session Information | Designer |
callEndReason | Indicates the reason that the call ended. For example, it might have been routed to an agent, abandoned, triggered a Business Controls condition, such as an emergency flag, business hours, or special day exception, or the caller selected a menu option that ended the call. | Session Information | Designer |
callEndType | Indicates the conditions under which the call was ended, i.e. Normal or Error. | Session Information | Designer |
dtmfpath | The menu path (via the pressing of DTMF keys) that the customer took through the application. | Session Information | Designer |
menucount | The number of Menu blocks the customer encountered during the session. | Session Information | Designer |
inputcount | Total number of User Input blocks the customer encountered during the session. | Session Information | Designer |
blockpath | An ordered list of the names of all blocks that were encountered throughout the course of the interaction. | Session Information | Designer |
blockidpath | An ordered list of IDs for all blocks that were encountered throughout the interaction. For more information about block IDs, see Using the blocks. | Session Information | Designer |
blocks* | List of detailed information about the individual blocks that were encountered, such as:
|
Session Information | Designer |
inputs* | List of detailed information about the various User Input blocks that were encountered, such as:
|
Session Information | Designer |
externalrequests* | List containing detailed information about External Services Blocks that were encountered. | Session Information | Designer |
milestones |
List containing the system milestones that were encountered. Milestones indicate special points or transitions in the application, such as phases starting, phases ending, or an application terminating. | Session Information | Designer and Developer |
usermilestonecount | Number of user-defined milestones that were hit. These are milestones that were defined in Milestone blocks or set in other blocks, such as Menu. | Session Information | Designer |
userMilestones* | Milestones that were defined in Milestone blocks or set in other blocks, such as Menu. | Session Information | Designer and Developer |
userMilestonesPath | Names of all milestones that were encountered by the application during the session. | Session Information | Designer |
FinalUserMilestone | The last user-defined milestone that was encountered during the application session (if the value of usermilestonecount is greater than 0). | Session Information | Designer |
LastMilestone | The most recent milestone that was encountered during the session. | Session Information | Designer |
activities* | List of activities that were encountered during the session. Activities are defined in an Activity or automatically captured when an interaction enters or exits a Shared Module. | Session Information | Developer |
activitycount | Total number of activities that were encountered during the session. Activities are defined in an Activity block or automatically captured when an interaction enters or exits a Shared Module. | Session Information | Designer |
utcstart | Starting time of the interaction in Universal Coordinated Time (UTC). Example: 1454643744261 | Session Information | Designer |
SessionType | The type of session. Example: inbound | Session Information | Designer |
CountryName | Name of the country. | Session Information | Designer |
Region | Name of the region. | Session Information | Designer |
childIxns* | This field only applies to Digital type applications and contains a list of details about new child interactions that were created by the session. The details include information about the block that initiated the child interactions (i.e. blockid, blockname, and blocktype). It can also indicate if the child interaction was created by a busy treatment (isTreatment: Y). | Session Information | Designer |
attributeslist | Object with each key-value pair (KVP) appearing as a property that is set to the KVP value. (See also: setAttributes) | Generic Attributes | Designer |
businesshourserrcount | Number of times a Business Hours was accessed during the interaction. | Business Controls | Designer |
businesshoursextcount | Total number of external Business Hours checks that occurred within a session, if you are controlling Business Hours from a web service (for example, via an HTTP Rest block.) | Business Controls | Designer |
businesshoursreqcount | Total number of requests for Business Hours checks that occurred within a session. | Business Controls | Designer |
emergencieserrcount | Total number of Emergency Flags checks within a session. | Business Controls | Designer |
emergenciesextcount | Total number of external Emergency Flags checks within a session, if you are controlling emergency modes from a web service (for example, via an HTTP Rest block.) | Business Controls | Designer |
specialdayserrcount | Total number of Special Days checked within a session. All checks in a single Special Day block count as one check. | Business Controls | Designer |
specialdaysextcount | Total number of Special Days checked externally within a session, if you are controlling these from a web service (for example, via an HTTP Rest block). All checks in a single Special Day block count as one check. | Business Controls | Designer |
specialdaysreqcount | Total number of exceptions that were encountered when the application was performing Special Day checks. All errors encountered in a single Special Day block count as one check. | Business Controls | Designer |
routingAttempts | Each routing attempt is captured as an entry in the array. Some of the properties captured in each routing attempt include:
|
Routing | Designer |
routingBlockCount | Number of Routing blocks that were encountered within a session. | Routing | Designer |
routingBlockTimeoutCount | Number of times that routing blocks timed out.
Tip A high number here can indicate that customers are waiting too long in the queue for some reason. For example, skill levels might be set too high or there are not enough agents available. |
Routing | Designer |
routingCallHandlingType | Indicates the type of routing used for the call. For example: default or consult | Routing | Designer |
routingLCAAttempted | Indicates if Last Called Agent routing was attempted. This option can be enabled on the Agent Routing tab of the Route Agent block. | Routing | Designer |
routingSkillRelaxationCount | Number of Routing blocks that used skill relaxation as a routing option. The required skill level is gradually reduced until a specified minimum skill level is reached, which allows you to expand the group of agents that can receive this call if other agents are busy. | Routing | Designer |