en_ASRA_Joborder_File_Schnittstellenbeschreibung.pdf
(
144 KB
)
Pobierz
WIS/ASRA
Interface Description of the
ASRA Joborder Files
Document Version 3.0
Status: 09/2013
ASRA Joborder
Page 1 von 13
Change History
Document
Version
Status
Administrator
Changes
1.0
11.07.2011
Christine Huwig, GSP/OIP
christine.huwig@daimler.com
Complete revision of the document on
"WIS/ASRA net Joborder File Interface
Description" in view of the documents
"WIS 3.2 Joborder in XML v11.doc" and
"WIS 3.2: SAR Webparts Integration"
2.0
21.07.2011
Christine Huwig
Deletion of Sec. 1.3, with reference to
separate documentation
3.0
15.05.2013
Christine Huwig
Revision of chapters 1.2.8, 1.2.9, 1.2.9.1,
1.2.12.3, 1.2.12.4, 1.2.12.5;
new topic: parameter for overwritten
placeholders in operation texts
Status: 09/2013
ASRA Joborder
Page 2 von 13
Contents
1
ASRA Joborder File Interface Description .................................................................. 4
1.1
Definition................................................................................................................. 4
1.2
Interface Description............................................................................................... 4
2.2.1
Interface Type......................................................................................................... 4
2.2.2
Data Provision ........................................................................................................ 4
2.2.3
Application of the Data............................................................................................ 4
2.2.4
Data Scope ............................................................................................................. 4
2.2.5
Data Volume ........................................................................................................... 5
2.2.6
Data Flow ............................................................................................................... 5
2.2.7
Data Checks ........................................................................................................... 5
2.2.8
Memory Location and File Formats ........................................................................ 5
2.2.9
New File Format XML with New File Structure ....................................................... 6
2.2.9.1
Parameter for overwritten placeholders in operation texts..................................................................................6
2.2.10
Data Record Description for Record Formats (.txt, .utf, .ucs, .xfr) .......................... 6
2.2.11
Notes on Processing............................................................................................... 9
2.2.12
XML File Structure .................................................................................................. 9
2.2.12.1
File Structure ......................................................................................................................................................9
2.2.12.2
Header................................................................................................................................................................9
2.2.12.3
Operation item .................................................................................................................................................. 10
2.2.12.4
Example............................................................................................................................................................ 11
2.2.12.5
DTD .................................................................................................................................................................. 12
2.3
Joborder for Web-based Applications................................................................... 12
Status: 09/2013
ASRA Joborder
Page 3 von 13
1 ASRA Joborder File Interface Description
1.1
Definition
Description of the file interface between the ASRA module in the WIS/ASRA workshop information system and the Dealer
Management System (DMS) for transferring the ASRA operation items list.
ASRA
is the German abbreviation for work units, standard texts, flat rates and operation texts.
Daimler AG creates operation items for all repair operations that may be encountered in the workshop. The operation items
consist of operation texts and work units (concepts employed in Germany) or of standard texts and flat rates. The terms
"operation texts" and "standard texts" refer to the operation texts in operation items. The terms "work units" and "flat rates"
refer to time values. One work unit (WU) corresponds to 5 minutes, while the flat rates are specified in decimals of hours
(0.1 corresponds to 6 minutes).
ASRA is an electronic catalog of work units and flat rates that facilitates the fast and reliable search for operation items
and working hours.
The data determined with ASRA include the basis for
-
creating work orders with time allowed for the mechanic
-
invoice for services rendered by the mechanic
-
writing of invoice for the customer
-
warranty processing
-
preparation of cost estimates for customers
1.2
Interface Description
2.2.1
Interface Type
Combined communication and integration interface
2.2.2
Data Provision
The data are provided to the DMS on request by command call. The request occurs n times per workshop order or warranty
claim depending on the number of user calls.
Another use of the stored joborder file is that the user can save operation items lists in file form to a local folder, in order to
read and use them again as required.
2.2.3
Application of the Data
The requested data are stored in the calling commercial system in the workshop order or warranty claim.
2.2.4
Data Scope
The transfer file contains operation texts/standard texts with the corresponding work units/labor times, data on the vehicle
context and possibly other data stored in the ASRA operation items list, like customer requests, order numbers, warranty
codes, damage codes.
Status: 09/2013
ASRA Joborder
Page 4 von 13
2.2.5
Data Volume
The data volume is based on the number of the necessary items in the workshop order or warranty claim for filling the
customer order. It must be classified as low.
2.2.6
Data Flow
The DMS requests the data, and ASRA supplies the requested data in the joborder file. The data request occurs with the
ASRA command line call. The call interface is specified in the document EWANAPI Description.
2.2.7
Data Checks
None
2.2.8
Memory Location and File Formats
The joborder file is locally stored. The default path is C:\temp\MBCASE\joborder.
The individual joborder files are stored in the folder. This path can be overwritten using F2 (Options/Setup) or using the
EWANAPI call parameter ÏD. The default folder is ignored if the call parameter ÏD is used for transferring the file path
and the file name.
The name and format of the joborder file can be specified via the ASRA system preferences in the Setup, in the Save
dialog box in the ASRA operation items list or by the parameter transfer -D in the EWANAPI call from a calling system.
The extension of the file name determines the output format.
The following formats are supported:
Record format (for old file structure):
•
ASCII with extension
.txt
•
Unicode UTF8 with extension
.utf
•
Unicode UCS2 with extension
.ucs
•
XFR with extension
.xfr
XML format (for new file structure):
•
XML with extension
.xml
•
XML with extension
.x16
The choice of file format depends on how the joborder file is to be processed. This file serves the transfer of the contents
of the operation items list compiled in WIS/ASRA to a commercial system (DMS). The joborder file format is selected
depending on the language in question, on the input format expected by the commercial system and on whether the
warranty code and/or the parameter for overwritten placeholders in operation texts is also to be transferred.
Status: 09/2013
ASRA Joborder
Page 5 von 13
Plik z chomika:
ja1537
Inne pliki z tego folderu:
en_asra_data_spooler.pdf
(680 KB)
AdminToolGuide.htm
(42 KB)
en_damagecode_data_spooler.pdf
(283 KB)
en_ASRA_Joborder_File_Schnittstellenbeschreibung.pdf
(144 KB)
en_data_spooler_installation.pdf
(855 KB)
Inne foldery tego chomika:
de
Zgłoś jeśli
naruszono regulamin