Interface: SetEndpoint¶
Configuration for a step that will run after the user sets up a new account that fetches a set of endpoint domains that the user has access to and prompts the user to select the one that should apply to this account.
The selected endpoint domain is bound to this account and used as the root domain
of HTTP requests made by the fetcher. (Whenever an endpoint is associated with
an account, it is available at execution time as context.endpoint
, and alternatively
can make fetcher requests using relative URLs and the fetcher will apply the endpoint
to the URL automatically.)
As an example, we use this in the Jira pack to set up the Jira instance endpoint
to use with the user's account. A Jira account may have access to multiple
Jira instances; after authorizing the user account, this step makes an API call to
fetch all of the Jira instances that the user has access to, which are rendered as
options for the user, and the endpoint domain of the select option
(of the form
Properties¶
description¶
• description: string
A description to render to the user describing the selection they should be making, for example, "Choose an instance to use with this account".
Defined in¶
getOptionsFormula¶
• getOptionsFormula: MetadataFormula
The formula that fetches endpoints for the user
to select from. Like any MetadataFormula, this formula should return
an array of options, either strings or objects of the form
{display: '<display name>', value: '<endpoint>'}
if wanting to render a display
label to the user rather than rendering the underlying value directly.
Defined in¶
name¶
• name: string
An arbitrary name for this step, to distinguish from other steps of the same type (exceedingly rare).
Defined in¶
type¶
• type: SetEndpoint
Identifies this as a SetEndpoint step.