Configuring Find Services
A Find adapter service locates one or more entries that are stored in the AR System database. You identify the entries you want to find by specifying the name of the AR System form used for the entries and providing a query string to use as search criteria. The Find adapter service finds entries for the specified form that match the query string.
Note:
The Find adapter service returns the entry IDs of matching entries. It does not return the details about entries. If you want to access the details, for example, the values of the fields associated with an entry, use the Get adapter service. See
Configuring Get Services.
For more information about the template used to create these services, see
Find Adapter Service. For more information about adapter services, see
Using Adapter Services.
To configure a Find adapter service
2. Start Designer.
3. If you are using Designer, perform the following:
a. Right-click the package in which the service should be contained and select New > Adapter Service.
b. Select the parent namespace and type a name for the adapter service.
c. Click Next.
4. Select Remedy Adapter as the adapter type and click Next.
5. Select the appropriate Adapter Connection Name and click Next.
6. From the list of available templates, select the Find template and do the following:
Select a package and folder to contain the service, type a unique name for the service.
7. Click Finish.
The service is created and its parameters and controls are displayed in Designer.
8. In the editor, select the Query tab and specify the following values:
Parameter | Description/Action |
Form Name | Select the name of the form that was used for the entries that you want to find. Remedy Adapter populates the Form Name field with a list of forms that are currently defined in the AR System and that are accessible by the user that is defined for the connection. For more information, see
Configuring Adapter Connections. You can configure this form name at design time or supply it at run time. To supply the form name at run time, select the blank item from the list. If you select the blank item, the Find adapter service will have a formName input variable. |
Query String | Type a query string to narrow down the list of entries, for example, ‘Request ID' > 10. The query string will be applied against all entries that use the selected form. The Find adapter service returns the matching entries. Rather than specifying a query string at design time when you configure the Find adapter service, you can pass the query string to the Find adapter service as input at run time, for example, ${runtime_var}. If you do not specify a query string, the Find adapter service returns all entries that use the form you selected in the Form Name field. |
9. You can select the Output Fields tab to view the fields that the Find adapter service returns for each matching entry. These fields are:
EntryId, which is the entry ID for the matching entry
Description, which is a description for the entry.
10. You can select the Adapter Settings tab at any time to confirm adapter properties such as adapter name, connection name, and service template, as needed.
11. The Input/Output tab lists the input and output parameters for the service. If the service is subsequently used in a flow, its input and output signatures will be visible in the flow editor.
If you selected the blank item for Form Name, the service will have the input variables formName.
For additional information about using the Input/Output tab, see the webMethods Service Development Help for your release.
12. From the File menu, select Save.