Working With Transform Projects

In this section:

This section describes how to open, save, and publish Transform projects. It also describes how to access Transform components from an iWay Service Manager server.


Top of page

x
Opening Transform Projects

You can open a Transform project from a file system or from a Transform component, which resides on an iWay Service Manager server. For information on configuring a connection to iWay Service Manager, see Using Server Manager.



x
Procedure: How to Open a Transform Project From a File System

To open a Transform project from a file system:

  1. From the File menu, select Open, and then From File.

    The Open dialog box appears as shown in the following image.

  2. Browse through your file system and select the Transform project file you want to open.

    Note: The default file location points to the latest directory that was accessed.

  3. From the Files of type drop-down list, select Transform Project (*.gxp).
  4. Click Open.

    The Transform project you opened displays in the Transformer workspace.

    For more information on how to view Transform projects in Transformer, see Viewing Transform Projects.



x
Procedure: How to Access a Transform Component

The contents of a Transform component that resides in the iWay Registry or an iWay Service Manager configuration, can be accessed via Transformer’s Server Manager interface. For more information on configuring connections to iWay Service Manager servers, see Using Server Manager. For more information on using the iWay Registry and iWay Service Manager configurations, see the iWay Service Manager User's Guide.

To access Transform components, which reside on an iWay Service Manager server:

  1. From the File menu, select Open, and then select From Server.

    The Open From Server dialog box opens, as shown in the following image.

    The Server pane on the left contains a hierarchy tree of iWay Service Manager categories accessible via Transformer’s interface, which enables you to navigate through the iWay Registry and available configurations. The Components pane on the right lists the available Transform components located in the iWay Service Manager category that is selected on the left.

  2. Perform one of the following steps:
    1. To open a Transform component from the iWay Registry, expand the Registry node and select the Transforms category.

      Select an available Transform component in the Components pane.

    2. To open a Transform component from a configuration, expand the Configurations category, expand a specific configuration's category represented by the name of a configuration for example, base, and select the Transforms folder.

      Select an available Transform component in the Components pane.

  3. Click OK.

    For more information on how to view Transform components in Transformer, see iWay Transformer Environment.

    Note: After you make your changes to a Transform component and select Save As from the File menu, the following confirmation dialog box opens.

    If you click Yes, a Save As dialog box opens, which allows you to finish saving your Transform component.


Top of page

x
Saving Transform Projects

This section describes how to save a Transform project locally.



x
Procedure: How to Save a Transform Project

To save a Transform project:

  1. From the File menu, select Save As.

    The Save As dialog box opens as shown in the following image.

    1. Browse the file system to choose a location and file name for the project.
    2. Make sure Transform Project (*.gxp) is selected from the Files of type drop-down list.
    3. If necessary, define the encoding for your Transform project. The default is Cp1252.

      The default value is the file encoding that is used by your operating system. For more information on encoding, see Encoding Category.

  2. Click Save.

To save a project at any time during a work session, select Save from the File menu or click the Save icon on the toolbar.

You can also right-click the project name in the Project Navigator pane and select Save from the context menu, as shown in the following image.

Note: Only one Transform project file can be saved in each directory on your local disk that is specified for a specific Transform project. That directory represents the local workspace for your project. In addition, it is also recommended to keep all supporting files, for example, an input file, in the same directory where the Transform project (.gxp) file is located.



x
Closing or Exiting Multiple Transform Projects

If you try to close multiple Transform projects that contain changes by selecting Close All or Exit from the File menu, the Save Projects dialog box opens, as shown in the following image.

The Save Projects dialog box prevents you from closing active Transform projects before you have a chance to save your work. You have the option of selecting or deselecting specific Transform projects to save or all of the Transform projects that are listed.


Top of page

x
Publishing Transform Projects

After you design and test your Transform project, you can publish it to iWay Service Manager. For more information, see Using Server Manager.


Top of page

x
Template Support

This topic provides information on using Transformer templates.

Note: Using templates functionality is deprecated in the SM SP2 release. iWay Software recommends using projects, instead of templates, to manage your transformations.



x
Using Templates

A Transformer template is an XML configuration file that contains information on components and the rules of a particular transform in XML format. The Transformation Engine processes input data and builds the output data according to these rules. Each transform project requires its own template file. The main categories defined in the template file are:

Note: Template files have .xch extensions.



x
Viewing Templates

Open a Transform project and select the Template tab in the workspace. Note that the template file in the Template tab cannot be edited. It is provided for read-only purposes.

The following image shows a sample template in the Template tab.

The option to import an existing template to a current Transform project is available. To import an existing template, click File, select Template, and click Import from the submenu.

The following image shows the File menu and the submenu that becomes available after you highlight the Template option.

After you choose either the Import or Export option, an Open or Save As dialog box opens and enables you to import or export the specific template.


iWay Software