This functionality is only available for certain module packages. Info / Copyright

Action: plcservice


Parameters

Description

TYPE

Type of task that the action is to perform:
BUSDATAEXPORT: Export PLC data.
BUSDATAIMPORT: Import PLC data.

GENERATEPLCSCHEMATIC: Generate schematic.

EXPORTADDRESSOVERVIEW: Export addresses / assignment lists.

PROJECTNAME

Project name with complete file path.

LANGUAGE

Language code. This parameter has an effect only if the TYPE parameter has one of the following values: BUSDATAEXPORT, BUSDATAIMPORT.

CONVERTERID

Identifier for PLC configuration programs. Possible values are:

  • PlcDcExchangerBeckhoffTC3AML: Beckhoff TwinCAT 3 (AR APC 1.1.0)
  • PlcDcExchangerBoschAML: Bosch Nexeed Automation (AR APC 1.0.0)
  • PlcDcExchangerLogiCals3AML: logi.cals logi.CAD 3 (AR APC 1.1.0)
  • PlcDcExchangerMitsubishiAML: Mitsubishi iQ Works (AR APC 1.0.0)
  • PlcDcExchangerMitsubishi110AML: Mitsubishi iQ Works (AR APC 1.1.0)
  • PlcDcExchangerPhoenixContactAML: Phoenix Contact PLCnext Engineer 2019 (AR APC 1.0.0)
  • PlcDcExchangerRockwellArchitectAML: Rockwell Automation Studio 5000 (AR APC 1.0.0)
  • PlcDcExchangerSiemensTIA15AML: Siemens SIMATIC STEP 7 TIA-Portal 15 (AR APC 1.0.0)
  • PlcDcExchangerSiemensTIA151AML: Siemens SIMATIC STEP 7 TIA Portal 15.1 (AR APC 1.0.0)
  • PlcDcExchangerSiemensTIA16AML: Siemens SIMATIC STEP 7 TIA Portal 16 (AR APC 1.1.0)
  • PlcDcExchangerSiemensTIA17AML: Siemens SIMATIC STEP 7 TIA Portal 17 (AR APC 1.2.0)
  • PlcDcExchangerSiemensTSTAML: Siemens TIA Selection Tool (AR APC 1.1.0)
  • PlcDcAMLExchangerGeneral: PLC standard exchange format (AutomationML)
  • PlcDcXMLExchangerABB: ABB Automation Builder
  • PlcDcXMLExchangerBandR: B and R Automation Studio
  • PlcDcXMLExchangerRexroth: Bosch Rexroth Indra Works
  • PlcDcXMLExchangerSchneider: Schneider Unity Pro XL
  • PlcDcXMLExchangerSiemens: Siemens SIMATIC STEP 7 5.6
  • PlcDcXMLExchangerUniversal: PLC standard exchange format.

This parameter has an effect only if the TYPE parameter has one of the following values: BUSDATAEXPORT, BUSDATAIMPORT.

CONFIGURATIONPROJECT

Name of the PLC configuration project to be exported. This parameter has an effect only if the TYPE parameter has one of the following values: BUSDATAEXPORT, EXPORTADDRESSOVERVIEW

DESTINATIONFILE

Target file for data export. This parameter has an effect only if the TYPE parameter has one of the following values: BUSDATAEXPORT, EXPORTADDRESSOVERVIEW

SOURCEFILE

Source file for the data import. This parameter has an effect only if the TYPE parameter has the following value: BUSDATAIMPORT.

OVERWRITE

If the target file already exists, this parameter indicates whether the file should be overwritten (0 = No, 1 = Yes).
Default value: 0

This parameter has an effect only if the TYPE parameter has the following value: BUSDATAEXPORT.

IMPORTMATCH

Alignment options during PLC data import. The import process tries to synchronize the imported objects with those that exist in the project. Depending on the selected option, the adaption is performed on the basis of the internal object IDs or identifying object names. If an imported object matches an existing function, the properties of the existing function are updated while new functions in the project are generated for non-adjustable objects. The options are:

  • 0: Synchronization on the basis of internal object IDs.
  • 1: Synchronization on the basis of identifying names. Note that in this case a comparison dialog can be opened in which you must individually select a function for the update.
  • 2: No synchronization, new functions are generated for all imported objects.

This parameter has an effect only if the TYPE parameter has the following value: BUSDATAIMPORT.

CONFIGFILE

File path for configuration file for the generation of the schematic. This parameter has an effect only if the TYPE parameter has the following value: GENERATEPLCSCHEMATIC.

SINGLELINEPAGES

If specified, single-line pages are generated (0 = No, 1 = Yes).
Default value: 0
This parameter has an effect only if the TYPE parameter has the following value: GENERATEPLCSCHEMATIC.

MULTILINEPAGES

If specified, multi-line pages are generated (0 = No, 1 = Yes).
Default value: 0
This parameter has an effect only if the TYPE parameter has the following value: GENERATEPLCSCHEMATIC.

OVERVIEWS

If specified overview pages are generated (0 = No, 1 = Yes).
Default value: 0
This parameter has an effect only if the TYPE parameter has the following value: GENERATEPLCSCHEMATIC.

RACKOVERVIEWS

If specified, rack overview pages are generated (0 = No, 1 = Yes).
Default value: 0
This parameter has an effect only if the TYPE parameter has the following value: GENERATEPLCSCHEMATIC.

PLCSTATION

Name of the PLC station to be exported. This parameter has an effect only if the TYPE parameter has the following value: EXPORTADDRESSOVERVIEW

PLCCPU

Name of the CPU to be exported. This parameter has an effect only if the TYPE parameter has the following value: EXPORTADDRESSOVERVIEW

ClosedExample:

Export PLC data:

plcservice 
/TYPE:BUSDATAEXPORT 
/CONFIGURATIONPROJECT:Schneider-Electric 
/DESTINATIONFILE:"C:\tempdir\plcservice_export_1.xef" 
/PROJECTNAME:"C:\Users\Public\EPLAN\Projects\EPLAN_Sample_Project.elk" 
/LANGUAGE:de_DE 
/CONVERTERID:PlcDcXMLExchangerSchneider 
/OVERWRITE:1

Import PLC data:

plcservice 
/TYPE:BUSDATAIMPORT 
/SOURCEFILE:"C:\tempdir\plcservice_export_2.xml" 
/PROJECTNAME:"C:\Users\Public\EPLAN\Projects\EPLAN_Sample_Project.elk" 
/LANGUAGE:de_DE 
/CONVERTERID:PlcDcXMLExchangerUniversal

Generate schematic:

plcservice 
/TYPE:GENERATEPLCSCHEMATIC 
/PROJECTNAME:"C:\Users\Public\EPLAN\Projects\EPLAN_Sample_Project.elk" 
/CONFIGFILE:"C:\tempdir\schematics_generation_config.xml" 
/SINGLELINEPAGES:1 
/MULTILINEPAGES:1

Export addresses / assignment lists:

plcservice 
/TYPE:EXPORTADDRESSOVERVIEW 
/PROJECTNAME:"C:\Users\Public\EPLAN\Electric P8\Projects\Microsoft\EPLAN_Sample_Project.elk" 
/CONFIGURATIONPROJECT:"CAx_AML_Drive_00" 
/PLCSTATION:"S71500/ET200MP station_1" 
/PLCCPU:"1" 
/DESTINATIONFILE:"c:\tempdir\address_overview_export.csv"