Application Example  09/2016

Production feedback via

WinCC Data Transfer
with XML file
WinCC/IndustrialDataBridge V7.4, SIMATIC WinCC V7

https://support.industry.siemens.com/cs/ww/en/view/109483465
 Warranty and Liability

Warranty and Liability

Note The Application Examples are not binding and do not claim to be complete with regard to
configuration, equipment or any contingencies. The Application Examples do not
represent customer-specific solutions. They are only intended to provide support for
typical applications. You are responsible for the correct operation of the described
products. These Application Examples do not relieve you of the responsibility of safely
and professionally using, installing, operating and servicing equipment. When using these
Application Examples, you recognize that we cannot be made liable for any
damage/claims beyond the liability clause described. We reserve the right to make
changes to these Application Examples at any time and without prior notice. If there are
any deviations between the recommendations provided in this Application Example and
other Siemens publications – e. g. catalogs – the contents of the other documents shall
have priority.
We do not accept any liability for the information contained in this document.
Any claims against us – based on whatever legal reason – resulting from the use of
the examples, information, programs, engineering and performance data etc.,
described in this Application Example shall be excluded. Such an exclusion shall
not apply in the case of mandatory liability, e.g. under the German Product Liability
Act (“Produkthaftungsgesetz”), in case of intent, gross negligence, or injury of life,
body or health, guarantee for the quality of a product, fraudulent concealment of a
deficiency or breach of fundamental contractual obligations (“wesentliche
Vertragspflichten”). The compensation for damages due to a breach of a
fundamental contractual obligation is, however, limited to the foreseeable damage,
typical for the type of contract, except in the event of intent or gross negligence or
 Siemens AG 2016 All rights reserved

injury to life, body or health. The above provisions do not imply a change of the
burden of proof to your detriment.
Any form of duplication or distribution of these Application Examples or excerpts
hereof is prohibited without the expressed consent of Siemens AG.

Security Siemens provides products and solutions with Industrial Security functions that support
informa- the secure operation of plants, systems, machines and networks.
tion In order to secure plants, systems, machines and networks against cyber threats it is
necessary to implement (and to maintain continuously) a holistic, state-of-the-art Industrial
Security concept. With this in mind, Siemens’ products and solutions are only part of such
a concept.
It is the client’s responsibility to prevent unauthorized access to his plants, systems,
machines and networks. Systems, machines and components should only be connected
with the company’s network or the Internet, when and insofar as this is required and the
appropriate protective measures (for example, use of firewalls and network segmentation)
have been taken.
In addition, the recommendations by Siemens regarding the respective protective
measures have to be observed. For more information on Industrial Security, visit
http://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development in order to make them
even more secure. Siemens explicitly recommends to carry out updates as soon as the
respective updates are available and always only to use the current product versions. Use
of product versions that are no longer supported, and failure to apply latest updates may
increase customer’s exposure to cyber threats.
In order to always be informed about product updates, subscribe to the Siemens Industrial
Security RSS Feed at http://www.siemens.com/industrialsecurity.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 2
 Table of Contents

Table of Contents
Warranty and Liability ................................................................................................. 2
1 Task ..................................................................................................................... 4
1.1 Overview............................................................................................... 4
1.2 Requirements of the automation task .................................................. 5
2 Solution............................................................................................................... 6
2.1 Overview............................................................................................... 6
Example project .................................................................................... 6
2.2 Description of the core functionality ..................................................... 7
2.3 Sequence of the core functionality ....................................................... 7
2.4 Hardware and software components ................................................... 8
3 Application example:....................................................................................... 10
3.1 Overview............................................................................................. 10
3.2 SIMATIC WinCC V7 ........................................................................... 10
3.2.1 Preparing the project environment in SIMATIC WinCC V7 ................ 10
3.2.2 Function description of the WinCC application .................................. 12
3.2.3 Operating the WinCC application ....................................................... 12
3.3 IDB configuration system (CS) ........................................................... 14
3.3.1 Creating and configuring the IDB project ........................................... 15
3.3.2 Creating links graphically ................................................................... 16
3.3.3 Configuring the OPC Data Access interface as provider ................... 19
 Siemens AG 2016 All rights reserved

