Opas Unit4 Agresso -tietojen tuontiin

Tässä asiakirjassa on yksityiskohtainen kuvaus Unit4 Agressosta tuotavan XML-yleistietotiedoston kentistä. Se on tarkoitettu tekniselle henkilöstölle, joka vastaa integraation käyttöönotosta ja ylläpidosta.

Tuonti koostuu kahdesta pääosasta: Työntekijätiedot ja organisaatiohierarkia.

Työntekijän tiedot

Työntekijätiedot sisältävät tietoja yksittäisistä käyttäjistä, heidän yhteystietonsa ja erilaiset työsuhdetiedot.

Esimerkki työntekijän tiedoista

Alla on esimerkkipätkä komennosta <Resource> elementti yhdelle työntekijälle XML-tiedostossa.

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>

Työntekijän kenttien kuvaukset

XML-polku	Kuvaus	Tietotyyppi	Pakollinen	Käyttö
`Address/Street`	Katuosoite.	merkkijono	Ei	Ei käytetty.
`Address/Place`	Kaupunki tai kunta.	merkkijono	Ei	Ei käytetty.
`Address/ZipCode`	Postinumero.	Kokonaisluku	Ei	Ei käytetty.
`Address/mobile`	Matkapuhelinnumero.	Kokonaisluku	Ei	Käytetään sisään- ja uloskirjautumisen ilmoitusvirroissa.
`Address/eMailList/string`	Sähköpostiosoite.	merkkijono	Ei	Käytetään sisään- ja uloskirjautumisen ilmoitusvirroissa.
`employments/employment@resourceID`	Työntekijän numero.	Kokonaisluku	Kyllä	Yksilöi työntekijän yrityksen sisällä.
`employments/employment/employmentType`	Työllisyysluokan koodi (esim. "F" tarkoittaa "Fast").	merkkijono	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/EmploymentTypeDescription`	Työllisyysluokan kuvaus (esim. "Fast").	merkkijono	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/MainPosition`	Ilmoittaa, onko tämä työntekijän pääasiallinen asema (`true`/`false`).	merkkijono	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/Percentage`	Asemaprosentti (esim. 100).	Kokonaisluku	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/PostId`	Positiokoodi ID.	Kokonaisluku	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/PostIdDescription`	Tehtävänimike.	merkkijono	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/PostCode`	Aseman koodi.	merkkijono	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/PostCodeDescription`	Työn tyypin kuvaus.	merkkijono	Ei	Käytetään viestinvälitykseen, käyttäjätilien hallintaan ja pääsynvalvontaan.
`employments/employment/Relation/Value`	Osasto/vastuualue ID. Katso `ElementType` ominaisuus.	merkkijono	Ei	Käytetään käyttäjien yhdistämiseen osastoihin ja vastuualueisiin pääsynvalvontaa ja viestinvälitystä varten.
`employments/employment/Relation/Description`	Osaston/vastuualueen nimi.	merkkijono	Ei	Käytetään näyttämään, mihin osastoon ja vastuualueeseen käyttäjä kuuluu.
`employments/employment/DateFrom`	Aloituspäivämäärä kyseisessä tehtävässä.	Päivämäärä	Ei	Käytetään pääsynvalvontaan ja käyttäjätilien aktivointiin/deaktivointiin.
`employments/employment/DateTo`	Tietyn toimen päättymispäivä.	Päivämäärä	Ei	Käytetään pääsynvalvontaan ja käyttäjätilien aktivointiin/deaktivointiin.
`DateFrom`	Koko työsuhteen alkamispäivä.	Päivämäärä	Kyllä	Käytetään pääsynvalvontaan ja käyttäjätilien aktivointiin/deaktivointiin.
`DateTo`	Koko työsuhteen päättymispäivä.	Päivämäärä	Ei	Käytetään pääsynvalvontaan ja käyttäjätilien aktivointiin/deaktivointiin.
`FirstName`	Etunimi.	merkkijono	Kyllä	Käytetään ilmoitusvirroissa.
`Surname`	Sukunimi.	merkkijono	Kyllä	Käytetään ilmoitusvirroissa.
`ShortName`	Lyhyt nimi tai käyttäjänimen alias.	merkkijono	Ei	Voidaan liittää `sAMAccountName` paikallisessa Active Directory -hakemistossa.
`SocialSecurityNumber`	Norjan henkilötunnus.	merkkijono	Kyllä	Tunnistaa työntekijän yksiselitteisesti kaikissa järjestelmissä, myös Feidessä.
`user/UbwUserID`	Käyttäjätunnus Unit4 Business Worldista.	Kokonaisluku	Ei	Yksilöi työntekijän yksiselitteisesti U4BW:hen tehtäviä palautustoimintoja varten.
`user/DomainInfo`	Rekisteröitynyt käyttäjätunnus U4BW:ssä (esim, `domain\username`).	merkkijono	Ei	Verrattuna `sAMAccountName` Active Directory.
`user/resourceID`	Työntekijän numero.	Kokonaisluku	Kyllä	Yksilöi työntekijän yksiselitteisesti U4BW:hen tehtäviä palautustoimintoja varten.

Huom: Käyttäjällä voi olla useita <Employment> solmuja, yksi kutakin heidän asemaansa varten. Käyttäjät, joilla ei ole aktiivista asemaa, näkyvät kantatietotiedostossa ilman merkintää. <Employment> solmu. Samoin käyttäjällä voi olla useita <Relation> solmuja paikkaa kohti.

Organisaatiohierarkia

Tiedoston tässä osassa määritellään organisaatiorakenne, mukaan lukien osastot ja niiden väliset suhteet.

Esimerkki organisaation tiedoista

Alla on esimerkkipätkä esimerkki <Organisation> elementti.

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>

Organisaatiokenttien kuvaukset

XML-polku	Kuvaus	Tietotyyppi	Pakollinen	Käyttö
`CompanyCode`	Yrityksen koodi.	Teksti	Kyllä	Käytetään organisaatiohierarkian rakentamiseen.
`Name`	Osaston nimi.	Teksti	Kyllä	Käytetään organisaatiohierarkian rakentamiseen.
`Id`	Osaston tunnus.	Numero	Kyllä	Yksilöi osaston yksiselitteisesti.
`ParentId`	Emo-osaston tunnus.	Numero	Kyllä	Yksilöi emo-osaston yksiselitteisesti hierarkian rakentamiseksi.
`Managers/string`	Osaston johtajan tunnus.	Numero	Kyllä	Asettaa osastonjohtajan, jota käytetään pääsynvalvonnassa ja sisään-/uloskirjautumisilmoituksissa.
`DateFrom`	Päivämäärä, josta alkaen osasto on voimassa.	Päivämäärä	Ei	Käytetään osastojen aktivoimiseen/deaktivoimiseen.
`DateTo`	Päivämäärä, johon asti osasto on voimassa.	Päivämäärä	Ei	Käytetään osastojen aktivoimiseen/deaktivoimiseen.
`LastUpdate`	Päivämäärä, jolloin osasto on viimeksi päivitetty.	Päivämäärä	Ei	Käytetään osastojen aktivoimiseen/deaktivoimiseen.
`Status`	Osaston tila (esim. "A" tarkoittaa aktiivinen).	Teksti	Ei	Käytetään osastojen aktivoimiseen/deaktivoimiseen.

Viimeksi päivitetty: 26. kesäkuuta 2026