IWD Business Solution Configuration
Business Structure
Levels of a Business Structure for a Tenant:
Filters and Constraints
Configuration Server respects tenancy permission settings. You can access only those objects that you have been granted permissions and privileges to access.
You can filter the contents of this list in two ways:
- Type the name or partial name of an object in the Quick Filter field.
- Click the cube icon to open the Tenant Directory filter panel. In this panel, click the Tenant that you want to select. Use the Quick Filter field in this panel to filter the Tenant list.
You can sort the items in the list by clicking the Name column. Clicking a second time reverses the sort order. You can add or remove columns by clicking Select Columns.
To select or de-select multiple objects at once, click Select.
Data Fields
Each entry is shown with the following data fields:
- Name—The element's name.
- Type—Solution, Department or Process
- ID—The runtime ID of this element.
- Contact Name—Contact name for queries about this element.
- Description—Free-format text description of the element.
To create a new Solution
To create a new Solution, do one of the following:
- If one or more Solution is already present, select one Solution and click More, then click Clone, then edit the Solution data fields.
- If one or more Solution is already present, Display the details of an existing Solution and click Clone, then edit the new Solution data fields.
- If no Solution is present, click the the New button (+), choose Solution, then edit the Solution data fields.
Other Actions
From this context you can Delete this Solution.
2. if you delete a Solution, all related rules packages in GRS will be lost, and you and will not be able to recreate new rules packages with the same name.
Solution Details
- Solution Name—The Solution name. Mandatory when you add a new Solution.
- ID—The ID of the Solution. Mandatory when you add a new Solution. The system will propose a default new Runtime ID.
- Timezone—Solution timezone. Use the drop-down list to change this.
- First Day of Week—The first day of the working week for this Solution. Use the drop-down list to change this.
- Description—Free-format text description of the Solution.
The following options allow customization of interaction queues used by iWD in the current Solution. Non-standard queue names must be defined when there are multiple iWD business processes configured in the same Tenant. Queue names can be selected from drop-down lists. If a value is missing, a default name is displayed for this queue.
- Queue for new tasks—Interaction queue recognized by iWD as an entry to the business process in this solution. Default values:
- IRD—iWD_New
- Composer—iwd_bp_comp.Main.iWD_New
- Queue for captured tasks—Interaction queue for tasks successfully processed by the Classification strategy. Default values:
- IRD—iWD_Captured.
- Composer—iwd_bp_comp.Main.iWD_Captured
- Queue for queued tasks—Interaction queue for tasks successfully processed by the Prioritization strategy. Default vlaues:
- IRD—iWD_Queued
- Composer—iwd_bp_comp.Main.iWD_Queued
- Queue for completed tasks—Interaction queue for tasks marked as completed by agents. Default values:
- IRD—iWD_Completed
- Composer—iwd_bp_comp.Main.iWD_Completed
- Queue for rejected tasks—Interaction queue for tasks rejected by the Classification strategy. Default values:
- IRD—iWD_Rejected
- Composer—iwd_bp_comp.Main.iWD_Rejected
- Queue for canceled tasks—Interaction queue for tasks canceled by a Global Task List user or by a capture point. Default values:
- IRD—iWD_Canceled
- Composer—iwd_bp_comp.Main.iWD_Canceled
- Queue for error-held tasks—Interaction queue for tasks that failed to be processed by the Classification or Prioritization strategies. Default values:
- IRD—iWD_ErrorHeld
- Composer—iwd_bp_comp.Main.iWD_ErrorHeld
Interaction Server Settings
- Interaction Server—The Interaction Server for this Solution. Use the drop-down list to change this. This drop-down list contains those Interaction Servers which contain the Solution's parent Tenant on their Tenants list.
- Port—The connection port of the Interaction Server. Use the drop-down list to change this. This drop-down list contains the Interaction Server chosen above ports from the ports list.
Every configuration object or parameter that references the Port ID (and therefore can be either secure or non-secure) will work in the same way—the setting of the one configured second (where two Solutions are configured) is the one that the Interaction Server will use. This affects connection protocol, local timeout, remote timeout, trace mode and transport protocol parameters.
- Connection Protocol—The connection protocol of the Interaction Server. Use the drop-down list to change this. This parameter is set as the connection attribute of the Interaction Server connection in the iWD Manager application.
- Protocol Timeout—The timeout configured for the connection protocol.
- Local Timeout—The timeout configured on the local server. This parameter is set as the connection attribute of the Interaction Server connection in the iWD Manager application.
- Event Buffer Size—The maximum size in bytes of the event buffer.
- Remote Timeout—The timeout configured on the remote server. This parameter is set as the connection attribute of the Interaction Server connection in the iWD Manager application.
- Threads—The number of threads available.
- EventLog JDBC URL—The URL of the JDBC event log. Mandatory for all database engines set in the Eventlog DAP (connected to Interaction Server set above), apart from MSSQL.
- Attribute Filter Include—Attributes included here will appear in the Custom Attributes displayed in the Global Task List in iWD Manager.
- Attribute Filter Exclude—Attributes excluded here will not appear in the Custom Attributes displayed in the Global Task List in iWD Manager.
Permissions Settings (new in 8.5.105)
Business Structure details include a Permissions tab on which users with the relevant permissions can view and edit permissions settings for all users of the selected node.
Permissions Table
Permission | Description |
---|---|
Read | Permission to read information and receive updates about the object. |
Create | Permission to create objects in this folder. |
Change | Permission to change the properties of the object. The Change permission is the
same as allowing “Write” access. |
Execute | Permission to perform a predefined action or set of actions with respect to the object. |
Delete | Permission to delete the object. |
Read Permissions | Permission to read the access control settings for the object. |
Change Permissions | Permission to change the access control settings for the object. |
Execute |
Permission to perform a predefined action or set of actions with respect to this object. |
Propagate | For container objects (such as Tenants). The Propagate check box controls whether to propagate this set of elementary permissions to the child objects. By default, the check box is selected). |
Actions
- Add Access Group—Displays the Select Access Group panel from which you can select one of the available Access Groups to add to this node and for whom you can then configure permissions.
- Add Person—Displays the Select Person panel from which you can select one of the available Persons to add to this node and for whom you can then configure permissions.
- Replace Recursively—Enables you, upon confirmation, to remove permissions for all child objects of this container and replace them with the permissions defined in this container.
To create a new Department
To create a new Department, first choose the Solution to work with, then do do one of the following:
- If one or more Department is already present, select one Department and click More, then click Clone, then edit the Department data fields.
- If one or more Department is already present, display the details of an existing Department and click Clone, then edit the new Department data fields.
- If no Department is present, click the the New button (+), choose Department, then edit the Department data fields.
Other Actions
From here you can Clone, Delete or Move this Department. You can move the Department only to a Solution. Any Processes configured under it will also be moved. Runtime IDs are not moved in the Move function—you must create a new one for the Department and all its child Processes in its new Solution.
2. If you delete a Department or Process, any rules assigned to those objects will be inactivated and moved to the Solution level. This happens if you delete and re-create a Solution/Department/Process with the same name.
Department Details
- Department Name—The department name. Mandatory when you add a new Department.
- ID—The department's Runtime ID. Mandatory when you add a new Department. The system will propose a default new Runtime ID.
- Contact Name—The contact name for the department, for informational purposes.
- Contact Email—The contact email for the department, for informational purposes.
- Contact Phone—The contact phone number for the department, for informational purposes.
- Start Date—The date on which the department becomes active. If left empty, the period start date is unconstrained.
- End Date—The last day that the department is active. If left empty, the period end date is unconstrained (that is, the department will be active infinitely).
- Description—Free-format text description of the Department.
Department Attributes
Click Add to create new attributes.
- Name—The attribute name
- Type—Select from the drop-down list. Valid values are:
- Text
- Percentage
- Number
- Date
- Lookup Table
- Value—The attribute value. If the type is a lookup table, then the value is set from the drop-down list.
- Description—Free-format text description of the attribute.
Department Metrics
Click Add to create a set of user-defined metrics, for reporting purposes.
[+] MORE- Name—The metric name
- Type—Select from the drop-down list. Valid values are:
- Text
- Percentage
- Number
- Date
- Lookup Table
- Value—The attribute value. If the type is a lookup table, then the value is set from the drop-down list.
- Description—Free-format text description of the attribute.
Permissions Settings (new in 8.5.105)
Business Structure details include a Permissions tab on which users with the relevant permissions can view and edit permissions settings for all users of the selected node.
Permissions Table
Permission | Description |
---|---|
Read | Permission to read information and receive updates about the object. |
Create | Permission to create objects in this folder. |
Change | Permission to change the properties of the object. The Change permission is the
same as allowing “Write” access. |
Execute | Permission to perform a predefined action or set of actions with respect to the object. |
Delete | Permission to delete the object. |
Read Permissions | Permission to read the access control settings for the object. |
Change Permissions | Permission to change the access control settings for the object. |
Execute |
Permission to perform a predefined action or set of actions with respect to this object. |
Propagate | For container objects (such as Tenants). The Propagate check box controls whether to propagate this set of elementary permissions to the child objects. By default, the check box is selected). |
Actions
- Add Access Group—Displays the Select Access Group panel from which you can select one of the available Access Groups to add to this node and for whom you can then configure permissions.
- Add Person—Displays the Select Person panel from which you can select one of the available Persons to add to this node and for whom you can then configure permissions.
- Replace Recursively—Enables you, upon confirmation, to remove permissions for all child objects of this container and replace them with the permissions defined in this container.
To create a new Process
To create a new Process, first choose the Solution and Department to work with, then do one of the following:
- If one or more Process is already present, select one Process and click More, then click Clone, then edit the Process data fields.
- If one or more Process is already present, display the details of an existing Process and click Clone, then edit the new Process data fields.
- If no Process is present, click the the New button (+), choose Process, then edit the Process data fields.
Other Actions
From here you can Clone, Delete or Move this Process. You can move the Process only to a Department. Runtime IDs are not moved in the Move function—you must create a new one for the Process in its new Department.
2. If you delete a Department or Process, any rules assigned to those objects will be inactivated and moved to the Solution level. This happens if you delete and re-create a Solution/Department/Process with the same name.
Process Details
- Process Name—The Process name. Mandatory when you add a new Process.
- ID—The Runtime ID of the Process. Mandatory when you add a new Process. The system will propose a default new Runtime ID.
- Contact Name—The contact name for the process, for informational purposes.
- Contact Email—The contact email for the process, for informational purposes.
- Contact Phone—The contact phone number for the process, for informational purposes.
- Start Date—The date the process becomes active. The start date of the process cannot be earlier than the start date of the parent department.
- End Date—The last day that the process is active. If left empty, the period end date inherits the end date value of the parent department.
- Description—Free-format text description of the Process.
Process Attributes
Click Add to create new attributes.
- Name—The attribute name
- Type—Select from the drop-down list. Valid values are:
- Text
- Percentage
- Number
- Date
- Lookup Table
- Value—The attribute value. If the type is a lookup table, then the value is set from the drop-down list.
- Description—Free-format text description of the attribute.
Process Metrics
Click Add to create new metrics.
[+] MORE- Name—The attribute name
- Type—Select from the drop-down list. Valid values are:
- Text
- Percentage
- Number
- Date
- Lookup Table
- Value—The attribute value.
- Description—Free-format text description of the attribute.
Permissions Settings (new in 8.5.105)
Business Structure details include a Permissions tab on which users with the relevant permissions can view and edit permissions settings for all users of the selected node.
Permissions Table
Permission | Description |
---|---|
Read | Permission to read information and receive updates about the object. |
Create | Permission to create objects in this folder. |
Change | Permission to change the properties of the object. The Change permission is the
same as allowing “Write” access. |
Execute | Permission to perform a predefined action or set of actions with respect to the object. |
Delete | Permission to delete the object. |
Read Permissions | Permission to read the access control settings for the object. |
Change Permissions | Permission to change the access control settings for the object. |
Execute |
Permission to perform a predefined action or set of actions with respect to this object. |
Propagate | For container objects (such as Tenants). The Propagate check box controls whether to propagate this set of elementary permissions to the child objects. By default, the check box is selected). |
Actions
- Add Access Group—Displays the Select Access Group panel from which you can select one of the available Access Groups to add to this node and for whom you can then configure permissions.
- Add Person—Displays the Select Person panel from which you can select one of the available Persons to add to this node and for whom you can then configure permissions.
- Replace Recursively—Enables you, upon confirmation, to remove permissions for all child objects of this container and replace them with the permissions defined in this container.
Data Mart
Filters and Constraints
Configuration Server respects tenancy permission settings. You can access only those objects that you have been granted permissions and privileges to access.
You can filter the contents of this list in two ways:
- Type the name or partial name of an object in the Quick Filter field.
- Click the cube icon to open the Tenant Directory filter panel. In this panel, click the Tenant that you want to select. Use the Quick Filter field in this panel to filter the Tenant list.
You can sort the items in the list by clicking a column head. Clicking a column head a second time reverses the sort order. You can add or remove columns by clicking Select Columns.
To select or de-select multiple objects at once, click Select.
Data Fields
Each entry is shown with the following data fields:
- Name—Name of the solution hosting iWD Data Mart.
- Application—Name of the iWD Runtime Node application attached to the selected Solution. There is a one-to-one relationship between Solutions requiring Data Mart and iWD Runtime Node applications. The iWD Runtime Node can be detached from the Solution by selecting a blank name in this field.
- Host—Host where the iWD Runtime Node is installed. Selectable from the list of hosts configured in GAX Configuration Manager.
- Port—Port assigned to iWD Runtime Node. Numeric field; the value must be between 1 and 65535 inclusive. The port must be unique within the host.
- ETL Scripts Directory—The directory on the server in which iWD Data Mart ETL scripts are stored. For example, the default path used when iWD Data Mart is installed is C:\Program Files\GCTI\iWD Data Mart\etl.
- From release 8.5.102—Configuration Server's Database Access Point—The name of the Database Access Point associated with Configuration Server. Required for Data Mart's Load Config job.
- Number of Threads—Performance tuning: the size of the thread pool.
- Ignored Dimensions—Performance tuning: the list of dimensions that will be ignored by the Load Intraday job. One dimension per line.
- Default Dimension Key—Performance tuning: the default value which will be used for ignored dimensions' keys.
- From release 8.5.105—Clear Dimension Cache—Enables or disables persistence of the dimension's cache between Load Intraday job runs. With value true, the dimension's cache is cleared when the Load Intraday job completes. With value false (default), the cache persists between Load Intraday job runs. Requires restart of the IWD Runtime Node to take effect.
The Logging tab configures internal logging capabilities within the iWD Runtime Node.
- Log Level—The Service log level. This should be set to Info unless otherwise instructed by Genesys Technical Support. The possible log levels are:
- Debug—The most detailed informational events that are most useful in debugging an application.
- Info—Informational messages that highlight the progress of the application.
- Warning—Potentially harmful situations.
- Error—Error events that might not affect the application’s ability to run.
- Trace—Turns on all logging.
- Off—Turns off all logging.
- Log Directory—The directory in which the log files will be stored, for all services. If it starts with / (on Unix-based operating systems) or a drive letter (on Windows), an absolute path will be used; otherwise, the path is relative from the iWD Runtime Node installation directory.
- Note: It is strongly recommended that you only set the file path to a directory on a local machine, not a remote location such as a shared network drive. Logging to a remote location can severely impact performance.
- Log Age—Sets the number of days that log files should be kept in the system. A value of 0 disables this limit.
- Log Size—Sets a limit on the size of a single log file, in megabytes. A value of 0 disables this limit.
- Log Files—Sets a limit on the number of log files that are kept for this service, excluding the current log file. A value of 0 disables this limit.
The Database tab defines a connection to a Data Mart database server. The configured database and user must exist in the database server. The user must have read/write permissions to the database.
- Application—The name of the Database Access Point application associated with Data Mart instance.
- Database—The name of the database. This is available only for MS SQL Server.
- SID—Oracle System ID of the database. The Oracle System ID (SID) is used to uniquely identify a particular database on a system. This is available only for Oracle database.
- Server—The database server. Selectable from list of configured hosts.
- Port—The TCP port number of the database server.
- User Name —The database user name.
- Password—The password for the database.
- Auto-Sync—The iWD Data Mart database will be initialized automatically the first time the Database Service and Kettle ETL Service are started. If the Auto-Sync option is selected, this initialization is automatic, and the Database Service will also check for updates to the iWD Data Mart database whenever a new version of iWD Data Mart is installed. The Auto-Sync option will also initialize ETL plug-ins.
- Custom URL (for Data Mart)—Add a specific custom URL here to override any default value for the Data Mart database used by iWD Data Mart.
- Custom URL (for iWD SSJE)—Add a specific custom URL here to override any default value for the Data Mart database used by BPR iWD StatServer extensions.
The Stat Server tab configures Statistics Adapter job and defines connection to Genesys Stat Server. Statistics Adapter processes the statistical data created by the Aggregate Stats ETL job and writes stat-types and filters in the configuration for Genesys Stat Server. CCPulse+ requests iWD statistics from Stat Server, and reads the stat-types and filters from the Stat Server configuration.
- '''[stat-server]/name'''—<StatServer_1>;<StatServer_2>;...;<StatServer_N>
- Application—The Stat Server's application name. Selectable from list of installed Stat Server applications. Each Data Mart requires separate Stat Server instance.
- Dimension Mapping—Defines how statistical dimensions are mapped.
- Filter—Dimensions are mapped to CCPulse+ filters.
- Virtual Queue—Dimensions are mapped to Genesys virtual queues.
- Virtual Queue Name—Name of the Genesys virtual queue to which statistics are distributed. Applicable only if Dimension Mapping is set to Virtual Queue.
- Service Index—Statistical service index for configuration options. This should be unique inside the set of indexes, assigned to statistical services served by the one instance of Genesys Stat Server.
- Extension File Name—Required to support a Genesys reporting environment with multiple instances of Stat Server Java Extensions. This is the name of the Stat Server Java extension jar file (BPR_iWD_Extension.jar). This file is saved to the Stat Server installation directory during installation of the iWD Stat Extensions. You can find the location of this file in Stat Server configuration options as the value of the java-libraries-dir option in the java-config section.
- Extension Section Name—Required to support a Genesys reporting environment with multiple instances of Stat Server Java Extensions. This property maps to the section name for the specific Stat Server Java Extension in the Stat Server configuration.
The Schedules tab configures execution schedule of three Data Mart job groups. The syntax follow standard CRON scheduling expression. For example, the following expression will cause the job to be executed every 15 minutes:
0 0,15,30,45 * * * ?
For more information about CRON scheduling, see [http://www.quartz-scheduler.org/documentation/quartz-2.1.x/tutorials/crontrigger Quartz Scheduler documentation]
- Intraday—The schedule for the Intraday job group: Load Config, Load Intraday, Aggregate Intraday, Aggregate Stats and Statistic Adapter. Typically scheduled to run every 15 minutes.
- Historical—The schedule for the Historical job group: Load Historical, Aggregate Historical and Maintain. Typically scheduled to run once a day, after midnight.
- Prune—The schedule for Prune job. Typically scheduled to run once a day, after Historical group.
The Expirations tab configures the Maintain job, which deletes expired facts from Data Mart tables.
- Record Details—The number of days after which the detailed task (task_fact, task_event_fact, and task_work_fact) data will be removed from the database.
- Aggregation 15 min—The number of days after which the data will be removed from 15-minute aggregation tables.
The Tenant Attributes tab enables selection of up to 5 of a tenant's custom attributes, that will be loaded into the CUSTOM_DIM dimension and associated to the tenant via the CUSTOM_DIM_KEY field.
- Custom Attribute 1-5—User-configured custom Tenant attributes, selectable from the list of Custom Attributes attached to the Tenant.
The Department Attributes tab allows selection of up to 5 of a departments's custom attributes that will be loaded into the CUSTOM_DIM dimension and associated to the departments via the CUSTOM_DIM_KEY field.
- Custom Attribute 1-5—User-configured custom Department attributes, selectable from the list of Custom Attributes attached to any Department within the Solution.
The Process Attributes tab allows selection of up to 5 of a process' custom attributes, that will be loaded into the CUSTOM_DIM dimension and associated to the processes via the CUSTOM_DIM_KEY field.
- Custom Attribute 1-5—User-configured custom Process attributes, selectable from the list of Custom Attributes attached to any Process within the Solution.
The Task Attributes tab defines up to 10 names of a task's custom attributes that will be loaded into the task_fact custom attribute fields (CUSTOM_ATTRIBUTE 1-10). Names must start with a letter, and only underscores and alphanumeric characters are supported.
In order for Kettle to pick them up, it is necessary to create fields in the Event Log Database. In the rpt_interaction and rpt_esp tables, add the fields in the following format:
*: Name: <attribute_name>, type: varchar(length).
These fields should be added to the mappings in the Event Log DAP options in the esp-custom-data and itx-custom-data sections.
For example, in order to store a custom attribute with the name order_total in the iWD Data Mart, as a task custom attribute:
- Create a new column in the rpt_interaction table: order_total, type: varchar(50)
- Create a new column in the rpt_esp table: order_total, type: varchar(50)
- Create a new option in the esp-custom-data section of the Event Log DAP options: order_total=order_total
- Create a new entry option in the itx-custom-data section of the Event Log DAP options: order_total=order_total
- Add order_total to the Task Attributes list in iWD GAX Plugin.
The Dimension Mapping tab defines up to 5 comma-separated names of a task's custom attributes that will be loaded into the CUSTOM_DIM dimension and associated to the task via the CUSTOM_DIM_KEY field. Names must start with a letter, and only underscores and alphanumeric characters are supported.
In order for Kettle to pick them up, it is necessary to create fields in the Event Log Database. In the rpt_interaction and rpt_esp tables, add the fields in the following format:
*: Name: <attribute_name>, type: varchar(length).
These fields should be added to the mappings in the Event Log DAP options in the esp-custom-data and itx-custom-data sections.
For example, in order to store a custom attribute with the name order_total in the iWD Data Mart, as a task custom attribute:
- Create a new column in the rpt_interaction table: order_total, type: varchar(50)
- Create a new column in the rpt_esp table: order_total, type: varchar(50)
- Create a new option in the esp-custom-data section of the Event Log DAP options: order_total=order_total
- Create a new entry option in the itx-custom-data section of the Event Log DAP options: order_total=order_total
- Add order_total to Dimension Mapping list in iWD GAX Plugin.
Lookup Tables
Lookup Tables
[+] MORE
Filters and Constraints
Configuration Server respects tenancy permission settings. You can access only those objects that you have been granted permissions and privileges to access.
You can filter the contents of this list in two ways:
- Type the name or partial name of an object in the Quick Filter field.
- Click the cube icon to open the Tenant Directory filter panel. In this panel, click the Tenant that you want to select. Use the Quick Filter field in this panel to filter the Tenant list.
You can sort the items in the list by clicking a column head. Clicking a column head a second time reverses the sort order. You can add or remove columns by clicking Select Columns.
To select or de-select multiple objects at once, click Select.
Data Fields
Each entry is shown with the following data fields:
- Name—The element's name.
To add a new Lookup Table
Either:
- From the List view, click New and complete the Lookup Table's details.
- Display the details of a Lookup Table and click Clone, then edit the details.
To add a new key/label pair to a Lookup Table
Display the Lookup Table by selecting it, then click Add and complete the new details.
Other Actions
From this context you can Delete or Move this Lookup Table. You can move the Lookup Table only to another Tenant. Runtime IDs are not moved in the Move function—you must create a new one for theLookup Table in its new Tenant.
Distribution Points and Lookup Tables
Distribution Points are attributes that can be assigned to tasks in business rules, and there is still a Distribution Point dimension for this purpose in the iWD Data Mart schema.
Distribution Points must be configured as Lookup Tables at the Tenant level. The following procedure describes the steps that are used to configure Distribution Points as Lookup Tables.
Configuring Distribution Points as Lookup Tables
- In iWD GAX Plugin, configure a new Lookup Table for your tenant. The name of the Lookup Table must be distributionPoints.
- The distributionPoints lookup table must be configured under the iWD managed tenant in which the rule action to assign the distribution point to a task is defined.
- Start using the rule action Assign distribution point in your business rules.
There is a rule action in the iWD Standard Rule Template called Assign distribution point that uses a rule parameter configured to read the values from the distributionPoints Lookup Table. This rule action can be used in a business rule.