Guide d'importation des données Unit4 Agresso | Base de connaissances Identum

Ce document fournit une description détaillée des champs du fichier XML de données de base importé depuis Unit4 Agresso. Il s'adresse au personnel technique chargé de la mise en place et de la maintenance de l'intégration.

L'importation comprend deux parties principales : les données relatives aux salariés et la hiérarchie organisationnelle.

Données relatives aux salariés

Les données relatives aux salariés contiennent des informations sur chaque utilisateur, ses coordonnées et ses différents antécédents professionnels.

Exemple de données relatives aux salariés

Voici un exemple d'extrait du <Resource> élément correspondant à un seul salarié dans le fichier XML.

XML

<Resource>
    <Addresses>
        <Address>
            <AddressId>64699</AddressId>
            <Type>1</Type>
            <Contact />
            <Position />
            <Street>Høneveien 17</Street>
            <Place>Utfjord</Place>
            <Province />
            <CountryCode>NO</CountryCode>
            <ZipCode>4000</ZipCode>
            <Telephone />
            <Telefax />
            <Telex />
            <Mobile />
            <Pager />
            <Home />
            <Assistant />
            <EMailList>
                <string>ola.nordmann@utfjord.kommune.no</string>
            </EMailList>
            <EMailCopyList>
                <string />
            </EMailCopyList>
            <LastUpdate>2016-02-26T08:55:58</LastUpdate>
        </Address>
    </Addresses>
    <Employments>
        <Employment ResourceId="514564">
            <PostId>9002</PostId>
            <EmploymentType>A</EmploymentType>
            <EmploymentTypeDescription>Fast</EmploymentTypeDescription>
            <MainPosition>true</MainPosition>
            <Percentage>100</Percentage>
            <PostIdDescription>Annet</PostIdDescription>
            <PostCode>691204</PostCode>
            <PostCodeDescription>Driftsoperatør</PostCodeDescription>
            <SeniorityDate>1996-01-01</SeniorityDate>
            <WageRule>4.1</WageRule>
            <Relations>
                <Relation Type="MNAL" Name="Organisasjonstilhørighet" ElementType="ORGANISATION">
                    <Value>4098</Value>
                    <Value1>0</Value1>
                    <Description>Teknisk anlegg vann og avløp</Description>
                    <DateFrom>2023-05-01</DateFrom>
                    <DateTo>2099-12-31</DateTo>
                </Relation>
                <Relation Type="C1" Name="Ansvar" ElementType="COST_CENTER">
                    <Value>5312</Value>
                    <Value1>B</Value1>
                    <Description>Tekniske va-anlegg</Description>
                    <DateFrom>2023-04-01</DateFrom>
                    <DateTo>2099-12-31</DateTo>
                </Relation>
                <Relation Type="MNBB" Name="Arbeidstid pr. uke" ElementType="WORK_TIME_GROUP">
                    <Value>35,5</Value>
                    <Value1>35.5</Value1>
                    <Description>35,5 t pr. uke</Description>
                    <DateFrom>2023-05-01</DateFrom>
                    <DateTo>2099-12-31</DateTo>
                </Relation>
            </Relations>
            <DateFrom>2023-05-01</DateFrom>
            <DateTo>2099-12-31</DateTo>
        </Employment>
    </Employments>
    <CompanyCode>L1</CompanyCode>
    <ResourceId>514264</ResourceId>
    <DateFrom>2016-03-01</DateFrom>
    <DateTo>2099-12-31</DateTo>
    <FirstName>Ola</FirstName>
    <Surname>Nordmann</Surname>
    <Name>Nordmann, Ola</Name>
    <ShortName>OLANORD</ShortName>
    <ResourceType>1</ResourceType>
    <Birthdate>1978-05-15</Birthdate>
    <SocialSecurityNumber>00000000000</SocialSecurityNumber> <!-- example value: replace with actual field from source system -->
    <Sex>M</Sex>
    <Municipal>3487</Municipal>
    <Status>N</Status>
    <User>
        <UbwUserId>OLANORD</UbwUserId>
        <DomainInfo>offsam\olanord</DomainInfo>
        <ResourceId>514264</ResourceId>
    </User>
</Resource>

Descriptions des postes des employés

