Documentation:GA:user:BulkChangeSets:DRAFT

Ensembles de modifications en masse

Genesys Administrator Extension vous permet d’exécuter des modifications en masse sur les utilisateurs. Vous pouvez, par exemple, créer un ensemble de modifications en masse pour ajouter ou supprimer plusieurs utilisateurs de votre système en une seule action, ou ajouter ou supprimer plusieurs compétences, voire exécuter les deux actions en une fois.

À partir de la version 8.5.250, la fonction d’ensembles de modifications en masse n’est pas disponible dans GAX par défaut. En revanche, Genesys conseille d’utiliser les autres fonctionnalités de provisioning en masse pour les objets Utilisateur (personne), y compris les objets Agents et Groupe d’agents. Toutefois, si vous voulez tout de même utiliser des ensembles de modifications en masse, activez-les en réglant enable_bulk_change_sets=true dans la section [general] de l’onglet Options de l’objet Application GAX. Cela apparaîtra dans le menu Administration.

Options d’affichage

Le panneau Ensembles de modifications en masse répertorie tous les ensembles de modifications en masse dans votre environnement qui n’ont pas encore été exécutés ou dont l’exécution a échoué. Pour afficher la liste des ensembles de modifications en masse réussis, voir le panneau Modifications en masse terminées.

La gestion des objets de configuration respecte les paramètres d’autorisation du locataire. Vous ne pouvez accéder qu’aux objets pour lesquels vous avez un droit d’accès.

Vous pouvez filtrer le contenu de cette liste de deux façons :

• Entrez le nom ou une partie du nom d’un objet dans le champ Filtre rapide.
• Cliquez sur Filtre locataires pour ouvrir le panneau Filtre locataires. Dans ce panneau, cochez la case en regard de chaque locataire à sélectionner. Utilisez le champ Filtre rapide de ce panneau pour filtrer la liste des locataires.

Vous pouvez trier les éléments d’une liste en cliquant sur un en-tête de colonne. Pour inverser l’ordre de tri, cliquez une seconde fois sur l’en-tête de la colonne active.

Détails

La liste Ensembles de modifications en masse affiche les informations suivantes :

• Nom de l’ensemble de modifications—Nom de l’ensemble de modifications en masse.
• Créateur—Nom de l’utilisateur qui a créé l’ensemble de modifications en masse.
• Date de création—Date à laquelle l’ensemble de modifications en masse a été créé.
• Date de la dernière modification—Date à laquelle l’ensemble de modifications en masse a été modifié pour la dernière fois.
• État de l’ensemble de modifications—Il peut s’agir de l’une des valeurs suivantes :
  • Vide—Aucune donnée n’a encore été entrée dans l’ensemble de modifications en masse.
  • Incomplet—L’ensemble de modifications en masse ne contient que des données partielles.
  • Prêt à exécuter—L’ensemble de modifications en masse est prêt à être exécuté.
• Exécution —Il peut s’agir de l’une des valeurs suivantes :
  • Non exécuté—L’ensemble de modifications en masse n’a pas encore été exécuté.
  • Terminé—L’ensemble de modifications en masse a été exécuté.
  • Échec—L’exécution de l’ensemble de modifications en masse a échoué.
• Progression—Une barre de progression s’affiche dans ce champ durant l’exécution de l’ensemble de modifications en masse.
• Exécuté par locataire—Indique le dernier locataire ayant exécuté l’ensemble de modifications en masse.
• Exécuté par utilisateur—Indique le dernier utilisateur ayant exécuté l’ensemble de modifications en masse.
• Date d’exécution précédente—Indique la date et l’heure auxquelles l’ensemble de modifications en masse a été exécuté pour la dernière fois.

Cliquez sur un ensemble de modifications en masse dans la liste pour afficher d’autres informations le concernant. Les champs suivants s’affichent :

• Nom de l’ensemble de modifications—Nom de l’ensemble de modifications en masse.
• Suppressions—Objets qui seront supprimés par l’ensemble de modifications en masse.
• Ajouts—Objets qui seront ajoutés par l’ensemble de modifications en masse.
• Mises à jour—Objets qui seront mis à jour par l’ensemble de modifications en masse.

Important

Un fichier de définition de solution est créé lorsqu’un ensemble de modifications en masse est exécuté. Consultez le panneau Modifications en masse terminées pour les instructions de téléchargement du fichier de définition de solution.

Procédures

Vous pouvez exécuter les actions suivantes depuis les panneaux Ensemble de modifications en masse :

Création d’ensembles de modifications en masse

Pour créer un ensemble de modifications en masse, procédez comme suit :

[+] Afficher les étapes

