1 WIS/ASRA net Joborder File Interface Description

1.1 ASRA

Arbeitswerte, Standardtexte, Richtzeiten, Arbeitstexte /
Work units, standard texts, flat rates, operation texts

1.2 Änderungshistorie/ Maintenance history

1.3 Verteilerliste / Distribution list

1.4 Synonym / synonym

Keines

none

1.5 Definition/ definition

Schnittstelle zwischen Händlersystem (DMS) und dem ASRA-Retrievalystem. ASRA steht für Arbeitswerte, Standardtexte, Richtzeiten und Arbeitstexte. Mit diesem System werden die genannten Daten verwaltet und für andere Systeme bzw. für Informationszwecke bereitgestellt. Das ASRA-Retrievalsystem enthält außerdem, sofern die entsprechenden Daten eingespeichert werden, eine Referenz zu(r) Schadensnummer(n) in Abhängigkeit von Arbeitspositionen.

Interface between dealer management system (DMS) and ASRA retrieval system. ASRA stands for 'Working units, standard texts, flat rates and operation texts'. This system is used to maintain the data listed above and make them available to other systems for information. In a further expansion phase, the ASRA retrieval system does include the reference from (the) damage number(s) according to operation items in case the data are delivered.

1.6 Erweiterte Definition/ extended definition

Der Begriff ‘Arbeitstexte’ ist gleichzusetzen mit dem Begriff ‘Standardtexte’. Der Begriff ‘Arbeitstexte’ wird in deutschsprachigen Ländern verwendet, während der Begriff ‘Standardtexte’ in anderen Ländern benutzt wird.

Der Begriff ‘Arbeitswerte’ entspricht dem Begriff ‘Richtzeiten’. Die Arbeitswerte (AW) werden in Einheiten angegeben (ein AW entspricht 5 Minuten), die Richtzeiten werden in Minuten, bzw. zehntel Dezimalstunden angegeben. Der Begriff ‘Arbeitswerte’ wird in deutschsprachigen Ländern verwendet, während der Begriff ‘Richtzeiten’ in anderen Ländern benutzt wird.

The German term ‘Arbeitstexte’ ('operation texts') is equivalent to the term ‘standard texts’. The term ‘Arbeitstexte’ is used in the Germanic countries, whereas the term 'standard texts' is used in other countries.

The term ‘work units’ is equivalent to the term ‘flat rates’. The work units (AW) are specified in units (one AW equals five minutes), the flat rates are specified in minutes of tenths of decimal hours. The term ‘work units’ is used in Germanic countries, whereas the term ‘flat rates’ is used in other countries.

Die Nutzung der Arbeitswerte-/Richtzeitenunterlagen greifen in / The documentation on the work units/flat rates is used:

• Auftragserstellung mit Zeitvorgabe für den Mechaniker / to generate a job including time limit for the mechanic
• Leistungsabrechnung für den Mechaniker / to quantify the work completed by the mechanic
• Rechnungsschreibung an Kunden / for customer invoicing
• Garantieabwicklung zwischen Händler und VG (MLC) / for warranty processing between dealership and sales company (MLC)
• Kostenvoranschlägen für den Kunden / to generate cost estimates for customer
• Auswertungen z. Bsp. SMIS (Service Market Information System) / evaluations, e.g. SMIS

1.7 Schnittstellentyp / interface type

Kombinierte Kommunikations- und Integrationsschnittstelle / combined communication and integration interface

1.7.1 Einbindung der Daten im DMS (Dealer Management System)/
incorporation of data in DMS

Einbindung der Daten im IMS (Importeur Management System) /
incorporation of data in IMS (importer management system)

(Zusätzlich zur Anbindung an DMS) / (in addition to the DMS incorporation)

1.7.2 Datenbereitstellung / delivery of data

Die Daten werden dem DMS bei Anforderung durch Maus-click bzw. Befehlsaufruf zur Verfügung gestellt. Die Anforderung geschieht maximal n-mal pro Werkstattauftrag bzw. Garantieantrag in Abhängigkeit der Anzahl Benutzeraufrufe.

Die Daten können auch aus Informationsgründen angefordert werden.

Eine genaue Beschreibung der Schnittstellenbedienung ist der Beschreibung "Pflichtenheft mit Ablaufbeschreibung für ASRA-Funktionalität im WIS-Release G.04.00", erstellt von VSE/IP, zu entnehmen.

The data are made available to the DMS upon request by mouse-clicking or by command call. Depending on the number of operation items, the request is made n-times (maximum) per workshop order or warranty claim.

The data can also be requested for information.

For detailed operating instructions for the interface see the description "Specifications with Process Description for ASRA Functionality in WIS Release G.04.00", written by VSE/IP.

1.7.3 Übernahme der Daten / integration of data

Die angeforderten Daten werden im Werkstattauftrag bzw. Garantieantrag abgelegt.

The requested data are copied into the workshop order or the warranty claim.

1.7.4 Datenumfang / contents of data

Arbeitstexte/Standardtexte mit den entsprechenden Arbeitswerten/Arbeitszeiten und Schadennummer entweder aus WIS oder via Relationendatei. VEGA Relationen werden zur Zeit noch nicht eingespeist. Es können auch Kundenanliegen als Textzeilen vorliegen.

Operation texts/standard texts with corresponding work units/working times and damage number either from WIS or via relational file. Also customer requests as text lines could exist.

1.7.5 Datenvolumen / volume of data

Das Datenvolumen richtet sich nach der Anzahl der notwendigen Positionen im Werkstattauftrag bzw. Garantieantrag zur Ableistung des Kundenauftrages. Er ist als gering einzustufen.

The volume of data depends on the number of items on the workshop order or the warranty claim in order to fulfill the customer's requests, but is rather low in general.

1.7.6 Datenfluß / data flow

Das DMS fordert die Daten an, ASRA liefert die angeforderten Daten. Die Datenanforderung geschieht mit dem ASRA Kommandozeilenaufruf, geliefert wird der JOBORDER.DAT Datensatz.

The DMS requests the data, and ASRA delivers the requested data. The data request is generated by the ARSA call function; the data are delivered as part of the JOBORDER.DAT record.

1.7.7 Datenprüfungen / validation of data

keine
none

1.7.8 Besonderheiten, Hinweise / special features, notes

Ab Version 8.0 mit WIS Release G.04 wird die Datei JOBORDER.DAT in einem dediziertem Verzeichnis auf dem WIS Server gespeichert. Grund dafür ist die neue Speicher/Ladefunktion in ASRA Retrieval. Das Verzeichnis heißt:
/opt/MBCASE/wis/ASRA/clientname/
Darin werden dann die einzelnen Joborders gespeichert. Der Name der Joborderdatei kann über die ASRA Systemeinstellungen bestimmt werden. Die Endung des Speichernamens entscheidet über das Ausgabeformat. Folgende Formate werden unterstützt:
UTF8 mit Endung .utf
UCS2 mit Endung .ucs
ASCII mit Endung .txt

Bei Verwendung des Aufrufparameter -D Dateiname wird das festgelegte Speicherverzeichnis ignoriert.

Starting with version 8.0 with WIS release G.04 the file JOBORDER.DAT will be stored in a specific directory on the WIS server. Reason for that is the new SAVE/LOAD function of the ASRA Retrieval system. The directory's name is:
/opt/MBCASE/wis/ASRA/clientname/
Therein the joborder files will be stored. The name of the joborder file can be defined via the ASRA system properties. The appendix of the jobrder file name is responsable for the output format. Following formats are supported:
UTF8 with appendix .utf
UCS2 with appendix .ucs
ASCII with appendix .txt

In case of usage of the call parameter -D file name the default values for the directories will be ignored.

1.7.9 Externer Aufruf / external call

ASRA Retrieval kann via qualifiziertem Einstieg direkt gestartet werden. Es werden verschiedene Aufrufe unterschieden.

Syntax:(bis Version 7.3 mit WIS Release G.03)

wis(api).exe -ASRA -WMC <WHC> [-T <TypBaumuster>] [-L <Lenkung/Werk>] [-P <Produktionszahl>] [-S<Sparte>] [-F<Familie>] [-TK<Typkennzahl>] [-A<Arbpos>]

Syntax:(ab Version 8.0 mit WIS Release G.04)

wis(api).exe -ASRA [-Background] [-WMC <WMC>] [[[-T <TypBM>] [-L <Lenkung/Werk>]] [-P <Produktionszahl>]] [-AN Auftragsnummer]
[-A ArbPosNr]] [-D <Dateiname>] [-err <Fehlerdatei>]

Mit diesem Aufruf wird ASRA direkt gestartet und in den Vordergrund gebracht, sofern der Parameter <Background> nicht verwendet wurde.

ASRA Retrieval can be started directly by qualified calls. There are multiple calls differenciated.

Syntax:(until version 7.3 under WIS release G.03)

wis(api).exe -ASRA -WMC <world manufacturer code> {-T <model baumuster> -L <steering/factory> -P<production number> -S<group> -F<family> -TK<type code> -A<operation item>}

Syntax:(starting from version 8.0 with WIS Release G.04)

wis(api).exe -ASRA [-Background] [-WMC <WMC>] [[[-T <model baumuster>] [-L <steering/factory>]] [-P <productionnumber>]] [-AN ordernumber]
[-A labour number]] [-D <joborder file name>] [-err <error file name>]

