MOS'aik Schnittstelle Echtzeit / TIM - Aufbau der Importdatei v2.0

MOSER Gesamtdokumentation - 7.2. Aufbau der Importdatei v2.0

7.2. Aufbau der Importdatei v2.0

Das Format v2.0 für die Importdatei ist gegenüber dem "alten" Format v1.0 um das Importieren von Materialien erweitert worden.

Das in der Datei verwendete Trennzeichen ist der Tabulator. Die erste Zeile enthält Spaltenüberschriften. Die Zeichenkodierung ist UTF-8. Die Datei besteht aus exakt 18 Spalten, die im folgenden im Detail beschrieben werden.

Spaltendefinition der Importdatei v2.0

Nr	Name	Datentyp	Pflichtfeld	Gültigkeit	Beschreibung
1	Typ	Text	Ja	`M` oder `S`	Enthält den Typ des Datensatzes in dieser Zeile. Dabei steht `M` für Material und `S` für Stunden.
2	Mandantennummer	Integer	Ja	>= 0	Die Mandantennummer kann unter MOS'aik den Firmenstammdaten entnommen werden ( Stammdaten \| Einstellungen \| Fimenstammdaten ). Stimmt die Mandantennummer nicht mit den Firmenstammdaten überein, wird der Datensatz nicht importiert.
3	Projekt	Text	(Ja)		Enthält die Nummer des Projektes, auf welchen die Buchung erfolgen soll. Wird das Projekt nicht gefunden, wird, wenn dies entsprechend konfiguriert (siehe Import) ist, automatisch ein neues angelegt (dies wird im Protokoll vermerkt).
4	Belegnummer	Text	(Ja)	-	Enthält die Belegnummer auf welche die Buchung durchgeführt werden soll. Kann MOS'aik keinen Vorgang zu der übergebenen Nummer ermitteln, wird automatisch - je nach Voreinstellung (siehe Import) - ein Vorgang angelegt (dies wird im Protokoll vermerkt).
5	Personal	Text	Nein	-	Die Personal(nummern) können unter dem Arbeitsblatt Stammdaten \| Personal \| Alle Mitarbeiter eingesehen und gepflegt werden. Alternativ kann an dieser Stelle auch der eindeutige Name aus den MOS'aik Stammdaten des Mitarbeiters übertragen werden. MOS'aik ermittelt beim Import automatisch, welches Feld für den Import angesprochen werden muss. Nicht vorhandene Mitarbeiter werden angelegt. Die automatische Anlage von Daten wird entsprechend im Importprotokoll vermerkt.
6	Artikelnummer	Text	(Ja)		Enthält die Artikelnummer des Materials. Handelt es sich um einen Eintrag vom Typ `M`, ist die Artikelnummer verpflichtend.
7	Ausführungsdatum	Datum	Ja	-	Enthält das Ausführungsdatum der Tätigkeit.
8	Arbeitsbeginn	Uhrzeit	Nein		Enthält den Arbeitsbeginn einer Buchung.
9	Arbeitsende	Uhrzeit	Nein		Enthält das Arbeitsende einer Buchung.
10	Lohnart	Text	Nein	-	Die Lohnart entspricht entweder dem Namen einer Lohnart oder deren Externnamen. MOS'aik ermittelt beim Import automatisch welches Feld für den Import angesprochen werden muss. Lohnarten können über das Arbeitsblatt Stammdaten \| Projekte \| Lohnarten eingesehen und gepflegt werden. Das Feld Externname wird zum Beispiel verwendet, um Ziffern statt Text zu übertragen. So kann die Lohnart <Normalstunden> zum Beispiel den Externnamen „0“ erhalten. Nicht vorhandene Lohnarten werden angelegt. Die automatische Anlage von Daten wird entsprechend im Importprotokoll vermerkt.
11	Lohnzuschlag		Nein		Enthält den zu verbuchenden Lohnzuschlag. Der Lohnzuschlag entspricht entweder dem Namen eines Lohnzuschlags oder dessen Externnamen. MOS'aik ermittelt beim Import automatisch, welches Feld für den Import angesprochen werden muss. Lohnzuschläge können über das Arbeitsblatt Stammdaten \| Projekte \| Lohntarife eingesehen und gepflegt werden. Das Feld Externname wird zum Beispiel verwendet, um Ziffern statt Text zu übertragen. So kann der Lohnzuschlag <Standard> zum Beispiel den Externnamen „0“ erhalten. Nicht vorhandene Lohnzuschläge werden angelegt. Die automatische Anlage von Daten wird entsprechend im Importprotokoll vermerkt.
12	Menge	Double	Nein		Enthält die Menge des Materials, welche verbucht werden soll.
13	Einheit	Text	Nein		Enthält die Einheit, mit welcher das Material verbucht werden soll.
14	Kostenstelle	Long Integer	Nein		Kostenstellen können in der MOS'aik-Finanzverwaltung über das Arbeitsblatt Stammdaten \| Kostenrechnung \| Kostenstellen eingesehen und gepflegt werden.
15	Feld1	Text	Nein		Zusätzliches Feld, dessen Mapping frei konfiguriert werden kann (siehe Abschnitt 3.2, „Registerkarte MOSImExport “).
16	Feld2	Text	Nein		Zusätzliches Feld, dessen Mapping frei konfiguriert werden kann (siehe Abschnitt 3.2, „Registerkarte MOSImExport “).
17	Feld3	Text	Nein		Zusätzliches Feld, dessen Mapping frei konfiguriert werden kann (siehe Abschnitt 3.2, „Registerkarte MOSImExport “).
18	Feld4	Text	Nein		Zusätzliches Feld, dessen Mapping frei konfiguriert werden kann (siehe Abschnitt 3.2, „Registerkarte MOSImExport “).
19	Modus	Text	Ja	`ALL` oder `DIF`	Entspricht dem Modus, mit welchem die Daten eingefügt werden sollen. Dabei werden zwei Modi unterstützt: `ALL` und `DIF` (siehe auch Abschnitt 5.1, „Differentieller und absoluter Import“).