General
|
- Operation name – the name of the operation.
- Operation type – the operation to be performed. Operation
types include Create, Update, Delete, Entity Read and Other.
- Use Other only when there are no attributes
associated with the MBO. In these cases the Fill
from Attribute field is disabled since there are no
attributes associated with Other operations.
- See Entity Read Operations for
information about how and when Entity Read
operations are used.
- Comment – describes the operation.
|
Data Source
|
Information about the data source from which the operation is derived. Select Change Connection Profile to bind the operation to a different connection profile of the same data source type, or Bind Data Source to bind the operation to a data source, or to rebind to a data source. |
Definition
|
View, modify, and test operations:- View – display the operation (SQL statement, or Web service method, for example) in a read-only window.
- Edit – modify the operation definition. You can change the type of operation as long as it is supported by the data source, and validate your changes. Enter credentials, if required, to access the data source.
- Test
execute – tests the operation against the data source to which
it is bound. The Test execute dialog
allows you to load any existing test configurations and preview
the results. Be advised that using Test execute or Preview for
large data or object types (BigString/BigBinary), can result in
out of memory errors in Unwired WorkSpace.
Note: Selecting Test execute can modify data stored on the data source to which the operation is bound. However, SQL statements are automatically rolled back and do not modify data.
|
Operation Parameters |
View or configure the operation parameters that map to data
source arguments. Select Refresh to update the
parameters. For example, if the data source argument changes. Data Source- Argument – name of the operation argument.
Names cannot contain C# or Java reserved words.
- Datatype – the argument's datatype.
- Old value argument (update and delete
operations only) – maps a parameter to a second (old)
argument. See Old Value
Argument.
Value- Fill from attribute – fills the argument's value with that
of the selected attribute.
If a create,
update, or delete (CUD) operation parameter argument is
a fill from attribute parameter and is bound to a
personalization key, you cannot set < NULL > value
for this argument. If you want to pass < NULL >
value for a CUD operation parameter argument which is
fill-from-attribute, model additional operations without
personalization keys or default values bound to the
argument.
- Personalization key – select a personalization key to map
to the argument, which provides the value.
- Client Parameter – select a client parameter
to map to the argument, which provides the value.
- Default value – the default value of the
argument.
For MBO operations with a non-nullable
argument, the argument must come from either a fill-from-attribute,
personalization key, client parameter, or default value. If a
non-nullable argument includes a fill-from-attribute or client
parameter, the default value is ignored, even though Unwired
WorkSpace allows you to input a default value. Also, if the
personalization key or fill-from-attribute is used to fill the value
of the argument, the client parameter might not be used. But if the
device user returns a client parameter value, it overrides
personalization key or fill-from-attribute values.
|
Client Parameters
|
Client parameters are available in
the device application and allows the user to enter values that are
passed to the enterprise information system (EIS) operation argument
during operation replay. Client parameters can be mapped to operation
parameter arguments to determine how the client passes information to
the EIS:- Name – name of the client parameter. Names
cannot contain C# or Java reserved words.
- Datatype– the argument's datatype. BigString/BigBinary
datatypes are not supported, and an error displays if the MBO
developer selects a structure type that contains BigString or
BigBinary fields.
To
provide client parameters for BigString/BigBinary datatypes,
or a structure with BigString/BigBinary fields, use
compatible types: String for BigString, Binary for
BigBinary. For a structure, copy the original structure in
WorkSpace Navigator, and change the large object type fields
to String/Binary, then use the new structure as the datatype
of the client parameter.
- Nullable – accepts null as a valid value.
|
Output |
(Create, Update, and Entity Read
operations) Configure the remote operation results-to-MBO mapping by
selecting the remote operation result and connecting it to the MBO
attribute to which it maps. Alternatively, map the entire output to MBO
by connecting the high-level result to the MBO. See Output Mapping for additional guidelines.
Most guidelines for multiple mappings (composite relationship) apply to
a single result. |
Roles
|
Lists all logical roles granted to
the operation along with all available roles. Use
Add and Add All to
move available roles to granted, and Remove and
Remove All to remove roles from an operation.
Select Create to define a new role. Entity Read
operations do not support roles. |
Cache Policy
|
Determine how the results of an MBO operation are applied to the Unwired Server cache. See Cache Policy. |