Fusionのコンテキスト参照
UIがattach(...)を呼び出すと、Fusionは現在のセッションを説明するコンテキスト オブジェクトを共有します。 このページでは、すべてのフィールド、その意味、およびFusionとAdobe IMSIDの関連付けを説明します。
コンテキストの読み方
- 初期値：
connection.sharedContext.get("<key>") - 更新：
contextchangeイベントをリッスンします。 最新のオブジェクトはevent.detail.contextに届きます。
完全なコードパターンについては、 カスタム拡張機能UIの構築を参照してください。
const organization = connection.sharedContext.get("organization");
const fusionOrgId = organization?.id; // Fusion's organization id
const imsOrgId = connection.sharedContext.get("imsOrgId"); // Adobe IMS org id
トップレベルキー
imsTokenBearer トークンとして使用して、ユーザーの代わりにAdobeまたはFusion APIを呼び出します。 機密性が高いため、ログを記録したり、表示したりしないでください。imsOrgIdXXXXXXXXXXXX@AdobeOrgのAdobe IMS組織ID。imsUserIdteamFusion IDとIMS ID
各エンティティには Fusion ID があり（Fusion独自のAPIで使用）、存在する場合はAdobe IMSID （Adobe Platform APIで使用）があります。
organization.idimsOrgId （organization.externalOrgIdとしても公開）team.iduser.idimsUserIdorganization フィールド
これらのフィールドは、アクティブな組織レコードにあります。 ほとんどの拡張機能はid、name、および識別子のみを必要とします。
idnameexternalOrgIdimsOrgIdと同じ値）。externalIdcountryIdtimezoneIdserviceNameteamIdslicensescenariosCountactiveScenariosactiveAppsoperations, operationsExttransfer, transferExtisPausedisDeletedimsEnabledusersCountteam フィールド
これらのフィールドは、チームがアクティブな場合に表示されます。 チームがundefinedの場合は、フォールバックを指定する必要があります（例えば、チームが選択されていない組織レベルの画面など）。
idnameorganizationIdcountrytimezonelicenseactiveScenariosactiveAppsscenarioDraftsisDeleteduser フィールド
これらのフィールドは、ログインしているFusion ユーザーに適用されます。
idnameemailavatarlocaleenなどのユーザーロケール。languagetimezonetimezoneIdcountryIdlocaleIdfeaturesallow_apps、public_templates）usersAdminsRoleIduser オブジェクトには、追加の内部フィールドが含まれる場合があります。 ここで説明したフィールドのみに依存してください。 その他のフィールドは予告なく変更される可能性があり、認証関連のフィールドの中にはログを記録したり表示したりしてはならないものもあります。日付
コンテキストは拡張機能に到達する前にシリアル化されるので、日付フィールドはJavaScript Date オブジェクトではなく文字列 （ISO 8601、"2026-06-24T00:00:00.000Z"など）として到達します。 必要に応じてこれらを変換できます。
const resetDate = new Date(context.organization.nextReset);
コンテキストの更新
次の場合、Fusionはコンテキスト全体（contextchange経由）を再送信します。
- ユーザーは組織を切り替えます,
- ユーザー はチーム を切り替えるか、または
- サインイン ユーザーの情報が変更されます。
1つの値のみを変更すると仮定するのではなく、contextchange ハンドラー内で使用するすべてのキーを常に再読み取りしてください。
セキュリティのベストプラクティス
imsTokenを記録、表示、または永続化しない。 パスワードとして扱ってください。- 信頼できるAdobe/Fusion エンドポイントにのみ、HTTPS経由で
Bearerトークンとしてトークンを送信します。 - 機能が必要とするものを超えたコンテキストから個人データを保存しないでください。
トークンを使用したAPIの呼び出し
imsToken （プラス organization.id / team.id）を実際のWorkfrontに変換するには、または
CORSはブロックするため、Fusion データを使用すると、これらのAPIをブラウザーから直接呼び出すことはできません
it。 代わりに、小さなApp Builder ランタイムアクションを通じて呼び出しをルーティングします。 を参照
WorkfrontおよびFusion APIの呼び出し。
カスタム拡張機能の作成プロセスを続行するには、拡張機能の公開を参照してください。