Importing XPDL Processes

Designer can format imported XPDL processes to match that of the tools used to create them, such as ARISand Fujitsu's Interstage. It can create single or multiple Designer process models from imported XPDL containing multiple WorkflowProcess elements, and can create one or more process simulations directly from imported XPDL files that contain simulation information. Designer checks for duplicate step names during the import process, automatically incrementing each duplicate by 1 (Step, Step1, Step2, and so on).

Important:
When you manually import XPDL from ARIS, you can select Export to be used by ARIS tools. This configures the XPDL to use workspace references for call activity child processes, rather than the child processes themselves. This allows simultaneous editing of the child processes and the parent process, and is selected by default when importing from the ARIS Tasks view. When using this option, first import the child processes to your workspace, and then import the parent process.

Note:Designer's layout of imported XPDL files is dependent upon the information contained therein. There are a great number of tool-specific layout options; Designer uses the available information in the file to create its best approximation of the original tool's layout. Some tool-specific formats, such as extended attributes, cannot be used for conversion. When information is not present in the import file or cannot be used for conversion, Designer creates the process layout based on its auto-layout feature.

Import status is displayed during the import process, and includes information about the import progress and resulting files and artifacts being generated. The full import details are presented as a final report when the import process is complete, and can be exported to a file. The report includes the following information:

1. In Designer: File > Import > Software AG > Process icon

XPDL File.

a. Click the Browse button to navigate to the XPDL file you want to import. In the Open window, click Open to select the file and populate the Select file field.

b. From the Select process project list, select an existing process project into which to import the XPDL file. If you want to create a new process project for the XPDL file, click New Project to open the New Process Project window.

d. From the Select an Integration Server list, select an Integration Server that will serve as the server for the steps in the imported process, and where the imported XPDL that refers to data will be located. If you need to configure Integration Servers, click the Configure Integration Server s link to open the Integration Servers preferences page. See Integration Servers Preferences in webMethods Service Development Help.

Tip:
When an Integration Server connection is required but not available, Designer prompts you to connect. If no Integration Server is configured, Designer prompts you to configure one so you can connect to it.

e. If the XPDL you are importing contains multiple WorkflowProcess constructs, Designer combines them all into a single process by default. The Create a single process model from multiple XPDL WorkflowProcess constructs check box is automatically selected. You can clear the check box if you do not want Designer to create a single process from multiple WorkflowProcess constructs.

Note:
To create a single process design for multiple XPDL WorkflowProcess constructs, each WorkflowProcess must be mapped to a pool in the XPDL with a valid Process attribute (Process ID). Additionally, each pool must have specified size and coordinates. If these conditions are not satisfied, Designer creates multiple Designer process files, as this is its default behavior. When this situation occurs, the event is recorded in the Import Log.

Note:
If you clear the Create a single process model from multiple XPDL WorkflowProcess constructs check box, importing XPDL files containing multiple WorkflowProcess constructs results in multiple Designer processes (.process files). Importing XPDL files containing multiple WorkflowProcess constructs that contain activities with SimulationInformation results in multiple Designer simulations (.simulation files). Multiple imported processes or simulations are automatically named based on identifying information (Name or ID) of the WorkflowProcess constructs in the XPDL.

Important:
When you manually import XPDL from ARIS, you can select Export to be used by ARIS tools This configures the XPDL to use workspace references for call activity child processes, rather than the child processes themselves. This allows simultaneous editing of the child processes and the parent process, and is selected by default when importing from the ARIS Tasks view. When using this option, first import the child processes to your workspace, and then import the parent process.

f. If Export to be used by ARIS tools is selected and the XPDL being imported contains call activities that refer to child processes, Designer checks for the presence of these child processes in the Designer workspace. If they exist, the log reflects this fact and the import continues. If the referenced child processes do not exist in the workspace, Designer alerts you of this and lists these child processes. You must import them before importing the parent process. Click Cancel to stop the import wizard, then Accept Task and Import each child process listed.

g. Designer checks for duplicate step names during the import process, automatically incrementing each duplicate by 1 (Step, Step1, Step2, and so on). This protects against build errors due to duplicate step names. If you do not want your duplicate step names changed, clear the Enforce Step Name Uniqueness check box, which is selected by default. Click Next.

a. To create Integration Server documents, select the Create Integration Server Documents check box in the Inputs / Outputs section. This enables you to create Integration Server documents for the DataObjects selected in the table. If the XPDL does not contain any data to be mapped to Integration Server documents, the Inputs / Outputs section is not enabled.

DataObject	A DataObject is an XPDL element that contains one or more DataField elements. A DataObject can contain internally defined DataFields, such as Strings and Numbers, or DataFields that refer to Complex XML Data Types defined in schema definitions (XSDs).
DataField	Name of the externally referenced data as used in the XPDL file being imported. A DataField is a child of a DataObject.
External Document URL	The URL of the XSD (schema definition) where the Complex XML Data Type (data definition) resides
Create	Select the check box to create the Integration Server document for the DataObject in the same row. You can also use the Select All and Clear All buttons to select or clear all the check boxes in the table at once.

i. If you selected DataObjects from which to create Integration Server documents, you must specify their creation location (or locations). The Create a New Document Type window is pre-populated with Server, URL, and Element name values. You can edit the Element name in the text box.

Server	The Integration Server selected on the Inputs / Outputs page of the wizard. If no selection is made, Default is displayed to represent the default Integration Server.
URL	The address of the selected Server
Package	The Integration Server package containing the folder where you create the new Integration Server document
Folder	The folder where you create the new Integration Server document
Element name	The default Element name is based on the corresponding DataObject on the Inputs / Outputs page of the wizard. You can edit this name.

j. Expand the Integration Server tree to select the target folder for the new Integration Server document and populate the Package and Folder fields.

Tip:
A valid package containing a valid folder must exist before you can select them. You cannot create a new package or folder in the Create a New Document Type window.

Tip:
If you click Next in the Create a New Document Type window, you can select a source for your Integration Server document in the Select a Source window. These options are pre-selected based on the data type being imported. Internally defined data types select None, which is the default option. Externally referenced data types select XML Schema and also display the External Document URL. If you click Finish, you bypass the viewing of these pre-selected options.

l. If you are creating multiple Integration Server documents, populate the Package and Folder fields, and optionally edit the Element name in the Create a New Document Type window for each one. Then click Finish.

m. If the XPDL being imported has been edited using multiple tools, you must choose the tool whose layout you want to import. In the Select Tool ID section of the XPDL Layout window, click the Select layout list to see the available options and select the one you want. These options are dependent upon the information in the XPDL file. Click Next.

n. If the XPDL being imported contains simulation information, and you have the Designer Process Simulation feature installed, you can create one or more process simulations (.simulation files) from the import as well.

a. If the import wizard finds simulation information, it displays the Create Simulation window with the option to Create simulation already selected.

b. If the import wizard finds information for a single simulation, the Simulation Name field is populated with the same name entered for the Process name in the XPDL Import Wizard window. You can edit the process simulation name without affecting the process name. If the import wizard finds information for multiple simulations, the resulting .simulation files are automatically named based on identifying information (Name or ID) of the WorkflowProcess constructs in the XPDL.

o. If the XPDL being imported contains references to Web Services that implement activities, Designer displays the Web Service Descriptors page of the wizard. For each Web Service Descriptor (WSD) you want to use, click to select the browse button in the Run WSC wizard column in the row that contains it.

Important:
Restrictions apply concerning CentraSite predefined services. For more information, see Avoiding CentraSite Predefined Services for Import/Export.

p. Designer searches for pre-existing matching Web Service Descriptors automatically. If a WSDL has already been imported as a part of this or another process, Designer locates it. If any are found, Designer displays the Select Web Service Connector page of the wizard.

r. If you click Cancel to create a new Web Service Descriptor (WSD), Designer displays the New Web Service Descriptor page of the wizard. Provide the information listed in the table below to create a new WSD:

Server	Integration Server Name, or Default for the defined default Integration Server
URL	Integration Server URL
Package	Integration Server package name
Namespace	Select the parent namespace from the Integration Server tree
Element name	New Web Service Descriptor (WSD) name

4. Designer checks for duplicate step names during the import process, automatically incrementing each duplicate by 1 (Step, Step1, Step2, and so on). This protects against build errors due to duplicate step names. If you do not want your step names changed, clear the Enforce Step Name Uniqueness check box, which is selected by default.

6. The Progress Information window displays the import progress, and prompts you to overwrite existing resources when duplicate file names exist. When the import is complete, click Save to save the import report to a file (*.txt). This action opens the Save As window, where you can specify a file name and location for the report.

7. Click Close to close the Progress Information window. Designer automatically opens all processes (.process files) created from the imported XPDL. Simulations (.simulation files) do not open automatically. You can open them in the Solutions view.