UI拡張機能ツールとアカウントの設定

Workfront FusionのUI拡張機能を作成する前に、ツールとアカウントを設定する必要があります。 これは一度おこなう必要があります。

NOTE
この記事は、ソフトウェア開発ツールに精通していることを前提としています。

前提条件

UI拡張機能ツールとアカウントを設定するには、次の手順を実行する必要があります。

  • Adobe組織へのアクセス権を持つAdobe ID。 これは、Fusionへのログインに使用するアカウントです。

  • App Builderへの開発者アクセス: 組織管理者は、Developer ロールを付与し、App Builderを含む​ Product Profile ​に追加する必要がある場合があります。 後でコマンドが「開発者以外のユーザー」で失敗する場合、または組織が表示されない場合は、Adobeの組織管理者に連絡して追加を依頼してください。

  • 最後のリリースステップの​システム管理者 (チームの他のユーザーの可能性があります)です。 作成とデプロイには開発者の役割のみが必要ですが、承認/公開用に拡張機能を送信するには、システム管理者の役割​が必要です。

    Adobeのアクセスレベルについて詳しくは、を参照してください
    Adobe ドキュメントの​ アクセスを取得する方法

  • ソフトウェアをインストールし、ターミナル コマンド (macOS、Windows、またはLinux)を実行できるコンピューター

Node.jsのインストール

Adobe ツールは​ Node.js ​で実行されます。 LTS バージョン (18または20)をインストールする必要があります。

  1. https://nodejs.orgに移動し、LTS インストーラーをダウンロードします。

  2. インストーラーを実行し、デフォルトを受け入れます。

  3. ターミナルを開いて実行して、動作することを確認します。

    code language-sh
    node --version
    npm --version
    

    バージョン番号(v20.17.010.xなど)が表示されます。

  4. (条件付き) nodeが見つからない場合は、ターミナルを閉じて再度開くか、コンピューターを再起動してください。

  5. 引き続きAdobe I/O CLI (aio) ​をインストールします。

TIP
  • 複数のNode バージョンを使用する場合は、nvmなどのバージョン マネージャーが便利ですが、オプションです。
  • Adobe CLIにはNode 18以降が必要です。 非常に新しい、非LTS バージョンは、時折問題を引き起こす可能性があるので、LTSを使用することをお勧めします。

Adobe I/O CLIをインストールします(aio

拡張機能の作成、ビルド、公開に使用するコマンドライン ツールはaioと呼ばれます。

グローバルにインストールするには:

  1. コマンドラインで次のnpm コマンドを使用します。

    code language-sh
    npm install -g @adobe/aio-cli
    
  2. 次のコマンドを使用して、インストールされていることを確認します。

    code language-sh
    aio --version
    

    @adobe/aio-cli/11.x.xのような表示になります。

  3. 引き続きAdobeにログイン ​します。

NOTE
MacOS/Linuxで権限エラーが発生した場合は、not​でsudoを使用してください。 代わりに、npmのグローバルフォルダー権限を修正するか、ホームディレクトリにインストールするNode バージョンマネージャーを使用します。

Adobeにログイン

  1. 次のコマンドを使用して、CLIをAdobe アカウントに接続します。

    code language-sh
    aio login
    
  2. 開いたブラウザーウィンドウで、Adobe IDでログインしてアクセスを承認します。

  3. ログインが成功したら、ブラウザーのタブを閉じてターミナルに戻ります。

  4. (オプション)後でログアウトするには(アカウントの切り替えなど)、次のコマンドを使用します:aio logout

  5. 引き続き​ アクティブな組織を確認してください。

アクティブな組織を確認

CLIがどの組織を指しているかを確認します。

aio console org list      # see organizations you can use
aio console where         # see your currently selected org/project/workspace

複数の組織に属している場合は、正しい組織を選択します。

aio console org select

これで、プロジェクトを作成する準備が整いました。

recommendation-more-help
workfront-fusion-help-workfront-fusion