3.3.4 Configuring the “Free Text Editor” interface as consumer ................. 20

3.3.5 Configuring the link settings ............................................................... 23
OPC Data Access transfer settings .................................................... 23
Connection mapping (XML file) .......................................................... 25
3.4 Generating IDB Runtime configuration .............................................. 36
4 Further notes, tips and tricks ......................................................................... 39
Preparing XML for iDOC SAP import ................................................. 39
5 Error detection ................................................................................................. 40
6 Links & Literature ............................................................................................ 42
7 History............................................................................................................... 42

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 3
 1 Task
1.1 Overview

1 Task
1.1 Overview
Introduction
WinCC/IndustrialDataBridge V7.4 (IDB) is a WinCC option which enables easy and
fast configuration of data exchange between various automation systems across
various standard interfaces, e.g.:
• OPC XML,
• WinCC OLE DB or
• Send/Receive.
The WinCC/IndustrialDataBridge V7.4 also provides data exchange with other
applications for the analysis and storage of process values in Office formats, such
as:
• CSV/TXT,
• Microsoft Excel or
• Microsoft Access.
It is also possible to integrate databases (e.g. SQL Server, Oracle) for archiving
larger amounts of data.
 Siemens AG 2016 All rights reserved

The figure below shows a schematic overview of the different applications and
format supported by the WinCC/IndustrialDataBridge V7.4.

Figure 1-1

The data interfaces shown in Figure 1-1 are integrated via software modules.
These modules are structured as follows:

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 4
 1 Task
1.2 Requirements of the automation task

Provider module
The provider module establishes the connection to the data source which delivers
the data.

Consumer module
The consumer module connects to the data target where the data are written.

Note You can connect different providers and consumers with each other. The
following must be observed:

• Not all providers are available as consumers and vice versa.

• Providers and consumers are an integral part of a connection.

1.2 Requirements of the automation task

The application describes which software and settings are necessary to implement
the following automation tasks:
 Siemens AG 2016 All rights reserved

• Saving IDB online values from the WinCC data manager outside WinCC in a
“Free Text Editor” XML file even as a consumer. This XML file can be used (as
1
a template) by SAP application systems , among others, via a message-based
interface. This fulfills the following objectives:
– Structured data exchange
– Base structure of different complex structures of different application
systems as simple as possible.

1
See Chapter 4.1

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 5
 2 Solution
2.1 Overview

2 Solution
2.1 Overview
This documentation leads you through the configuration of
WinCC/IndustrialDataBridge V7.4 using a practical example.
The included TIA example project provides the required environment for the data
transfers between provider and consumer modules to be created in the
WinCC/IndustrialDataBridge V7.4.

Example project
The included WinCC project “WinCC_IDB_Application_5” enables reading online
tag values from the WinCC data manager of SIMATIC WinCC V7.
This example provides WinCC/IndustrialDataBridge V7.4 with the environment for
transferring the online tag values which can then be transferred via the “Free Text
Editor” module in XML format.

Figure 2-1 below shows a schematic overview of the sample project in WinCC
Runtime:

Figure 2-1
 Siemens AG 2016 All rights reserved

Topics not covered by this application

This documentation does not explain how to create the included example project.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 6
 2 Solution
2.2 Description of the core functionality

2.2 Description of the core functionality

The application example is used to familiarize with the configuration interface of
IndustrialDataBridge V7.4. It shows in detail how to create and configure the
individual IDB projects within the WinCC/IndustrialDataBridge V7.4 using the
WinCC project included in the delivery. The application example covers the
following topics:
• Creating a new project and the required link(s)
• Defining the provider and consumer types
• Configuring the provider properties
• Configuring the consumer properties
• Configuring the link settings
• Configuring the relevant provider and consumer tags
• Generating the Runtime configuration

2.3 Sequence of the core functionality

This documentation shows the work steps required for configuring the
WinCC/IndustrialDataBridge V7.4 using the included WinCC example project
 Siemens AG 2016 All rights reserved

