1 EWANAPI Descriptions / Examples of DMS Calls

Daimler AG

2 Table of Contents

1 EWANAPI Descriptions / Examples of DMS Calls

2 Table of Contents

3 Introduction

3.1 History

3.2 Files

3.3 Interface expansion

3.4 Direct return codes of EWANAPI

4 WIS net call interface

4.1 Determination of damage code

4.1.1 Objective

4.1.2 Parameters

4.1.3 Boundary conditions

4.1.4 Output

4.1.5 Example

4.2 Document display

4.2.1 Objective

4.2.2 Parameters

4.2.3 Boundary conditions

4.2.4 Output

4.2.5 Examples

5 ASRA net call interface

5.1 Objective

5.2 Parameters

5.3 Boundary conditions

5.4 Output

5.5 Examples

6 ASSYST net call interface

6.1 Without background call

6.1.1 Objective

6.1.2 Parameters

6.1.3 Boundary conditions

6.1.4 Output

6.1.5 Examples

6.2 WIS ASSYST Call

6.2.1 Objective

6.2.2 Parameters

6.2.3 Output

6.2.4 Boundary conditions

6.2.5 Examples

7 EPC net call interface

7.1 EPC Navigate Call

7.1.1 Objective

7.1.2 Parameters

7.2 Examples

7.3 EPC Search Part Call

7.3.1 Objective

7.3.2 Parameters

7.4 Examples

3 Introduction

3.1 History

This document describes the call interface in the EWA net project. Here, the existing "WISAPI" interface for the "classic" WIS product was used as a basis to define an interface allowing the "WIS/ASRA/EPC net" applications to be called up in a way that is very compatible to that of the previous concepts in the "classic" world. Even more it has been extended subsequently and now allows also some control over the EPC net client.

Significant stages of development were:

• Integration in the Web-based EWA net environment
• Adherence to core compatibility of the existing WISAPI interface
• Expansion of the call interface to communicate with parts application EPC net

This document focuses on merging the following two files:

• "direktg0602_aufrufschnittstelle_wisapi.doc"
• "EWA-Net-DMS-API-1.10.doc"

The technical details have been removed so that the document basically can be used as an external call reference.

3.2 Files

Standard Installations (“Local” and “Central”):

The following files comprise the installation of the call interface in a standard environment (“local” or “central”):

ewanapi.exe

ewanapi.ini

hpwin32.dll

wisapi.exe

ewanapi.jar

Standalone Installation:

When installed by the WIS net standalone installer (i.e. in the STAR DIAGNOSIS environment) following files comprise the installation, but the call interface on the command line is exactly the same:

ewanapi.exe

ewanapi.ini

hpwin32.dll

wisapi.exe

ewanapi.jar

ewanapi.config

wisapi.config

External Java EWANAPI Interface:

System integrators who want to make use of a more tight EWA net integration via EWANAPI may want to make use of the EWANAPI Java API which is provided within the file ewanapi.jar on the official delivery DVD of EWA net. The file can be found in the directory[DVD]:\ewa\Apps_sd\ewanapi_sd\application. Additional technical developer documentation can be requested from the EWA net product management team.

3.3 Interface expansion

In general, the call interface had to be expanded to include the following parameters - all of them are optional, but typically the credential information might be needed to authenticate against a given EWA net application server:

-application

WIS-Net

EPC-Net

-application EPC-Net

-userid

-userid stollms

-userdomain

-userdomain localworkshop

-userpwd

-userpwd password

-triggername

-triggername kerridge_pipe_15

-debug

-debug

-debug C:\EWANAPI.log

-locale

-locale de_DE

These parameters are always specified in the following calls.

3.4 Direct return codes of EWANAPI

EWANAPI forwards the business request to the correct client application which is responsible to evaluate the call and react correctly. In case of errors or incomplete or even wrong commandlines the clients write error codes into an error file - if an error file has been specified.

But there are cases when EWANAPI cannot even handle the call. In this case it returns specific error codes to the calling application. In a command line you may react on this reading the Windows %errorlevel% command line variable. Within application code the process will return the given code. Following error codes exist:

4 WIS net call interface

4.1 Determination of damage code

4.1.1 Objective

The WIS damage code module can be directly called up from a command line. The code determined is written to a file.

4.1.2 Parameters

The syntax for calling up WIS net to determine a damage code is as follows:

ewanapi[1] -S <filename>  -t <Model>  [-F <FGR>  [-f <FUG>]] 
          [-damagedpart <damagedpart> [-damageid <damageid>] [-damagetype <damagetype>] [-repairtype <repairtype>]]
          [-err <filename>]
              -application WIS-Net
              -userid <your_userid> 
              -userpwd <your_passwd> 
              -userdomain <your_domain>

The parameters in detail:

-S

-S C:/tmp/ssl.txt

-t

-t 202018

-F

-F 10

-f

-f  30

-damageid

-damageid 1

-damagedpart

-damagedpart 54148

-damagetype

-damagetype 78

-repairtype

-repairtype 7

-err

-err C:/tmp/error.txt

4.1.3 Boundary conditions

• The sequence of the parameters given above is definitive.
• If the file name for saving the damage code is missing, the file cannot be opened for writing, or an invalid model is given, the program quits with an error code. In the case of an error, the error code is also generally written to the transfer file.
  

  In the case of an error, the transfer file contains the text

  ERROR:<Error code>
  

  The error code can have the following values:

  • 0: no error[2]
  • 1: Missing output file or output file to which it is not possible to write
  • 2: Missing or incorrect model
  • 3: No access authorization or missing connection to the access authorization manager
• If valid values for the file name and model have been transferred, the system starts immediately with the Damage code 1 screen. If a valid function group and subgroup have been given, these are preselected. Following the selection of the damage code images, the user can change to the Damage code 2 screen. Using the F2 function button (document functions), it is possible to switch between screens.

4.1.4 Output

If a complete damage code has been determined, then on Quit, this key is saved in the output file. In this way the last completely determined damage code is valid. The format of the file is as follows:

            
Damage_identification_designation_type_of_damage_type_of_repair

whereby the damage identification can have the value 0 (for original equipment fit) and 1 (for replacement part/replacement unit). The identification is a 5-digit code and describes the component (e.g. 05212: inner valve spring). The damage type is represented by a 2-digit code (e.g. 06: broken), the repair type by a one-digit code (e.g. 1: replace unit). All values are separated by a space. As soon as the Damage code 1 screen is left using the F8 button (End), the MB-WIS quits.

4.1.5 Example

1. ewanapi -S C:\temp\key.txt -t 210035 -F 42 -f 30 -err C:\temp\error.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   The "Damage code 1" screen appears. The function group 42.30 (ABS) is preselected. Following selection of an image title, the "Determine damage code" button becomes activated. This takes the user to the "Damage code 2" screen, where - following the selection of the component, the type of damage, the damage identification and the type of repair - the damage code is displayed. At the same time the "Apply" button becomes activated; this button is used to select the damage code. After returning to "Damage code 1" using the "Back" button and quitting the application, the following entry is to be found in C:\temp\key.txt:
   

   0 03203 06 7

   i.e., the connecting rod bolt (03203) is broken (06). This is a replacement of original equipment (0), whereby repair using material (07) is necessary.
    

2. ewanapi -S C:\temp\key.txt  -t 210  -F 42  -f 30 –err C:\temp\error.txt -application WIS-Net -userid stollms -userpwd 478967895 –userdomain sampledomain

   Error code 2 is output to the error file, as there is no 6-digit model designation available; as such, it is not possible to determine the damage code.

4.2 Document display

4.2.1 Objective

The specified document is displayed in (and optionally printed from) the WIS net "Document display". It is also possible to prepare a document search, i.e. to open "Infothek 1" or "Infothek 2".

4.2.2 Parameters

The following calls are supported:

1. ewanapi -D
      ((-t <type_model_designation> [-m <engine_model_designation>] [-a <major_assembly_model_designation_1>,..,<major_assembly_model_designation_n>])      
    | ([-t  <type_model_designation>] -m <engine_model_designation> [-a <major_assembly_model_designation_1>,..,<major_assembly_model_designation_n>]) 
    | ([-t <type_model_designation>] [-m <engine_model_designation>] -a <major_assembly_model_designation_1> [,..,<major_assembly_model_designation_n>]))
       [-f <function_group_1>,..,<function_group_n>] 
       [-i <info_type_1>,..,<info_type_n>]  
       [-s <KD logic>] [-err <filename>] [-Z]
       [-p]        
                 -application WIS-Net
                 -userid <your_userid> 
                 -userpwd <your_passwd> 
                 -userdomain <your_domain>

2. ewanapi -D -V <VIN>
         [-f <function_group_1>,..,<function_group_n>]
         [-i <info_type_1>,..,<info_type_n>]
         [-s <KD_logic>]   [-err <filename>] [-Z] 
         [-p]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

