Einsatz von UKG mit „ IBM App Connect Enterprise “

Die Ultimate Kronos Group (UKG, früher bekannt als Kronos Worksuite Dimension) ist eine flexible und nahtlose Lösung, die darauf abzielt, Unternehmen mit globalem HCM zu transformieren, und datenbasierte, verlässliche Erkenntnisse bietet, um das Personalmanagement zu verbessern. Die Lösung umfasst Technologie und Services für Personalwesen, Talente, Lohnbuchhaltung und Personalmanagement und ermöglicht Ihnen das Management der gesamten Mitarbeiterreise von einer einzigen Plattform aus. IBM® App Connect Enterprise bietet einen UKG -Anforderungsknoten, über den Sie eine Verbindung zu UKG herstellen und Anfragen zum Abrufen, Zurücksetzen oder Anlegen von Objekten wie Anwesenheitsdaten, Mitarbeiterplänen, Stellenpräferenzen, Personen und Urlaubsdaten stellen können.

1. Erstellen Sie im „ IBM App Connect Enterprise “-Toolkit einen Ablauf, der einen UKG-Request -Knoten enthält.
2. Wählen Sie den Knoten UKG Request im Flow aus, damit die Knoteneigenschaften im Editor angezeigt werden.
3. Klicken Sie auf der Registerkarte Basis auf Connector-Erkennung starten.
   Es erscheint eine Anzeige, in der Sie den Namen des Richtlinienprojekts und die Vaultdetails angeben können, die während der Connectorerkennung verwendet werden.
4. Geben Sie die Details des Richtlinienprojekts und der Vault an, die während der Connectorerkennung verwendet werden sollen:
   1. Geben Sie im Feld Richtlinienprojekt das Richtlinienprojekt an, in dem die Richtlinien gespeichert werden, die während der Connectorerkennung erstellt werden.
      Alternativ können Sie ein neues Richtlinienprojekt erstellen, indem Sie auf Neu klicken und dann den Namen des neuen Richtlinienprojekts angeben. Klicken Sie anschließend auf Fertigstellen.
   2. Geben Sie die Vault an, die während der Connectorerkennung verwendet wird. Berechtigungsnachweise, die während der Connector-Erkennung verwendet werden, werden standardmäßig in einer externen Verzeichnisvaultgespeichert. Dies ist eine App Connect Enterprise -Vault, die von jedem Integrationsserver verwendet werden kann. Alternativ können Sie die Berechtigungsnachweise in einer Integrationsserver-Vault speichern, die im Arbeitsverzeichnis des Integrationsservers erstellt und nur von diesem Integrationsserver verwendet werden kann.
      Um die Vault anzugeben, die zum Speichern der Berechtigungsnachweise verwendet werden soll, führen Sie die Schritte im Abschnitt Connectorerkennungsassistenten verwenden in einem der folgenden Abschnitte aus:

      • Konfigurieren eines externen Verzeichnistresors
      • Vault für Integrationsserver konfigurieren
   3. Geben Sie im Feld Vaultschlüssel den Vaultschlüssel ein, der für den Zugriff auf die in der Vault gespeicherten Berechtigungsnachweise verwendet wird. Der Vaultschlüssel muss mindestens 8 Zeichen lang sein.
   4. Optional: Standardmäßig werden die angegebene Vaultposition und der angegebene Vaultschlüssel als Vorgaben im Toolkit gespeichert, sodass die Werte beim Starten der Connectorerkennung voreingestellt sind. Wenn Sie die Vorgaben nicht sichern wollen, wählen Sie In Vaultvorgaben speichernab.
