Navigatie

Handleiding voor het importeren van gegevens in Unit4 Agresso

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.

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>


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.

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>


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.


Laatst bijgewerkt: