Library Tab › Mapping for Object Properties Tabs › Object Properties: Settings Tab (Custom Operator)

Object Properties: Settings Tab (Custom Operator)

Target

Specifies where the custom operator is to run.

• Click the Search icon to open the Object Browser. Navigate to the target environment and select an Orchestrator touchpoint, an agent touchpoint, a proxy touchpoint, or a touchpoint group. Alternatively, enter the IP address or host name that matches a pattern specified in a Host Group in this environment.
• Specify a dataset that points to a valid target.

Target is a calculated expression.

Specifies that the Target entry is a calculated expression. Calculated expressions specify a target dynamically at runtime. Consider the following examples:

• Use a string dataset variable containing the name of the touchpoint.
• Use an Object Reference dataset variable that points to the touchpoint.

Important! When a process is destined for an import as a content package, specify the IP address or FQDN in a dataset. A dataset can be modified in the import environment, but the Target field cannot.

Match target in Host Groups only?

Specifies the search scope for an operator target when the Target field entry is an IP address or a host name (FQDN). The operator execution on the target can proceed only when the target is known to CA Process Automation. Select Disabled to allow the broadest search. Select Enabled here and Disabled for the next field for the most restricted search.

Note: A DNS lookup of a specified hostname finds associated IP addresses; a DNS lookup of the IP address finds associated hostnames.

Values: The drop-down list has the following values:

• Inherit - Use the inherited value, either Enabled or Disabled.
• Enabled - The scope of the search depends on whether the "Lookup DNS when matching target in Host Groups" field is enabled or disabled.
  • If a DNS lookup is disabled, searches: Host group reference to a remote host (exact)
  • If a DNS lookup is enabled, searches: Host group reference to a remote host (exact or DNS lookup result)
• Disabled - Search the Domain components in the following order:
  1. Touchpoint (exact or a DNS lookup result)
  2. Orchestrator (exact or a DNS lookup result)
  3. Agent (exact or a DNS lookup result)
  4. Proxy touchpoint mapping to a remote host (exact or DNS lookup result)
  5. Host group reference to a remote host (exact or DNS lookup result)

Default: Inherit

Lookup DNS when matching target in Host Groups?

When the "Match target in Host Groups only" is set to Enabled, specifies whether to limit the search through Host Group references to the entry type. For example: When the Target field entry type is an FQDN, search only host name patterns. When the Target field entry type is an IP address, search only subnets. When a DNS lookup is included, the search can also accept a host group reference to the other type, as resolved by a DNS lookup.

Values: This drop-down list has the following values:

• Inherit - Use the inherited value, either Enabled or Disabled.
• Enabled - Search all host group references. Host group references for hostnames are patterns (regular expressions) that can include the specified host name. Host group references for IP addresses are IP address subnets that are expressed in CIDR notation that can include the specified IP address. Extend the search to all host group references. Let the search find either an exact match or a match to the DNS lookup result.
• Disabled - Restrict the search to host group references that include an exact match to the Target field entry.

Default: Inherit from Environment.

Target is Read-Only

Indicates the target is read-only and cannot be changed.

Run as Caller User

Indicates the operator runs as if it were the calling entity.

'Run as Caller User' is Read-Only

Indicates the operator runs as if it were the calling entity, but as read-only so that it cannot be changed.

Group

Specifies a group name for your custom operator. This setting is used as the title of the group or folder in the Operators palette. You can use the same group name for related custom operators so that they all appear under the same folder in the Operators palette. The Custom Operator Group configuration defines common parameters and values for custom operators in the group.

Display Name

Indicates the name that is shown in the Operators palette with the icon for your custom operator. The name should be short and based on the function of your operator. Display Name is also used to provide the initial value for the Name field on the Information page of the Operator Properties. You can use any combination of letters, digits, spaces, and underscore characters.

Custom Operator Pre-execution

Specifies any code that must be performed before the custom operator runs.

Custom Operator Post-execution

Specifies any code that must be performed after the custom operator runs.