Massenänderungssätze

Mithilfe von Genesys Administrator Extension können Sie Massenänderungen an Benutzern vornehmen. So können Sie beispielsweise einen Massenänderungssatz erstellen, um mehrere Benutzer in einem einzigen Vorgang aus dem System zu entfernen oder dem System hinzuzufügen, mehrere Skills zu entfernen oder hinzuzufügen oder beides, Benutzer- und Skillvorgänge, zusammen durchzuführen.

Ab Version 8.5.250 ist die Funktion „Massenänderungssätze“ standardmäßig nicht in GAX verfügbar. Stattdessen empfiehlt Genesys die Verwendung der anderen Massenprovisionierungsfunktionen für Benutzerobjekte (Personen), einschließlich Agenten, sowie Agentengruppenobjekte. Wenn Sie jedoch weiterhin Massenänderungssätze verwenden möchten, aktivieren Sie sie. Legen Sie dazu für enable_bulk_change_sets=true fest, und zwar im Abschnitt [general] der Registerkarte Optionen des GAX-Anwendungsobjekts. Die Funktion wird im Menü Verwaltung angezeigt.

Anzeigeoptionen

In der Liste der Massenänderungssätze werden sämtliche Massenänderungen der Umgebung erfasst, die noch nicht ausgeführt wurden bzw. aufgrund von Fehlern nicht ausgeführt werden konnten. Eine Liste der erfolgreich ausgeführten Massenänderungssätze finden Sie im Bereich Durchgeführte Massenänderungen.

Bei der Verwaltung der Konfigurationsobjekte gelten die Berechtigungseinstellungen für Mandanten. Sie können nur auf Objekte zugreifen, für die Sie die entsprechende Berechtigung besitzen.

Sie können die Liste auf zweierlei Art filtern:

• Geben Sie den Namen oder einen Teil des Namens eines Objekts im Feld Schnellfilter ein.
• Klicken Sie auf die Schaltfläche Mandantenfilter, um den Bereich Mandantenfilter zu öffnen. Klicken Sie in diesem Bereich auf das Kontrollkästchen jedes Mandanten, den Sie auswählen möchten. Über das Feld Schnellfilter in diesem Bereich können Sie die Mandantenliste filtern.

Durch Klicken auf eine Spaltenüberschrift werden die Listeneinträge sortiert. Wenn Sie ein zweites Mal auf die Spaltenüberschrift klicken, wird die Sortierreihenfolge umgekehrt.

Details

In der Liste Massenänderungssätze werden folgende Informationen angezeigt:

• Name des Änderungssatzes—Der Name des Massenänderungssatzes.
• Ersteller—Der Name des Benutzers, von dem der Massenänderungssatz angelegt wurde.
• Erstellungsdatum—Das Datum, zu dem der Massenänderungssatz angelegt wurde.
• Datum der letzten Änderung—Das Datum, zu dem der Massenänderungssatz zuletzt geändert wurde.
• Status des Änderungssatzes—Einer der folgenden Status:
  • Leer—Es wurden noch keine Daten im Massenänderungssatz eingegeben.
  • Unvollständig—Es wurde erst ein Teil der Daten im Massenänderungssatz eingegeben.
  • Bereit zur Ausführung—Der Massenänderungssatz steht zur Ausführung bereit.
• Ausführung—Einer der folgenden Status:
  • Nicht ausgeführt—Der Massenänderungssatz wurde noch nicht ausgeführt.
  • Abgeschlossen—Der Massenänderungssatz wurde ausgeführt.
  • Fehlgeschlagen—Der Massenänderungssatz konnte nicht ausgeführt werden.
• Fortschritt—Während der Ausführung des Massenänderungssatzes erscheint hier eine Fortschrittsleiste.
• Von Mandant durchgeführt—Gibt an, welcher Mandant den Massenänderungssatz zuletzt ausgeführt hat.
• Von Benutzer durchgeführt—Gibt an, welcher Benutzer den Massenänderungssatz zuletzt ausgeführt hat.
• Datum der letzten Ausführung—Gibt das Datum und den Zeitpunkt an, zu dem der Massenänderungssatz zuletzt ausgeführt wurde.

Klicken Sie zur Anzeige von Einzelheiten auf den jeweiligen Massenänderungssatz in der Liste. Die folgenden Felder werden angezeigt:

