XChange ​

XChangeは、組織がワークスペース全体で自動化アセットを標準化し、ガバナンスを適用できるようにするパッケージ管理および配布プラットフォームです。

ビルダーは、MCPサーバー、Genies、レシピ、コネクション、ルックアップ テーブルなどの自動化アセットをパッケージ化し、レビュー用に送信します。 キュレーターはパッケージバージョンをレビューして承認し、2つのモデルを通じて配布を制御します。 キュレーターは、テナントワークスペースのユーザーがパッケージを参照してインストールできるプライベートコミュニティにパッケージを公開するか、パッケージをテナントワークスペースに直接配布できます。

これにより、アセットの作成と承認から、制御された配布およびインストール済みバージョンの可視化まで、ガバナンスされたエンドツーエンドのパイプラインが作成されます。

ロールと権限 ​

XChangeはロールベースのアクセス制御（RBAC）を使用して、パッケージの作成、キュレーション、および利用へのアクセスを管理します。

このガイドでは、次のロールを使用します:

• ビルダー: 自動化アセットをパッケージ化します。
• キュレーター: パッケージバージョンをレビューして承認し、配布を管理します。
• コンシューマー: パッケージを参照、インストール、および使用するテナントワークスペースのユーザー。 Admin privileges（管理者権限）のXChangeタブでは、パッケージの作成、キュレーション、および利用へのアクセスを制御します。

次の権限はこれらのロールにマッピングされ、各ロールが実行できるアクションを定義します:

• パッケージの作成
• キュレーション
• 利用

パッケージの作成 ​

パッケージを作成してXChangeに送信します。

キュレーション ​

XChangeでパッケージを承認、管理、および配布します。

利用 ​

XChangeからパッケージを参照してインストールします。

ダッシュボード ​

XChangeダッシュボードでは、組織内のすべてのパッケージを一元的に確認できます。 ビルダーとキュレーターは、このビューを使用して既存のパッケージを確認し、ステータスを追跡し、新しいパッケージを作成できます。

パッケージの検索とフィルタリング ​

ビルダーとキュレーターは、パッケージを検索バーを使用して、名前でパッケージを検索できます。

パッケージのフィルタリング

次のフィルタを使用してリストをフィルタリングすることもできます:

• すべてのパッケージ: レビュー待ち、配布準備完了、却下などのステータスでフィルタリングします。
• すべてのビルダー: 特定のビルダーが作成したパッケージを表示します。

パッケージの作成 ​

ビルダーは、プロジェクトを選択し、関連するアセットをバージョン付きリリースにグループ化してパッケージを作成します。

新しいパッケージを作成するには、次の手順を実行します:

バージョン ​

バージョンタブには、パッケージのすべてのバージョンがテーブルに表示されます。

バージョンタブ

ビルダーとキュレーターは、このタブを使用して、バージョン履歴の確認、導入状況の追跡、および新しいバージョンの作成ボタンを使用した新しいバージョンの作成を含むパッケージ更新の管理を行います。

インストール列には、各バージョンのインストール総数が表示されます。 バーにカーソルを合わせると、プライベートコミュニティからのライブラリインストールとワークスペースへの直接インストールの内訳を表示できます。

インストールの表示

バージョンを選択すると、その詳細ページが開きます。

バージョン詳細 ​

バージョン詳細ページには、説明、リリースノート、ステータスなど、選択したバージョンに関する情報が表示されます。

バージョン詳細ページ

ページには次の内容が含まれます:

• 説明: パッケージ機能の概要
• リリースノート: バージョンに含まれる変更の完全なリスト
• ステータス: 公開済みなどの現在の状態
• インストール: ライブラリおよび直接インストールの数

ページには次のタブも含まれます:

• 詳細: 説明、リリースノート、およびバージョン情報を表示します。
• 内容: レシピやコネクションなど、含まれるアセットを表示します。

利用状況メトリクス ​

利用状況メトリクスタブには、選択したバージョンのワークスペース全体でのインストールデータが表示されます。

利用状況メトリクスページ

インストール概要チャートには、バージョンごとのインストール数が表示されます。 ビルダーとキュレーターは、このビューを使用してバージョン間の導入状況を比較し、傾向を特定します。

顧客テーブルでは、ワークスペース別のインストールの詳細ビューを確認できます。 これには、顧客名、インストール済みバージョン、インストールのタイムスタンプ、およびライブラリインストールや直接インストールなどのインストールタイプが含まれます。

新しいパッケージのレビューと承認 ​

キュレーターは送信されたパッケージをレビューし、内容を検証して、バージョンを承認または却下します。

保留中のパッケージを開く ​

承認待ちのパッケージはXChangeダッシュボードで確認できます。

保留中のパッケージを開くには、次の手順を実行します:

レビューの送信 ​

レビューでは、キュレーターが任意のコメントを添付して決定を説明し、パッケージを承認または却下できます。

パッケージのレビューを完了した後に決定を送信するには、次の手順を実行します:

承認後、Workatoはバージョンステータスを配布準備完了に設定します。 これは、パッケージがレビューに合格したことを示します。

