Navigationsspår

Handbok för import av data till Unit4 Agresso

Detta dokument ger en detaljerad beskrivning av fälten i den XML-masterdatafil som importeras från Unit4 Agresso. Det är avsett för teknisk personal som ansvarar för att sätta upp och underhålla integrationen.

Importen består av två huvuddelar: Medarbetardata och Organisationshierarki.


Uppgifter om anställda

Medarbetardata innehåller information om enskilda användare, deras kontaktuppgifter och deras olika anställningsuppgifter.


Exempel på medarbetardata

Nedan följer ett exempel på ett utdrag av <Resource> element för en enskild anställd 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>


Fältbeskrivningar för anställda

XML sökväg

Beskrivning

Typ av data

Obligatoriskt

Användning

Address/Street

Gatuadress.

Sträng

Nej

Ej använd.

Address/Place

Stad eller ort.

Sträng

Nej

Ej använd.

Address/ZipCode

Postnummer.

Heltal

Nej

Ej använd.

Address/mobile

Mobiltelefonnummer.

Heltal

Nej

Används i meddelandeflöden för onboarding och offboarding.

Address/eMailList/string

E-postadress.

Sträng

Nej

Används i meddelandeflöden för onboarding och offboarding.

employments/employment@resourceID

Anställningsnummer.

Heltal

Ja

Identifierar den anställde på ett unikt sätt inom företaget.

employments/employment/employmentType

Kod för anställningskategori (t.ex. "F" för "Fast").

Sträng

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/EmploymentTypeDescription

Beskrivning av anställningskategorin (t.ex. "Fast").

Sträng

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/MainPosition

Anger om detta är medarbetarens primära befattning (true/false).

Sträng

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/Percentage

Position i procent (t.ex. 100).

Heltal

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/PostId

Positionskod ID.

Heltal

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/PostIdDescription

Titel på befattning.

Sträng

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/PostCode

Positionskod.

Sträng

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/PostCodeDescription

Beskrivning av arbetstyp.

Sträng

Nej

Används för meddelanden, hantering av användarkonton och åtkomstkontroll.

employments/employment/Relation/Value

ID för avdelning/ansvar. Se ElementType attribut.

Sträng

Nej

Används för att koppla användare till avdelningar och ansvarsområden för åtkomstkontroll och meddelanden.

employments/employment/Relation/Description

Avdelningens/ansvarets namn.

Sträng

Nej

Används för att visa vilken avdelning och vilket ansvarsområde användaren tillhör.

employments/employment/DateFrom

Startdatum för den specifika befattningen.

Datum

Nej

Används för åtkomstkontroll och för att aktivera/avaktivera användarkonton.

employments/employment/DateTo

Slutdatum för den specifika befattningen.

Datum

Nej

Används för åtkomstkontroll och för att aktivera/avaktivera användarkonton.

DateFrom

Startdatum för hela anställningsförhållandet.

Datum

Ja

Används för åtkomstkontroll och för att aktivera/avaktivera användarkonton.

DateTo

Slutdatum för hela anställningsförhållandet.

Datum

Nej

Används för åtkomstkontroll och för att aktivera/avaktivera användarkonton.

FirstName

Förnamn.

Sträng

Ja

Används i meddelandeflöden.

Surname

Efternamn.

Sträng

Ja

Används i meddelandeflöden.

ShortName

Kortnamn eller alias för användarnamn.

Sträng

Nej

Kan mappas till sAMAccountName i en lokal Active Directory.

SocialSecurityNumber

Norskt nationellt identitetsnummer.

Sträng

Ja

Identifierar den anställde på ett unikt sätt i alla system, inklusive Feide.

user/UbwUserID

Användar-ID från Unit4 Business World.

Heltal

Nej

Identifierar den anställde på ett unikt sätt för återskrivning till U4BW.

user/DomainInfo

Registrerat användarnamn i U4BW (t.ex., domain\username).

Sträng

Nej

Jämfört med sAMAccountName i Active Directory.

user/resourceID

Anställningsnummer.

Heltal

Ja

Identifierar den anställde på ett unikt sätt för återskrivning till U4BW.


Obs! En användare kan ha flera <Employment> noder, en för varje position de innehar. Användare utan en aktiv position kommer att visas i masterdatafilen utan en <Employment> nod. På samma sätt kan en användare ha flera <Relation> noder per position.


Organisatorisk hierarki

I den här delen av filen definieras organisationsstrukturen, inklusive avdelningar och deras relationer.

Exempel på organisatoriska data

Nedan följer ett exempel på ett utdrag av 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>


Beskrivningar av organisatoriska fält

XML sökväg

Beskrivning

Typ av data

Obligatoriskt

Användning

CompanyCode

Företagskod.

Text

Ja

Används för att bygga upp organisationshierarkin.

Name

Avdelningens namn.

Text

Ja

Används för att bygga upp organisationshierarkin.

Id

Avdelnings-ID.

Antal

Ja

Identifierar avdelningen på ett unikt sätt.

ParentId

ID för den överordnade avdelningen.

Antal

Ja

Identifierar den överordnade avdelningen på ett unikt sätt för att bygga upp hierarkin.

Managers/string

ID för avdelningschefen.

Antal

Ja

Anger avdelningschef, används för åtkomstkontroll och meddelanden om onboarding/offboarding.

DateFrom

Datum som avdelningen är giltig från.

Datum

Nej

Används för att aktivera/avaktivera avdelningar.

DateTo

Datum som avdelningen är giltig till.

Datum

Nej

Används för att aktivera/avaktivera avdelningar.

LastUpdate

Datum då avdelningen senast uppdaterades.

Datum

Nej

Används för att aktivera/avaktivera avdelningar.

Status

Avdelningens status (t.ex. "A" för Active).

Text

Nej

Används för att aktivera/avaktivera avdelningar.


Senast uppdaterad: