        |  |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|
SAP Connect User's Guide
CHAPTER 3
As with all Composer components, the first step in creating an SAP component is to specify the XML templates needed. (For more information, see Creating a New XML Template in the Composer User's Guide.) Once you've specified the XML templates you can create a component using the template's sample documents to represent the inputs and outputs processed by your component.
Also, as part of the process of creating an SAP component, you must select an SAP connection or you can create a new one. If you created a connection beforehand, then it is available to all new SAP components as a selection.
To create a new SAP component:
Select File>New>xObject, then open the Component tab and select SAP.
NOTE: Alternatively, under Component in the Composer window category pane you can highlight SAP, click the right mouse button, then select New.
Click Next. The XML Input/Output Property Info panel of the New SAP Component Wizard appears.
Specify the Input and Output templates as follows.
Type in a name for the template under Part if you wish the name to appear in the DOM as something other than "Input".
Select a Template Category if it is different than the default category.
Select a Template Name from the list of XML templates in the selected Template Category.
To add additional input XML templates, click Add and choose a Template Category and Template Name for each.
To remove an input XML template, select an entry and click Delete.
Select an XML template for use as an Output DOM using the same steps outlined above.
NOTE: You can specify an input or output XML template that contains no structure by selecting {System}{ANY} as the Input or Output template. For more information, see "Creating an Output DOM without Using a Template" in the User's Guide.
If desired, specify a template to be used as a scratchpad under the "Temp Message" pane of the dialog window. This can be useful if you need a place to hold values that will only be used temporarily during the execution of your component or are for reference only. Select a Template Category if it is different than the default category. Then select a Template Name from the list of XML templates in the selected Template Category.
Under the "Fault Message" pane, select an XML template to be used to pass back to clients when an error condition occurs.
As above, to add additional input XML templates, click Add and choose a Template Category and Template Name for each. Repeat as many times as desired. To remove an input XML template, select an entry and click Delete.
Click Next. The Connection Info panel of the "Create a New SAP Component" Wizard appears.
Select a Connection type from the pull down list. For more information on the SAP Connection, see creating an SAP Connection Resource.
Click Finish. The component is created and the SAP Component Editor appears.
The SAP Component Editor includes all the functionality of the XML Map Component Editor. It contains mapping panes for Input and Output XML documents as well as an Action Model pane.
The SAP Component Editor's Native Environment pane (which is initially grey) will display two tabs, SAP Request and SAP Response, whenever an SAP Function Action is highlighted in the Action Model pane. The SAP Request and SAP Response tabs appear only if the Use Mapping Model checkbox is selected (default) on the SAP Function Action's SAP Request and SAP Response tabs, respectively. Therefore, the SAP Action may have only a Request Tab, or only a Response Tab, both a Request Tab and a Response Tab, or not tabs at all.
When the Native Environment Pane first opens, it displays the SAP Request tab. The SAP Request Tab allows you to map data from an Input XML document (or other available DOM) and use it as input for an SAP function's request before the SAP function is execution. For example, you could drag a customer ID number from an input DOM into an SAP Request CUSTOMID field. Once executed, the SAP function would return data associated with that customer ID.
The NEP's SAP Response Tab allows you to map data from an SAP function's response after the SAP function is executed. The data is mapped from the SAP function's Response field into an Output XML document (or other available DOM, e.g., Temp, MyDom, etc.).
Copyright © 2004 Novell, Inc. All rights reserved. Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved. more ...