“WinCC_IDB_Application_5” included in the delivery to create a link between the

“OPC Data Access” as data source and “Free Text Editor” as data target.

Figure 2-2 shows a schematic diagram of the process sequence and the interfaces
used in the WinCC/IndustrialDataBridge V7.4.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 7
 2 Solution
2.4 Hardware and software components

Figure 2-2
 Siemens AG 2016 All rights reserved

2.4 Hardware and software components

The application was created with the following components:

Software components
Table 2-1
Component Qty Article number
SIMATIC WinCC V7.3 1 6AV63.1-....7-3...
WinCC/IndustrialDataBridge 1 6AV6362-4AA07-4…
V7.4
Windows 7 SP1 64-bit 1

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 8
 2 Solution
2.4 Hardware and software components

Example file and project

The table below contains the example project contained in this documentation:
Table 2-2
Component Note
WinCC_IDB_Application_5.zip This zip file contains the WinCC project required for
the application example.
OPCDA-XML.xml Contains a prefabricated XML template. In the WinCC
project included in the delivery, this can be found
under:
“WinCC_IDB_Application_5\IndustrialDataBridge\XML”

Download and unzip

Download the example project available as download and unzip the received zip
archive.
 Siemens AG 2016 All rights reserved

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 9
 3 Application example:
3.1 Overview

3 Application example:
In this chapter, you will learn how to online tag values from the WinCC data
manager to an XML file using
• WinCC/IndustrialDataBridge V7.4 and
• SIMATIC WinCC V7

3.1 Overview
The application example shows how to perform the following steps in the
WinCC/IndustrialDataBridge V7.4 using the WinCC project
“WinCC_IDB_Application_5”:
• Creating a new IDB project
• Creating the relevant link
• Configuring the respective provider/consumer links
• Setting the transmission behavior.

3.2 SIMATIC WinCC V7

 Siemens AG 2016 All rights reserved

Objective of this application

In the WinCC project “WinCC_IDB_Application_5” included in the delivery online
tag values are provided using a simple application from the WinCC data manager
to export them to an XML file later using WinCC/IndustrialDataBridge V7.4 in order
to be able to save and further analyze them.

Range of functions/topics not covered

The focus of this chapter is the function description and not how to create the
WinCC application.

Assumed knowledge
No previous knowledge is required to understand the functional description of the
WinCC application.

3.2.1 Preparing the project environment in SIMATIC WinCC V7

This chapter describes the required steps for adjusting the project environment of
the WinCC project “WinCC_IDB_Application_5.MCP” included in the delivery for
SIMATIC WinCC V7 in order to avoid error messages when activating the WinCC
Runtime.
Table 3-1
No. Procedure
1. Start the SIMATIC WinCC Explorer.
2. Click on “File > Open” and select the WinCC project
“WinCC_IDB_Application_5.MCP” to open the project.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 10
 3 Application example:
3.2 SIMATIC WinCC V7

No. Procedure
3. In the WinCC Explorer window:
• Click the “Computer” icon in the WinCC Explorer (1).
• In the work area, right-click the computer name with “Server computer”
type (2).
• Then click on “Properties” (3).
 Siemens AG 2016 All rights reserved

4. In the “Computer properties” window

• Click on “Use Local Computer Name” in the “Computer properties >
General” window (1).
• Confirm your selection with “OK” (2).

• Re-start the SIMATIC WinCC.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 11
 3 Application example:
3.2 SIMATIC WinCC V7

3.2.2 Function description of the WinCC application

Figure 3-1 shows the WinCC application directly after activating the WinCC
Runtime.

Note The user interface is completely in English.

Figure 3-1

2
 Siemens AG 2016 All rights reserved

3
7
4

Table 3-2
No. Description
1. WinCC/IndustrialDataBridge Runtime (embedded in WinCC)
2. Existing IDB link(s)
3. Input field for the raw material name
4. Input field for number of pieces
5. Updating the IBD trigger
6. Opening the XML file (data target)
7. Preview of the latest tags exported to the XML file

3.2.3 Operating the WinCC application