3. ewanapi -D <doc._no._1>[,..,<doc._no._n>] [-Z] [-T 1] 
          [-p]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

4. ewanapi [–T <vehicle_type>] -t <type_model_designation> [-m <engine_model_designation> -a  <major_assembly_model_designation>] 
         –A <WU_number> [-err <filename>]
         [-p]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

5. ewanapi -D -V <VIN> -A <WU_number> [-err <filename>] 
           [-p]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

If the document search only produces one hit, i.e. only one document is found, then this is displayed immediately.

The parameters for calls 1 to 3 (for variant 4 see below) in detail are:

-D

-D BB0040P012500A

-V

-V WDB2102171A354643

-t

-t 202018 

-m

-m 611961

-a

-a 722613,768002

-f

-f 00,20.10

-i

-i 2,3,4

-s

-s 0

-Z

-Z

-T

-T 1

-p

-p

-err

-err C:/tmp/error.txt

Overview of supported infotype values:

Parameters for variant 4 (document search with WU value) in detail:

-T

-T 1

-t

-t 202018

-m

-m 102921

-a

-a 760700

-A

-A 421050

-p

-p

-err

-err C:/tmp/error.txt

Parameters for variant 5 (document search with WU value and VIN) in detail:

-V

-V WDB2102171A354643

-A

-A 421050

-Z

-Z

-p

-p

-err

-err C:/tmp/error.txt

4.2.3 Boundary conditions

1. The two parameters "-D" are used for starting the document search. If there are no other parameters after this but another character, then this is interpreted as a document number.
2. The number of parameters after the options "-f" and "-I" is limited to 20.
3. Only 6-digit models are accepted.
4. The parameters for the call are to be arranged according to the various possibilities. A mixture between a document search with document number, or, e.g., with function groups and info. types, or with a WU search is not allowed. It is currently known that WIS net may not generate an error file in such cases.
5. The parameter "-s" is, similar to WIS net (Infothek-1), only activated in the case of the complete entry of the VIN. Otherwise the parameter has no effect.
6. In the case of lists in parameters (e.g. several information types, function groups or documents), it is not allowed to use spaces (e.g. –i 1,2); alternately the entire character string must be placed in quotation marks (e.g. –i "1, 2").
7. In call 3 the parameter –T 1 can also be set; however in this case this parameter is ignored.
8. In call 5, no info. types or function groups may be entered.

4.2.4 Output

The return values for these calls are:

• 0:  No error (that is all call parameters correct)
• -1: No access authorization
• -2: Invalid call parameters
• -3: Document not found

4.2.5 Examples

1. ewanapi –D si0000p0005c  -application WIS-Net -userid stollms -userpwd 478967895 –userdomain sampledomain

   The document with number Si00.00-P-005C is displayed.

2. ewanapi –D si0000p0005c -p -application WIS-Net -userid stollms -userpwd 478967895 –userdomain sampledomain

   The document with number Si00.00-P-005C is displayed and printed to the default printer.

3. ewanapi –T 1 –t 210217 –A 421050 -application WIS-Net -userid stollms -userpwd 478967895 –userdomain sampledomain

   A selection of documents with operation number 42-1050 that correspond to model designation 210.217 is shown.

4. ewanapi -D -V WDB2020181L0000 -A 421050 -err C:\err.txt -application WIS-Net -userid stollms -userpwd 478967895 –userdomain sampledomain

   A selection of documents with operation number 42-1050 that correspond to VIN WDB2020181L0000 is shown. Error messages are saved to the C:\err.txt file.

5 ASRA net call interface

5.1 Objective

Activation of the ASRA retrieval system.

5.2 Parameters

Numerous combinations of parameters are supported:

ewanapi[3] –ASRA  [-Background]  [-V <VIN>] [–WMC <WMC>]  
               [  [[-T <type_model_designation>]  [-M <engine_model_designation>] [-L <steering/plant>]]  [-P <production_number>]  ]
               [–A <operation_position_number>[,operation_position_number,...]] [-AN order_number] ]  [-D <filename>] [-err <error_file>]
              -application WIS-Net
              -userid <your_userid>
              -userpwd <your_passwd>
              -userdomain <your_domain>

-ASRA

-Background

-WMC

-WMC WDB

-V

-V WDB2102171A354643

-T

-T 202018

-M

-M 111920

-L

-L 1a

-P

-P 123456

-A

