Schritt 6c: Einrichtung der Entitäten in SwissSalary (Personio) |
|
Allgemeine Einrichtung
1.Auf der Seite «Cloud Connector-Verwaltung» wählen Sie «Einrichtung» und dann «Einrichtung der Entität» aus. 2.In der Tabelle müssen die Spalten «Tabellen-ID», «Quelle» und «Webdienstendpunkt» ausgefüllt werden. •Tabellen-ID: Hier wird der Name der SwissSalary/Business Central-Tabelle angegeben. Klicken Sie in der Spalte «Tabellen-ID», wählen Sie «Aus vollständiger Liste auswählen» und wählen Sie die entsprechende SwissSalary/Business Central-Tabelle aus, in die Sie Daten aus dem verbundenen System übertragen möchten oder aus der Sie Daten in das verbundene System schreiben möchten. Dieselbe Tabelle kann mehrmals, mit verschiedenen Endpunkten in dem verbundenen System eingerichtet werden. •Reihenfolge: Gibt die Reihenfolge an, in der diese Entitätstabelle synchronisiert werden soll. Beachten Sie die Tabellenabhängigkeiten; die Tabellenbeziehungen werden während der Synchronisierung validiert. Nach diesem Schritt klicken Sie auf den Wert in der Spalte "Tabellenname", und füllen Sie die folgenden Felder im Abschnitt "Details" aus. •Endpoint: Hier wird der API-Endpoint von Personio angegeben. Klicken Sie auf die drei Punkte im Feld „Endpoint“ und wählen Sie einen der folgenden Personio-Endpoints aus. Daten können ausschließlich über diese Endpoints von Personio nach SwissSalary synchronisiert werden: ov1/company/employees ov2/cost-centers ov2/legal-entities Sie können Dokumente aus SwissSalary über den Endpoint v1/company/documents mit Personio synchronisieren. •Quelle: bei den Endpoints v1/company/employees, v2/cost-centers und v2/legal-entities kann nur "Externes System" als Quelle ausgewählt werden. Bei dem Endpoint v1/company/documents kann nur "Business Central" ausgewählt werden. Hier wird die Richtung der Synchronisation angegeben. Wenn die Quelle Business Central ist, werden die Daten aus SwissSalary/Business Central ins Personio synchronisiert. Wenn die Quelle extern ist, erfolgt die Synchronisation von Daten aus dem verbundenen System in SwissSalary/Business Central. •Aggregation Feld: Gibt das Feld an, das zur Aggregation von Daten während der Synchronisation verwendet wird. Dies ist nützlich, wenn Sie eine Entität synchronisieren, die mehrere zugehörige Datensätze für einen einzelnen übergeordneten Datensatz enthält, wie zum Beispiel mehrere Kostenstellen für einen einzelnen Mitarbeiter. •Löschungen Synchronisieren: Gibt an, ob Löschvorgänge für diese Entität synchronisiert werden sollen. Das Aktivieren dieser Einstellung kann erhebliche Auswirkungen auf die Gesamtleistung der Synchronisierung haben. •Datenintegrationsprüfungen überspringen: Gibt an, ob Datenintegritätsprüfungen im SwissSalary ausser Acht gelassen werden sollen, die vor Beginn der Synchronisierung für diese Entität durchgeführt werden. 3.Sie können das Mapping der zu synchronisierenden Felder einrichten, indem Sie auf den entsprechenden Tabellenname klicken. Die folgenden Felder können im Abschnitt «Entitätsfeld-Zuordnung» wie folgt ausgefüllt werden: •Feld-ID: Hier müssen Sie das Feld aus der ausgewählten SwissSalary/Business Central-Tabelle auswählen. •Feldname: Hier wird der Name des Feldes in der ausgewählten SwissSalary/BusinessCentral-Tabelle automatisch ausgefüllt. •Name des Servicefelds: Hier wird der Name des Feldes auf dem ausgewählten Endpoint (zum Beispiel: v1/company/employees) von Personio. HIer werden alle, für den Personio Endpoint freigegebene Felder angezeigt. Im Personio können Sie die Felder beliebig für den Endpoint hinzufügen, bzw. entfernen. •Aktiviert: Hier wird angegeben, ob dieses Feld beim Aktualisieren von Datensätzen in der Quell- oder Zielinstanz einbezogen werden soll. •Der Schlüssel: Gibt an, ob dieses Feld Teil des Schlüssels (Primary Key) für diese Entität ist. •Validieren: Gibt an, ob die Tabellenfeldüberprüfung durchgeführt werden soll, wenn Daten für dieses Feld festgelegt werden. Dies gilt nur, wenn Daten aus dem angebundenen System in SwissSalary übernommen werden. 4.Im Abschnitt «Wertzurordnung» können Sie konstante, bzw. Mapping-Werte für die zu synchronisierenden Felder bestimmen. Wählen Sie das gewünschte Feld in dem Abschnitt «Entitätsfeld-Zuordnung» aus, dieser wird dann im Feld "Dienst Feldname" im Abschnitt «Wertzurordnung» angezeigt. •Von Wert: Hier können Sie den Wert bestimmen, der mit einem anderen Wert ersetzt werden muss. •Zu Wert: Hier können Sie es festlegen, mit welchem Wert der ursprüngliche Wert ersetzt werden muss. Beispiel: Sie wollen das Feld "LohnCode" auf der Personalkarte in das verbundene System synchronisieren und die Enum-Werte (Gehalt, Monatslohn, Stundenlohn, Akkordlohn, Monatslohn LMV) auf diesem Feld möchten Sie mit anderen Text-Werten ersetzen. In das Feld "Von Wert" geben Sie "Gehalt" ein, und in das Feld "Zu Wert" geben Sie den gewünschten Ersatzwert, zum Beispiel "GH" ein. In der nächsten Zeile können Sie in das Feld "Von Wert" "Monatslohn" eingeben, und in das Feld "Zu Wert" können Sie zum Beispiel "ML" angeben. In den nächsten Zeilen können Sie die restlichen Mapping-Werte angeben. Sie können es auch einen konstanten Wert festlegen, in dem Sie in das Feld "Von Wert" ein Stern (*) und in das Feld "Zu Wert" den konstanten Wert einfügen. 5. Falls die SwissSalary Felder Nationalität und Gender ausgewählt sind, werden die Felder im "Wertzuordnung" automatisch ausgefüllt.
Einrichtung von spezieller Entitäten:
I. Bankdaten Um die IBAN-Nummer der Mitarbeitenden zu synchronisieren, müssen Sie die Entität wie folgt einrichten: 1. Im Feld "Tabellen-Id" geben Sie 3009087 an, "Reihenfolge" können Sie selber bestimmen. 2. "Endpoint" ist v1/company/employees und "Quelle" ist External System. 3. Im Feld "Template-Code" estellen Sie einen neuen Eintrag, indem Sie auf "+ Neu" klicken. oIm Feld "Code" geben Sie "Bank" ein. oIn der Spalte "Feldname" wählen Sie "Pos" aus. oIm Feld "Standardwert" geben Sie die Nummer 1. oKlicken Sie auf "Zurück"
Mit diesen Einrichtungen wird es sichergestellt, dass die in Personio gespeicherte IBAN-Nummer, immer als das Hauptbankkonto ins SwissSalary synchronisiert wird.
4. Sie müssen das Entitätsfeldmapping wir folgt einrichten:
*Dienstfeldname im Personio kann von dem Angezeigten abweichen.
II. Kostenstellen (Dimensionen) Falls Sie diese Entität einrichten, müssen Sie die Dimensionen nur in Personio pflegen. Um die Dimensionen aus Personio ins SwissSalary zu synchronisieren, müssen Sie die Entität wie folgt einrichten 1.Im Feld "Tabellen-Id" geben Sie 349 an, "Reihenfolge" können Sie selber bestimmen. 2."Endpoint" ist v2/cost-centers und "Quelle" ist External System. 3.Im Feld "Template-Code" estellen Sie einen neuen Eintrag, indem Sie auf "+ Neu" klicken. oIm Feld "Code" geben Sie "COSTCENTER" ein. oIn der Spalte "Feldname" wählen Sie "Dimension Code" aus. oIm Feld "Standardwert" geben Sie den Dimensionsnamen im SwissSalary ein. Dies kann bei diesem Kunden unterschiedlich sein. oKlicken Sie auf "Zurück" 4.Mit diesem Entitätsfeldmapping kann das Dimensionsstamm aus Personio ins SwissSalary übermittelt werden.
III. Dokumente (Lohnabrechnungen, Lohnausweise usw.) aus SwissSalary Um die ausgewählten Dokumenten aus SwissSalary ins Personio zu synchronisieren, müssen folgenden Einrichtungen vorgenommen werden. 1. Auf der Seite "SwissSalary Dokumenten Einrichtung" muss der ID der entsprechenen Personio-Dokumentkategorie in das Feld "Personio Category ID" zu der SwissSalary Dokumentkategorie eingetragen werden. Alle Dokumente aus dieser SwissSalary Dokumentkategorie werden ins Personio, in die eingetragene Kategorie übermittelt. 2. Auf der Seite "Entitätseinrichtung" bei der "Cloud Connector Einrichtung", muss eine neue Entität erstellt werden. 3. Im Feld "Tabellen-Id" geben Sie 3009140 an, "Reihenfolge" können Sie selber bestimmen. 4. "Endpoint" ist v1/company/documents und "Quelle" ist Business Central. 5. Mit diesem Entitätsfeldmapping werden die Dkoumenten ins Personio übermittelt:
IV. Dimensionszuordnungen aus Personio
Um die Zuordnung der Mitarbeitenden zu Personaldimensionen zu synchronisieren, müssen folgenden Einrichtungen vorgenommen werden. 1. Im Feld "Tabellen-Id" geben Sie 3009084 an, "Reihenfolge" können Sie selber bestimmen. 2. "Endpoint" ist v1/company/employees und "Quelle" ist External System. 3. Im Feld "Template-Code" estellen Sie einen neuen Eintrag, indem Sie auf "+ Neu" klicken. oIm Feld "Code" geben Sie "EMPCOST" ein. oIn der Spalte "Feldname" wählen Sie "Dimension" aus. oIm Feld "Standardwert" geben Sie den Dimensionsnamen (zum Beispiel KOSTENSTELLEN) im SwissSalary ein. Dies kann bei diesem Kunden unterschiedlich sein. oKlicken Sie auf "Zurück"
4. Mit diesem Entitätsfeldmapping werden die Dkoumenten ins Personio übermittelt:
5. Das Feld "Aggregation Field" muss den Wert "cost_centers" haben. |