Duplicaat van Handleiding voor Unit4 Agresso gegevensimport

Dit document geeft een gedetailleerde beschrijving van de velden in het XML-stamgegevensbestand dat wordt geïmporteerd vanuit Unit4 Agresso. Het is bedoeld voor technisch personeel dat verantwoordelijk is voor het opzetten en onderhouden van de integratie.

Het importeren bestaat uit twee hoofdonderdelen: Werknemersgegevens en Organisatiehiërarchie.

Personeelsgegevens

Werknemersgegevens bevatten informatie over individuele gebruikers, hun contactgegevens en hun verschillende dienstverbanden.

Voorbeeld van werknemersgegevens

Hieronder staat een voorbeeldfragment van de <Resource> element voor een enkele werknemer in het XML-bestand.

CODE

XML

CODE

<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>23027844556</SocialSecurityNumber>
    <Sex>M</Sex>
    <Municipal>3487</Municipal>
    <Status>N</Status>
    <User>
        <UbwUserId>OLANORD</UbwUserId>
        <DomainInfo>offsam\olanord</DomainInfo>
        <ResourceId>514264</ResourceId>
    </User>
</Resource>

Werknemer Veldomschrijvingen

XML-pad	Beschrijving	Gegevenstype	Verplicht	Gebruik
`Address/Street`	Straatadres.	String	Geen	Niet gebruikt.
`Address/Place`	Stad of gemeente.	String	Geen	Niet gebruikt.
`Address/ZipCode`	Postcode.	Integer	Geen	Niet gebruikt.
`Address/mobile`	Mobiel telefoonnummer.	Integer	Geen	Gebruikt in meldingsstromen voor onboarding en offboarding.
`Address/eMailList/string`	E-mailadres.	String	Geen	Gebruikt in meldingsstromen voor onboarding en offboarding.
`employments/employment@resourceID`	Werknemersnummer.	Integer	Ja	Identificeert de werknemer op unieke wijze binnen het bedrijf.
`employments/employment/employmentType`	Werkgelegenheidscategoriecode (bijvoorbeeld 'F' voor 'Fast').	String	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/EmploymentTypeDescription`	Beschrijving van de tewerkstellingscategorie (bv. "Snel").	String	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/MainPosition`	Geeft aan of dit de primaire functie van de werknemer is (`true`/`false`).	String	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/Percentage`	Positiepercentage (bijvoorbeeld 100).	Integer	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/PostId`	Positiecode ID.	Integer	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/PostIdDescription`	Functieomschrijving.	String	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/PostCode`	Functiecode.	String	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/PostCodeDescription`	Beschrijving van het type werk.	String	Geen	Gebruikt voor berichten, gebruikersaccountbeheer en toegangscontrole.
`employments/employment/Relation/Value`	Afdeling/verantwoordelijke ID. Zie `ElementType` attribuut.	String	Geen	Wordt gebruikt om gebruikers te koppelen aan afdelingen en verantwoordelijkheden voor toegangscontrole en berichtgeving.
`employments/employment/Relation/Description`	Naam afdeling/verantwoordelijkheid.	String	Geen	Wordt gebruikt om weer te geven tot welke afdeling en verantwoordelijkheid de gebruiker behoort.
`employments/employment/DateFrom`	Startdatum voor de specifieke functie.	Datum	Geen	Gebruikt voor toegangscontrole en om gebruikersaccounts te activeren/deactiveren.
`employments/employment/DateTo`	Einddatum voor de specifieke functie.	Datum	Geen	Gebruikt voor toegangscontrole en om gebruikersaccounts te activeren/deactiveren.
`DateFrom`	Begindatum voor de volledige arbeidsrelatie.	Datum	Ja	Gebruikt voor toegangscontrole en om gebruikersaccounts te activeren/deactiveren.
`DateTo`	Einddatum voor de volledige arbeidsrelatie.	Datum	Geen	Gebruikt voor toegangscontrole en om gebruikersaccounts te activeren/deactiveren.
`FirstName`	Voornaam.	String	Ja	Gebruikt in meldingsstromen.
`Surname`	Achternaam.	String	Ja	Gebruikt in meldingsstromen.
`ShortName`	Verkorte naam of gebruikersnaam alias.	String	Geen	Kan worden toegewezen aan `sAMAccountName` in een lokale Active Directory.
`SocialSecurityNumber`	Noors nationaal identiteitsnummer.	String	Ja	Identificeert de werknemer op unieke wijze in alle systemen, inclusief Feide.
`user/UbwUserID`	Gebruikers-ID van Unit4 Business World.	Integer	Geen	Identificeert de werknemer op unieke wijze voor terugboekingen naar U4BW.
`user/DomainInfo`	Geregistreerde gebruikersnaam in U4BW (bijv, `domain\username`).	String	Geen	Vergeleken met `sAMAccountName` in Active Directory.
`user/resourceID`	Werknemersnummer.	Integer	Ja	Identificeert de werknemer op unieke wijze voor terugboekingen naar U4BW.

Opmerking: Een gebruiker kan meerdere <Employment> knooppunten, één voor elke positie die ze bekleden. Gebruikers zonder actieve positie verschijnen in het bestand met stamgegevens zonder een <Employment> knooppunt. Op dezelfde manier kan een gebruiker meerdere <Relation> knooppunten per positie.

Organisatorische hiërarchie

Dit deel van het bestand definieert de organisatiestructuur, inclusief afdelingen en hun relaties.

Voorbeeld van organisatiegegevens

Hieronder staat een voorbeeldfragment van een <Organisation> element.

CODE

XML

CODE

<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>

Organisatorische veldbeschrijvingen

XML-pad	Beschrijving	Gegevenstype	Verplicht	Gebruik
`CompanyCode`	Bedrijfscode.	Tekst	Ja	Wordt gebruikt om de organisatiehiërarchie op te bouwen.
`Name`	Naam afdeling.	Tekst	Ja	Wordt gebruikt om de organisatiehiërarchie op te bouwen.
`Id`	Afdeling ID.	Aantal	Ja	Identificeert de afdeling op een unieke manier.
`ParentId`	ID van de bovenliggende afdeling.	Aantal	Ja	Identificeert op unieke wijze de bovenliggende afdeling om de hiërarchie op te bouwen.
`Managers/string`	ID van de afdelingsmanager.	Aantal	Ja	Stelt de afdelingsmanager in, gebruikt voor toegangscontrole en meldingen voor in- en uitstappen.
`DateFrom`	Datum vanaf wanneer de afdeling geldig is.	Datum	Geen	Wordt gebruikt om afdelingen te activeren/deactiveren.
`DateTo`	Datum waarop de afdeling geldig is tot.	Datum	Geen	Wordt gebruikt om afdelingen te activeren/deactiveren.
`LastUpdate`	Datum waarop de afdeling voor het laatst is bijgewerkt.	Datum	Geen	Wordt gebruikt om afdelingen te activeren/deactiveren.
`Status`	Status van de afdeling (bijv. 'A' voor Actief).	Tekst	Geen	Wordt gebruikt om afdelingen te activeren/deactiveren.