Vejledning i import af Unit4 Agresso-data

Dette dokument indeholder en detaljeret beskrivelse af felterne i XML-stamdatafilen, der importeres fra Unit4 Agresso. Det er beregnet til teknisk personale, der har ansvaret for opsætning og vedligeholdelse af integrationen.

Importen består af to hoveddele: Medarbejderdata og organisationshierarki.

Medarbejderoplysninger

Medarbejderdata indeholder oplysninger om de enkelte brugere, deres kontaktoplysninger og deres forskellige ansættelsesforhold.

Eksempel på medarbejderoplysninger

Nedenfor ses et eksempel på et uddrag af <Resource> element for en enkelt medarbejder i XML-filen.

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>

Beskrivelser af medarbejderfelter

XML-sti	Beskrivelse	Datatype	Obligatorisk	Anvendelse
`Address/Street`	Gadeadresse.	Streng	Nej	Anvendes ikke.
`Address/Place`	By eller landsby.	Streng	Nej	Anvendes ikke.
`Address/ZipCode`	Postnummer.	Heltal	Nej	Anvendes ikke.
`Address/mobile`	Mobilnummer.	Heltal	Nej	Anvendes i notifikationsforløb i forbindelse med ansættelse og fratrædelse.
`Address/eMailList/string`	E-mail-adresse.	Streng	Nej	Anvendes i notifikationsforløb i forbindelse med ansættelse og fratrædelse.
`employments/employment@resourceID`	Medarbejdernummer.	Heltal	Ja	Identificerer medarbejderen entydigt inden for virksomheden.
`employments/employment/employmentType`	Kode for ansættelseskategori (f.eks. »F« for »Fast«).	Streng	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/EmploymentTypeDescription`	Beskrivelse af ansættelseskategorien (f.eks. »Fast«).	Streng	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/MainPosition`	Angiver, om dette er medarbejderens primære stilling (`true`/`false`).	Streng	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/Percentage`	Procentdel (f.eks. 100).	Heltal	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/PostId`	Stillingskode-ID.	Heltal	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/PostIdDescription`	Stillingsbetegnelse.	Streng	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/PostCode`	Stillingskode.	Streng	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/PostCodeDescription`	Beskrivelse af arbejdstypen.	Streng	Nej	Anvendes til beskedudveksling, administration af brugerkonti og adgangskontrol.
`employments/employment/Relation/Value`	Afdelings-/ansvars-ID. Se `ElementType` attribut.	Streng	Nej	Bruges til at knytte brugere til afdelinger og ansvarsområder med henblik på adgangskontrol og meddelelseshåndtering.
`employments/employment/Relation/Description`	Afdeling/ansvarsområde.	Streng	Nej	Bruges til at vise, hvilken afdeling og hvilket ansvarsområde brugeren tilhører.
`employments/employment/DateFrom`	Startdato for den pågældende stilling.	Dato	Nej	Anvendes til adgangskontrol og til at aktivere/deaktivere brugerkonti.
`employments/employment/DateTo`	Sidste arbejdsdag for den pågældende stilling.	Dato	Nej	Anvendes til adgangskontrol og til at aktivere/deaktivere brugerkonti.
`DateFrom`	Startdato for hele ansættelsesforholdet.	Dato	Ja	Anvendes til adgangskontrol og til at aktivere/deaktivere brugerkonti.
`DateTo`	Afslutningsdato for hele ansættelsesforholdet.	Dato	Nej	Anvendes til adgangskontrol og til at aktivere/deaktivere brugerkonti.
`FirstName`	Fornavn.	Streng	Ja	Anvendes i notifikationsforløb.
`Surname`	Efternavn.	Streng	Ja	Anvendes i notifikationsforløb.
`ShortName`	Kortnavn eller alias for brugernavn.	Streng	Nej	Kan knyttes til `sAMAccountName` i et lokalt Active Directory.
`SocialSecurityNumber`	Norsk personnummer.	Streng	Ja	Identificerer medarbejderen entydigt på tværs af systemer, herunder Feide.
`user/UbwUserID`	Bruger-ID fra Unit4 Business World.	Heltal	Nej	Identificerer medarbejderen entydigt i forbindelse med tilbageskrivninger til U4BW.
`user/DomainInfo`	Registreret brugernavn i U4BW (f.eks. `domain\username`).	Streng	Nej	Sammenlignet med `sAMAccountName` i Active Directory.
`user/resourceID`	Medarbejdernummer.	Heltal	Ja	Identificerer medarbejderen entydigt i forbindelse med tilbageskrivninger til U4BW.

Bemærk: En bruger kan have flere <Employment> noder, én for hver stilling, de besidder. Brugere uden en aktiv stilling vil fremgå af stamdatafilen uden en <Employment> node. Ligeledes kan en bruger have flere <Relation> knudepunkter pr. position.

Organisationshierarki

Denne del af filen beskriver organisationsstrukturen, herunder afdelingerne og deres indbyrdes relationer.

Eksempel på organisationsdata

Nedenfor ses et eksempel på et uddrag af en <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>

Beskrivelser af organisationsområder

XML-sti	Beskrivelse	Datatype	Obligatorisk	Anvendelse
`CompanyCode`	Selskabsnummer.	Tekst	Ja	Anvendes til at opbygge organisationshierarkiet.
`Name`	Afdelingsnavn.	Tekst	Ja	Anvendes til at opbygge organisationshierarkiet.
`Id`	Afdelings-ID.	Tal	Ja	Identificerer afdelingen entydigt.
`ParentId`	ID for den overordnede afdeling.	Tal	Ja	Identificerer den overordnede afdeling entydigt med henblik på opbygning af hierarkiet.
`Managers/string`	Afdelingslederens ID-nummer.	Tal	Ja	Angiver afdelingslederen, som anvendes til adgangskontrol og meddelelser i forbindelse med ansættelse og fratrædelse.
`DateFrom`	Dato, hvorfra afdelingen er gyldig.	Dato	Nej	Bruges til at aktivere/deaktivere afdelinger.
`DateTo`	Dato, hvor afdelingen er gyldig til.	Dato	Nej	Bruges til at aktivere/deaktivere afdelinger.
`LastUpdate`	Dato for sidste opdatering af afdelingen.	Dato	Nej	Bruges til at aktivere/deaktivere afdelinger.
`Status`	Afdelingens status (f.eks. »A« for Aktiv).	Tekst	Nej	Bruges til at aktivere/deaktivere afdelinger.

Senest opdateret: 26. juni 2026