Skip to Content

Creating Data Type & Message Type Artifacts

Intermediate
20 min.
SAP Business Technology Platform, Intermediate, Tutorial, SAP Integration Suite
Learn how to create the data type and message type artifacts.
You will learn
  • What are the two methods to create data type and message type artifacts.
HarshitaSuryavanshiNovember 6, 2024
Created by
HarshitaSuryavanshi
November 6, 2024
Contributors
HarshitaSuryavanshi

Prerequisites

Data types (DT) and Message Type (MT) artifacts that historically were available in on premise PI/PO are now available in SAP Integration Suite’s Cloud Integration capability (version 6.40 and above). It gives you the opportunity to:

  • Re-use your PI/PO Datatype and Message type artifacts into your integration flows via import.
  • Create new data type and message type artifacts.

Data Type is an object, containing the structure of data that defines the message. A message type comprises a data type that describes the structure of a message. For technical reasons, a data type alone is not sufficient to describe the instance of a message. Data types are defined in XML Schema as abstract types that aren’t yet tied to an element. You can only describe an instance of a message when you’ve specified a data type. Therefore, a message type defines the root element of a message.
This message type is further consumed in message mappings, which we will learn later in next tutorials.

  • Step 1
    1. Choose Design > Integrations and APIs to view the list of integration packages.
    2. Select the integration package in which you want to add a Data Type or Message Type and choose Edit.
      Edit Integration Package

    3. Navigate to the Artifacts tab and choose Add > Data Type or Add > Message Type to add a data Type or message type artifact respectively.

      Add Artifact

    4. In the dialog box, choose Import from ES Repository.

    5. Now, ES Repository appears as the Source. In the Name list, select an ES Repository from the list of connected systems. The Address is automatically populated.
    6. Choose Connect. A list of available data types or message types in ES repository appears.
      Import Artifact

    7. Select the data type or message type that you wish to import.

    8. Select the Include Dependent Data Types checkbox if you wish to include the dependent data type objects while importing the selected data type or message type.
      Include Dependent Data Types

    9. Choose View Summary to view a summary of all the artifacts to be imported. From the list of objects, you can view the following object status in the Information column:

      • Create artifact: Means that this object will be created for the first time.
      Import result: create artifact
      • Skips; version already exists: Means that the selected version of this object already exists in an integration package, which can be reused. Hence, object import is skipped. Duplicate object isn’t created.
      Import result: create artifact
      • Adds new version: Means that a version of this object already exists in an integration package. But, it is not the latest version, which is being imported from the ES repository. So, latest version of the object is created.
      Import result: create artifact
      • Error; ID already exists: Means that an artifact with the same ID as the selected primary data type or message type already exists in an integration package. Choose Resolve, to assign another ID for this artifact. Then, choose View Summary.
      Import result:create artifact

    10. Choose Add. Import results with the details of created, skipped, failed artifacts appear. In the Artifacts tab, choose the added artifact to launch it in editor.

      Include Dependent Data Types

    11. Choose Edit to bring the artifact in editing mode.
      You can now start adding new nodes to the data type or message type artifacts or edit the existing details of the artifact.

      Include Dependent Data Types
  • Step 2
    1. Choose Design > Integrations and APIs to view the list of integration packages.
    2. Select the integration package in which you want to create a Data Type or Message Type and choose Edit. You can also create a new integration package first. See here.
    3. Navigate to the Artifacts tab and Add > Data Type or Add > Message Type to add a data type or message type artifact respectively.
      Add Artifact

    4. In the dialog box, choose Create.

      Create Artifact

    5. Enter the value in the fields.

      Note: Begin the target namespace with an alphabet. It can contain numbers and special characters except tilde (~), back-quote (`), and caret(^).

    6. Choose Add to stay in the Artifacts tab. CHoose the added artifact to launch it in editor.
      Or, choose Add and Open in Editor to directly open the artifact’s Structure tab.
    7. Choose Edit to bring the artifact in editing mode.
      You can now start adding new nodes to the data type or message type artifacts or edit the existing details of the artifact.

    See you in the next tutorial to study the rules and process to edit these artifacts.

    More information links:
    - Outbound Sap Cloud Connector
    - Cloud Connector

Back to Top
Back to top