Duplikat av Guide till Unit4 Agresso Data Import

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.

KOD

XML

KOD

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

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.

KOD

XML

KOD

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