カスタム統合機能

カスタム統合機能は、プラットフォームの機能を拡張するために、一般に公開されている Autodesk API を使用して開発する統合機能です。Autodesk Platform Services からサインアップしてください。API ドキュメントもそこでご覧いただけます。

カスタム統合機能の権限は、セキュア サービス アカウント(SSA)によって制御できます。SSA の詳細については、「セキュア サービス アカウント」を参照してください。

カスタム統合機能を追加する

カスタム統合を追加するには、まず Autodesk Platform Services(APS)ポータルでカスタム統合を作成する必要があります。カスタム統合機能を作成したら、Autodesk Construction Cloud プラットフォーム(ACC)に追加することができます。

注: カスタム統合機能を追加するには、ACC アカウントが必要です。
  1. [カスタム統合機能]ツールで、 [カスタム統合機能を追加] をクリックします。
  2. APS クライアント ID を入力します。クライアント ID は、カスタム統合の一意の識別子です。クライアント ID は、APS ポータルにあります。
  3. 統合機能の名前を入力します。
  4. 統合機能の説明を入力します。
  5. [次へ] をクリックします。

カスタム統合機能を追加する

  1. システムは、クライアント ID に対して以前に設定されたセキュア サービス アカウント(SSA)を自動的に取得します。
    • SSA が見つからない場合、この統合機能の権限を制御する方法はありません。SSA は、アカウント内のすべてのデータに即座にアクセスできるアカウント管理者として機能します。[続行] をクリックして、統合機能を完了します。
    • 単一の SSA が検出された場合、統合機能は自動的にこの SSA にアタッチされます。SSA アカウントがプロジェクトに招待されるまで、統合機能へのデータ アクセスは許可されません。[了解] をクリックして、統合機能を完了します。
    • 複数の SSA が検出された場合は、この統合機能にアタッチする SSA の電子メール アドレスを指定します。[追加] をクリックして、統合機能を完了します。

統合機能のステータス

統合機能のステータスは、統合機能がアクティブか非アクティブかを示します。統合機能のステータスはいつでも変更できます。統合機能の問題をトラブルシューティングするには、統合機能のステータスを非アクティブに設定することをお勧めします。

統合機能のステータスを変更するには:

  1. [カスタム統合機能]ツールの統合機能リストから、統合機能を選択します。
  2. ステータスのドロップダウン リストを選択し、目的のステータスを選択します。

統合機能のアクセス

[カスタム統合機能]ツールでリストからカスタム統合機能を選択すると、その統合機能に関する詳細(アクセス レベルなど)が表示されます。ここには、統合機能がすべてのプロジェクトに対して持つアクセスのうち最も高いレベルのアクセスが表示されます。たとえば、あるプロジェクトに対してはフル アクセスがあり、別のプロジェクトに対しては制限付きアクセスしかない場合でも、統合機能のアクセスは "フル プロジェクト アクセス" になります。

プロジェクトごとに統合機能のアクセス レベルの詳細を表示するには:

  1. [カスタム統合機能]ツールの統合機能リストから、統合機能を選択します。
  2. [統合機能のアクセス]で、プロジェクト数のリンクをクリックします。

統合機能のアクセス

次の 3 つのアクセス レベルがあり、それぞれに次の意味があります。

注: 以前は SSA がなかった統合機能に SSA をアタッチするには、セキュア サービス アカウント API のドキュメントに従って、SSA の作成後に、統合機能を削除してから再作成します。

既存の SSA のアクセスを変更するには、各プロジェクト内のプロジェクト管理者の[メンバー]ツールに移動します。

統合機能を削除する

不要になった統合機能は削除することができます。[非アクティブ]ステータスを使用して、統合機能が ACC との間でデータを転送するのを一時的に停止してください。統合機能を削除するとリストから削除されますが、再度追加することもできます。統合機能を削除するには:

  1. [カスタム統合機能]ツールの統合機能リストから、統合機能を選択します。
  2. ドロワーの[その他]メニュー [その他]メニュー をクリックします。
  3. [統合機能を削除] を選択します。
  4. 確認ダイアログで [削除] をクリックします。