Firmenkunden können Stammdaten über eine csv-Schnittstelle automatisiert in regelmäßigen Abständen (täglich, wöchentlich, monatlich) aktualisieren. Über einen gesicherten sFTP-Zugang, der von Atlatos bereitgestellt wird, werden die Daten ausgetauscht. Über die csv-Datei kann der Zugangsdatenversand bei der Neuanlage eines Mitarbeiters gesteuert werden, wie auch der Deaktivierung oder Löschung von einzelnen Mitarbeitern. In der Vorlage „EinrichtungAtlatoscsvImport_jan2019“ ist die Struktur der csv- Datei abgebildet. Format der Datei: UTF-8, Kommagetrennt oder Semikolongetrennt.
Grundsätzlich gilt, dass zu jedem Datensatz ein Abgleich zu den in Atlatos hinterlegten Daten erfolgt. Ist in der eingespielten csv-Datei die Kostenstelle unterschiedlich zu der in dem Atlatos Profi Traveller aufgeführten Kostenstelle, wird diese abgeändert. Die csv-Datei des Kunden ist somit das führende System.
Manuelle Änderungen von Reisenden werden überschrieben, sofern das Feld in der csv-Datei gepflegt ist.
Beachten Sie auch die Dateistruktur in der csv-Datei im Anhang.
Nr.
Feldbezeichnung
Beschreibung
Auswahlelemente
Pflichtfeld
Feldlänge
1
Indikator
Über das Feld Indikator wird gesteuert, ob der Mitarbeiter gelöscht, inaktiv oder aktiv ist.
M: aktiver Mitarbeiter, Zugangsversand bei Neuanlage oder Niederlassungswechsel
N: aktiver Mitarbeiter, kein Zugangsversand
Z: aktiver Mitarbeiter, Zugangsversand (auch ohne Neuanlage)
I: Inaktiver Mitarbeiter
P: Passiver Mitarbeiter für den gebucht werden kann, der sich jedoch nicht im System anmelden kann
L: Mitarbeiter wird gelöscht
IL=dd.MM.yyyy = Mitarbeiter wird auf inaktiv gesetzt und zum angegeben Datum gelöscht
S: Profilsynchronisation zum Reisebüro wird angestossen, ohne Übernahme von Profiländerungen
Ja
13
2
Benutzername
Der Benutzername ist die eindeutige ID des Mitarbeiters im Unternehmen, die im Atlatos Profi Traveller auch als Primary Key geführt wird. Es ist zu empfehlen die E-Mail-Adresse oder die Personalnr des Reisenden zu verwenden. Ist die Personalnr eindeutig ist diese von Vorteil, da im Falle einer Namensänderung keine Änderung des Benutzernamens erforderlich ist. Sofern kein Single Sign-On Verfahren genutzt wird, ist die Eingabe des Benutzernamens bei dem Login erforderlich. Kennen die Mitarbeiter im Unternehmen ihre Personalnr. nur selten, so ist die E-Mail-Adresse zu bevorzugen.
Firmenspezifischer Wert
Achtung:
Erlaubte Zeichen in Benutzernamen: Buchstaben, Zahlen und die Sonderzeichen _-@+!#~
Mit einem Leerzeichen Im Benutzernamen kann der User keine URL speichern, bei der der Benutzername bereits ausgefüllt ist.
Wechsel des Benutzernamens:
"neuer Benutzername;alter Benutzername"
(Ist die Datei Semikolon-getrennt: "neuer Benutzername,alter Benutzername")
Ja
100
3
Anrede
Anrede des Reisenden
- "Frau" oder "Herr" oder "Divers"
- "Divers-Mr": Divers & Alternative Anrede "Herr"
- "Divers-Ms": Divers & Alternative Anrede "Frau"
- "NONE-Mr": Keine Angabe & Alternative Anrede "Herr"
- "NONE-Ms": Keine Angabe & Alternative Anrede "Frau"
- "NONE" ohne Zusatz oder eine leere Anrede: Keine Angabe & keine Alternative Anrede
Ja
4
4
Titel
Titel des Reisenden
Die Übergabewerte sind: Dr., Prof. etc. - dieser Wert ist optional
Nein
75
5
Vorname
Vorname/n des Reisenden
Textfeld
Ja
255
6
Nachname
Nachname des Reisenden
Textfeld
Ja
255
7
Niederlassung
Hier ist die zugehörige Gesellschaft der Reisenden, die auch der Rechnungsanschrift entspricht, anzugeben. Bitte beachten Sie, dass die Niederlassung bereits in Atlatos angelegt sein muss. Wird ein Datensatz mit einer unbekannten Gesellschaft geliefert, so wird dieser Datensatz ignoriert.
firmenspezifischer Wert
Ja
255
8
Abteilung
Abteilung des Reisenden
firmenspezifischer Wert
Ja
255
9
Telefon
Telefonnummer des Reisenden
Telefonnummer mit Ländervorwahl z.B.: +49 6431 212498 (wird die Ländervorwahl nicht gesetzt, wird automatisch +49 gewählt)
nein, jedoch
im Buchungs-
prozess
100
10
Mobil
Handynummer des Reisenden
Handynummer mit Ländervorwahl z.B.: +49 6431 212498 (wird die Ländervorwahl nicht gesetzt, wird automatisch +49 gewählt)
Nein
30
11
E-Mail
E-Mail Adresse des Reisenden
E-Mail Format Beispiel: xxxx@xxxx.xx
Ja
75
12
Fax
Faxnummer des Reisenden
Faxnummer mit Ländervorwahl z.B.: +49 6431 212498 (wird die Ländervorwahl nicht gesetzt, wird automatisch +49 gewählt)
Nein
30
13
Kostenstelle
Kostenstelle des Reisenden oder der alternativ genutzte Inhalt für das Feld des Unternehmens (Firmenspezifischer Wert)
kann nicht mehr genutzt werden (nur SSO kundenspezifisch)
Nein
255
41
YNodeID/FacesID
standardmäßig deaktiviert
ID-Wird durch die Profilsynchronisation des Reisebüros vergeben
Nein
11
42
Gruppenrecht
Rolle des Users - wird keine Rolle angegeben, wird der User automatisch als Reisende/r angelegt. Es können die Bezeichnungen der firmenspezifischen Rollen übergeben werden
firmenspezifischer Wert z.B. Reisende/r, Buchende/r, Travel Manage/r
Nein
255
43
PLACEHOLDER_4
derzeit nicht vergeben
Nein
44
Berechtigte
Übergabe des Buchungs- oder Reportingrechte, Genehmiger für Reiseanträge oder Reiseabrechnungen: Mit der Option Mode kann ausgewählt werden, ob sich das Genehmigungsrecht auf den Reiseantrag (RA), die Reisekosten-abrechnung (RKA), die Reisebuchung oder auf das Reporting bezieht:
MODE (optional) ra= Genehmiger für Reiseanträge rka= Genehmiger für Reiseabrechnungen book= Buchungsrecht report= Reportingrechte
Wenn kein Mode ausgewählt wird, ist automatisch der Mode ra gewählt.
USER Bei dem User handelt es sich um den Atlatos-Benutzernamen.
LEVEL(optional) Bei dem Level (nur für RA und RKA möglich) handelt es sich um die Stufe des Genehmigers. Level 1 ist damit der erste Genehmiger und Level 2 der zweite Genehmiger, der den RA oder die RKA nach Genehmigung des ersten Genehmigers zur Freigabe erhält. Wenn kein Level angegeben wurde, handelt es sich immer um Level 1. Zu beachten: Usernamen dürfen keine "(" im Namen enthalten.
VERTRETUNG
Steht vor der der Genehmigungsstufe ein v, handelt es sich um einen Vertreter.
REMOVE
Ermöglicht die Löschung von ALLEN angelegten Rechten (manuell o. autom. angelegt) auf Mitarbeiterebene für die gewählten Mode + User.
MEHRERE RECHTE
Mehrere Rechte können je nach Trennzeichen mit Komma oder Semikolon aufgezählt werden.
MODE_BENUTZERNAME (LEVEL)
Beispiel 1:
book_BENUTZERNAME book_001234 (Der User mit dem Benutzer 001234 hat das Buchungsrecht für den Reisenden)
Beispiel 2: rka_BENUTZERNAME(2) rka_001551(2) (2. Genehmiger des Reisenden ist der User mit dem Benutzernamen 001551)
Beispiel 3:
ra_BENUTZERNAME(v2)
ra_001551(v2)
(Vertretung für den Genehmiger des Reiseantrags auf zweiter Stufe)
Beispiel 4:
book_remove;rka_remove
(Alle Buchungs- und Genehmigungsrechte für Abrechnungen auf personenbezogener Ebene/ Mitarbeiterebene werden für den User der entsprechenden Zeile entfernt)
Neue Rechte können im selben Zug vergeben werden:
rka_remove;rka_BENUTZERNAME
rka_remove;rka_001551
Beispiel 5:
report_BENUTZERNAME
Der eingetragene Benutzer kann die Buchungen dieses Mitarbeiters einsehen.
Nein
Vorgabe-wert
45
Straße
Straße des Reisenden oder Externen
Nein
46
Postleitzahl
Postleitzahl des Reisenden oder Externen
Nein
47
Wohnort
Wohnort des Reisenden oder Externen
Nein
Den Flyer zum Angebot finden Sie unten im Anhang.
Häufig gestellte Frage zum Stammdaten-Import:
1. Ist es besser immer nur die Datensätze mit Änderungen zu liefern oder alle Datensätze der Mitarbeiter?
Für Atlatos spielt es keine Rolle, ob nur die Änderungen oder alle Datensätze geliefert werden. In vielen Fällen ist es für das Unternehmen einfacher, alle Datensätze zu liefern. Wird ein User über mehrere Tage mit dem Kennzeichen "L" für zu löschen gesendet, so wird dieser Datensatz bei der ersten Lieferung gelöscht und bei der 2. Datenanlieferung wird dieser Löschauftrag nicht ausgeführt, da der Datensatz nicht mehr existiert und entsprechend im Fehlerreport aufgeführt. Auch wenn einzelne Datensätze nicht mehr verarbeitet werden können (da die Löschung beispielsweise schon stattgefunden hat), werden die restlichen Datensätze vollständig abgearbeitet.
2. Als Unternehmen wollen wir nur die Pflichtfelder übergeben. Reicht eine Datei mit den entsprechenden Pflichtfeldern?
Nein. Die Import-Datei benötigt alle geforderten Spalten und die Informationen der Pflichtfelder sind in der jeweiligen Spalte einzutragen. Alle anderen Felder können leer übergeben werden. Eine Datei mit einer geringeren Anzahl an Spalten kann nicht bearbeitet werden.
3. Welchen Benutzernamen können Sie empfehlen?
Wir haben als Atlatos keine speziellen Anforderungen für einen Benutzernamen, nur dass dieser pro Mitarbeiter eindeutig ist. Für den Stammdaten-Import empfiehlt es sich nicht die E-Mail Adresse oder Vorname. Nachname zu verwenden, da der Benutzername bei jeder Hochzeit / Scheidung geändert werden müßte. Der Mitarbeiter müßte in diesem Fall neue Zugangsdaten erhalten oder der Benutzername wird über die Schnittstelle geändert (siehe Frage 5).
Ist ein Single Sign-On Verfahren gewünscht, ist bei der Wahl des Benutzernamens zu beachten, dass dieser Wert auch bei dem gewählte Authentifizierungsserver wie dem ADFS vorhanden ist.
Wird kein Single-Sign-On verwendet, ist ein Benutzername zu empfehlen, den der Mitarbeiter selbst kennt.
Wird doch die E-Mail-Adresse verwendet, sollte bei dem Stammdaten-Import die Funktion zur Änderung des Benutzernamens genutzt werden.
4. Was ist bei dem Datenfeld Niederlassung zu beachten?
In dem Feld der Niederlassung ist der Name der Gesellschaft in Atlatos zu übergeben. Beispiel: Mustermann KG oder Mustermann Tochtergeselslchaft 1 GmbH & Co KG. Die Angabe von firmenspezifischen ID ist derzeit nicht möglich.
5. Wie kann ein Benutzername geändert werden?
Bei Änderung eines Benutzernamen ist in der zweiten Spalte unter Benutzername der neue und alte Benutzername in folgender Form zu übergeben:
Übergabe bei einer Komma-getrennten Datei:
<neuer Benutzername>;<alter Benutzername>
Übergabe bei einer Semikolon-getrennten Datei:
<neuer Benutzername>,<alter Benutzername>
6. Was passiert, wenn Felder nicht befüllt werden? Werden manuell hinterlegte Daten gelöscht?
Werden Datenfelder über den Import nicht befüllt, so werden diese NICHT überschrieben. So können z.B. Vielfliegernummer selbst vom Reisenden hinterlegt werden und dieser werden nicht über den Import überschrieben. Ändert der Reisende manuell die Kostenstelle und diese wird im Import übermittelt, so wird die manuelle Änderung des Reisenden überschrieben.
7. Kann ein Fehlerreport für den täglichen Import geliefert werden?
Ja, per Mail kann an die gewünschten Personen ein Fehlerreport zugestellt werden. Die gewünschten Personen werden bei Einrichtung des Stammdatenimportes von Atlatos hinterlegt. Der Fehlerreport listet auf, aus welchen Gründen ein Datensatz (z.B. fehlende E-Mailsadresse) nicht angelegt werden kann. Werden einzelne Datensätze aufgrund fehlder Daten nicht verarbeitet, werden dennoch alle folgenden korrekten Datensätze importiert.
Kommentare
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.