要約：◀▼
アクションフローをLinearに連携させることで、ワークフロー内で直接、課題やプロジェクト、コメントの作成および更新、管理を行うことができます。このインテグレーションでは、課題やユーザーの検索と参照、課題の割り当て、プロジェクトの整理ができ、プラットフォームを切り替えることなく、効率的にプロジェクトの管理や課題のトラッキングを行うことが可能です。安全かつ帰属が明確な外部アクションを実行するには、専用のサービスアカウントを使用してください。
Linearは、ソフトウェア開発チーム向けに設計された課題のトラッキングおよびプロジェクト管理ツールです。アクションビルダー用Linearコネクタを使用すると、Zendeskのアクションフローで直接、課題、プロジェクト、コメントの作成や管理、課題やユーザーの検索を行い、チームの業務を整理して管理することができます。
Linearをアクションビルダーに接続する
外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。
- アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
- すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
- APIキーベースのツール（OpenAIなど）の資格情報を管理する場合、キーは、セキュアな保管場所または資格情報管理ツールに保存することをお勧めします。
- 管理センターで、サイドバーにある「
アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。 - アクションフローを新規作成するか、既存のアクションフローを編集します。
- ステップサイドバーを開きます。
- 「外部アクション」セクションで、「Linear」をクリックします。
- 「接続」をクリックします。
- Linearの指示に従って認証を行い、接続を完了します。
Linearコネクションは、OAuth 2.0 の認証コードグラント方式を使用しています。コネクションを承認すると、Linearにリダイレクトされ、Zendeskアカウントに権限を付与します。
メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびLinearで利用可能なアクションが表示されます。
アクションフローでLinearアクションを使用する
Linearアクションステップを使用して、課題、プロジェクト、コメントの作成や管理、課題やユーザーの検索を行うことができます。
課題を作成する
「課題を作成」アクションを使用して、指定した詳細情報を含む新しい課題をLinearに作成します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Title、Teamオプション：
メモ：期日は、Linearアカウントのタイムゾーンに基づいて「YYYY-MM-DD」の形式で入力してください。優先度のオプション：優先度なし、緊急、高、中、低。
|
| 出力 | 課題の詳細情報：ID、識別子、タイトル、説明、URL、プロジェクト情報、担当者情報、ステータス情報、優先度、期限、見積もり、およびタイムスタンプなど |
課題を更新する
「課題を更新」アクションを使用して、Linear内の既存の課題のプロパティを更新します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Issueオプション：
メモ：期日は、Linearアカウントのタイムゾーンに基づいて「YYYY-MM-DD」の形式で入力してください。
|
| 出力 | 更新された課題の詳細情報：ID、識別子、タイトル、説明、URL、担当者情報、ステータス情報、優先度、期限、見積もり、および更新日時など |
課題を参照する
「IDで課題を検索」アクションを使用して、特定の課題に関する詳細情報を取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Issue ID
|
| 出力 | 課題の詳細情報：ID、識別子、タイトル、説明、URL、プロジェクト情報、担当者情報、ステータス情報、優先度、期限、見積もり、およびタイムスタンプなど |
課題を検索する
「課題を検索」アクションを使用して、さまざまな条件に基づいて課題を検索します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | オプション：Team、Project、Assignee email、Status、Order by、Limit、Cursor
|
| 出力 | 課題のリスト：ID、識別子、タイトル、URL、ステータス情報、担当者情報、優先度、作成日時などの情報を含む。ページネーション情報（hasNextPage、endCursor）も含む。 |
課題にコメントを追加する
「課題にコメントを追加」アクションを使用して、既存の課題にコメントを追加します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Issue、Body
|
| 出力 | コメントの詳細情報：ID、本文、作成者の情報（IDおよび名前）、作成日時など |
ユーザーを参照する
「ユーザーを参照」アクションを使用して、メールアドレスまたは表示名からユーザー情報を取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Lookup by、Value
|
| 出力 | ユーザー情報：ID、名前、表示名、メールアドレス、アバターのURL、プロフィールのURLなど |
ユーザーを検索する
「ユーザーを検索」アクションを使用して、検索クエリに一致するユーザーを検索します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Queryオプション： |
| 出力 | ユーザーのリスト：ID、名前、表示名、メールアドレス、アバターのURLなどの情報を含む。ページネーション情報（hasNextPage、endCursor）も含む。 |
プロジェクトを作成する
「プロジェクトを作成」アクションを使用して、Linearに新しいプロジェクトを作成します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Name、Teamオプション：
メモ：開始日と終了日は、Linearアカウントのタイムゾーンに基づいて「YYYY-MM-DD」の形式で入力します。
|
| 出力 | プロジェクトの詳細情報：ID、名称、説明、URL、チーム情報（IDおよび名称）、開始日、終了日、作成日時 |
プロジェクトを更新する
「プロジェクトを更新する」アクションを使用して、既存のプロジェクトのプロパティを更新します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Projectオプション：
メモ：開始日と終了日は、Linearアカウントのタイムゾーンに基づいて「YYYY-MM-DD」の形式で入力します。
|
| 出力 | 更新プロジェクトの詳細情報：ID、名称、説明、URL、開始日、終了日、更新日時 |
プロジェクトに課題を追加する
「プロジェクトに課題を追加」アクションを使用して、既存の課題をプロジェクトに追加します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Issue、Project
|
| 出力 | 課題の詳細情報：ID、識別子、タイトル、URL、およびプロジェクト情報（IDと名称）など |
課題をメンバーに割り当てる
「課題をメンバーに割り当て」アクションを使用して、メールアドレスを指定して、チームメンバーに課題を割り当てます。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Issue、Assignee
email
|
| 出力 | 課題の詳細情報：ID、識別子、タイトル、URL、および担当者情報（IDと名称）など |