This section describes how to establish a write access to the online tag values in
WinCC Manager.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 12
 3 Application example:
3.2 SIMATIC WinCC V7

Table 3-3
No. Procedure
1. Enter the desired name in the “Raw material” input field (1).
2. Confirm your entries with the “Enter” button.
3. Enter the desired amount in the “Value” input field (2).
4. Confirm your entries with the “Enter” button.
5. Upon clicking the “Update” (3) button, the IDB trigger stored in the
WinCC/IndustrialDataBridge is activated or set to “1” and transfers or
updates the tags via IDB(RT) in an XML file.
 Siemens AG 2016 All rights reserved

Note The values in the XML file are overwritten with every transfer or update.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 13
 3 Application example:
3.3 IDB configuration system (CS)

3.3 IDB configuration system (CS)

This chapter shows all steps required in the IDB configuration system (CS) for
creating and configuring an IDB project for establishing a link between data source
and data target.
Figure 3-2
IDB Configuration system (CS)

IDB project

Link(s)

Provider interface Consumer interface

OPC
OPC DA > XML Free Text Editor
Data Access
 Siemens AG 2016 All rights reserved

Link settings

Generating Runtime configuration

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 14
 3 Application example:
3.3 IDB configuration system (CS)

3.3.1 Creating and configuring the IDB project

Opening the IDB configuration system (CS)

Open the IDB configuration system (CS) as described in the following table:
Table 3-4
No. Procedure
1. Right-click on “IndustrialDataBridge” in the navigation area of the WinCC Explorer
(1).
2. Select “Configuration” (2) to open the IDB configuration system.
 Siemens AG 2016 All rights reserved

Creating a new project

Create a new project as described in the table below:
Table 3-5
No. Procedure
1. Click “Projects > New project” in the menu bar.
2. In the “Create a new project” window, enter a project name, e.g.
“WinCC_XML_Application” (1), and a storage path for the new IDB project (2).
3. Click the “Create” button (3).

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 15
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure

The created project is displayed in the list in the navigation area.

The next step is to create a link.

3.3.2 Creating links graphically

In addition to the traditional way of creating links, IDB V7.4 offers the option to
 Siemens AG 2016 All rights reserved

create links graphically.

To create a link between provider and consumer, proceed as follows:

Note Create a link with the “OPC Data Access” interface as provider and the “Free
Text Editor” interface as consumer.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 16
 3 Application example:
3.3 IDB configuration system (CS)

Table 3-6
No. Procedure
1. Double-click the left mouse button on “Add link(s) graphically” below the
“WinCC_XML_Application” project name node in the tree structure (1).
 Siemens AG 2016 All rights reserved

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 17
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
2. Create an “OPC DA > XML” link graphically
• In the “Link configuration” area, select the “OPC Data Access” provider
and drag and drop it in the “Free Text Editor” consumer.
• A new link is indicated by a line (1).
• Enter a unique link name for the new link, e.g. “OPCDA > XML” (2), in the
text field.

2 1
 Siemens AG 2016 All rights reserved

Note:
For a better overview, it is sensible to identify the link with the name of the desired
provider and the respective consumer when assigning names. “Provider >
Consumer”

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 18
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
3. The created link is displayed under the project name in the project tree.
 Siemens AG 2016 All rights reserved

The next step is configuring the provider interface (OPC Data Access).

3.3.3 Configuring the OPC Data Access interface as provider

To configure the OPC Data Access interface, proceed as follows:

Note Make sure that the WinCC runtime has been activated.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 19
 3 Application example:
3.3 IDB configuration system (CS)

Table 3-7
No. Procedure
1. Double-click the provider node “Provider(OPCDA)” within the created link in the
project tree.
 Siemens AG 2016 All rights reserved

2. In the “OPC Data Access provider configuration” window in the configuration

area, click on [...] and select the “OPCServer.WinCC”. Then click on “√“.

The “Computer name” field is automatically filled in after selecting the OPC
server.

3.3.4 Configuring the “Free Text Editor” interface as consumer

Storage location structure

