ActionLinkGroupTemplate
Represents the action link group template. Action link templates let you reuse action link definitions and package and distribute action links. An action link is a button on a feed element. Clicking on an action link can take a user to another Web page, initiate a file download, or invoke an API call to an external server or Salesforce. Use action links to integrate Salesforce and third-party services into the feed. Every action link belongs to an action link group and action links within the group are mutually exclusive.
This type extends Metadata and inherits its fields.
ActionLinkGroupTemplate components have the suffix .actionLinkGroupTemplate and are stored in the actionLinkGroupTemplates folder.
Introduced in API version 33.0.
- Type: ActionLinkTemplate[]
- Required: No
- Description: Action link templates that are associated with the action link group template.
- Type: PlatformActionGroupCategory (enumeration of type string)
- Required: Yes
- Description: Required. The location of the action link group within the feed element. Values are:
- Possible values:
- Primary — The action link group is displayed in the body of the feed element.
- Overflow — The action link group is displayed in the overflow menu of the feed element.
- Type: ActionLinkExecutionsAllowed (enumeration of type string)
- Required: Yes
- Description: Required. The number of times an action link can be executed. Values are:
- Possible values:
- Once — An action link can be executed only once across all users.
- OncePerUser — An action link can be executed only once for each user.
- Unlimited — An action link can be executed an unlimited number of times by each user. If the action link’s
actionTypeisApiorApiAsync, you can’t use this value.
- Type: int
- Required: No
- Description: Required. The number of hours from when the action link group is created until it’s removed from associated feed elements and can no longer be executed. The maximum value is 8,760.
- Type: boolean
- Required: Yes
- Description: Required. If
true, the action link group template is published. Action link group templates shouldn’t be published until at least one action link template is associated with it.
- Type: string
- Required: Yes
- Description: Required. The name of the action link group template to use in code.
ActionLinkTemplate components are used to create multiple action links that share properties.
- Type: string
- Required: Yes
- Description: Required. The action link URL. For example, a
Uiaction link URL is a Web page. ADownloadaction link URL is a link to the file to download.UiandDownloadaction link URLs are provided to clients. AnApiorApiAsyncaction link URL is a REST resource.ApiandApiAsyncaction link URLs aren’t provided to clients. Links to Salesforce can be relative. All other links must be absolute and start withhttps://.
- Type: string
- Required: No
- Description: Template for the HTTP headers sent when corresponding action links are invoked. This field can be used only for
ApiandApiAsyncaction links. This field can contain context variables and binding variables in the form{!Bindings.key}.
- Type: boolean
- Required: Yes
- Description: Required. If
true, a confirmation dialog appears before the action is executed.
- Type: boolean
- Required: Yes
- Description: Required. If
true, action links derived from this template are the default or primary action in their action groups. There can be only one default action per action group.
- Type: string
- Required: No
- Description: A custom label to display on the action link button. If none of the
LabelKeyvalues make sense for an action link, use a custom label. Set theLabelKeyfield toNoneand enter a label name in theLabelfield.
- Type: string
- Required: Yes
- Description: Required. Key for the set of labels to display for these action link states: new, pending, success, failed. For example, the Approve set contains these labels: Approve, Pending, Approved, Failed. For a complete list of keys and labels, see Action Link Labels in the Connect REST API Developer Guide.
- Type: ActionLinkType (enumeration of type string)
- Required: Yes
- Description: Required. The type of action link. One of these values:
- Possible values:
- Api — The action link calls a synchronous API at the action URL. Salesforce sets the status to
SuccessfulStatusorFailedStatusbased on the HTTP status code returned by your server. - ApiAsync — The action link calls an asynchronous API at the action URL. The action remains in a
PendingStatusstate until a third party makes a request to/connect/action-links/actionLinkIdto set the status toSuccessfulStatusorFailedStatuswhen the asynchronous operation is complete. - Download — The action link downloads a file from the action URL.
- Ui — The action link takes the user to a web page at the action URL.
- Api — The action link calls a synchronous API at the action URL. Salesforce sets the status to
-
Type: ActionLinkHttpMethod (enumeration of type string)
-
Required: Yes
-
Description: Required. HTTP method for the action URL. One of these values:
UiandDownloadaction links must useHttpGet. -
Possible values:
- HttpDelete — Returns HTTP 204 on success. Response body or output class is empty.
- HttpGet — Returns HTTP 200 on success.
- HttpHead — Returns HTTP 200 on success. Response body or output class is empty.
- HttpPatch — Returns HTTP 200 on success or HTTP 204 if the response body or output class is empty.
- HttpPost — Returns HTTP 201 on success or HTTP 204 if the response body or output class is empty. Exceptions are the batch posting resources and methods, which return HTTP 200 on success.
- HttpPut — Return HTTP 200 on success or HTTP 204 if the response body or output class is empty.
- Type: int
- Required: Yes
- Description: Required. An integer specifying the position of the action link template relative to other action links in the group. 0 is the first position.
- Type: string
- Required: No
- Description: Template for the HTTP request body sent when corresponding action links are invoked. This field can be used only for
ApiandApiAsyncaction links. This field can contain context variables and binding variables in the form{!Bindings.key}.
- Type: string
- Required: No
- Description: If you selected
CustomUserorCustomExcludedUserforUserVisibility, this field is the alias for the custom user. Use the alias in a template binding to specify the custom user when an action link group is created using the template.
- Type: ActionLinkUserVisibility (enumeration of type string)
- Required: Yes
- Description: Required. Who can see the action link. This value is set per action link, not per action link group. Values are:
- Possible values:
- Creator — Only the creator of the action link can see the action link.
- Everyone — Everyone can see the action link.
- EveryoneButCreator — Everyone but the creator of the action link can see the action link.
- Manager — Only the manager of the creator of the action link can see the action link.
- CustomUser — Only the custom user can see the action link.
- CustomExcludedUser — Everyone but the custom user can see the action link.
The following is an example of an ActionLinkGroupTemplate component.
The following is an example package.xml that references the previous definition.
If you modify action link group templates, you overwrite the related action link templates.
If you delete a published action link group template, you delete all related action link information which includes deleting all action links that were instantiated using the template from feed items.
This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.