Étape 5 Configuration des entités dans SwissSalary

Configuration générale

1.Sur la page « Gestion du Cloud Connector », sélectionnez « Configuration », puis « Configuration de l'entité ».

2.Dans le tableau, les colonnes « ID du tableau », « Source » et « Point de terminaison du service Web » doivent être remplies.

•ID du tableau: le nom du tableau SwissSalary/Business Central est indiqué ici. Cliquez dans la colonne « ID du tableau », sélectionnez « Sélectionner dans la liste complète » et choisissez le tableau SwissSalary/Business Central correspondant dans lequel vous souhaitez transférer les données du système connecté ou à partir duquel vous souhaitez écrire des données dans le système connecté. Le même tableau peut être configuré plusieurs fois, avec différents points finaux dans le système connecté.

•Ordre: indique l'ordre dans lequel cette table d'entité doit être synchronisée. Tenez compte des dépendances entre les tables; les relations entre les tables sont validées pendant la synchronisation. Après cette étape, cliquez sur la valeur dans la colonne « Nom de la table » et remplissez les champs suivants dans la section « Détails ».

•Point de terminaison: le point de terminaison API de Personio est indiqué ici. Cliquez sur les trois points dans le champ « Point de terminaison » et sélectionnez l'un des points de terminaison Personio suivants. Les données peuvent être synchronisées entre Personio et SwissSalary exclusivement via ces points de terminaison:

ov1/company/employees

ov2/cost-centers

ov2/legal-entities

Vous pouvez synchroniser les documents de SwissSalary avec Personio via le point de terminaison v1/company/documents.

•Source: pour les points finaux v1/company/employees,  v2/cost-centers et v2/legal-entities, seule l'option « Système externe » peut être sélectionnée comme source. Pour le point final v1/company/documents, seule l'option « Business Central » peut être sélectionnée. La direction de la synchronisation est indiquée ici. Si la source est Business Central, les données de SwissSalary/Business Central sont synchronisées dans Personio. Si la source est externe, la synchronisation des données du système connecté s'effectue dans SwissSalary/Business Central.

•Champ d'agrégation: spécifie le champ utilisé pour agréger les données pendant la synchronisation. Cela est utile lorsque vous synchronisez une entité qui contient plusieurs enregistrements associés pour un seul enregistrement parent, par exemple plusieurs centres de coûts pour un seul employé.

•Synchroniser les suppressions: indique si les suppressions pour cette entité doivent être synchronisées. L'activation de ce paramètre peut avoir un impact significatif sur les performances globales de la synchronisation.

•Ignorer les contrôles d'intégration des données : indique si les contrôles d'intégrité des données dans SwissSalary doivent être ignorés avant le début de la synchronisation pour cette entité.

3.Vous pouvez configurer le mappage des champs à synchroniser en cliquant sur le nom du tableau correspondant. Les champs suivants peuvent être remplis dans la section « Affectation des champs d'entité » comme suit:

•ID du champ: vous devez sélectionner ici le champ dans le tableau SwissSalary/Business Central choisi.

•Nom du champ: le nom du champ dans le tableau SwissSalary/BusinessCentral sélectionné est automatiquement renseigné ici.

•Nom du champ de service: le nom du champ sur le point de terminaison sélectionné (par exemple :  v1/company/employees) de Personio s'affiche ici. Tous les champs partagés pour le point de terminaison Personio s'affichent ici. Dans Personio, vous pouvez ajouter ou supprimer les champs de votre choix pour le point de terminaison.  

•Activé: indique si ce champ doit être inclus lors de la mise à jour des enregistrements dans l'instance source ou cible.

•La clé: indique si ce champ fait partie de la clé primaire (Primary Key) pour cette entité.

•Valider: indique si la vérification du champ du tableau doit être effectuée lorsque des données sont définies pour ce champ. Cela s'applique uniquement lorsque les données du système connecté sont transférées vers SwissSalary.

4.Dans la section « Affectation des valeurs », vous pouvez définir des valeurs constantes ou des valeurs de mappage pour les champs à synchroniser. Sélectionnez le champ souhaité dans la section « Affectation des champs d'entité ». Il s'affichera alors dans le champ « Nom du champ de service » dans la section « Affectation des valeurs ».

•De valeur: vous pouvez ici déterminer la valeur qui doit être remplacée par une autre valeur.

•Valeur: vous pouvez ici définir la valeur par laquelle la valeur d'origine doit être remplacée.