It is advisable to create a structured storage location for better overview. For
multiple links, this has the benefit of being able to divide the logs to be created
depending on consumer type.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 20
 3 Application example:
3.3 IDB configuration system (CS)

To configure the “Free Text Editor” interface, proceed as follows:

Table 3-8
No. Procedure
1. Double-click the “Consumer(Free Text Editor)” consumer node in the project tree.
 Siemens AG 2016 All rights reserved

2. In the configuration area in the tab “consumer configuration for the free
text editor”
Select the option “XML” in the “Document type” area (1).

In the “File selection” button, click the [...] button and change to the storage path
of the folder containing the “base file” in XML format.
Under: \\...\WinCC_IDB_Application_5\IndustrialDataBridge\XML.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 21
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
In the “Open” browser window, select the base file name “OPCDA.XML.xml” (1)
and click on “Open”. (2)
The preconfigured template can be found in the downloaded WinCC project
under:
“\\…\WinCC_IDB_Application_5\IndustrialDataBridge\XML\OPCDA-XML.xml“

1
 Siemens AG 2016 All rights reserved

3. The “Output file name” field in the “File selection” area is filled in automatically by
adding the suffix “_Output” to the existing base file name.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 22
 3 Application example:
3.3 IDB configuration system (CS)

3.3.5 Configuring the link settings

Double-click the “Settings” node in the project tree and open the “Settings” window
in the work area. The “Settings” window contains three tabs:
• “Transfer options”,
• “Connection mapping” and
• “Connections”.
Figure 3-3
 Siemens AG 2016 All rights reserved

OPC Data Access transfer settings

For the transfer configuration of the OPC DA provider, proceed as follows in the
“Transfer options” tab:

Note Make sure that the WinCC runtime has been activated.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 23
 3 Application example:
3.3 IDB configuration system (CS)

Table 3-9
No. Procedure
1. In the “OPC Data Access transfer settings” window
• In the “Group settings for the provider” area, select the option “Send
values using trigger”.

2. In the “Trigger settings” area, click on the [...] button to select the trigger.
 Siemens AG 2016 All rights reserved

3. Open the project tree on the left side: “OPCServer.WinCC/@LOCALMACHINE::/

Internal tags/.(1)
In the right-hand area, select “PostTriggerTag” (2).
Confirm the selection by clicking on the (√) button (3).

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 24
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
4. In the “Trigger settings” area
Enter “1” in the field “Trigger value” (1).
Enter “0” in the field “Confirmation value” (2).

Note
With these settings, the IDB will send the desired tag values only if the “trigger
value” is set to “1”. After successful transfer to the “OPCDA-XML_Output.xml“
XML file, the IDB resets the “trigger value” to “0” as a confirmation.

Connection mapping (XML file)

In the “Settings” window, click on the “Connection mapping” tab and proceed as
follows:

Note The “Connection mapping” tab contains the following areas:

 Siemens AG 2016 All rights reserved

• OPC Data Access provider

• Free Text Editor consumer

• Connection mapping settings

• Default name options

• Connections

This application example considers the following tag names from the “OPC Data
Access provider” area for preparing and creating a “Free Text Editor” file:
• RawMaterial: contains the tag name.
• Value: contains the tag value.

To transfer tags from the “OPC Data Access provider” to a “Free Text Editor file”,
the desired column names from the “OPC Data Access provider” area must be
mapped to the “Free Text Editor consumer” area as follows:

Note Make sure that the WinCC runtime has been activated.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 25
 3 Application example:
3.3 IDB configuration system (CS)

Table 3-10
Tag name Column name
(OPC Data Access provider) (Free Text Editor consumer)
RawMaterial Material
Value Value
The figure shows the completed Free Text Editor file after preparation:
 Siemens AG 2016 All rights reserved

Proceed as follows:

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 26
 3 Application example:
3.3 IDB configuration system (CS)

Preparing the Free Text Editor file:

The consumer type “Free Text Editor” contains a free editor which supports
individual layout formatting, enabling previewing and processing consumer tags
and text strings as well as creating and processing HTML/XML tags.

