Use the Service tab of the Service REST rule to configure the mapping of the URL path parameters, data transforms, and other configuration options for your service.
- On the Service tab of your Service REST rule, in the
Primary page section, complete the following fields:
- In the Page class field, enter the class of the primary page for this service.
- In the Data transform field, specify a data transform to run on the service page before processing the request. Use this option to set defaults on the page.
- In the Page name field, enter a name for the page so that
you can reference it from other rules. If you leave this field blank, a page name is
- In the Resource properties section, specify the following
- In the Name field, enter the name of the variable resource parameter in the resource path.
- In the Description field, enter a description for the variable resource parameter.
- In the Map to field, select the destination or the type of
destination for the value in Pega Platform:
- Clipboard – Map to the page name or a property on the clipboard specified by the Map to key field.
- Automation input – Use an automation to implement the method. If you select this option for any resource path parameters, you must use an automation as your implementation for each method that you implement in your rule, and set the Map to key value for each method on the Methods tab.
- In the Map to key field, specify the key used to locate the
property or the rule in the destination that you specify in the Map
- If the Map to value is Clipboard, enter the property name to which to map the data at run time.
- If the Map to value is Automation input, this field is not editable. You specify the Map to key values on the Request tab of the method that you want to implement.
- In the Processing options section, specify one of the following
- End Requestor When Done – When the Processing mode field on the service package is set to Stateful, select this option to have the system end the requestor after the activity ends and the system sends a response. Stateless services ignore the value in this field. For more information, see Service Package form - Completing the Context tab.
- Method is read-only – Select this option to indicate that each use of this service does not count as a service invocation under the terms of your license agreement. For more information, see License compliance.
- Enable service SLA with fallback activity – This option displays for asynchronous execution modes. Select this option to configure a fallback activity for a time-out. For example, when the service activity does not finish after a configured amount of time, and the maximum number of violations has occurred, the fallback activity is called. No further requests are attempted until the retry interval passes. If the next attempt is successful, normal processing resumes.
- Maximum duration for service activity (milliseconds) – Enter the amount of time, in milliseconds, after which the service activity is considered to have failed. The default is 500 milliseconds. This option only displays if you select Enable service SLA with fallback activity.
- Maximum consecutive violations – Enter the number of SLA violations that must occur before the fallback activity is called. The default is 3. This option only displays if you select Enable service SLA with fallback activity.
- Retry interval (seconds) – Enter the amount of time, in seconds, to wait before attempting to process the service activity. The default is 10 seconds. This option only displays if you select Enable service SLA with fallback activity.
- Optional: If you select Enable service SLA with fallback activity, you can
choose the method for setting the values in the Maximum duration for service
activity (milliseconds), Maximum consecutive
violations, and Retry internal (seconds)
- Provide values – Select this option to manually enter values in the Maximum duration for service activity (milliseconds), Maximum consecutive violations, and Retry internal (seconds) fields, or keep the default values.
- Use application settings – Select this option to use the application settings to define the values in the Maximum duration for service activity (milliseconds), Maximum consecutive violations, and Retry internal (seconds) fields. In each field, use the Down arrow key to select an existing application setting from the list.
- To run the service with lightweight clipboard pages, in the Lightweight
clipboard mode section, select the clipboard page that you want to use.
- Select Use application settings.
- In the Setting name field, press the Down arrow key and select a clipboard page.
- In the Execution mode field, choose from the following execution
- Execute synchronously – Select this option if you want the service to run the request immediately.
- Execute synchronously (queue on error) – Select this option when you want the service to queue the request for asynchronous execution only if processing fails while executing the service activity.
- Execute asynchronously (queue for execution) – Select this option when you want the service to queue the request for asynchronous execution, return the Queue Item ID to the external application, and end the service call while the processing starts.
- In the Request processor field, select a request
- To specify whether to monitor this rule, and whether to include the clipboard state
when monitoring, in the Service monitoring field, click
- To enable monitoring for this rule, in the Select service monitoring field, select Yes.
- If you enable monitoring and you want to include the state of the primary data page in the monitoring results, in the Capture clipboard state field, select Yes.
- Click Submit.
- Optional: The Service package (includes additional processing options) section displays a link to the service package that contains your Service REST rule. To navigate to the service package if you need to make changes, click the link.
- Click Save.