Edit XML Maps and Interface Dialog (General)
Use this dialog to view and edit the declaration and XML maps for a method or callback. Through XML maps, you can define the relationship between values in an incoming or outgoing XML message and method or callback parameters and return values.
Provides a place to specify which map you are editing—the parameter-xml map or the return-xml map. By default, the XML pane displays a default map representing the natural mapping provided by WebLogic Server. Click in the pane or click Custom to edit the default map, creating a custom XML map.
Note: When you click in the XML pane or click Custom, WebLogic Workshop adds code for the default map to your source code immediately preceding the declaration for this method or callback. This code will reflect edits you make in the Edit Maps and Interface dialog.
Provides a place to edit the parameter-xml map, which governs mapping between values in method and callback parameters and XML messages.
Provides a place to edit the return-xml map, which governs mapping between values in method and callback return values and XML messages.
The return value of a method or callback is referred to using the special name return in the map. If the return value is an Object, you may access fields and methods of the object using standard dot notation. For example, return.field.
Note: The direction of parameter-xml and return-xml maps changes depending on the context.
In interactions between your web service and its clients (the left hand side of Design View) a method arriving at your web service has incoming parameters and an outgoing return value and callbacks have outgoing parameters and an incoming return value.
In interactions between your web service and controls (the right hand side of Design View), methods have outgoing parameters and an incoming return value and callbacks have incoming parameters and an outgoing return value.
Choose an option to specify whether to use the natural (default) mapping provided by WebLogic Server or a custom mapping:
Default — Choose this to allow WebLogic Server to use the natural mapping to describe the relationship between XML messages and your declaration's parameters and return values.
Custom — Choose this to edit the XML map, defining a custom mapping between between XML messages and your declaration's parameters and return values.
Provides a place to edit the declaration for the selected method or callback. Edits to the declaration here will be reflected in your source code.
How Do I: Add or Edit an XML Map with the Edit Maps and Interface Dialog?