• Name des Änderungssatzes—Der Name des Massenänderungssatzes.
• Löschungen—Die Objekte, die durch den Massenänderungssatz gelöscht werden.
• Hinzufügungen—Die Objekte, die durch den Massenänderungssatz hinzugefügt werden.
• Aktualisierungen—Die Objekte, die durch den Massenänderungssatz aktualisiert werden.

Wichtig

Bei der Ausführung von Massenänderungssätzen wird eine Lösungsdefinitionsdatei erstellt. Anweisungen zum Herunterladen der Lösungsdefinitionsdatei finden Sie im Bereich Durchgeführte Massenänderungen.

Prozeduren

Über die Bereiche für die Massenänderungssätze können Sie folgende Maßnahmen durchführen:

Erstellen von Massenänderungssätzen

Gehen Sie zum Erstellen von Massenänderungssätzen wie folgt vor:

[+] Schritte anzeigen

1. Klicken Sie im Bereich Massenänderungssätze auf +.
2. Füllen Sie die folgenden Felder aus:
   • Name des Änderungssatzes—Der Name des Massenänderungssatzes.
   Wichtig
   Das Feld Name des Änderungssatzes muss in der Umgebung eindeutig sein.
   • Löschungen—Geben Sie die Konfigurationsobjekte an, die mit dem Massenänderungssatz gelöscht werden sollen. Wenn Löschungen durchzuführen sind, führen Sie die folgenden Aktionen aus. Fahren Sie andernfalls mit dem nächsten Schritt fort.
     1. Klicken Sie auf Hinzufügen. Rechts wird der Bereich Neues Löschungselement angezeigt
     2. Klicken Sie auf Durchsuchen. Rechts wird eine Liste der Konfigurationsobjekte angezeigt.
     3. Welche Objekte in der Liste angezeigt werden, hängt von der derzeit ausgewählten Kategorie ab. Klicken Sie auf das Dropdown-Menü oben im Bereich, wenn Sie die Kategorie ändern möchten.
     4. Mit dem Feld Schnellfilter oder Mandantenfilter können bestimmte Objekte gesucht werden. Klicken Sie auf das Kontrollkästchen neben einem Objekt, um das Objekt in die Löschungsliste aufzunehmen.
     5. Der Name des Objekts wird im Bereich Neues Löschungselement angezeigt. Klicken Sie auf OK, um das Objekt in die Löschungsliste aufzunehmen.
     6. Wiederholen Sie die aufgeführten Schritte, um der Löschungsliste weitere Objekte hinzuzufügen.
   • Hinzufügungen—Geben Sie die Konfigurationsobjekte an, die mit dem Massenänderungssatz hinzugefügt werden sollen. Wenn Hinzufügungen durchzuführen sind, führen Sie die folgenden Aktionen aus. Fahren Sie andernfalls mit dem nächsten Schritt fort.
     1. Klicken Sie auf Hinzufügen. Es wird nun rechts ein neuer Bereich angezeigt.
     2. Klicken Sie auf Durchsuchen. Rechts wird eine Liste der Konfigurationsobjekte angezeigt.
     3. Wählen Sie im Dropdown-Menü Typ einen Objekttyp aus.
     4. Klicken Sie auf Durchsuchen, um einen als Vorlage zu verwendenden Objekttyp auszuwählen. Es wird nun rechts ein neuer Bereich angezeigt. Klicken Sie zur Auswahl eines Objekts auf das zugehörige Kontrollkästchen.
     Wichtig
     Wenn ein Objekt als Vorlage verwendet wird, werden sämtliche Eigenschaften des Vorlagenobjekts für die Hinzufügungsobjekte übernommen, einschließlich der Verbindungen und Berechtigungen.
     5. Klicken Sie auf Weiter.
     6. Geben Sie im Feld Zu erstellende Anzahl eingeben die Anzahl der mit der Vorlage zu erstellenden Objekte ein. Der Wert muss eine Ganzzahl zwischen 1 und 100 sein.
     7. Führen Sie im Feld CSV-Datei die folgenden Aktionen aus:
        • Klicken Sie auf Datei auswählen, um eine CSV-Datei auszuwählen, aus der die neuen Daten übernommen werden sollen.
        • avigieren Sie im angezeigten Fenster zum Speicherort der CSV-Datei. Wählen Sie die gewünschte CSV-Datei aus.
        Wichtig
        Das folgende Beispiel zeigt ein CSV-Dateiformat, das für die Erstellung von Benutzerobjekten (Personen) geeignet ist. Nur die Felder employeeid (Mitarbeiter-ID) und username (Benutzername) sind Pflichtfelder. Alle anderen Felder sind optional und können leer bleiben. In diesem Fall werden Standardwerte aus dem Vorlagenobjekt übernommen.
        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}"
        • Klicken Sie auf Öffnen.
     8. Klicken Sie auf Beenden.
   • Aktualisierungen—Geben Sie die Aktualisierungen ein, die mit dem Massenänderungssatz an den Konfigurationsobjekten durchgeführt werden sollen. Wenn Aktualisierungen durchzuführen sind, führen Sie die folgenden Aktionen aus. Fahren Sie andernfalls mit dem nächsten Schritt fort.
     1. Klicken Sie auf Hinzufügen. Rechts wird der Bereich Neues Aktualisierungselement angezeigt.
     2. Klicken Sie auf Durchsuchen. Rechts wird eine Liste der Konfigurationsobjekte angezeigt.
     3. Welche Objekte in der Liste angezeigt werden, hängt von der derzeit ausgewählten Kategorie ab. Klicken Sie auf das Dropdown-Menü oben im Bereich, wenn Sie die Kategorie ändern möchten.
     4. Mit dem Feld Schnellfilter oder Mandantenfilter können bestimmte Objekte gesucht werden. Klicken Sie auf das zu dem Objekt gehörige Kontrollkästchen, um das Objekt in die Aktualisierungsliste aufzunehmen.
     5. Der Name des Objekts wird im Bereich Neues Aktualisierungselement angezeigt. Klicken Sie auf OK, um es der Aktualisierungsliste hinzuzufügen.
     6. Wiederholen Sie die aufgeführten Schritte, um der Aktualisierungsliste weitere Objekte hinzuzufügen.
