Configuring Delete Services
A Delete adapter service deletes an entry from the AR System database. You identify the entry to delete by specifying the AR System form name and entry ID.
If the delete is successful, the Delete adapter service returns the Status output variable set to SUCCESS. If the Delete adapter service encountered an error and the entry could not be deleted, an exception is thrown.
For more information about the template used to create these services, see
Delete Adapter Service. For more information about adapter services, see
Using Adapter Services.
To configure a Delete 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 Delete 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 Schema tab and specify the following values:
Parameter | Description/Action |
Form Name | Select the name of the form from where the entry is to be deleted. 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 Delete adapter service will have a formName input variable. |
Entry ID | Specify the entry ID of the entry that you want the Delete adapter service to delete. Remedy Adapter populates the Entry ID field with a list of all entry IDs in the AR System that use the selected form. Rather than specifying an entry ID at design time (when you configure the Delete adapter service), you can pass the entry ID to the Delete adapter service as an input at run time. Note:
If you want to specify an entry ID at runtime, leave the parameter field blank at design time. |
9. You can select the Output Fields tab to view the fields that the Delete adapter service returns as output. The output for a Delete adapter service is always Status, which is the outcome from the delete operation. The output variable, Status, is set to SUCCESS when the row is deleted successfully. Otherwise, Status, is set to FAILURE, and an exception is thrown.
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 and EntryID.
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.