Portlet Factory, Version 6.1.2

 

Creating an operation based on an integration builder

These steps describe how to create an operation based on an integration builder.

  1. In a model, add a Service Definition builder that identifies the service that holds the operation.

  2. In the model, place an integration builder (for example, SAP Function Call, SQL Call, Web Service Call, or Domino View) that can successfully access back-end data.

    See the one of the getting started guides for information on setting up integration services.

  3. Add a Service Operation builder to the model and, for the Operation Name input, enter the name to use for your operation.

    A typical name might look like findEmployees.

  4. For the Action To Call input in the Service Operation builder, look under Data Services for the back end operation.

    For example, for an SQL Call, this might be something like employeeSearch/execute.

    You can configure the inputs (if any) and results of your operation. To use the same input and result structure as the back end operation you are calling, select Use Structure From Called Action for both inputs and results, and leave the Input Field Mapping and Result Field Mapping input choices on Automatic.

    Note: You must use different techniques when working with data services and methods.

    For example, IBM® WebSphere Portlet Factory integration builders create data service operations and methods to support their operations in the WebApp. In the Action To Call input, you can select either Data Services or Methods. However, as a general rule, you should select the data service operation rather than the equivalent method. When you select an operation from Data Services, the Service Operation builder can access information about the input and output parameters of the operations, including the schema type information. When you select from Methods, specify the schema type for XML inputs or results.

    Note: The only supported methods are those with the following types of argument.

    • No argument

    • A single IXML argument

    • One or more simple arguments (String, int/Integer, Double, Boolean, and the like)

    So, for example, you cannot use methods that take a Bean argument or that take an IXML argument and one or more simple arguments.

Parent topic: Using data services

Library | Support |