5. Klicken Sie auf Erkennung starten , um den Connectorerkennungsassistenten für den UKG -Connector zu starten.
   Das Fenster Connectorerkennung wird angezeigt. Wenn vorhandene UKG -Verbindungen (Konten) verfügbar sind, wird eine Liste dieser Verbindungen angezeigt. Wenn keine Verbindungen vorhanden sind, wird der Status des Connectors UKG als Not connectedangezeigt.
   • Wenn eine oder mehrere UKG -Verbindungen (Konten) verfügbar sind, führen Sie die folgenden Schritte durch:
     1. Wählen Sie die Verbindung (das Konto) aus, die Sie verwenden möchten, indem Sie darauf klicken.
     2. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie dann die Aktion aus, die Sie für das Objekt ausführen möchten. Um beispielsweise Teilnahmedatensätze aus UKGabzurufen, klicken Sie auf Teilnahme und anschließend auf Teilnahmedatensätze abrufen.
   • Wenn keine Verbindungen (Konten) vorhanden sind, führen Sie die folgenden Schritte aus:
     1. Klicken Sie auf den erforderlichen Objekttyp und wählen Sie dann die Aktion aus, die Sie für das Objekt ausführen möchten. Um beispielsweise Teilnahmedatensätze aus UKGabzurufen, klicken Sie auf Teilnahme und anschließend auf Teilnahmedatensätze abrufen.
     2. Klicken Sie auf Verbinden.
        Es wird ein Fenster angezeigt, in das Sie die Verbindungsdetails für Ihr UKG -Konto eingeben. Geben Sie die folgenden Informationen ein:

        • Endpunkt URL : Der UKG URL im Format 'https://<hostName>.mykronos.com', wobei <hostName> der Hostname des Mandanten ist, der für Benutzer mit IDP-Konten konfiguriert ist. Dieser Teil von URL ist als Teil einer Mandantenverbundkonfiguration festgelegt.
        • Benutzername: Der Benutzername für Ihr UKG -Konto
        • Benutzerkennwort: Das Kennwort für Ihr UKG -Konto
        • Client-ID: Die Client-ID der Anwendung „ OAuth “ zur Neuerstellung des Zugriffstokens.
        • Client-Geheimnis: Das Client-Geheimnis der Anwendung „ OAuth “ zur Neugenerierung des Zugriffstokens.
        • Anwendungsschlüssel: Sie können den Anwendungsschlüssel im UKG -Entwicklungsportal generieren. Alle Anfragen an die UKG-APIs müssen einen gültigen Anwendungsschlüssel enthalten, der im Header von HTTP übergeben wird.

        Weitere Informationen zum Ermitteln dieser Verbindungsdaten finden Sie unter „Verwendung von IBM App Connect mit UKG“ in der Dokumentation zu Continuous Delivery (CD) unter IBM App Connect in containers.

     3. Klicken Sie auf Verbinden.
6. Legen Sie die erforderlichen Connectoreigenschaften im Assistenten fest.
   Sie können Bedingungen für den Datenabruf hinzufügen, indem Sie auf Bedingung hinzufügen klicken und anschließend die Eigenschaft auswählen, nach der gefiltert werden soll. Sie können beispielsweise Teilnahmedatensätze für weitere Mitarbeiter abrufen. Sie können auch Eigenschaften festlegen, die die maximale Anzahl der abzurufenden Datensätze und die Aktion angeben, die ausgeführt werden soll, wenn dieser Grenzwert überschritten wird.
7. Wenn Sie die Eigenschaften im Connectorerkennungsassistenten angegeben haben, klicken Sie auf Speichern.
   Der Berechtigungsnachweis, der für die Verbindung zu UKG verwendet wird, wird in der Vault gespeichert und die anderen Verbindungsdetails werden in der UKG-Richtliniegespeichert. Die Werte der Eigenschaften, die Sie im Assistenten festgelegt haben, werden an den UKG-Request -Knoten im „ IBM App Connect Enterprise “-Toolkit zurückgegeben.
8. Wenn Sie die Erkennung abgeschlossen und die Eigenschaftswerte gespeichert haben, verlassen Sie den Connectorerkennungsassistenten, indem Sie auf das X in der rechten oberen Ecke des Fensters klicken oder die Tastenkombination Alt+F4drücken.
9. Zurück zur Bearbeitung des UKG -Anforderungsknotens im „ IBM App Connect Enterprise “-Toolkit.
   Die Connectoreigenschaften, die im Connectorerkennungsassistenten (in Schritt 6) festgelegt wurden, werden jetzt im Eigenschafteneditor im Knoten UKG-Anforderung angezeigt. Auf der Registerkarte Basis werden die Werte der Eigenschaften Aktion und Objekt angezeigt, die Sie im Assistenten festgelegt haben. Wenn Sie beispielsweise im Assistenten Teilnahme > Teilnahmedatensätze abrufen ausgewählt haben, werden die folgenden Eigenschaften auf der Registerkarte Basis des Knotens angezeigt:

   • Aktion - RETRIEVEALL
   • Objekt - attendance

   Die Werte der Eigenschaften Aktion und Objekt werden schreibgeschützt angezeigt. Wenn Sie diese Werte ändern möchten, können Sie dies tun, indem Sie erneut auf Connectorerkennung starten klicken und im Assistenten für die Connectorerkennung neue Werte festlegen.

   Die Eigenschaft Schemabasisname gibt den Basisnamen der Schemadateien an, die das Format der Anforderungs-und Antwortnachrichten beschreiben, die vom UKG -Connector gesendet und empfangen werden. Der Schemabasisname wird automatisch bei der ersten Ausführung der Erkennung für den Knoten festgelegt und basiert auf dem aktuellen Flow-Namen und dem Knotennamen. Wenn Sie diese Eigenschaft vor der ersten Ausführung der Erkennung manuell festlegen, wird der von Ihnen festgelegte Wert verwendet. Wenn Sie die Schemas nach der Erkennung umbenennen, müssen Sie diese Eigenschaft so bearbeiten, dass sie dem Schemabasisnamen entspricht, der von den umbenannten Schemas im Projekt verwendet wird. Wenn Sie diese Eigenschaft nach der Erkennung ändern, müssen Sie entweder die Schemanamen umbenennen, damit sie übereinstimmen, oder die Erkennung erneut ausführen.

   Abhängig von der Aktion, die während der Erkennung ausgewählt wurde, generiert der Assistent für Connectorerkennung entweder ein Anforderungsschema und ein Antwortschema oder nur ein Antwortschema. Ein Anforderungsschema wird nur generiert, wenn die ausgewählte Aktion und das ausgewählte Objekt eine Anforderungsnachricht erfordern. Das generierte Anforderungsschema wird für die Validierung der Anforderungsnachricht verwendet. Wenn die Aktion RETRIEVE oder DELETEwar, wird nur das Antwortschema vom Connector zurückgegeben.

   Die generierten Schemadateien werden dem Projekt hinzugefügt und können vom Knoten Zuordnung für die Umsetzung von Eingabe-und Ausgabedaten verwendet werden. Der vollständige Dateiname des Schemas wird aus dem Schemabasisnamen (z. B. gen/MyMessageFlow.UKG_Request) mit dem Suffix response.schema.json oder request.schema.jsonabgeleitet. Sie können das Schema öffnen, indem Sie auf Anforderungsschema öffnen oder auf Antwortschema öffnenklicken.

