Tia Portal Exporter Manual
Tia Portal Exporter Manual
Tia Portal Exporter Manual
Table of Contents
TIA Portal Exporter Utility 1
Table of Contents 2
User Guide 5
Use in Server 5
Tag Data Type Conversions 6
Index 13
www. ptc.com
3 TIA Portal Exp orter Utility
CONTENTS
Overview
What is the TIA Portal Exporter Utility?
User Guide
How do I use the TIA Portal Exporter utility?
Error M essages
What are the possible error messages, causes, and solutions for theTIA Portal Exporter Utility?
Overview
The TIA Portal Exporter utility is a tool that can be used to export tags from a Siemens TIA Portal project into
the server. When a project is opened using the tool, the content of the project is displayed, allowing the selec-
tion of program block, tag tables, or individual tags. The selected tags are exported into a format which can
be consumed by the Siemens TCP/IP Driver Automatic Tag Generation process.
The TIA Portal Exporter utility supports versions 13, 14, 15, or 16 of TIA Portal.
For more information regarding how tags are translated see Tag Data Type Conversions.
www. ptc.com
TIA Portal Exporter Utility 4
1. Open the utility folder on the system where the server has been installed.
6. Identify the Windows user accounts to run the utility under, and add them to the Siemens TIA Open-
ness local user group.
N ote: In order for user account changes to take effect, the account must be logged out and logged
in again. An operating system restart is recommended.
www. ptc.com
5 TIA Portal Exp orter Utility
User Guide
Access the links below for information on how to use the TIA Portal Exporter Utility:
l In t he Ut ilit y
l In Server
l M ult ilingual Project s
Use in t he Ut ilit y
1. From the Start menu, select TIAPortalExporter 6 from the TIAPortalExporter 6 folder.
N otes:
l TIA Portal project files have the extension .apn where n is the version number (.ap13, .ap14,
.ap15_1...).
l The TIA Portal Exporter utility cannot open projects which are already open in TIA Portal.
Close any projects you have open in TIA Portal before you open them in the utility. Once the
Exporter utility has completed its processing of the project you may re-open it in TIA Portal
without interfering with the operation of the Exporter utility.
l Be sure to compile and save data blocks in the project from which you would like to export.
Un-compiled data blocks will not be visible to the Exporter utility.
l Multilingual Tag Comments are deserialized using the Siemens TIA Portal Project’s “Refer-
ence Language” (see Working with Multilingual Projects for more information).
4. Wait while the project file is opened and the tags are loaded.
5. Once the project has loaded you will be presented with a list of tag tables and program blocks. Entire
blocks may be selected by clicking the “Select All” button on the block header. You may also elect to
expand the blocks and select individual tags within. The blocks may be expanded by clicking the
expand (down caret) button at the left side of the block header. The number of selected tags in the
block is displayed in the block header, and the overall number of selected tags is shown in the inform-
ation pane at the left hand side of the window.
6. Once you have selected the tags you would like to export, click the Export button. Wait for the export
to complete.
Use in Server
1. Copy the export file produced by the TIA Portal Exporter utility to the system where Server is run-
ning.
2. Open the Server Configuration application, expand the Siemens Ethernet TCP/IP driver and select
the device to which you would like to import tags.
4. In the property editor for the device, select the Tag Import Tab. Enter the path to the export file in
www. ptc.com
TIA Portal Exporter Utility 6
5. Select the Tag Generation Tab. Click the “Create tags” button. Wait for tag generation to complete.
www. ptc.com
7 TIA Portal Exp orter Utility
TIA Portal program block data types are converted to Server data types as follows:
www. ptc.com
TIA Portal Exporter Utility 8
N otes:
www. ptc.com
9 TIA Portal Exp orter Utility
1. Arrays are automatically expanded. For each array, a tag is created for the entire array as well as
each index in the array.
2. Tags cannot be created for User Data Types or Strings placed in the InOut section of a function block.
3. User defined types in tag tables cannot be expanded. The address of the start of the UDT will be
provided as a tag.
Unsupported Types
l Multidim ensional Boolean Arrays: Multidimensional Boolean array tags are not supported by
Server, however tags are created for the individual elements of the array.
l String Arrays: Arrays of strings, and data types which evaluate to string (see table above) are not
supported.
l Strings Longer than 210 Characters: Due to limitations in the Siemens TCP/IP Driver strings
greater than 210 characters in length are not currently supported.
l Com plex Types in the InOut Section of Instance Function Blocks: Tags for complex data types (
user defined types, structs, arrays, and strings) cannot be generated for the InOut section of instance
function blocks.
For more information, refer to the Siemens TIA Information System | Editing Project Data | Working with Multi-
Language Projects.
www. ptc.com
TIA Portal Exporter Utility 10
Invalid ext ract or version. Please check your inst allat ion.
Error Type:
Warning
Possible Solution:
Check your installation.
Possible Solution:
Make sure that the correct version of Openness is installed.
Error init ializing t he Openness API. Please verify t hat all necessary com -
ponent s are inst alled.
Error Type:
Warning
Possible Cause:
Not all necessary components of Openness API are installed.
Possible Solution:
Please verify that all necessary components are installed.
Possible Causes:
www. ptc.com
11 TIA Portal Exp orter Utility
1. The version of TIA Portal installed on this system is not compatible with the project.
Possible Solutions:
1. Verify that the project can be opened by the version of TIA Portal installed on this system.
A problem has been encount ered ext ract ing t ags from t he select ed pro-
ject . Please verify t hat t he project is com plet e and has been successfully
com piled.
Error Type:
Warning
Possible Causes:
The project is not complete nor successfully compiled.
Possible Solution:
Verify that the project is complete and has been successfully compiled.
Possible Solution:
Convert the project to one of the supported versions.
No ext ract ors can be found on t he syst em . Please check your inst allat ion.
Error Type:
Warning
Possible Cause:
There is an issue with the installation.
Possible Solution:
Check the installation.
www. ptc.com
TIA Portal Exporter Utility 12
Possible Cause:
The selected file is in use or open in another application.
Possible Solution:
Close the selected file in any other application or instance.
Unable t o find help docum ent at ion. Please verify your inst allat ion.
Error Type:
Warning
Possible Cause:
There is an issue with the installation.
Possible Solution:
Check the installation.
Possible Cause:
The current user is not a member of the Siemens TIA Openness group.
Possible Solution:
Add current user to the Siemens TIA Openness group.
www. ptc.com
13 TIA Portal Exp orter Utility
Index
A problem has been encountered extracting tags from the selected project. Please verify that the project
is complete and has been successfully compiled. 11
Error initializing the Openness API.Please verify that all necessary components are installed. 10
Event Log Messages 10
Help Contents 3
Overview 3
www. ptc.com
TIA Portal Exporter Utility 14
Unable to access the Openness API. The current user is not a member of the Siemens TIA Openness
group. 12
Unable to find help documentation. Please verify your installation. 12
Unable to load project. 12
Unable to open the selected project. Make sure that the correct version of Openness is installed. 10
Unexpected error reading the project file. 10
Use in Server 5
Use in the Utility 5
User Guide 5
www. ptc.com