Exemple: vous souhaitez synchroniser le champ « CodeSalaire » de la fiche du personnel dans le système connecté et remplacer les valeurs énumérées (salaire, salaire mensuel, salaire horaire, salaire à la tâche, salaire mensuel CNT) dans ce champ par d'autres valeurs textuelles. Dans le champ « De la valeur », saisissez « Salaire » et dans le champ « À la valeur », saisissez la valeur de remplacement souhaitée, par exemple « GH ». Dans la ligne suivante, vous pouvez saisir « Salaire mensuel » dans le champ « De la valeur » et « ML » dans le champ « À la valeur ». Dans les lignes suivantes, vous pouvez indiquer les valeurs de mappage restantes. Vous pouvez également définir une valeur constante en insérant un astérisque (*) dans le champ « De la valeur » et la valeur constante dans le champ « À la valeur ».

5. Si les champs Nationalité et Sexe de SwissSalary sont sélectionnés, les champs de « Attribution de valeur » sont automatiquement remplis.

Création d'entités spéciales:

I. Données bancaires

Pour synchroniser le numéro IBAN des collaborateurs, vous devez configurer l'entité comme suit:

1. Dans le champ « ID du tableau », indiquez 3009087. Vous pouvez déterminer vous-même l'ordre.

2. « Endpoint » est v1/company/employees et « Source » est External System.

3. Dans le champ « Code du modèle », créez une nouvelle entrée en cliquant sur « + Nouveau ».

oDans le champ « Code », saisissez « Banque ».

oDans la colonne « Nom du champ », sélectionnez « Pos ».

oDans le champ « Valeur par défaut », entrez le chiffre 1.

oCliquez sur « Retour ».

Ces paramètres garantissent que le numéro IBAN enregistré dans Personio est toujours synchronisé dans SwissSalary en tant que compte bancaire principal.

4. Vous devez configurer le mappage des champs d'entité comme suit:

*Le nom du champ de service dans Personio peut différer de celui affiché.

II. Centres de coûts (Dimensions)

Si vous configurez cette entité, vous devez uniquement gérer les dimensions dans Personio. Pour synchroniser les dimensions de Personio vers SwissSalary, vous devez configurer l'entité comme suit

1.Dans le champ « ID du tableau », indiquez 349. Vous pouvez déterminer vous-même l'ordre.

2.« Endpoint » est v2/cost-centers et « Source » est External System.

3.Dans le champ « Code du modèle », créez une nouvelle entrée en cliquant sur « + Nouveau ».

oDans le champ « Code », saisissez « COSTCENTER ».

oDans la colonne « Nom du champ », sélectionnez « Code de dimension ».

oDans le champ « Valeur par défaut », saisissez le nom de la dimension dans SwissSalary. Celui-ci peut varier d'un client à l'autre.

oCliquez sur « Retour ».

4.Ce mappage de champs d'entités permet de transférer la base dimensionnelle de Personio vers SwissSalary.

III. Documents (Décompte salaire, certificats de salaire, etc.) issus de SwissSalary

Pour synchroniser les documents sélectionnés depuis SwissSalary vers Personio, les paramètres suivants doivent être configurés.

1. Sur la page « Configuration des documents SwissSalary », l'ID de la catégorie de documents Personio correspondante doit être saisi dans le champ « Personio Category ID » de la catégorie de documents SwissSalary. Tous les documents de cette catégorie de documents SwissSalary sont transférés vers Personio, dans la catégorie saisie.

2. Une nouvelle entité doit être créée sur la page « Configuration de l'entité » dans « Configuration du Cloud Connector ».

3. Dans le champ « ID du tableau », indiquez 3009140. Vous pouvez déterminer vous-même l'ordre.

4. « Endpoint » est v1/company/documents et « Source » est Business Central.

5. Avec ce mappage de champs d'entités, les documents sont transférés vers Personio:

IV. Attributions dimensionnelles à partir de Personio

Afin de synchroniser l'affectation des collaborateurs aux dimensions du personnel, les paramétrages suivants doivent être effectués.

1. Dans le champ « ID du tableau », indiquez 3009084. Vous pouvez déterminer vous-même l'ordre.

2. « Endpoint » est v1/company/employees et « Source » est External System.

3.Dans le champ « Code du modèle », créez une nouvelle entrée en cliquant sur « + Nouveau ».

oDans le champ « Code », saisissez « EMPCOST ».

oDans la colonne « Nom du champ », sélectionnez « Dimension ».  

oDans le champ « Valeur par défaut », saisissez le nom de la dimension (par exemple CENTRES DE COÛTS) dans SwissSalary. Cela peut varier selon les clients.

oCliquez sur « Retour ».

4. Avec ce mappage de champs d'entités, les documents sont transférés vers Personio:

5. Le champ « Aggregation Field » doit avoir la valeur « cost_centers ».