-A 421050,421060

-AN

-AN 12xx34

-D

-D C:/tmp/liste.txt

-err

-err C:/tmp/error.txt

5.3 Boundary conditions

• The sequence of the parameters given above is definitive.
  
  
• The command line call is error tolerant, i.e. even with invalid entries the system starts as a rule. The following combinations are expressly not accepted by the system, i.e. the system does not start:
  
  • Entry of the steering/plant parameter without model designation
  • Entry of a production number without vehicle
• For further information on combinations of parameters that are allowed and useful, you are referred to the examples given.
• For the background call the following applies: If an operation number is given for which additional work exists, this is not taken into account on the creation of the job order file.
• A complete WIS net access authorization is required for calling up WIS from the command line.

5.4 Output

The error codes for these calls are:

The error field in the job order file can be filled with the following values:

5.5 Examples

1. ewanapi -ASRA -T 210017 -L 1A -P 123456 -A 421050 -D C:\jobtest.txt -err C:\errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   After the call, folder C:\ contains a job order file "jobtest.txt" and a file "errtest.txt", which also contains in addition to the call log, the return value (in this case: 0). If the ‘-D’ parameter is not given, the user is prompted for the job order name.

2. ewanapi -ASRA -T 202018 -M 111920 -L 1A -P 123456 -A 421050 -D C:\jobtest.txt -err C:\errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   After the call, folder C:\ contains a job order file "jobtest.txt" and a file "errtest.txt", which also contains in addition to the call log, the return value (in this case: 0). If the ‘-D’ parameter is not given, the user is prompted for the job order name.

3. ewanapi -ASRA -Background -T 210017 -L 1A -P 123456 -A 421050 -D C:\jobtest.txt -err C:\errtest.txt

   The same case as in 2., but there is no interaction with the user (background call).

4. ewanapi -ASRA -T 202018 -A 00 -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   The "ASRA vehicle determination" screen appears with specified vehicle context. For the design group "00" (service) is preselected and the design group table of contents indicates the appropriate subgroups.

5. ewanapi -ASRA -T 21002 -AN 1000ab -D C:\jobtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   A popup screen appears for selecting a model designation. Caution: The order number is not applied in the context, because the vehicle was not completely specified in the call. After <Back>, no job order file is written. If operation items are subsequently selected, a job order with the name given is written when the application quits.
6. (Invalidate access authorization)
   

   ewanapi -ASRA -T 202018 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   Error code "-1" is generated.

7. ewanapi -ASRA -WMC abc -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   Error code "-101" is generated.

8. ewanapi -ASRA -T 123456 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   Error code "-102" is generated.

9. ewanapi -ASRA -T 12 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   Error code "-103" is generated.

10. ewanapi -ASRA -T 202018 -L 1 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-104" is generated.

11. ewanapi -ASRA -T 202018 -L 1a -P 12 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-105" is generated.

12. ewanapi -ASRA -T 202018 -L 1a -P 123456 -A 00100 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-109" is generated.

13. ewanapi -ASRA -T 202018 -L 1a -P 123456 -A 001055 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-110" is generated.

