Jiraをデータパイプラインソースとして設定する ​

課題、プロジェクト、ユーザー、および関連レコードを宛先に抽出するために、Jiraをデータパイプラインソースとして設定します。 このガイドを使用して、コネクションの設定、パイプラインの設定、オブジェクトの追加、同期動作と既知の制限事項の理解を行います。

サポートされている機能 ​

Jiraをパイプラインソースとして使用する場合、次の機能がサポートされます:

• クラウドおよびオンプレミス接続: HTTPS経由でJira Cloudに接続するか、オンプレミスグループ経由でJira ServerおよびJira Data Centerに接続します。 サポートされているコネクションタイプを参照して、各デプロイメントで利用可能なコネクションオプションを確認してください。
• 完全更新と増分同期: 完全更新モードと増分同期モードをサポートします。 詳細については、同期モードを参照してください。
• オブジェクトレベルの選択: Jiraオブジェクトを選択し、宛先の個別のテーブルとして同期します。
• フィールドレベルの選択: 抽出およびスキーマレプリケーション中に、各オブジェクトから含めるフィールドまたは除外するフィールドを選択します。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータマスキング: 機密フィールドをそのままレプリケートするか、宛先に到達する前にハッシュ化します。
• 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。

前提条件 ​

Jiraをデータパイプラインソースとして接続する前に、次の要件を満たしてください。

• APIアクセスが有効なJira Cloud、Jira Server、またはJira Data Centerインスタンス。
• Jiraインスタンスのホスト名。 例: workato.atlassian.net。
• 同期する予定のオブジェクトへの読み取りアクセス権。
• 選択した認証方法の認証情報。 詳細については、サポートされているコネクションタイプを参照してください。

必要な権限 ​

接続済みのJiraアカウントには、同期する予定のデータを読み取る権限が必要です。 Jiraは複数のレベルで権限を適用します。権限が不足している場合、パイプラインは403 - Forbiddenレスポンスを受信し、影響を受けるレコードをスキップします。

接続済みアカウントは、次の各条件を満たす必要があります。

• プロジェクト権限: アカウントには、同期する予定のデータを含むすべてのJiraプロジェクトに対してBrowse Projects権限が必要です。 権限は、各プロジェクトに割り当てられた権限スキームを通じて付与されます。 詳細については、Atlassianの権限ガイドを参照してください。
• 課題セキュリティレベル: プロジェクトが課題セキュリティスキームを使用している場合、アカウントは同期する予定の課題に割り当てられたセキュリティレベルのメンバーである必要があります。 アカウントがアクセスできないセキュリティレベルの課題は、抽出から除外されます。
• アプリケーションアクセス: アカウントには、データを含むJira製品へのアプリケーションアクセス権が必要です。 たとえば、Boardsオブジェクトの読み取りには、Jira Softwareのアプリケーションアクセス権が必要です。

サポートされるコネクションタイプ ​

Jiraデータパイプラインでは、次の認証方法がサポートされています。 コネクションを作成するときに、Auth typeフィールドで対応する値を選択します。

• API token: Atlassian APIトークンで認証します。 個人のAtlassianアカウントの場合はAPIトークンを選択し、Atlassianサービスアカウントの場合はService account (API token) を選択します。 どちらのオプションも、同じ設定手順と同じフィールドを使用します。 この方法では、オンプレミスJiraコネクションはサポートされません。
• OAuth 2.0: JiraアカウントからWorkatoアクセスを認可します。 Jira Cloudの場合はOAuth 2.0 (Cloud - Atlassian-hosted Jira) を選択し、オンプレミスJiraの場合はOAuth 2.0 (Data Center) を選択します。 Data Centerオプションでは追加で、JiraでクライアントIDとクライアントシークレットを生成し、それらをWorkatoに指定する必要があります。
• Personal access token: Jiraアカウントで生成した個人用アクセストークン（PAT）で認証します。 この方法では、オンプレミスJiraコネクションがサポートされます。
• Basic authentication with password: ユーザー名とパスワードで認証します。 Atlassianは、クラウドコネクションに対してこの方法を2018年12月に廃止しました。

Jiraへの接続 ​

Jiraに接続するには、次の4つの方法があります:

• APIトークン
• OAuth 2.0
• Personal access tokens
• パスワードによる基本認証

パスワードを使用したbasic authenticationではなく、API token、OAuth 2.0、またはpersonal access tokenを使用してJiraに接続することを強くお勧めします。

API token ​

OAuth 2.0 ​

Personal access tokens ​

パスワードによる基本認証 ​

パイプラインの設定 ​

Jiraをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Jiraデータパイプラインは、Jira REST APIリソースからデータを同期します。 選択した各オブジェクトは、宛先の個別のテーブルとして同期されます。 選択可能なオブジェクトは、Jiraインスタンスの設定によって異なります。 たとえば、Jira Software製品では、ボードなどの追加オブジェクトが公開されます。

利用可能なオブジェクトには次のものがあります。

• Issues: 標準フィールドと、Jiraインスタンスで設定された任意のカスタムフィールドを含む課題レコード。
• Projects: Jiraプロジェクトレコード。
• Users: Jiraユーザーレコード。
• Boards: Jira Software製品のボード。
• Fields: カスタムフィールド定義を含むフィールドメタデータ。

同期モード ​

Jiraデータパイプラインは、フルリフレッシュと増分同期をサポートしています。

完全更新 ​

フルリフレッシュ同期では、選択したオブジェクトについてJiraから利用可能なすべてのレコードを読み取り、宛先テーブルを上書きします。 実行ごとに完全なスナップショットが必要なオブジェクトには、完全更新を使用します。

増分同期 ​

増分同期では、最後に成功した実行以降に変更されたレコードのみが抽出されます。

スキーマとデータ型の処理 ​

Jiraからデータを同期する場合、スキーマとデータ型には次の考慮事項が適用されます。

カスタムフィールド ​

パイプラインは、Jiraオブジェクトに設定されたカスタムフィールドを自動的に検出し、標準フィールドとともにスキーマに含めます。 たとえば、Issuesオブジェクトには、id、key、Resolutionなどの標準フィールドと、Jiraインスタンスの課題に設定された任意のカスタムフィールドが含まれます。 個々のカスタムフィールドを選択解除して、抽出およびスキーマレプリケーションから除外します。

主キー ​

各オブジェクトには、選択解除できない主キーフィールドがあります。 たとえば、idはIssuesオブジェクトの主キーです。

制限事項 ​

Jiraをデータパイプラインソースとして使用する場合、次の制限事項が適用されます。

認証方法の制限事項 ​

次の認証の制限事項が適用されます。

• APIトークン認証では、オンプレミスJiraコネクションはサポートされません。
• パスワードを使用する基本認証はJira Cloudでは廃止されており、オンプレミスJiraのみをサポートします。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。 これより高い頻度で同期をトリガーすることはできません。