1. Dans le panneau Ensembles de modifications en masse, cliquez sur le bouton +.
2. Entrez les informations appropriées dans les champs suivants :
   • Nom de l’ensemble de modifications—Nom de l’ensemble de modifications en masse.
   Important
   Le champ Nom de l’ensemble de modifications doit être unique au sein de l’environnement.
   • Suppressions—Entrez tout objet de configuration devant être supprimé avec l’ensemble de modifications en masse. S’il y a des suppressions, exécutez les actions suivantes. Sinon, passez à l’étape suivante.
     1. Cliquez sur Ajouter. Le panneau Nouvel élément de suppression s’affiche à droite.
     2. Cliquez sur Parcourir. Une liste d’objets de configuration s’affiche sur la droite.
     3. Les objets qui apparaissent dans la liste sont déterminés par la catégorie actuellement sélectionnée. Cliquez sur le menu déroulant en haut du panneau pour changer le type de catégorie.
     4. Vous pouvez utiliser le champ Filtre rapide ou Filtre locataires pour trouver des objets spécifiques. Cochez la case en regard de l’objet voulu pour l’ajouter à la liste Suppressions.
     5. Le nom de l’objet s’affiche dans le panneau Nouvel élément de suppression. Cliquez sur le bouton OK pour l’ajouter à la liste Suppressions.
     6. Répétez les étapes de la procédure ci-dessus pour ajouter d’autres objets à la liste Suppressions.
   • Ajouts—Entrez tout objet de configuration devant être ajouté avec l’ensemble de modifications en masse. S’il y a des ajouts, exécutez les actions suivantes. Sinon, passez à l’étape suivante.
     1. Cliquez sur Ajouter. Un nouveau panneau s’affiche sur la droite.
     2. Cliquez sur Parcourir. Une liste d’objets de configuration s’affiche sur la droite.
     3. Sélectionnez un type d’objet dans le menu déroulant Type.
     4. Cliquez sur le bouton Parcourir pour sélectionner un objet à utiliser comme modèle. Un panneau s’affiche sur la droite. Cochez la case en regard de l’objet à sélectionner.
     Important
     Lorsqu’un objet est utilisé comme modèle, tous les aspects de l’objet modèle sont utilisés pour les objets Ajout, y compris les connexions et autorisations.
     5. Cliquez sur Suivant.
     6. Dans le champ Entrer le nombre à créer, entrez le nombre d’objets à créer avec le modèle. La valeur doit être un nombre entier compris entre 1 et 100.
     7. Dans le champ Fichier CSV, exécutez les actions suivantes :
        • Cliquez sur le bouton Choisir un fichier pour sélectionner un fichier CSV contenant les nouvelles données.
        • Dans la fenêtre qui s’ouvre, trouvez l’emplacement de stockage du fichier CSV. Sélectionnez le fichier CSV à utiliser.
        Important
        Voici un exemple de fichier CSV acceptable pour créer un utilisateur (personne). Seuls les champs ID employé et Nom d’utilisateur sont obligatoires. Tous les autres champs sont facultatifs et peuvent être ignorés. Le cas échéant, GAX leur attribue une valeur par défaut qui est copiée à partir de l’objet Modèle.
        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}"
        • Cliquez sur Ouvrir.
     8. Cliquez sur Terminer.
   • Mises à jour—Entrez toute mise à jour devant être exécutée sur les objets de configuration avec l’ensemble de modifications en masse. S’il y a des mises à jour, exécutez les actions suivantes. Sinon, passez à l’étape suivante.
     1. Cliquez sur Ajouter. Le panneau Nouvel élément de mise à jour s’affiche à droite.
     2. Cliquez sur Parcourir. Une liste d’objets de configuration s’affiche sur la droite.
     3. Les objets qui apparaissent dans la liste sont déterminés par la catégorie actuellement sélectionnée. Cliquez sur le menu déroulant en haut du panneau pour changer le type de catégorie.
     4. Vous pouvez utiliser le champ Filtre rapide ou Filtre locataires pour trouver des objets spécifiques. Cochez la case en regard de l’objet voulu pour l’ajouter à la liste Mises à jour.
     5. Le nom de l’objet s’affiche dans le panneau Nouvel élément de mise à jour. Cliquez sur le bouton OK pour l’ajouter à la liste Mises à jour.
     6. Répétez les étapes de la procédure ci-dessus pour ajouter d’autres objets à la liste Mises à jour.
3. Dans le panneau de création d’ensembles de modifications en masse, vous pouvez réorganiser les objets dans les listes Suppressions, Ajouts ou Mises à jour.
Important
Les actions relatives aux ensembles de modifications en masse sont exécutées dans l’ordre suivant : suppressions, ajouts, puis mises à jour.
4. Cliquez sur le bouton Sauvegarder pour sauvegarder l’ensemble de modifications en masse.
Important
Cette action n’exécute pas l’ensemble de modifications en masse. Pour exécuter l’ensemble de modifications en masse, suivez les instructions de la rubrique Exécution d’un ensemble de modifications en masse.

Suppression d’ensembles de modifications en masse

Pour supprimer un ensemble de modifications en masse, procédez comme suit :

[+] Afficher les étapes

1. Cochez la case en regard de chaque ensemble de modifications en masse à supprimer.
2. Cliquez sur Supprimer. Une boîte de dialogue s’affiche et vous demande de confirmer l’action.
3. Cliquez sur OK pour continuer ou sur Annuler pour ignorer l’action.