14. ewanapi -ASRA -WMC WDB -P 123456 -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-111" is generated.
15. (Activate "WIS without ASRA” access authorization)
    

    ewanapi -ASRA -D jobtest.txt -err errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-112" is generated.

16. ewanapi -ASRA -Background -T 220 -D jobtest.txt -err errtest.txt

    Error code "-115" is generated.

17. ewanapi -ASRA -T 210017 -M 123456 -L 1A -P 123456 -A 421050 -D C:\jobtest.txt -err C:\errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-106" is generated.

18. ewanapi -ASRA -T 210017 -M 123 -L 1A -P 123456 -A 421050 -D C:\jobtest.txt -err C:\errtest.txt -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

    Error code "-106" is generated.

6 ASSYST net call interface

6.1 Without background call

6.1.1 Objective

Activation of the ASSYST retrieval system.

6.1.2 Parameters

Numerous combinations of parameters are supported:

1. ewanapi[4] -ASSYST -V <FIN> [-s <service_code>] [-w <workshop_code>]
                 [-K <customer_name>] [-A <order_number>]
                 ( [-k <current_km_reading>] | [-M <current_mileage_reading] )
                 [-r <correctness_service_supervisor>] [-f <completion_date>]
                 [-v <type_of_oil/viscosity>] [-d <dialog_acceptance>]
                 [-h <notes>] [-D <job_order_filename>] [-err <filename>]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

2. ewanapi[5]  -ASSYST -t <type_model_designation> -m <engine_model_designation> [-s <service_code>] [-w <workshop_code>]
                 [-S <special_equipment_code>] [-K <customer_name>] [-A <order_number>]
                 ( [-k <current_km_reading>] | [-M <current_mileage_reading] )
                 [-r <correctness_service_supervisor>] [-f <completion_date>]
                 [-v <type_of_oil/viscosity>] [-d <dialog_acceptance>]
                 [-h <notes>] [-D <job_order_filename>] [-err <filename>]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

The parameters for call a. in detail:

-V

-V WDB2102171A354643

-s

-s A+

-w

-w 24E

-K

-K "John Smith"

-A

-A 12345

-k

-k 25000

-M

-M 12000

-r

-r "John Smith"

-f

-f  01.12.2001

-v

-v "SAE 15/40"

-d

-d 1

-h

-h "This is a note"

-D

-D C:/tmp/liste.txt

-err

-err C:/tmp/error.txt

The parameters for call b. in detail:

-t

-t 202018

-m

-m 102921

-s

-s A+

-w

-w 24E

-S

-S 850a

-K

-K "John Smith"

-A

-A 12345

-k

-k 25000

-M

-M 12000

-r

-r "John Smith"

-f

-f  01.12.2001

-v

-v "SAE 15/40"

-d

-d 1

-h

-h "This is a note"

-D

-D C:/tmp/liste.txt

-err

-err C:/tmp/error.txt

6.1.3 Boundary conditions

• If the VIN cannot be resolved by EPC into a model type and an engine model, then "Infothek 1" appears with the maximum possible preselection.
• Only 6-digit type/engine models are accepted.
• If the model type designation is not unambiguous, then the vehicle type selection appears with the screen "Infothek 1".
• If the engine model designation is incorrect or not contained in the database, then the "Infothek 1" screen also appears for the selection of an engine model designation.
• Either km or miles is entered. On the entry of both values, the mileage figure is ignored.

6.1.4 Output

The error codes for these calls are:

6.1.5 Examples

1. ewanapi -ASSYST -t 210020 -m 123456 -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   The "Infothek 1" screen appears with an empty engine model designation table.

2. ewanapi -ASSYST -t 211004 -m 646951 -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   The "ASSYST" screen appears with preselected "With service processor".

3. ewanapi -ASSYST -t 211004 -m 646951 -k 30000 -w 4g3p -application WIS-Net -userid stollms -userpwd 478967895 -userdomain sampledomain

   The "ASSYST" screen appears with completed "Current km reading" and "Workshop code" fields. The "Next" button is activated.

6.2 WIS ASSYST Call

6.2.1 Objective

Activation of the service retrieval system in the background. The service sheet is printed automatically using the default printer in the MS Windows operating system. In addition, the job order file is written automatically.

It is to be noted that the background call is only to be used for vehicles with ASSYST-PLUS (service processor with workshop code). For this reason the workshop code is also a "mandatory" entry. The reason is: only with a workshop code can the additional work be determined without user interaction. In all other cases, as a rule, user interaction is unavoidable, and as a result a background call is then no longer meaningful.

6.2.2 Parameters

The following combinations of parameters are supported:

1. ewanapi[6] -ASSYST -Background -V <VIN> [-s <service_code>] -w <workshop_code>
                ( -k <current_km_reading> | -M <current_mileage_reading])
                 [-p] [-K <customer_name>] [-A <order_number>]
                 ( [-k <current_km_reading>] | [-M <current_mileage_reading] )
                 [-r <correctness_service_supervisor>] [-f <completion_date>]
                 [-v <type_of_oil/viscosity>] [-d <dialog_acceptance>]
                 [-h <notes>] [-D <filename>] [-err <filename>]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

2. ewanapi[7] -ASSYST -Background -t <type_model_designation> -m <engine_model_designation> [-s <service_code>]  -w <workshop_code>
                 ( -k <current_km_level> | -M <current_mileage_level])
                 [-p] [-S <special_equipment_code>] [-K <customer_name>] [-A <order_number>]
                 [-r <correctness_service_supervisor>] [-f <completion_date>]
                 [-v <type_of_oil/viscosity>] [-d <dialog_acceptance>]
                 [-h <notes>] [-D <filename>] [-err <filename>]
                 -application WIS-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

The parameters for call a. in detail:

-Background

-V

-V WDB2102171A354643

