Anleitung zum Datenimport in Unit4 Agresso

Dieses Dokument enthält eine detaillierte Beschreibung der Felder in der XML-Stammdatendatei, die aus Unit4 Agresso importiert wird. Es richtet sich an technische Mitarbeiter, die für die Einrichtung und Pflege der Integration zuständig sind.

Der Import besteht aus zwei Hauptteilen: Mitarbeiterdaten und Organisationshierarchie.

Mitarbeiterdaten

Mitarbeiterdaten enthalten Informationen zu einzelnen Benutzern, deren Kontaktdaten sowie deren verschiedene Beschäftigungsverhältnisse.

Beispiel für Mitarbeiterdaten

Nachfolgend finden Sie einen Beispielausschnitt aus dem <Resource> Element für einen einzelnen Mitarbeiter in der XML-Datei.

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>

Beschreibungen der Mitarbeiterfelder

XML-Pfad	Beschreibung	Datentyp	Obligatorisch	Verwendung
`Address/Street`	Anschrift.	Zeichenkette	Nein	Wird nicht verwendet.
`Address/Place`	Stadt oder Ort.	Zeichenkette	Nein	Wird nicht verwendet.
`Address/ZipCode`	Postleitzahl.	Ganzzahl	Nein	Wird nicht verwendet.
`Address/mobile`	Handynummer.	Ganzzahl	Nein	Wird in Benachrichtigungsabläufen für das Onboarding und Offboarding verwendet.
`Address/eMailList/string`	E-Mail-Adresse.	Zeichenkette	Nein	Wird in Benachrichtigungsabläufen für das Onboarding und Offboarding verwendet.
`employments/employment@resourceID`	Mitarbeiter-Nr.	Ganzzahl	Ja	Identifiziert den Mitarbeiter innerhalb des Unternehmens eindeutig.
`employments/employment/employmentType`	Code für die Beschäftigungsart (z. B. „F“ für „Fast“).	Zeichenkette	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/EmploymentTypeDescription`	Beschreibung der Beschäftigungsart (z. B. „Fast“).	Zeichenkette	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/MainPosition`	Gibt an, ob es sich hierbei um die Hauptstelle des Mitarbeiters handelt (`true`/`false`).	Zeichenkette	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/Percentage`	Positionsanteil (z. B. 100).	Ganzzahl	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/PostId`	Stellen-Code-ID.	Ganzzahl	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/PostIdDescription`	Stellenbezeichnung.	Zeichenkette	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/PostCode`	Positionscode.	Zeichenkette	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/PostCodeDescription`	Beschreibung der Arbeitsart.	Zeichenkette	Nein	Wird für die Nachrichtenübermittlung, die Verwaltung von Benutzerkonten und die Zugriffskontrolle verwendet.
`employments/employment/Relation/Value`	Abteilungs-/Zuständigkeits-ID. Siehe `ElementType` Attribut.	Zeichenkette	Nein	Dient dazu, Benutzer mit Abteilungen und Zuständigkeiten zu verknüpfen, um die Zugriffskontrolle und die Nachrichtenübermittlung zu regeln.
`employments/employment/Relation/Description`	Name der Abteilung/des Zuständigkeitsbereichs.	Zeichenkette	Nein	Dient dazu, anzuzeigen, zu welcher Abteilung und welchem Zuständigkeitsbereich der Benutzer gehört.
`employments/employment/DateFrom`	Startdatum für die jeweilige Stelle.	Datum	Nein	Wird für die Zugriffskontrolle sowie zum Aktivieren und Deaktivieren von Benutzerkonten verwendet.
`employments/employment/DateTo`	Enddatum für die jeweilige Stelle.	Datum	Nein	Wird für die Zugriffskontrolle sowie zum Aktivieren und Deaktivieren von Benutzerkonten verwendet.
`DateFrom`	Beginn des gesamten Arbeitsverhältnisses.	Datum	Ja	Wird für die Zugriffskontrolle sowie zum Aktivieren und Deaktivieren von Benutzerkonten verwendet.
`DateTo`	Enddatum des gesamten Arbeitsverhältnisses.	Datum	Nein	Wird für die Zugriffskontrolle sowie zum Aktivieren und Deaktivieren von Benutzerkonten verwendet.
`FirstName`	Vorname.	Zeichenkette	Ja	Wird in Benachrichtigungsabläufen verwendet.
`Surname`	Nachname.	Zeichenkette	Ja	Wird in Benachrichtigungsabläufen verwendet.
`ShortName`	Kurzname oder Alias für den Benutzernamen.	Zeichenkette	Nein	Kann zugeordnet werden an `sAMAccountName` in einem lokalen Active Directory.
`SocialSecurityNumber`	Norwegische Personenkennziffer.	Zeichenkette	Ja	Identifiziert den Mitarbeiter systemübergreifend eindeutig, einschließlich Feide.
`user/UbwUserID`	Benutzername aus Unit4 Business World.	Ganzzahl	Nein	Dient zur eindeutigen Identifizierung des Mitarbeiters bei Rückbuchungsvorgängen in U4BW.
`user/DomainInfo`	Registrierter Benutzername bei U4BW (z. B. `domain\username`).	Zeichenkette	Nein	Im Vergleich zu `sAMAccountName` in Active Directory.
`user/resourceID`	Mitarbeiter-Nr.	Ganzzahl	Ja	Dient zur eindeutigen Identifizierung des Mitarbeiters bei Rückbuchungsvorgängen in U4BW.

Hinweis: Ein Benutzer kann mehrere haben <Employment> Knoten, jeweils einen für jede Position, die sie innehaben. Benutzer ohne aktive Position werden in der Stammdatendatei ohne einen <Employment> Knoten. Ebenso kann ein Benutzer mehrere <Relation> Knoten pro Position.

Organisationshierarchie

In diesem Teil der Datei wird die Organisationsstruktur definiert, einschließlich der Abteilungen und ihrer Beziehungen untereinander.

Beispiel für Organisationsdaten

Nachfolgend finden Sie einen Beispielausschnitt aus einem <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>

Beschreibungen der Organisationsbereiche

XML-Pfad	Beschreibung	Datentyp	Obligatorisch	Verwendung
`CompanyCode`	Buchungskreis.	Text	Ja	Wird zum Aufbau der Organisationshierarchie verwendet.
`Name`	Name der Abteilung.	Text	Ja	Wird zum Aufbau der Organisationshierarchie verwendet.
`Id`	Abteilungs-ID.	Zahl	Ja	Identifiziert die Abteilung eindeutig.
`ParentId`	ID der übergeordneten Abteilung.	Zahl	Ja	Identifiziert die übergeordnete Abteilung eindeutig, um die Hierarchie aufzubauen.
`Managers/string`	ID des Abteilungsleiters.	Zahl	Ja	Legt den Abteilungsleiter fest, der für die Zugriffskontrolle sowie für Benachrichtigungen bei Ein- und Austritten herangezogen wird.
`DateFrom`	Datum, ab dem die Abteilung gültig ist.	Datum	Nein	Dient zum Aktivieren/Deaktivieren von Abteilungen.
`DateTo`	Gültigkeitsende der Abteilung.	Datum	Nein	Dient zum Aktivieren/Deaktivieren von Abteilungen.
`LastUpdate`	Datum der letzten Aktualisierung der Abteilung.	Datum	Nein	Dient zum Aktivieren/Deaktivieren von Abteilungen.
`Status`	Status der Abteilung (z. B. „A“ für „aktiv“).	Text	Nein	Dient zum Aktivieren/Deaktivieren von Abteilungen.

Zuletzt aktualisiert: 26. Juni 2026