Chemin d'accès XML	Description	Type de données	Obligatoire	Utilisation
`Address/Street`	Adresse postale.	Chaîne de caractères	Non	Non utilisé.
`Address/Place`	Ville ou commune.	Chaîne de caractères	Non	Non utilisé.
`Address/ZipCode`	Code postal.	Entier	Non	Non utilisé.
`Address/mobile`	Numéro de téléphone portable.	Entier	Non	Utilisé dans les flux de notification liés à l'intégration et au départ des collaborateurs.
`Address/eMailList/string`	Adresse e-mail.	Chaîne de caractères	Non	Utilisé dans les flux de notification liés à l'intégration et au départ des collaborateurs.
`employments/employment@resourceID`	Numéro d'employé.	Entier	Oui	Identifie de manière unique le salarié au sein de l'entreprise.
`employments/employment/employmentType`	Code de catégorie d'emploi (par exemple, « F » pour « Fast »).	Chaîne de caractères	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/EmploymentTypeDescription`	Description de la catégorie d'emploi (par exemple, « Rapide »).	Chaîne de caractères	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/MainPosition`	Indique s'il s'agit du poste principal de l'employé (`true`/`false`).	Chaîne de caractères	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/Percentage`	Pourcentage de position (par exemple, 100).	Entier	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/PostId`	Code d'identification du poste.	Entier	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/PostIdDescription`	Intitulé du poste.	Chaîne de caractères	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/PostCode`	Code de poste.	Chaîne de caractères	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/PostCodeDescription`	Description du type de travail.	Chaîne de caractères	Non	Utilisé pour la messagerie, la gestion des comptes utilisateurs et le contrôle d'accès.
`employments/employment/Relation/Value`	Référence du service/de la fonction. Voir `ElementType` attribut.	Chaîne de caractères	Non	Sert à associer les utilisateurs à des services et à des responsabilités à des fins de contrôle d'accès et de messagerie.
`employments/employment/Relation/Description`	Nom du service/de la fonction.	Chaîne de caractères	Non	Permet d'indiquer le service et le domaine de responsabilité auxquels appartient l'utilisateur.
`employments/employment/DateFrom`	Date de prise de fonction pour ce poste spécifique.	Date	Non	Sert au contrôle d'accès et à l'activation/la désactivation des comptes utilisateurs.
`employments/employment/DateTo`	Date de fin du contrat pour ce poste spécifique.	Date	Non	Sert au contrôle d'accès et à l'activation/la désactivation des comptes utilisateurs.
`DateFrom`	Date de début de la relation de travail dans son ensemble.	Date	Oui	Sert au contrôle d'accès et à l'activation/la désactivation des comptes utilisateurs.
`DateTo`	Date de fin de la relation de travail dans son ensemble.	Date	Non	Sert au contrôle d'accès et à l'activation/la désactivation des comptes utilisateurs.
`FirstName`	Prénom.	Chaîne de caractères	Oui	Utilisé dans les flux de notification.
`Surname`	Nom de famille.	Chaîne de caractères	Oui	Utilisé dans les flux de notification.
`ShortName`	Pseudonyme ou nom d'utilisateur.	Chaîne de caractères	Non	Peut être associé à `sAMAccountName` dans un Active Directory local.
`SocialSecurityNumber`	Numéro d'identité national norvégien.	Chaîne de caractères	Oui	Identifie de manière unique le salarié dans tous les systèmes, y compris Feide.
`user/UbwUserID`	Identifiant utilisateur issu d'Unit4 Business World.	Entier	Non	Identifie de manière unique le salarié pour les opérations de réécriture dans U4BW.
`user/DomainInfo`	Nom d'utilisateur enregistré sur U4BW (par exemple, `domain\username`).	Chaîne de caractères	Non	Par rapport à `sAMAccountName` dans Active Directory.
`user/resourceID`	Numéro d'employé.	Entier	Oui	Identifie de manière unique le salarié pour les opérations de réécriture dans U4BW.

Remarque : Un utilisateur peut en avoir plusieurs <Employment> nœuds, un pour chaque poste qu’ils occupent. Les utilisateurs n’occupant aucun poste actif apparaîtront dans le fichier de données de base sans <Employment> nœud. De même, un utilisateur peut avoir plusieurs <Relation> nœuds par position.

Hiérarchie organisationnelle

Cette partie du fichier définit la structure organisationnelle, notamment les services et les liens qui les unissent.

Exemple de données organisationnelles

Voici un exemple d'extrait de code d'un <Organisation> élément.

XML

<Organisation>
    <CompanyCode>L1</CompanyCode>
    <Name>Utfjord ungdomsskole</Name>
    <Id>5003</Id>
    <ParentId>4014</ParentId>
    <Managers>
        <string>503579</string>
    </Managers>
    <DateFrom>0001-01-01T00:00:00</DateFrom>
    <DateTo>9999-12-31T23:59:59.9999999</DateTo>
    <LastUpdate>2016-01-13T12:54:14</LastUpdate>
    <Status>N</Status>
</Organisation>

Descriptions des domaines organisationnels

Chemin d'accès XML	Description	Type de données	Obligatoire	Utilisation
`CompanyCode`	Code de la société.	Texte	Oui	Sert à établir la hiérarchie organisationnelle.
`Name`	Nom du département.	Texte	Oui	Sert à établir la hiérarchie organisationnelle.
`Id`	Code du service.	Nombre	Oui	Identifie de manière unique le service.
`ParentId`	Identifiant du service parent.	Nombre	Oui	Identifie de manière unique le service parent afin de construire la hiérarchie.
`Managers/string`	Identifiant du responsable de service.	Nombre	Oui	Définit le responsable de service, utilisé pour le contrôle d'accès et les notifications relatives à l'intégration et au départ des collaborateurs.
`DateFrom`	Date à partir de laquelle le service est valable.	Date	Non	Permet d'activer ou de désactiver des services.
`DateTo`	Date jusqu'à laquelle le service est valable.	Date	Non	Permet d'activer ou de désactiver des services.
`LastUpdate`	Date de la dernière mise à jour du service.	Date	Non	Permet d'activer ou de désactiver des services.
`Status`	Statut du service (par exemple, « A » pour « Actif »).	Texte	Non	Permet d'activer ou de désactiver des services.

Dernière mise à jour : 26 juin 2026