Configuring and Using Schema Sets

In this section:

How to:

Schema sets can now be configured, which consist of logically related schemas in a hierarchical structure. This provides support for importing schemas within schemas. In iIT, a schema set has the same role as a standalone schema, and is lifecycle managed.

Procedure: How to Create a Schema Set

To create a schema set:

  1. Click File in the menu bar, select New, and click Schema Set.

    The New Schema Set window appears and a unique ID is assigned to the new schema set instance, as shown in the following image.

  2. In the Name field, add a name to the schema set, and click Finish.

    Note: Existing schemas can be converted to schema sets from the main menu. The content of the schema set can then be edited using the Integration Explorer.

Procedure: How to Edit a Schema Set

To edit a schema set:

  1. In the left pane, click on the Integration Explorer tab.
  2. Expand the Schemas folder, and then expand the Dtp Schema Set node.
  3. Click the .iwresource file.

    A sample .iwresource file is provided below. Notice that there is no <file> element specified.

    <?xml version="1.0" encoding="UTF-8"?>
    <cli:IWResource
    xmlns:cli="http://registry.iwaysoftware.com/xml/client">
        <Name> Dtp Schema Set </Name>
        <Type>schema</Type>
        <File>schema</File>
        <Description/>
        <GUID>88D1081F11CF09F9D1A17E0E26037964</GUID>
        <targetServer>7.0.0</targetServer>
    </cli:IWResource>

Procedure: How to Export Managed Schema From iSM Using iWay Explorer

To export managed schema from iSM using iWay Explorer:

  1. In iWay Explorer, expand Registry, Components, and then Schemas.
  2. Right-click an available schema node that you want to export (for example, PFIVPResponse) and select Export, as shown in the following image.

    The .xsd file node for the schema is created, as shown in the following image.

Procedure: How to Export Managed Schema From iSM Using Integration Explorer

To export managed schema from iSM using Integration Explorer:

  1. Under the main project folder, expand the Schemas folder.
  2. Right-click an available schema (for example, PFIVPResponse) and select Convert to Schema Set.

    Note: All managed and unmanaged schemas have the Convert to Schema Set option.

    The .xsd file node for the schema is created, as shown in the following image.

Procedure: How to Assign a Schema Set to a Start Object

You can assign a schema set for a Start object in a process flow to describe the input document.

  1. Right-click the Flows folder in your Integration Project, select New, and then click Process Flow.

    The New Process Flow Wizard opens and displays the General Properties pane, as shown in the following image.

  2. Provide a name for your process flow, a brief description (optional), and select a target server version.
  3. Click Finish.

    The new process flow is created in the designer workspace with a default Start object, as shown in the following image.

  4. Click the Start object.

    The Properties tab in the lower pane displays the properties for the selected Start object.

  5. Select the Schema tab in the left pane of the Properties tab.
  6. Click the ellipsis button to the right of the Schema field (Browse project for Schema).

    The Select Schema dialog box opens, as shown in the following image.

  7. Expand the Schemas folder in your Integration Project, an available schema set (for example, Schema_Set_Test1) and select the schema document that you want to add.

    The input schema properties for the Start object are now defined in the Properties tab, as shown in the following image.

    You can also assign a schema set for an End object in a process flow to describe the output document.

Procedure: How to Import a Schema Set From a Process Flow

To import a schema set from a process flow:

  1. Click File from the menu bar, select Import, and click Schema Set.

    The Import window appears, as shown in the following image.

  2. Select Process Flow and click Next.

    The Import Schema Set window appears.

    There are two ways to import schema sets from the file system to the workspace. You can:

    • Select the Schema Set root directory.
    • Browse to the Schema Set .zip file.

    In both cases, the Schema set root folder is the iwresource folder.

  3. Choose a project folder or directory, and then click either ellipsis (...) to select a schema.

    The Select Schema window appears.

    On the Start or End object of a process flow, you can pick a schema set or a standalone schema.

    In the XML for the process flow, the schema entry on the Start object does not distinguish between the schema set and standalone schema.

    VALUE="schemas/3C07F99DD76EF24785344FD6AAEAB771/ExchangeSchemaLibrary
    /wsdl-schema/exchange/dtp/Dtp.xsd"

    The following sample shows the dependency entry in .iwresource:

    <Dependency>
        <Name>Dtp</Name>
        <Type>schema</Type>
        <GUID>3C07F99DD76EF24785344FD6AAEAB771</GUID>
    <Path>/schemaLis/ExchangeSchemaLibrary/wsdl-schema/exchange/dtp/Dtp.xsd
    </Path>
        <UsageCount>1</UsageCount>
    </Dependency>

    Notice that the GUID value matches that of the schema set.

    When an unmanaged schema in the workspace is used on a process flow, the schema is converted to managed format.

Publishing

When a schema set is published to iSM, either independently or as a dependency of a process flow, all the schema files in the package are published. Each schema file is wrapped in a server interface ComponentFile that has a path attribute set to its relative path in the package.

When the process flow publisher requests the schema path from the schema publisher, the schema publisher navigates through the resource tree until it finds the .iwresource file. Then, it publishes all resources from that level down.

Exporting From the Registry

When the schema is exported from the registry, it goes to the default folder for schemas. A container folder is created with the name attribute of the schema set. All schema files are wrapped in server interface ComponentFiles, with paths defining where to place them within the schema set.

Deploying

A schema set can be deployed as a dependency of a process flow. The deploy support is similar to publish, in that each schema file can be deployed relative to the parent folder.

Using With iWay Integration Applications (iIA)

Similar to the schema publisher in the Publish section, when the iIA builder encounters a schema file, it navigates the resource tree until it finds the .iwresource file and takes contents from that level down into the iIA package.

Deploying From the iSM Console

The console deployment mechanism can deploy all folders and files of a schema type, while preserving the directory structures.


iWay Software