Note If HTML/XML is used as the base file type, basic knowledge of HTML/XML is
required.

The IndustrialDataBridge V7.4 offers the following options for preparing the “Free
Text Editor” file and for mapping the connection:
• The Advanced option
• The drag-and-drop option

a) The Advanced option:

This option enables you to define the consumer tag names yourself or to connect
predefined consumer tag names with those of the provider.
Defining tags:
To map the desired provider tags in a “Free Text Editor”, they must be defined
beforehand.
 Siemens AG 2016 All rights reserved

Note Rules for tag definition

• A consumer tag value must always be preceded and followed by the “@” symbol,
e.g.: @tag@
• A consumer tag value must not have spaces between letters or words.
• The following special characters are not supported and cannot be used in consumer
tag names: <, >, /, \, @

The following steps must be performed in the “Free Text Editor consumer
connection” within the predefined link “<OPCDA-XML>…</OPCDA-XML>” in the
input text field:

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 27
 3 Application example:
3.3 IDB configuration system (CS)

Table 3-11
No. Procedure
1. For mapping the provider column name “RawMaterial”, enter the following text in
the link “<OPCDA-XML>…</OPCDA-XML>” predefined in the input field, for
example:
<Material>@Material@</Material>

2. Save your changes by clicking on the “Save” button in the “Free Text Editor
consumer” register.
 Siemens AG 2016 All rights reserved

3. Preview the XML file in its output form by clicking the “Edit/review” button in the
“Free Text Editor consumer” register. Change to edit mode with another click.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 28
 3 Application example:
3.3 IDB configuration system (CS)

Mapping column names:

Table 3-12
No. Procedure
1. In the “OPC Data Access provider” area
• Under “OPC tag browser” on the left side, select the “internal tags”
subfolder (1).
• On the right-hand side, select the tag name “RawMaterial” (2).
• Upon selection, the tag name is displayed in the display field “Tag” (3).
• The data type “OLE/Binary Automation string (VT_BSTR)” is determined
automatically upon selecting the tag name (4).

3 4
 Siemens AG 2016 All rights reserved

2. In the “Connection mapping settings” area

The tag name “RawMaterial” selected in the “OPC Data Access provider” area is
displayed in the field “Connection name” (1).
Note:
If the selected tag name cannot be displayed in the “Connection name” field,
deactivate and then re-activate the “Enable default name” option (2).

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 29
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
3. In the “Default name options” area
If the column names in the provider and consumer areas differ, the option “Name
equal to provider and consumer” is recommended.

4. In the “Free Text Editor consumer” area

Mark or double-click the tag name “@Material@” to be mapped in the text field.
 Siemens AG 2016 All rights reserved

5. Now the connection name in the “Connection mapping settings” area has
changed to “RawMaterial->@Material@” (1).
Click on the “ ” icon to create the connection between the two selected column
names of both areas (provider and consumer) (2).

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 30
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
6. In the “Connections” area
This area shows the created connection.
 Siemens AG 2016 All rights reserved

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 31
 3 Application example:
3.3 IDB configuration system (CS)

b) The drag-and-drop option:

In contrast to the advanced option, this option takes over both the tag name of the
desired tag from the OPCDA provider and the connection mapping automatically.

The following steps must be performed in the “Free Text Editor consumer
connection” within the predefined link “<OPCDA-XML>…</OPCDA-XML>” in the
input text field:

Table 3-13
No. Procedure
1. For mapping the provider column name “Value”, enter the following text in the
link “<OPCDA-XML>…</OPCDA-XML>” predefined in the input field, for
example:
“<Value></Value>”
 Siemens AG 2016 All rights reserved

Note:
Compared to the advanced option, the tag name “@Value@” between the start
marker “<Value>” and the end marker “</Value>” must be left out in the
drag&drop option.
2. Save your changes by clicking on the “Save” button in the “Free Text Editor
consumer” register.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 32
 3 Application example:
3.3 IDB configuration system (CS)

Mapping column names:

Table 3-14
No. Procedure
1. In the “Connection mapping settings” area
Activate the “Enable default name” checkbox (1).