承認後、パッケージをワークスペースに配布するか、パッケージをライブラリに公開できます。

パッケージをライブラリに公開する ​

キュレーターは、外部ユーザーが検出してインストールできるように、承認済みパッケージバージョンをライブラリに公開します。 公開すると、選択したライブラリにバージョンが表示され、既存の公開済みバージョンが置き換えられます。 アクセス権を持つユーザーは、このバージョンをインストールできます。

プライベートライブラリに公開するには、次の手順を実行します:

Workatoはパッケージステータスを公開済みに設定します。

パッケージバージョンの公開解除 ​

キュレーターは、パッケージバージョンをライブラリから削除するために公開を解除します。

ライブラリからバージョンを削除するには、次の手順を実行します:

パッケージをワークスペースに配布する ​

キュレーターは、公開済みパッケージバージョンを1つ以上のテナントワークスペースに直接配布できます。 これにより、セルフサービスライブラリを経由せずに、レシピ、コネクション、ルックアップ テーブルなど、パッケージのアセットが対象のテナントEnvironmentにインストールされます。

配布では、以前に配布されたワークスペース全体で、1回限りのプッシュと継続的なバージョン更新の両方がサポートされます。

パッケージをワークスペースに配布するには、次の手順を実行します:

プロセスが開始されると、パッケージには完了したインストール数をリアルタイムで示す配布進行状況バナーが表示されます。 配布を中断せずに、いつでもウィンドウを閉じることができます。

配布ログ ​

配布ログには、管理者ワークスペースから開始されたすべてのプッシュベースの配布イベントが記録されます。 各エントリには次の情報が記録されます:

• パッケージ名: 配布されたパッケージ
• バージョン: 配布されたバージョン
• 対象ワークスペース: パッケージを受け取ったテナントワークスペース
• タイムスタンプ: 配布イベントの日時
• ステータス: 成功、失敗、一部成功などの配布結果

キュレーターは、このログを監査証跡として使用してデプロイメントを検証し、配布の問題をトラブルシューティングできます。

配布ログ

設定 ​

Settings（設定）タブでは、キュレーターがXChangeのガバナンス制御を設定できます。

XChange設定

テナントワークスペースからパッケージを構築する ​

指定されたテナントワークスペースは、キュレーターのレビュー用にXChangeにパッケージを作成して送信できます。 承認済みパッケージは、管理者ワークスペースで作成された場合とまったく同じように配布できます。

テナントの貢献を有効にする ​

キュレーターは、XChange設定のXChangeへのテナント貢献を許可トグルを使用して、この機能を有効にできます。 有効にすると、テナントワークスペースのユーザーは、このワークスペースのXChangeにパッケージを送信できます。

コントリビューターテーブルには、承認されたすべてのテナントワークスペースと次の情報が表示されます:

• 顧客: テナントワークスペース名
• 追加日: ワークスペースがコントリビューターとして追加された日付
• コントリビューター数: ワークスペースから貢献しているユーザーの合計数
• 送信済みパッケージ: ワークスペースによって送信されたパッケージ数

キュレーターは、コントリビューターを追加または削除して、パッケージを送信できるテナントを制御できます。

仕組み ​

テナント貢献ワークフローには、ワークスペースの承認、パッケージの作成、送信、および配布が含まれます。

認可 ​

承認されたテナントワークスペースは、コラボレーターにビルダーロールを割り当て、ビルダービューでXChangeにアクセスできます。

パッケージの作成 ​

承認済みワークスペースのビルダーは、自身のXChangeにアクセスし、管理者ワークスペースと同じフローを使用して、Dev Environmentプロジェクトからパッケージまたは新しいパッケージバージョンを作成できます。

送信 ​

送信されたパッケージは、レビューのためにキュレーターにルーティングされます。 送信には、トレーサビリティのために、貢献元ワークスペースの名前とIDが含まれます。 キュレーターは送信を承認または却下できます。 却下されたパッケージは、修正のためにビルダーに返されます。

配布 ​

承認済みパッケージはXChangeに入り、標準の配布フローに従います。 キュレーターは、それらをPrivate Communityに公開するか、管理者ワークスペースからテナントワークスペースに直接配布できます。

コンシューマーエクスペリエンス ​

エンドユーザーはコミュニティライブラリを通じて公開済みパッケージにアクセスし、自分のワークスペースで利用可能なパッケージを参照、表示、インストールできます。

コミュニティライブラリでは、2つの主要なフローがサポートされています:

• パッケージを参照: 検証済みパッケージを検索して確認します。
• パッケージをインストールまたは更新: パッケージを開き、バージョンをインストールまたは更新します。

コミュニティライブラリで検証済みパッケージを表示する ​

すべての公開済みパッケージは、コミュニティライブラリの検証済みパッケージタブに表示されます。

コミュニティライブラリで検証済みパッケージを表示するには、次の手順を実行します:

パッケージ詳細の表示 ​

パッケージ詳細ページには、選択したバージョンに関する情報が表示されます。

パッケージ詳細を表示するには、次の手順を実行します: