自動化で Workato を使用する
The Workato integration with Automation is only available to Jira Service Management Cloud customers on Standard, Premium or Enterprise plans. Find out how to upgrade your plan.
Atlassian supports an integration with Workato, allowing you to create a connection between your automation flows and Workato account. Read about connections in Automation.
In Jira Automation, flows are made up of a series of triggers, conditions, and actions. The Trigger Workato recipe action allows you to run an existing Workato recipe at a specific point in a flow.
「Workato レシピをトリガー」アクションを初めて使用する前に、Workato との接続を作成する必要があります。
Workato に接続する
考慮事項
Jira 自動化で Workato を使用するには、次の手順を実行します。
you need the Workato API Platform enabled. Read more about the Workato API Platform.
Workato から開発者 API トークンとプラットフォーム API/認証トークンを生成し、それらを使用して Jira 自動化から Workato 接続を作成する必要があります。
Different Workato connections can be used, or a single connection re-used across multiple Workato actions in the same flow.
Once the Workato action is added and a new connection is made, recipe changes can only be made by the admin who created the connection. However, any admin with flow editing permissions can change the payload configuration. Review the recipes available with the connection to ensure you’re aware of what data may be shared.
開発者 API トークンを生成する
To generate a developer API token, you need to be a Workato admin. Read more about Workato collaborator roles.
Workato アカウントにログインします。
Create a client role. Before you save your client role:
[プロジェクト] を選択します。
[Project assets (プロジェクト資産)] で [レシピ] を展開します。
List | GET /api/recipes の横にあるボックスにチェックを入れます。
ツールを選択します。
[API プラットフォーム] で [コレクションとエンドポイント] を展開します。
コレクション内のエンドポイントを一覧表示する | GET /api/api_endpoints の横にあるボックスにチェックを入れます。
Create an API client. Before you save your API client:
[Client role (クライアント ロール)] で、事前に作成したクライアント ロールを選択します。
API クライアントの作成後に表示される API トークンを安全な場所に保管します。
Platform API または認証トークンの生成
Workato に移動します。
Before proceeding, we recommend that you create an API recipe collection for Jira Automation.
Jira 自動化のコレクションを作成した場合は、そのコレクションを含める API コレクションに追加します。
[ 認証方法] で、[ 認証トークン] を選択します。
表示される認証トークンをコピーして、安全な場所に保存します。
Connect to Workato from an automation flow
You can create a connection with Workato by creating an automation flow that uses the Trigger Workato recipe action. This action triggers a Workato recipe that runs as part of your automation flow. You can re-use the same connection, or use different connections for any number of Workato actions in your flow.
Workato と Jira Automation 間の接続を作成するには、Jira 管理者である必要があります。
サービス プロジェクトから、[ プロジェクト設定]、[ 自動化] の順に選択します。
Select Create flow and add a trigger.
Select Add step and find the Trigger Workato recipe action by searching for ‘Workato’ in the search box.
Workato への接続を求められたら、[ 接続] を選択します。
Workato に API クライアントを登録したときに受け取った詳細情報をフォームに記入します。
接続名を入力します。
Workato の [Developer API token (開発者 API トークン)] を入力します。開発者 API トークンを生成する手順は前述のとおりです。
Enter your Base URL. Read more about defining a base URL.
Workato のプラットフォーム API または認証トークンを入力します。認証トークンを生成する手順は前述のとおりです。
[Connect] を選択します。
Workato レシピのトリガーアクションの詳細を入力します
考慮事項
Data from any recipe associated with a Workato connection created from your automation flow may be exposed to the user who triggers the flow. So when building your automation flow, you should be mindful of the data or information that may be exposed through smart values in subsequent flow actions.
Ensure the schema validation for your recipe endpoint is toggled off in your endpoint settings (regardless of the type of endpoint method used), so that the automation action can call the endpoint successfully. Read about configuring API recipe endpoints.
We recommend using POST as the HTTP verb method for passing request data and recipe inputs (avoid using GET where possible when you need to pass request data). Read about HTTP methods.
Automation has an HTTP request timeout of 30 seconds for outgoing webhooks. Complex Workato recipes that run for longer than 30 seconds may cause the flow to time out. Read about automation service limits.
Once the connection is established, you’ll be able to use the Trigger Workato recipe action in your flow.
Select a recipe: to use this action, you must select the Workato recipe you want to trigger from the flow. Only recipes with a new API endpoint as the recipe trigger will be listed. If no recipes are available, create some in Workato or use a different connection. Read about API recipes.
ヘッダー、リクエストスキーマ、およびパスパラメーターに関する情報を入力します。これはオプションですが、選択したレシピがレシピの入力方法として受け入れる場合に使用できます。これらの入力が動作するには、レシピスキーマに正しく従う必要があります。
Headers and path parameters – you can enter key value pairs as an input if your recipe expects it. We suggest using the request schema if you have complex nesting requirements. To find the header parameters, check the recipe’s request structure. To find the path parameters, check the recipe’s request endpoint.
Request schema – you can craft a request schema payload using JSON if your recipe expects it. To find the request bodies schema, check the recipe’s request structure.
完了したら、[ 次へ ] を選択します。
制限事項
パス パラメーターはスキーマを持つことができますが、サポートされているのは単純なテキストまたは数値のみです。
クエリ パラメーターはサポートされていません。GET リクエストのリクエスト スキーマは、リクエスト ペイロードとして送信されます。
コンテンツタイプ JSON を返すエンドポイントのみがサポートされています。
スマート値
You can use these smart values to access Workato request response data in subsequent flow actions.
{{workatoResponse.statusCode}} – 応答コードを返します。{{workatoResponse.headers}} – ドット表記を使用してアクセスできる応答ヘッダーを返します。{{workatoResponse.body}} – ドット表記を使用してアクセスできる応答の本文を返します (JSON オブジェクトの場合)。{{workatoResponse.body.nested_field_name}} – ドット表記を使用してアクセスできる、応答の本文のネストされた値を返します (JSON オブジェクトの場合)。
この内容はお役に立ちましたか?