With that call ASRA will be started directly in the foreground, if parameter <Background> is not used.

1.7.10 Beispiele für qualifizierten ASRA Aufruf / Examples of a qualified ASRA call :

wis(api).exe -ASRA -WMC WDB -T 202080 -L 1F -P 792879

oder/or (--> Version 7.3)

wis(api).exe -ASRA -S 00 -F 12 -TK 52 -A 001100

oder/or (Version 8.0 -->)

wis(api).exe -ASRA -WMC WDB -T 210017 -L 1A -P 123456 -A 421050 -D C:\temp\jobtest.txt -err C:\temp\errtest.txt

Nach <Zurück> findet sich unter C:\temp eine Joborder-Datei "jobtest.txt" und eine Datei "errtest.txt", die neben dem Aufrufprotokoll auch den Rückgabewert enthält (in diesem Fall: 0). Wird der ‘-D’-Parameter nicht angegeben, erfolgt eine Rückfrage an den Anwender bzgl. des Joborder-Namens im Client Verzeichnis des WIS Servers.
After <Back> there will be in the directory C:\temp a joborder file "jobtest.txt" and a file "errtest.txt", which contents is beside the call parameters also the return values (in that case: 0). If the ‘-D’ parameter is not specified, the user will be asked for the joborder file name in the client directory of the WIS server before saving.

Eine detaillierte Beschreibung kann der Beschreibung EWANAPI Descriptionentnommen werden. /
A detailed description can be read in the description EWANAPI Description.

1.7.11 Erläuterung Kommandozeilenaufruf / Explanation call function

Bei erfolglosem Aufruf werden entsprechende Nachrichten über return codes zurückgegeben. Diese sind entsprechend der bereits vorhandenen WIS Aufruffunktion spezifiziert und im Dokument EWANAPI Description beschrieben.

If the call fails, corresponding messages are returned via return codes. These codes are similar to the WIS return codes and are described in the document EWANAPI Description.

Wird der Call anstatt mit wis.exe mit wisapi.exe abgesetzt, dann wird ein laufender WIS Prozess zurückgestzt und wieder neu aufgesetzt. Bei wis.exe werden bis zu maximal 3 WIS Applikationen gestartet.

1.7.12 Datensatzbeschreibung / description of records

Quelle: Dokument "Pflichtenheft mit Ablaufbeschreibung für ASRA-Funktionalität im WIS-Release G.02.00 Version 1.1" vom 11.2.1998.

Source: Document "Specifications with Process Description for ASRA Functionality in WIS Release G.02.00 Version 1.1", dated Feb. 11, 1998.

Die einzelnen Felder der Ausgabedatei werden immer in einem neuen Satz geschrieben. Das bedeutet, daß pro Satzart immer gleiche Anzahl Zeilen ausgegeben werden müssen und nicht füllbare Felder als Leerzeile auszugeben sind.

Each single field is always written into a new line into the output file. This means that per record type always same number of lines must be created and invalid fields must create a blank line.

Verarbeitet werden Datensätze mit folgendem Inhalt / Records with the following contents are processed:

1.7.13 Hinweise zur Verarbeitung:

Die JOBORDER.DAT ist nur dann zu erstellen, wenn mindestens eine Arbeitsposition ausgewählt und in die Arb-Pos-Liste übernommen wurde. In der JOBORDER.DAT müssen die Satzarten 01 und 03 grundsätzlich vorhanden sein. Die Satzarten 02 und 04 werden optional beigefügt. Die Datei endet mit dem Eintrag '#joborder complete#'.

Die Reihenfolge der Arbeitspositionen entspricht der letzten in der Arb-Pos-Liste. Grundsätzlich ist die Satzart 01 am Anfang und nur einmal vorhanden. Alle anderen Satzarten können mehrmals in unterschiedlicher Reihenfolge vorkommen. Im Normalfall steht die Satzart 02 vor den dazugehörigen Positionssätzen mit SA 03. Sollte zu einem Positionssatz 03 ein Schadensschlüsselsatz mit SA 04 vorhanden sein, wird dieser im Anschluß geschrieben.

1.7.14 Notes on processing:

The JOBORDER.DAT file has to be created only if at least one operation item was selected and copied to the item list. Record types 01 and 03 must always be present in this file. Record types 02 and 04 are optional. The file ends with '#joborder complete#'.

The sequence of the operation items is corresponding to the sequence of the last item list. Record type 01 (order header ) must be present only once and must be the first record of the JOBORDER.DAT file. All other record types can exist several times and in varying sequences. Usually record type 02 precedes all related items with SA 03. If there is a record type 04 (damage code) belonging to a record type 03 (operation item), the record type 04 is stored behind the record type 03.