Revision as of 15:13, June 4, 2013 by Jokane (talk | contribs) (→‎Bulk Changes)
Jump to: navigation, search

Genesys Administrator Extension enables you to perform bulk changes to users. For example, you can create a Bulk Change Set to add or remove multiple users from your system in one action, or to add or remove multiple skills, or both.

The Bulk Change Sets panel lists all the Bulk Change Sets in your environment that either have not been executed yet or have failed during execution. To see a list of successful Bulk Change Sets, see the Completed Bulk Changes panel.

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.
  • You can sort the items in the list by clicking a column head. Clicking a column head a second time reverses the sort order.

List Information

The Bulk Change Sets list displays the following information:

  • Change Set Name—The name of the Bulk Change Set.
  • Creator—The name of the user that created the Bulk Change Set.
  • Creation Date—The date on which the Bulk Change Set was created.
  • Last Modified Date—The date on which the Bulk Change Set was last modified.
  • Change Set Status—This can be one of the following:
    • Empty—No data has yet been entered in the Bulk Change Set.
    • Incomplete—Only partial data has been entered in the Bulk Change Set.
    • Ready to Execute—The Bulk Change Set is ready to be executed.
  • Execution—This can be one of the following:
    • Not Executed—The Bulk Change Set has not been executed yet.
    • Completed—The Bulk Change Set has been executed.
    • Failed—The execution of the Bulk Change Set failed.
  • Progress—During execution, this field displays a progress bar for the Bulk Change Set.
  • Executed by Tenant—Indicates which tenant last executed the Bulk Change Set.
  • Executed by User—Indicates which user last executed the Bulk Change Set.
  • Previously Executed Date—Indicates the date and time at which the Bulk Change Set was last executed.

Click a Bulk Change Set in the list to view more information about the item. The following fields are displayed:

  • Change Set Name—The name of the Bulk Change Set
  • Deletions—The objects that will be deleted by the Bulk Change Set
  • Additions—The objects that will be added by the Bulk Change Set
  • Updates—The objects that will be updated by the Bulk Change Set

Creating Bulk Change Sets

Creating Bulk Change Sets

To create a Bulk Change Set, perform the following steps:

  1. In the header, go to Operations > System > Bulk Change Sets.
  2. In the Bulk Change Sets panel, click the New button.
  3. Enter information in the following fields:
    • Change Set Name—The name of the Bulk Change Set.

      • Information.png Note: This field must be unique in the environment.

    • Deletions—Enter any object that is to be deleted with the Bulk Change Set. If there are deletions, perform the following actions. Otherwise, move on to the next step.
      1. Click the Add button. The New Deletion Item panel appears to the right.
      2. Click the Browse button. A list of objects appears to the right.
      3. Objects that appear in the list are determined by the currently selected category. Click the drop-down menu at the top of the panel to change the category type.
      4. You can use the Quick Filter field to find specific objects. Click the check box beside an object to add the object to the Deletions list.
      5. The name of the object appears in the New Deletion Item panel. Click the OK button to add it to the Deletions list.
      6. Repeat the steps in this list to add more objects to the Deletions list.
    • Additions—Enter any object that is to be added with the Bulk Change Set. If there are additions, perform the following actions. Otherwise, move on to the next step.
      1. Click the Add button. A new panel appears to the right.
      2. Click the Browse button. A list of objects appears to the right.
      3. Select an object type in the Type drop-down menu.
      4. Click the Browse button to select an object to use as a template. A panel opens to the right. Click the checkbox beside an object to select it.

        5. Information.png Note: When an object is used as a template, all aspects of the template object are used for the Addition objects, including connections and permissions.

      5. Click the Next button.
      6. In the Number to Create field, enter the number of objects to create with the template. The value must be an integer between 1 and 100
      7. In the CSV File field, perform the following actions:
        • Click the Choose File button to select a CSV file from which to acquire the new data.
        • In the window that opens, navigate to the location in which the CSV file is stored. Select the CSV file to use.

          • Information.png Note: The following is an example of an acceptable format for contents that are stored in the CSV file:
          employeeid, folderid, tenantdbid, state, lastname, firstname, password, username, skilllevels
          bulkuser1,105,1, CFGEnabled, Tamblyn, Ericm, password, bulkuser1, "{skilldbid:102, level:10},{skilldbid:106, level:6}"
          bulkuser2,106,2, CFGEnabled, Tamblyn, Ericm, password, bulkuser1, "{skilldbid:102, level:10},{skilldbid:107, level:7}"

        • Click the Open button.
      8. Click the Finish button.
    • Updates—Enter any update that is to be performed on objects with the Bulk Change Set. If there are updates, perform the following actions. Otherwise, move on to the next step.
      1. Click the Add button. The New Update Item panel appears to the right.
      2. Click the Browse button. A list of objects appears to the right.
      3. Objects that appear in the list are determined by the currently selected category. Click the drop-down menu at the top of the panel to change the category type.
      4. You can use the Quick Filter or Tenant Filter field to find specific objects. Click the check box beside an object to add it to the Updates list.
      5. The name of the object appears in the New Update Item panel. Click the OK button to add it to the Update list.
      6. Repeat the steps in this list to add more objects to the Update list.
  4. In the Bulk Change Set creation panel, you can reorder the objects within the Deletions, Additions, or Updates lists.

    5. Information.png Note: Bulk Change Set actions are executed in the following order : Deletions, Additions, and then Updates.

  5. Click the Save button to save the Bulk Change Set.

    6. Information.png Note: This action does not execute the Bulk Change Set. To execute the Bulk Change set, follow the instructions for Executing a Bulk Change Set.