2. In the “Default name options” area

If the column names in the provider and consumer areas differ, the option “Name
equal to provider and consumer” is recommended.
 Siemens AG 2016 All rights reserved

3. In the “OPC Data Access provider” area

• Under “OPC tag browser” on the left side, select the “internal tags”
subfolder (1).
• On the right-hand side, select the tag name “Value” (2).
• Upon selection, the tag name is displayed in the display field “Tag” (3).
• The data type “unsigned int (VT_UI4)” is determined automatically upon
selecting the tag name (4).

3 4

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 33
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
4. In the “Free Text Editor consumer” area
After selecting the desired “Value” tag from the “OPC Data Access provider”,
place it between the start marker “<Value>” and the end marker “</Value>” of the
desired consumer tag in the “Free Text Editor Consumer” area with drag&drop.
 Siemens AG 2016 All rights reserved

Note
Different data types between the provider and consumer tags will be
automatically matched by the provider tag.
5. Save your changes by clicking on the “Save” button in the “Free Text Editor
consumer” register.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 34
 3 Application example:
3.3 IDB configuration system (CS)

No. Procedure
6. Preview the XML file in its output form by clicking the “Edit/review” button in the
“Free Text Editor consumer” register. Change to edit mode with another click.

7. Now the connection name in the “Connection mapping settings” area has
changed to “Value->@Value@” (1).
 Siemens AG 2016 All rights reserved

8. In the “Connections” area

This area shows all created connections.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 35
 3 Application example:
3.4 Generating IDB Runtime configuration

3.4 Generating IDB Runtime configuration

To generate the Runtime configuration file, proceed as follows:

Table 3-15
No. Procedure
1. Click “Save” in the IDB menu bar (1).
2. Then click “Generate runtime configuration” (2).
3. Save the IDB configuration file “WinCC_XML_Application.xml” in the appropriate
folder.
Under: \\...\WinCC_IDB_Application_5\IndustrialDataBridge\RT\
4. Click the “Runtime configuration” button in the IDB menu bar (3).

5. In the “Runtime configuration” area:

• Enable the “Automatically connect and activate link(s)” checkbox (1).
• In the “Startup option” area, click on the [...] button in the “Open an
 Siemens AG 2016 All rights reserved

existing configuration file” field (2).

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 36
 3 Application example:
3.4 Generating IDB Runtime configuration

No. Procedure
6. • In the “Open” browser window, select the IDB configuration file
“WinCC_XML_Application.xml” you have created (1) under:
“\\…\WinCC_IDB_Application_5\IndustrialDataBridge\RT\WinCC_XML_Appli
cation.xml“.
• Click on the “Open” button (2).
 Siemens AG 2016 All rights reserved

7. • Activate the “Automatically activate trace” checkbox (1).

• Select 5 seconds in the “Wait before connect (seconds)” field as wait time.
This serves for activating/deactivating the respective connections (2).
• Then click “OK” (3).

Generating the IDB runtime configuration is now complete.

Result
Restart WinCC Runtime to automatically upload the existing IDB configuration file
“WinCC_XML_Application.xml” to the IndustrialDataBridge(RT).

Start the IndustrialDataBridge (RT) and proceed as follows:

• Enter a material name and a value as described in chapter 3.2.3 “Operating
the WinCC application”.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 37
 3 Application example:
3.4 Generating IDB Runtime configuration

• Then click on “Stop” and then “Disconnect” in the IndustrialDataBridge(RT)

toolbar.
• The transferred values can be found in the XML file “OPCDA-XML_Output.xml”
in the target folder under
“\\...\WinCC_IDB_Application_5\IndustrialDataBridge\XML\”.

XML file
The following figure is an example for a result of the data transfer to the XML file:

Figure 3-4
 Siemens AG 2016 All rights reserved

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 38
 4 Further notes, tips and tricks

4 Further notes, tips and tricks

Preparing XML for iDOC SAP import

NOTICE The SIMATIC IDB only provides one XML file.

