Asana は、プロジェクト、タスク、会話、およびダッシュボードを提供する作業管理およびプロジェクト・トラッキング・アプリケーションであり、チームがオンラインでコラボレーションし、進行状況を追跡できるようにします。 新しい作業は、チームのメンバーがマーケティング・システムに入力した新しいリードや、ニュースレターを購読した新しい連絡先など、多くのソースから提供されます。 IBM® App Connect Enterprise から Asana に接続することで、チームが常に最新の情報を入手できるようにすることができます。
このタスクの概要
IBM App Connect Enterprise Windows、 AIX、および Linux® システムで利用可能な「 Asana Input 」および「 Asana Request 」ノードを通じて、 Asana と同期的に通信します。
メッセージ・フロー内で Asana Input ノードを使用して、 Asanaからの入力を受け入れることができます。 このノードを使用して、新規または更新されたオブジェクト (タスク、プロジェクト、ストーリーなど) について Asana をモニターできます。 Asana Input ノードの構成について詳しくは、 Asana Input ノードを参照してください。
Asana 要求 ノードを使用して、 Asana に接続し、プロジェクト、タスク、ストーリー、ワークスペースなどのオブジェクトを作成、取得、更新、または削除する要求を発行できます。 Asana Request ノードの構成について詳しくは、 Asana Request ノードを参照してください。
手順
以下のステップでは、コネクター・ディスカバリーを使用して Asana アカウントに接続し、 Asana 要求 ノードを構成する方法を示します。 Asana 入力 ノードを含むフローを作成し、それをコネクター・ディスカバリーによって構成することにより、 Asana 入力 ノードを構成して、新規オブジェクトまたは更新されたオブジェクトを Asana でモニターすることができます。
- 「 IBM App Connect Enterprise 」ツールキットで、 Asanaリクエストノードを含むフローを作成します。
- フロー内の 「Asana 要求」 ノードを選択して、エディターにノード・プロパティーを表示します。
- 「基本」 タブで、 「コネクター・ディスカバリーの起動」をクリックします。
コネクターのディスカバリー中に使用するポリシー・プロジェクトの名前とボールトの詳細を指定するパネルが表示されます。
- コネクターのディスカバリー中に使用するポリシー・プロジェクトとボールトの詳細を指定します。
- 「ポリシー・プロジェクト」 フィールドに、コネクター・ディスカバリー中に作成されるポリシーを保管するために使用されるポリシー・プロジェクトを指定します。
あるいは、「新規」をクリックし、新規ポリシー・プロジェクトの名前を指定して、新規ポリシー・プロジェクトを作成することもできます。 次に、「完了」をクリックします。
- コネクターのディスカバリー中に使用するボールトを指定します。 デフォルトでは、コネクターのディスカバリー中に使用される資格情報は、 外部ディレクトリー・ボールトに保管されます。これは、どの統合サーバーでも使用できる App Connect Enterprise ボールトです。 あるいは、資格情報を統合サーバー・ボールトに保管することもできます。統合サーバー・ボールトは、統合サーバーの作業ディレクトリーに作成され、その特定の統合サーバーでのみ使用できます。
資格情報の保管に使用するボールトを指定するには、以下のいずれかのトピックの「
コネクター・ディスカバリー・ウィザードの使用 」セクションの手順を実行します。
- 「ボールト鍵 (Vault key)」 フィールドに、ボールトに保管されている資格情報にアクセスするために使用するボールト鍵を入力します。 ボールト鍵の長さは 8 文字以上でなければなりません。
- オプション: デフォルトでは、指定されたボールト・ロケーションとボールト・キーが Toolkit の設定として保存されるため、コネクター・ディスカバリーの起動時に値が事前設定されます。 設定を保存しない場合は、ボールト設定に保存 を選択解除します。
- Asana コネクターの「コネクター・ディスカバリー」ウィザードを開始するには、 「ディスカバリーの起動」 をクリックします。
「コネクター・ディスカバリー」 ウィンドウが表示されます。 既存の Asana 接続 (アカウント) が使用可能な場合は、それらの接続のリストが表示されます。 既存の接続がない場合、 Asana コネクターの状況は Not
connectedとして表示されます。
- 1 つ以上の Asana 接続 (アカウント) が使用可能な場合は、以下のステップを実行します。
- 使用したい接続 (アカウント) をクリックして選択します。
- 必要なオブジェクト・タイプをクリックし、オブジェクトに対して実行するアクションを選択します。 例えば、 Asanaから添付ファイルを取得するには、 「添付ファイル」 をクリックし、 「添付ファイルの取得」をクリックします。
- 既存の接続 (アカウント) がない場合は、以下のステップを実行します。
- 必要なオブジェクト・タイプをクリックし、そのオブジェクトに対して実行するアクションを選択します。 例えば、 Asanaから添付ファイルを取得するには、 「添付ファイル」 をクリックし、 「添付ファイルの取得」をクリックします。
- 「接続」 をクリックします。
Asana アカウントの接続の詳細を入力するためのウィンドウが表示されます。
https://developers.asana.com/docs/oauthの説明に従って、
Asana 開発者アプリケーション・コンソールでアプリケーションを登録し、クライアント ID とクライアント・シークレットを作成します。 アクセストークンは、クライアントID、クライアントシークレット、リダイレクト URL、および承認コードから生成されます。 アプリケーションを登録した後、コネクター・ウィザードで以下の情報を入力します。
- アクセス・トークン
- リフレッシュ・トークン
- クライアント ID
- クライアント・シークレット
- 「接続」 をクリックします。
取得する添付ファイルの詳細を選択するためのウィンドウが表示されます。
- ワークスペース/組織: ドロップダウン・メニューから を選択します。 例えば、 myOrgです。
- チーム: ドロップダウン・メニューから を選択します。 例えば、 myTeamです。
- プロジェクト: ドロップダウン・メニューからプロジェクトを選択します。 例えば、 myProjectです。
- タスク: ドロップダウン・メニューからタスクを選択します。 例えば、 myTask12345などです。
- プロキシ名 ： App Connect がコネクタへの呼び出しを転送するために使用するプロキシの名前を選択または指定します。 このフィールドは、呼び出しをプロキシ経由で行う必要がある場合にのみ必須となります。 IBM App Connect Enterprise ツールキットを使用する際は、プロキシ名を次の形式で指定する必要があります： {PolicyProjectName}:HTTPProxyPolicyName
これらの接続情報の確認方法の詳細については、『 IBM 』 の「継続的デリバリー（CD）」 ドキュメントにある「Asanaでの IBM の使用方法」 App Connect をご覧ください。 App Connect in containers
- 「接続」 をクリックします。
- ウィザードで必要なコネクター・プロパティーを設定します。
データを取得するための条件を追加するには、 「条件の追加」 をクリックしてから、フィルターに掛けるプロパティーを選択します。 例えば、指定された ID を持つ添付ファイルを取得できます。 取得するレコードの最大数と、その制限を超えた場合に実行するアクションを指定するプロパティーを設定することもできます。
- 「コネクター・ディスカバリー」ウィザードでプロパティーを指定し終えたら、 「保存」をクリックします。
Asana への接続に使用される認証情報はVaultに保存され、その他の
接続情報はAsanaポリシーに保存されます。 ウィザードで設定したプロパティの値は
、 IBM App Connect Enterprise ツールキットの 「
Asana Request 」ノードに返されます。
- ディスカバリーを終了してプロパティー値を保存したら、ウィンドウの右上隅にある X をクリックするか、 Alt+F4を押して、「コネクター・ディスカバリー」ウィザードを終了します。
- 「 IBM App Connect Enterprise Toolkit 」の 「Asana Request 」ノードの編集画面に戻る。
「コネクター・ディスカバリー」ウィザード (ステップ
6) で設定したコネクター・プロパティーが、プロパティー・エディターの
「Asana 要求」 ノードに表示されるようになりました。
「基本」 タブには、ウィザードで設定した
「アクション」 プロパティーと
「オブジェクト」 プロパティーの値が表示されます。 たとえば、ウィザードで を選択した場合、ノードの
[基本] タブには以下のプロパティが表示されます：
- 処置 -
RETRIEVEALL
- オブジェクト -
Attachments
処置 プロパティーおよび オブジェクト プロパティーの値は、読み取り専用形式で表示されます。 これらの値を変更するには、「コネクター・ディスカバリーの起動」を再度クリックし、「コネクター・ディスカバリー」ウィザードで新しい値を設定します。
「 スキーマ・ベース名 」プロパティーは、 Asana コネクターとの間で送受信される要求メッセージと応答メッセージの形式を記述するスキーマ・ファイルのベース名を指定します。 スキーマ・ベース名は、ノードに対して初めてディスカバリーを実行するときに自動的に設定され、現在のフロー名とノード名に基づいています。 ディスカバリーを初めて実行する前にこのプロパティーを手動で設定した場合は、設定した値が使用されます。 ディスカバリー後にスキーマの名前を変更する場合は、プロジェクト内の名前変更されたスキーマによって使用されるスキーマ・ベース名と一致するように、このプロパティーを編集する必要があります。 ディスカバリー後にこのプロパティーを変更した場合は、一致するようにスキーマ名を変更するか、再度ディスカバリーを実行する必要があります。
「コネクター・ディスカバリー」ウィザードは、ディスカバリー中に選択されたアクションに応じて、要求スキーマと応答スキーマ、または応答スキーマのみのいずれかを生成します。 要求スキーマは、選択したアクションおよびオブジェクトが要求メッセージを必要とする場合にのみ生成されます。 生成された要求スキーマは、要求メッセージの妥当性検査に使用されます。 アクションが RETRIEVE または DELETEであった場合は、応答スキーマのみがコネクターによって返されます。
生成されたスキーマ・ファイルはプロジェクトに追加され、入力データまたは出力データを変換するために Mapping ノードで使用できます。 スキーマの完全なファイル名は、 response.schema.json または request.schema.jsonの接尾部が付いたスキーマ・ベース名 ( gen/MyMessageFlow.Asana_Requestなど) から派生します。 「要求スキーマを開く」 または 「応答スキーマを開く」をクリックして、スキーマを開くことができます。
- Asana Request ノードのプロパティー設定が正しいことを確認してから、メッセージ・フローを保存します。
- Asana Request ノードの 「接続」 タブで、 「ポリシー」 プロパティーに、接続に使用されるセキュリティー ID の詳細を含むポリシーの名前が表示されます。 ポリシーのタイプは
Asanaです。
- オプション: 「接続」 タブの 「タイムアウト」 プロパティーを設定して、ノードが Asana による操作の処理を待機する時間 (秒単位) を指定します。
- Asana 要求 ノードの 「フィルター」 タブには、メッセージ・フローがデータを選択する方法を制御するプロパティーが含まれています。 これらのプロパティーの初期値は、「コネクター・ディスカバリー」ウィザードで 「Asana」 コネクターに設定されたプロパティー値から取得されます。これには、フィルター・オプション・プロパティーと、指定されたすべての条件 (ステップ 6で説明) が含まれます。 その後、「コネクター・ディスカバリー」ウィザードに戻り、プロパティーの値を変更すると (例えば、新しい条件を追加することによって)、それらの更新はノード上のプロパティー・セットに反映されます。
「フィルター・オプション」 プロパティーは、 Asana Request ノードの実行時に操作するオブジェクトを制御します。 「フィルター制限」 プロパティーは、取得する項目の最大数と、制限を超えた場合に実行するアクションを制御します。
値を変更するには、 「フィルター・オプション」 セクションで変更する値の横にある 「編集」 をクリックし、 「フィルター制限」 セクションで設定したプロパティー値を変更します。
プロパティー値は、テキスト値にすることも、実行時に Asana Request ノードに渡されるメッセージの内容から解決される ESQL または XPATH 式にすることもできます。
- 「要求」 タブで、 「データの場所」 プロパティーを設定して、 Asanaで作成するオブジェクト・データが含まれている着信メッセージ・ツリー内の場所を指定します。 このデータは、 Asana Request ノードから Asana システムに送信される要求を形成します。
- 「結果」 タブで、 「出力データのロケーション」 プロパティーを設定して、 Asanaで作成されたレコードのデータが含まれる出力メッセージ・ツリー内のロケーションを指定します。
- デフォルトでは、要求メッセージは、コネクター・ディスカバリー中に生成された要求スキーマに照らして検証されます。 Asana 要求 ノードの 「妥当性検査」 プロパティーを使用して、要求の妥当性検査をオフにしたり、妥当性検査の設定を変更したりすることができます。
- メッセージ・フローを保存 します。