外部コンテンツのインデックス作成のための Trello の構成

Trello Power-Up アドミンポータルで Power-Up を作成して承認し、Trello 外部コンテンツコネクタが Trello ソースシステムにアクセスできるようにします。

始める前に

組織は Trello Enterprise プランに参加している必要があります。この計画の詳細については、「 https://trello.com/enterprise」を参照してください。

組織の Trello エンタープライズ名があることを確認してください。

注:

エンタープライズ名は、組織の Trello エンタープライズアドミンダッシュボードの URL で確認でき、形式 は https://trello.com/e/EnterpriseName/admin です。Trello エンタープライズアドミンダッシュボードの詳細については、「https://trello.com/guide/enterprise/admins-dashboard」を参照してください。

Trello Power-Up アドミンポータルの開発者権限が必要です。

必要なロール：なし

このタスクについて

Trello 外部コンテンツコネクタは、Trello REST API を使用して、Trello ソースシステム内の公開アクセス可能なボードからコンテンツを取得します。

コネクタが Trello REST API を介してTrelloソースシステムにアクセスできるようにするには、Trello Power-Up アドミンポータルで Power-Up を設定して承認する必要があります。コネクタアドミンは、Power-Up からコピーした設定を使用して、ソースシステムに適切に接続できるようにTrello外部コネクタを構成できます。

手順

1. Trello Power-Up アドミンポータルで、Trello 外部コンテンツコネクタの新しい Power-Up を作成します。
   1. https://trello.com/power-ups/adminに移動し、開発者認証情報でログインします。
   2. [新規] を選択します。
   3. 新しいパワーアップの名前を入力します。
      たとえば、「 Trello 外部コンテンツコネクタ」と入力します。
   4. 新しい Power-Up を所有する Trello ワークスペースを選択します。
      これは、外部コンテンツコネクタが取得して検索可能にするコンテンツを含むワークスペースである必要があります。
   5. オプション: 新しい Power-Up のメールアドレス、サポート連絡先のメールアドレスまたは URL、作成者名を入力します。
   6. [Create] を選択します。
   新しいパワーアップの基本情報ページに移動します。
2. 新しい Power-Up の API キーとトークンを生成します。
   1. 新しい Power-Up の [API キー ] ページに移動します。
   2. [ 新しい API キーの生成] を選択します。
   3. [API キーを生成] モーダルウィンドウで、[ API キーを生成] を選択します。
   4. 新しい API キーをコピーし、安全な場所に保存します。
      重要:

      外部コンテンツコネクタアドミンは、 Trello 外部コンテンツコネクタを構成するときにこの API キーを必要とします。
   5. [ トークン] を選択します。
   6. 認証画面で、[ 許可] を選択します。
   7. 新しいトークンをコピーし、安全な場所に保存します。
      重要:

      外部コンテンツコネクタアドミンは、 Trello 外部コンテンツコネクタを構成するときにこの API トークンを必要とします。
3. Trello からエンタープライズ (組織) の ID を取得します。
   1. この curl コマンドを実行し、 <enterprise-name> を組織の Trello エンタープライズ名に、 <api-key> をコピーした API キーに、 <api-token> をコピーした API トークンに置き換えます。

      curl --request GET \
        --url 'https://api.trello.com/1/enterprises/<enterprise-name>?key=<api-key>&token=<api-token>' \
        --header 'Accept: application/json'

   2. curl 応答から idEnterprise 値をコピーし、安全な場所に保存します。
      重要:

      外部コンテンツコネクタアドミンは、 Trello 外部コンテンツコネクタを構成するときにこのエンタープライズ ID を必要とします。

次のタスク

コネクタアドミンに次のアイテムを提供します。

• ステップ 2.d でコピーした API キー。
• ステップ 2.g でコピーした API トークン。
• ステップ 3.b でコピーしたエンタープライズ ID。
• Trello REST API のベース URL。これは通常 https://api.trello.com です。

コネクタアドミンは、Trelloソースシステムからボードを取得するためのTrello外部コンテンツコネクタを構成するために、これらのアイテムを必要とします。

Trello外部コンテンツコネクターの作成と設定の詳細については、「Trello外部コンテンツコネクタの作成」を参照してください。