Veiledning til dataimport i Unit4 Agresso

Dette dokumentet gir en detaljert beskrivelse av feltene i XML-masterdatafilen som importeres fra Unit4 Agresso. Det er beregnet på teknisk personell som er ansvarlig for å sette opp og vedlikeholde integrasjonen.

Importen består av to hoveddeler: Medarbeiderdata og Organisasjonshierarki.

Data om ansatte

Medarbeiderdata inneholder informasjon om individuelle brukere, deres kontaktopplysninger og ulike ansettelsesforhold.

Eksempel på medarbeiderdata

Nedenfor er et eksempel på et utdrag av <Resource> element for en enkelt ansatt 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>

Feltbeskrivelser for ansatte

XML-sti	Beskrivelse	Datatype	Obligatorisk	Bruk
`Address/Street`	Gateadresse	Streng	Nei	Ikke brukt.
`Address/Place`	By eller tettsted.	Streng	Nei	Ikke brukt.
`Address/ZipCode`	Postnummer	Heltall	Nei	Ikke brukt.
`Address/mobile`	Mobiltelefonnummer.	Heltall	Nei	Brukes i varslingsflyter for onboarding og offboarding.
`Address/eMailList/string`	E-postadresse.	Streng	Nei	Brukes i varslingsflyter for onboarding og offboarding.
`employments/employment@resourceID`	Ansattnummer.	Heltall	Ja	Identifiserer den ansatte på en unik måte i selskapet.
`employments/employment/employmentType`	Kode for ansettelseskategori (f.eks. "F" for "Fast").	Streng	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/EmploymentTypeDescription`	Beskrivelse av ansettelseskategorien (f.eks. "Fast").	Streng	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/MainPosition`	Angir om dette er den ansattes primære stilling (`true`/`false`).	Streng	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/Percentage`	Posisjonsprosent (f.eks. 100).	Heltall	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/PostId`	Stillingskode-ID.	Heltall	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/PostIdDescription`	Stillingstittel.	Streng	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/PostCode`	Stillingskode.	Streng	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/PostCodeDescription`	Beskrivelse av arbeidstype.	Streng	Nei	Brukes til meldinger, administrasjon av brukerkontoer og tilgangskontroll.
`employments/employment/Relation/Value`	Avdeling/ansvars-ID. Se `ElementType` attributt.	Streng	Nei	Brukes til å knytte brukere til avdelinger og ansvarsområder for tilgangskontroll og meldinger.
`employments/employment/Relation/Description`	Navn på avdeling/ansvarsområde.	Streng	Nei	Brukes til å vise hvilken avdeling og ansvarsområde brukeren tilhører.
`employments/employment/DateFrom`	Startdato for den spesifikke stillingen.	Dato	Nei	Brukes for tilgangskontroll og for å aktivere/deaktivere brukerkontoer.
`employments/employment/DateTo`	Sluttdato for den spesifikke stillingen.	Dato	Nei	Brukes for tilgangskontroll og for å aktivere/deaktivere brukerkontoer.
`DateFrom`	Startdato for hele ansettelsesforholdet.	Dato	Ja	Brukes for tilgangskontroll og for å aktivere/deaktivere brukerkontoer.
`DateTo`	Sluttdato for hele ansettelsesforholdet.	Dato	Nei	Brukes for tilgangskontroll og for å aktivere/deaktivere brukerkontoer.
`FirstName`	Fornavn.	Streng	Ja	Brukes i varslingsflyter.
`Surname`	Etternavn.	Streng	Ja	Brukes i varslingsflyter.
`ShortName`	Kortnavn eller brukernavnalias.	Streng	Nei	Kan mappes til `sAMAccountName` i en lokal Active Directory.
`SocialSecurityNumber`	Norsk fødselsnummer.	Streng	Ja	Identifiserer den ansatte unikt på tvers av systemer, inkludert Feide.
`user/UbwUserID`	Bruker-ID fra Unit4 Business World.	Heltall	Nei	Identifiserer den ansatte på en unik måte for tilbakeskrivingsoperasjoner til U4BW.
`user/DomainInfo`	Registrert brukernavn i U4BW (f.eks, `domain\username`).	Streng	Nei	Sammenlignet med `sAMAccountName` i Active Directory.
`user/resourceID`	Ansattnummer.	Heltall	Ja	Identifiserer den ansatte på en unik måte for tilbakeskrivingsoperasjoner til U4BW.

Merk: En bruker kan ha flere <Employment> noder, én for hver stilling de innehar. Brukere uten en aktiv stilling vil vises i stamdatafilen uten en <Employment> node. På samme måte kan en bruker ha flere <Relation> noder per posisjon.

Organisatorisk hierarki

Denne delen av filen definerer organisasjonsstrukturen, inkludert avdelinger og deres relasjoner.

Eksempel på organisasjonsdata

Nedenfor er et eksempel på 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>

Organisatoriske feltbeskrivelser

XML-sti	Beskrivelse	Datatype	Obligatorisk	Bruk
`CompanyCode`	Firmakode.	Tekst	Ja	Brukes til å bygge opp organisasjonshierarkiet.
`Name`	Avdelingens navn.	Tekst	Ja	Brukes til å bygge opp organisasjonshierarkiet.
`Id`	Avdelings-ID.	Antall	Ja	Identifiserer avdelingen på en unik måte.
`ParentId`	ID for den overordnede avdelingen.	Antall	Ja	Identifiserer den overordnede avdelingen for å bygge hierarkiet.
`Managers/string`	ID til avdelingslederen.	Antall	Ja	Angir avdelingslederen, som brukes til tilgangskontroll og varslinger om onboarding/offboarding.
`DateFrom`	Datoen avdelingen er gyldig fra.	Dato	Nei	Brukes til å aktivere/deaktivere avdelinger.
`DateTo`	Dato avdelingen er gyldig til.	Dato	Nei	Brukes til å aktivere/deaktivere avdelinger.
`LastUpdate`	Dato for siste oppdatering av avdelingen.	Dato	Nei	Brukes til å aktivere/deaktivere avdelinger.
`Status`	Status for avdelingen (f.eks. "A" for Active).	Tekst	Nei	Brukes til å aktivere/deaktivere avdelinger.

Sist oppdatert: 26. juni 2026