10. Überprüfen Sie, ob die Eigenschafteneinstellungen auf dem UKG-Anforderungsknoten korrekt sind, und speichern Sie dann den Nachrichtenfluss.
11. Auf der Registerkarte Verbindung des Knotens UKG-Anforderung zeigt die Eigenschaft Richtlinie den Namen der Richtlinie an, die die Details der Sicherheitsidentität enthält, die für die Verbindung zu verwenden ist. Die Richtlinie hat den Typ UKG.
    Weitere Informationen finden Sie unter UKG policy.
12. Optional: Legen Sie die Eigenschaft Zeitlimit auf der Registerkarte Verbindung fest, um die Zeit (in Sekunden) anzugeben, die der Knoten auf die Verarbeitung der Operation durch UKG wartet.
13. Die Registerkarte Filter des UKG-Anforderungsknotens enthält Eigenschaften, die steuern, wie der Nachrichtenfluss Daten auswählt. Die Anfangswerte dieser Eigenschaften werden den Eigenschaftswerten entnommen, die für den Connector UKG im Connectorerkennungsassistenten festgelegt wurden, einschließlich der Filteroptionseigenschaften und aller Bedingungen, die angegeben wurden (wie in Schritt 6beschrieben). Wenn Sie anschließend zum Assistenten für Connectorerkennung zurückkehren und die Werte von Eigenschaften ändern (z. B. durch Hinzufügen neuer Bedingungen), werden diese Aktualisierungen in der Eigenschaftengruppe auf dem Knoten wiedergegeben.

    Die Eigenschaften Filteroptionen steuern, mit welchen Objekten gearbeitet werden soll, wenn der Knoten UKG Request ausgeführt wird. Die Eigenschaften für Filtergrenzwert steuern die maximale Anzahl der abzurufenden Elemente und die Aktion, die ausgeführt werden soll, wenn der Grenzwert überschritten wird.

    Sie können die Werte ändern, indem Sie neben dem Wert, den Sie ändern möchten, im Abschnitt Filteroptionen auf Bearbeiten klicken und die Eigenschaftswerte ändern, die im Abschnitt Filterbegrenzung festgelegt wurden.

    Die Eigenschaftswerte können entweder Textwerte oder ESQL-oder XPATH-Ausdrücke sein, die aus dem Inhalt der Nachricht aufgelöst werden, die während der Ausführung an den UKG-Anforderungsknoten übergeben wird.

14. Definieren Sie auf der Registerkarte Anforderung die Eigenschaft Datenposition , um die Position in der Baumstruktur für eingehende Nachrichten anzugeben, die die Objektdaten enthält, die in UKGerstellt werden. Diese Daten bilden die Anforderung, die vom Knoten UKG Request an das UKG -System gesendet wird.
15. Legen Sie auf der Registerkarte Ergebnis die Eigenschaft Position der Ausgabedaten fest, um die Position in der Baumstruktur der Ausgabenachricht anzugeben, die die Daten des in UKGerstellten Datensatzes enthält.
16. Standardmäßig werden Anforderungsnachrichten anhand des Anforderungsschemas validiert, das während der Connectorerkennung generiert wurde. Sie können die Anforderungsvalidierung inaktivieren oder die Validierungseinstellungen ändern, indem Sie die Validierungseigenschaften des Knotens UKG Request verwenden.
17. Speichern Sie den Nachrichtenfluss.