3. Im Bereich für die Erstellung von Massenänderungssätzen können die Objekte in den Listen Löschungen, Hinzufügungen oder Aktualisierungen neu sortiert werden.
Wichtig
Die Aktionen zu Massenänderungssätzen werden in der folgenden Reihenfolge ausgeführt: Löschungen, Hinzufügungen und dann Aktualisierungen.
4. Klicken Sie zum Speichern des Massenänderungssatzes auf Speichern.
Wichtig
Durch diese Aktion wird der Massenänderungssatz nicht ausgeführt. Zur Ausführung des Massenänderungssatzes befolgen Sie die Anweisungen zum Ausführen von Massenänderungssätzen.

Löschen von Massenänderungssätzen

Gehen Sie zum Löschen von Massenänderungssätzen wie folgt vor:

[+] Schritte anzeigen

1. Klicken Sie auf die Kontrollkästchen der zu löschenden Massenänderungssätze.
2. Klicken Sie auf Löschen. Ein Dialogfeld zum Bestätigen der Aktion wird angezeigt.
3. Klicken Sie auf OK, um fortzufahren, oder auf Abbrechen, um die Aktion zu verwerfen.

Ausführen von Massenänderungssätzen

Gehen Sie zum Ausführen von Massenänderungssätzen wie folgt vor:

[+] Schritte anzeigen

1. Wählen Sie einen Massenänderungssatz aus der Liste Massenänderungssätze aus. Rechts wird ein neuer Bereich mit weiteren Informationen zum Massenänderungssatz angezeigt.
2. Falls gewünscht, kann der Massenänderungssatz vor der Ausführung überprüft werden. Klicken Sie auf Validieren, um sicherzustellen, dass der Massenänderungssatz zur Ausführung bereit ist.
   Wichtig

   Mit der Schaltfläche Validieren wird überprüft, ob der Massenänderungssatz bereit zur Ausführung ist oder ob zunächst noch andere Massenänderungssätze ausgeführt werden müssen. Beispiel: Einige Hinzufügungen beruhen darauf, dass zunächst andere Objekte hinzugefügt werden. Eventuell sollten Sie einige Agenten mit einer neuen Skill aktualisieren. Die Skill muss jedoch zunächst erstellt werden, bevor Sie die Agenten aktualisieren können. In diesem Fall wird durch Klicken auf Validieren überprüft, ob die Skill erstellt wurde.