The XML file can contain a structure similar to iDOC, which enables
interpretation by SAP systems.
This is not an interface or connector to SAP.
A handshake between IDB/WinCC and SAP must be configured manually.

In case of successful data transfer => (T2 =1)

OPC DA
interface

No
No

Yes

SAP systems
Yes
No
Update data
 Siemens AG 2016 All rights reserved

Yes

Send IDB tag

reset

OPC server Free Text Editor

interface

Overwrite
XML file

XML file

T1 Upon successful data transfer, the WinCC trigger (T2) is set to “1” by SAP
systems.

T2 Upon successful data transfer, the WinCC trigger (T1) is set to “0” by IDB.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 39
 5 Error detection

5 Error detection
This chapter lists frequently occurring errors of the respective application
examples:

Table 5-1
No. Behavior Possible cause(s)
1. Error message upon Possibly, your computer is not configured as
activation of the SIMATIC server computer.
WinCC Runtime.
2. The OPC tag browser does To show OPC DA servers, opcenum.exe
not show an OPC DA must run as a service on the server
server, although there are computer.
OPC servers installed on To check whether the service is active, select
the computer. “Start > Execute” from the Windows start
menu. Enter “services.msc” and press the
enter button. If “opcenum” has not been
started, set automatic operation and start the
service.
If the OPC server cannot be displayed on the
 Siemens AG 2016 All rights reserved

remote computer, ensure that the above

mentioned step is carried out on the remote
computer.
3. The items on an OPC DA Check whether the OPC server is being
server cannot be displayed. executed. If not, start the OPC server.
4. You cannot get data, The “Microsoft Message Queue (MSQM)
although the Connectivity Server Core” service might not be activated.
Pack is installed. How to activate the service is described in
the WinCC/Connectivity Pack V7.3 system
manual under “How to install Microsoft
Message Queuing”.
5. IDB runtime signals an Possibly, you do not have administrator
error during start-up. rights. Proceed as follows to rectify the error:

Right-click on the start menu entry “Programs

> Siemens Automation >
IndustrialDataBridge > execute as
administrator” and select the context menu
item “IndustrialDataBridge(RT)”.

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 40
 5 Error detection

No. Behavior Possible cause(s)

Possibly, the IDB runtime service has not

been started yet. Proceed as follows to rectify
the error:

Right-click on the start menu item

“Computer”. Then click “Manage”. Double-
click on “Services and applications >
Services” in the “Computer Management”
window. Right-click on “IndustrialDataBridge
runtime > Properties”. Select the option
“Automatic” from the drop-down list in the
“Startup type” area, then click on the “Start”
button.
 Siemens AG 2016 All rights reserved

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 41
 6 Links & Literature

6 Links & Literature

Table 6-1

Topic Title
\1\ Siemens Industry Online http://support.industry.siemens.com
Support
\2\ Download page of the entry https://support.industry.siemens.com/cs/ww/en/view/10
9483465

\3\ System Manual https://support.industry.siemens.com/cs/ww/en/view/10

2768149/68357937035
WinCC/Connectivity Pack V7.3

\4\ System manual https://support.industry.siemens.com/cs/ww/en/view/73

WinCC/IndustrialDataBridge 968374/54432553995
V7.2
\5\ SIMATIC HMI WinCC V7.2 https://support.industry.siemens.com/cs/ww/en/view/73
WinCC/IndustrialDataBridge 968329/48054187787
Getting Started
\6\ Data Transmission from https://support.industry.siemens.com/cs/ww/en/view/10
WinCC Professional Runtime 9476988
with the help of
IndustrialDataBridge
 Siemens AG 2016 All rights reserved

\7\ Communication between https://support.industry.siemens.com/cs/ww/en/view/10

SIMATIC WinCC 4117374
IndustrialDataBridge and
SIMATIC S7
\8\ Info on https://support.industry.siemens.com/cs/de/de/view/95
SIMATIC/IndustrialDataBridge 157030
V7.3

7 History
Table 7-1
Version Date Modifications
V1.0 05/2016 First version

IDB V7.4 - Production feedback via XML

Entry ID: 109483465, V1.0, 09/2016 42