-s

-s A+

-w

-w 24E

-p

-p

-K

-K "John Smith"

-A

-A 12345

-k

-k 25000

-M

-M 12000

-r

-r "John Smith"

-f

-f  01.12.2001

-v

-v "SAE 15/40"

-d

-d 1

-h

-h "This is a note"

-D

-D C:/tmp/liste.txt

-err

-err C:/tmp/error.txt

The parameters for call b. in detail:

-Background

-t

-t 202018

-m

-m 102921

-s

-s A+

-w

-w 24E

-p

-p

-S

-S 850a

-K

-K "John Smith"

-A

-A 12345

-k

-k 25000

-M

-M 12000

-r

-r "John Smith"

-f

-f  01.12.2001

-v

-v "SAE 15/40"

-d

-d 1

-h

-h "This is a note"

-D

-D C:/tmp/liste.txt

-err

-err C:/tmp/error.txt

6.2.3 Output

The error codes for these calls are (similar to ASRA background call):

The error code -2 signifies "invalid call parameter". For ASSYST this also includes model type designation or model type designation and engine model designation combinations that do not have "ASSYST PLUS". Thus, if e.g. a workshop code is entered and the model type does not have ASSYST-PLUS, WIS also quits with error code -2.

The error field in the job order file can be filled with the following values:

6.2.4 Boundary conditions

• To prevent overflow of the files in the file system, the DMS should always use the same name for the command line call. The WIS overwrites an existing file without a prompt. The WIS system cannot decide how long a file is needed and is thus not responsible for the number of files or their deletion.
• No user interface is displayed.
• A printer dialog box does not appear; thus the default printer is used.
• The vehicle context is unambiguous (that is, e.g., by means of the entry of a VIN and EPC link).
• The workshop code is entered correctly, i.e. without a workshop code this background call is not possible.
• The additional work is completely defined with the vehicle code, i.e. manual addition of further additional work is not possible.
• The current kilometer reading has been entered (is a mandatory field in Service).
• File name and extension are transferred by means of call parameters. In this way the code for the file is defined.
• Either km or miles is entered. On the entry of both values, the mileage figure is ignored.
• For the background call the following applies: If an operation number is given for which additional work exists, this is not taken into account on the creation of the job order file.
• If an ambiguous model type has been entered, then only an error code is output. A vehicle type selection dialog box does not appear.

6.2.5 Examples

1. ewanapi -ASSYST -Background -p -t 211004 -m 646951 -k 30000 -w 4g3p

   The dynamic service sheet is automatically printed out on the default printer and the job order file created as per the settings on the "System settings" screen.

7 EPC net call interface

7.1 EPC Navigate Call

7.1.1 Objective

Activation of EPC net and writing of a shopping list.

7.1.2 Parameters

The following number of parameter combinations is supported:

1. ewanapi [-V <FIN>] 
             [-T <model code>]
                 -S <shoppinglist_file>
                 [-c]
             [-partslist <partnumber[,partnumber...]>]
                 [-err <error_file>]
                 -application EPC-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

-V

-V WDB2020281F333593

-T

-T 202028

-m

-m 104941

-S

–S C:\tmp\sl.txt

-c

-c

-partslist

-partslist A1089950520,N073379008100

-err

C:\tmp\err.txt

7.2 Examples

1. ewanapi -V WDB2020281F333593 -S C:\tmp\sl.txt -c -err C:\tmp\err.txt -application EPC-Net -userid stollms -userpwd 478967895 -userdomain sampledomain
   

2. ewanapi -V WDB2020281F333593 -S C:\tmp\sl.txt -partslist A1089950520,N073379008100 -application EPC-Net -err C:\tmp\err.txt -userid stollms -userpwd 478967895 -userdomain sampledomain
   

7.3 EPC Search Part Call

7.3.1 Objective

Activation of EPC net and searching a given part.

7.3.2 Parameters

The following number of parameter combinations is supported:

1. ewanapi [-V <FIN>]
                 -pn <partnumber>
                 [-err <error_file>]
                 -application EPC-Net
                 -userid <your_userid>
                 -userpwd <your_passwd>
                 -userdomain <your_domain>

-V

-V WDB2020281F333593

-pn

–pn A1089950520

-err

C:\tmp\err.txt

7.4 Examples

1. ewanapi –V WDB2020281F333593 -pn A1089950520 -application EPC-Net -userid stollms -userpwd 478967895 –userdomain sampledomain –err C:\tmp\err.txt