Executing Bulk Change Sets

To execute a Bulk Change Set, perform the following steps:

  1. In the header, go to Operations > System > Bulk Change Sets.
  2. Select a Bulk Change Set in the Bulk Change Sets list. A new panel with more information about the Bulk Change Set opens to the right.
  3. You can choose to validate the Bulk Change Set before execution. Click the Validate button to ensure that the Bulk Change Set is ready to be executed.

    4. Information.png Note: The Validate button is useful in determining whether the Bulk Change Set is ready to be executed or whether it is dependent on other Bulk Change Sets to be executed first. For example: Some Additions depend on other objects to be added. You might want to update several agents with a new skill. However, the skill must be created first, before the agents can be updated. In this scenario, clicking the Validate button will verify that the skill has been created.

  4. Click the Execute button to execute the Bulk Change Set. You can view the status of the Bulk Change Set in the Completed Bulk Changes panel.

Deleting Bulk Change Sets

To delete a Bulk Change Set, perform the following steps:

  1. In the header, go to Operations > System > Bulk Change Sets.
  2. Click the check box beside each Bulk Change Set that is to be deleted.
  3. Click the Delete button.
  4. A dialog box displays to confirm the action:
  • Click the OK button to continue.
  • Click the Cancel button to discard the action.

Keyboard Navigation

The Completed Bulk Changes panel lists the successfully executed bulk changes in your environment.

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.
  • You can sort the items in the list by clicking a column head. Clicking a column head a second time reverses the sort order.

The Completed Bulk Changes list displays the following information:

  • Change Set Name—The name of the Bulk Change Set
  • Creation Date—The date on which the Bulk Change Set was created
  • Executed by Tenant—Indicates which tenant last executed the Bulk Change Set
  • Executed by User—Indicates which user last executed the Bulk Change Set
  • Started—Indicates the date and time at which the execution of the Bulk Change Set was started
  • Ended—Indicates the date and time at which the execution of the Bulk Change Set was completed

To delete records of Bulk Change Sets, click the check box beside each Bulk Change Set that is to be deleted, and then click the Delete button.

Information.png Note: This action does not delete the Bulk Change Set; it deletes the record of the Bulk Change Set.

Click a Bulk Change Set in the list to view more information about the item. The following fields are displayed:

  • Change Set Name—The name of the Bulk Change Set
  • Deletions—The objects that were deleted by the Bulk Change Set
  • Additions—The objects that were added by the Bulk Change Set
  • Updates—The objects that were updated by the Bulk Change Set

Click the Export button to download the solution definition file that was used during execution of the Bulk Change Set.

Click the Delete button to delete the record of the Bulk Change Set.

Information.png Note: This action does not delete the Bulk Change Set; it deletes the record of the Bulk Change Set.




Comments or questions about this documentation? Contact us for support!