3. Klicken Sie zum Ausführen des Massenänderungssatzes auf Ausführen. Im Bereich Durchgeführte Massenänderungen können Sie den Status des Massenänderungssatzes anzeigen.

Wichtig

Bei der Ausführung von Massenänderungssätzen wird eine Lösungsdefinitionsdatei erstellt. Anweisungen zum Herunterladen der Lösungsdefinitionsdatei finden Sie im Bereich Durchgeführte Massenänderungen.

Durchgeführte Massenänderungen

Im Bereich Durchgeführte Massenänderungen werden die in der Umgebung erfolgreich ausgeführten Massenänderungen aufgelistet.

In der Liste Durchgeführte Massenänderungen werden folgende Informationen angezeigt:

• Name des Änderungssatzes: Der Name des Massenänderungssatzes.
• Erstellungsdatum: Das Datum, an dem der Änderungssatz angelegt wurde.
• Von Mandant durchgeführt: Gibt an, welcher Mandant den Änderungssatz zuletzt ausgeführt hat.
• Von Benutzer durchgeführt: Gibt an, welcher Benutzer den Änderungssatz zuletzt ausgeführt hat.
• Gestartet: Datum und Zeitpunkt, an dem die Ausführung des Massenänderungssatzes begonnen wurde.
• Beendet: Datum und Zeitpunkt, an dem die Ausführung des Massenänderungssatzes abgeschlossen wurde.

Klicken Sie zum Löschen von Datensätzen in Massenänderungssätzen auf das Kontrollkästchen neben dem zu ändernden Massenänderungssatz und dann auf Löschen.

Wichtig

Bei diesem Vorgang wird nicht der Massenänderungssatz, sondern der Datensatz des Massenänderungssatzes gelöscht.

Klicken Sie zur Anzeige von Einzelheiten auf den jeweiligen Massenänderungssatz in der Liste. Die folgenden Felder werden angezeigt:

• Name des Änderungssatzes: Der Name des Massenänderungssatzes.
• Löschungen: Die Objekte, die durch den Massenänderungssatz gelöscht wurden.
• Hinzufügungen: Die Objekte, die durch den Massenänderungssatz hinzugefügt wurden.
• Aktualisierungen: Die Objekte, die durch den Massenänderungssatz aktualisiert wurden.

Klicken Sie auf Exportieren, um die Lösungsdefinitionsdatei herunterzuladen, die während der Ausführung des Massenänderungssatzes verwendet wurde.

Klicken Sie zum Löschen des Datensatzes des Massenänderungssatzes auf Löschen.

Wichtig

Durch diesen Vorgang wird nicht der Massenänderungssatz, sondern der Datensatz des Massenänderungssatzes gelöscht.

Einschränkungen

Die folgenden Szenarien werden von der Massenänderungssatz-Funktion in GAX nicht unterstützt:

Durch den Massenänderungssatz werden neue Objekte mit zirkulären Abhängigkeiten erstellt

Beispiel:

1. Ein Benutzer erstellt einen Massenänderungssatz und fügt im Abschnitt "Hinzufügungen" einen neuen Agenten und eine neue Skill hinzu.
2. Der Benutzer speichert den Massenänderungssatz.
3. Der Benutzer weist dem neuen Agenten die neue Skill zu und erteilt dem neuen Agenten zusätzlich Zugriffsberechtigungen für die neue Skill.

In diesem Szenario werden zirkuläre Abhängigkeiten zwischen den Objekten erstellt, d. h., die Ausführung des Massenänderungssatzes schlägt fehl.

Lösung:

• Führen Sie den Massenänderungssatz aus, bevor Sie Abhängigkeiten zwischen Objekten zuweisen.

Der Massenänderungssatz verweist auf ein neues Objekt, bevor der Massenänderungssatz gespeichert wird

Beispiel:

1. Ein Benutzer erstellt einen Massenänderungssatz und fügt im Abschnitt "Hinzufügungen" einen neuen Agenten und eine neue Skill hinzu.
2. Der Benutzer speichert den Massenänderungssatz nicht und versucht, dem neuen Agenten die neue Skill zuzuweisen.
3. Der Benutzer kann die neuen Objekte nicht auswählen, solange der Massenänderungssatz nicht gespeichert wurde.

Lösung:

• Speichern Sie den Massenänderungssatz, bevor Sie auf das neue Objekt verweisen.

category:Genesys Administrator Extension category:Genesys Administrator Extension User Guide