Exécution d’ensembles de modifications en masse

Pour exécuter un ensemble de modifications en masse, procédez comme suit :

[+] Afficher les étapes

1. Sélectionnez un ensemble dans la liste Ensembles de modifications en masse. Un nouveau panneau contenant d’autres informations sur l’ensemble de modifications en masse s’ouvre à droite.
2. Vous pouvez choisir de valider l’ensemble avant l’exécution. Cliquez sur le bouton Valider pour vérifier que l’ensemble de modifications en masse est prêt à être exécuté.
   Important

   Le bouton Valider est utile pour déterminer si l’ensemble de modifications en masse est prêt à être exécuté ou si d’autres ensembles de modifications en masse doivent être exécutés au préalable. Par exemple : Certains ajouts dépendent de l’ajout d’autres objets. Si vous voulez mettre à jour les compétences de plusieurs agents, vous devez d’abord créer les compétences avant de pouvoir effectuer la mise à jour des agents. Dans ce scénario, un clic sur le bouton Valider permet de vérifier que la compétence a bien été créée.
3. Cliquez sur le bouton Exécuter pour exécuter l’ensemble de modifications en masse. Vous pouvez afficher l’état de l’ensemble de modifications en masse dans le panneau Modifications en masse terminées.

Important

Un fichier de définition de solution est créé lorsqu’un ensemble de modifications en masse est exécuté. Consultez le panneau Modifications en masse terminées pour les instructions de téléchargement du fichier de définition de solution.

Modifications en masse terminées

Le panneau Modifications en masse terminées affiche les modifications en masse qui ont été exécutées avec succès dans votre environnement.

La liste Modifications en masse terminées affiche les informations suivantes :

• Nom de l’ensemble de modifications—Nom de l’ensemble de modifications en masse.
• Date de création—Date à laquelle l’ensemble de modifications en masse a été créé.
• Exécuté par locataire—Indique le dernier locataire ayant exécuté l’ensemble de modifications en masse.
• Exécuté par utilisateur—Indique le dernier utilisateur ayant exécuté l’ensemble de modifications en masse.
• Démarré—Indique la date et l’heure auxquelles a débuté l’exécution de l’ensemble de modifications en masse.
• Terminé—Indique la date et l’heure auxquelles s’est terminée l’exécution de l’ensemble de modifications en masse.

Pour supprimer des enregistrements d’ensembles de modifications en masse, cochez la case en regard de l’ensemble à supprimer puis cliquez sur le bouton Supprimer.

Important

Cette action ne supprime pas l’ensemble de modifications en masse ; elle supprime l’enregistrement correspondant.

Cliquez sur un ensemble de modifications en masse dans la liste pour afficher d’autres informations le concernant. Les champs suivants s’affichent :

• Nom de l’ensemble de modifications—Nom de l’ensemble de modifications en masse.
• Suppressions—Objets qui ont été supprimés par l’ensemble de modifications en masse.
• Ajouts—Objets qui ont été ajoutés par l’ensemble de modifications en masse.
• Mises à jour—Objets qui ont été mis à jour par l’ensemble de modifications en masse.

Cliquez sur le bouton Exporter pour télécharger le fichier de définition de solution utilisé pendant l’exécution de l’ensemble de modifications en masse.

Cliquez sur le bouton Supprimer pour supprimer l’enregistrement de l’ensemble de modifications en masse.

Important

Cette action ne supprime pas l’ensemble de modifications en masse ; elle supprime l’enregistrement correspondant.

Limitations

La fonction Ensemble de modifications en masse dans GAX ne prend pas en charge les scénarios suivants :

Ensemble de modifications en masse crée de nouveaux objets qui ont également des dépendances circulaires

Exemple :

1. Un utilisateur crée un ensemble de modifications en masse et ajoute un nouvel agent et une nouvelle compétence à la section Ajouts.
2. L’utilisateur enregistre l’ensemble de modifications en masse.
3. L’utilisateur attribue la nouvelle compétence au nouvel agent, et il lui donne également les autorisations d’accès à la nouvelle compétence.

Ce scénario crée des dépendances circulaires entre les nouveaux objets et l’exécution de l’ensemble de modifications en masse échoue.

Solution :

• Exécutez l’ensemble de modifications en masse avant d’attribuer des dépendances entre les objets.

L’ensemble de modifications en masse se rapporte à un nouvel objet avant la sauvegarde de l’ensemble de modifications en masse

Exemple :

1. Un utilisateur crée un ensemble de modifications en masse et ajoute un nouvel agent et une nouvelle compétence à la section Ajouts.
2. L’utilisateur ne sauvegarde pas l’ensemble de modifications en masse et essaie d’attribuer la nouvelle compétence au nouvel agent.
3. L’utilisateur ne peut pas sélectionner les nouveaux objets avant la sauvegarde de l’ensemble de modifications en masse.

Solution :

• Sauvegardez l’ensemble de modifications en masse avant de référencer le nouvel objet.