Now Assist のスポーク生成スキルを使用したスポークの作成とアクションのビルド
必要なサードパーティ API ドキュメントスニペットを入力として指定することで、統合を自動化し、再利用可能なアクションを生成します。
始める前に
必要なロール:admin
手順
- 移動先 すべて > プロセスの自動化 > ワークフロースタジオ.
- クリック 新規作成 > スポーク.
-
[スポーク情報 (Spoke Info)] 画面で、スポークを新しいスコープに作成するか既存のスコープに作成するかを指定します。
-
新しいスコープでスポークを作成する場合は、統合のロゴとして画像を選択し、フィールドに入力します。
ここでは、例として 360Learning との統合について説明します。
フィールド 説明 スポーク名 カスタムスポークを識別する名前 説明 カスタムスポークの説明。 注:[アプリスコープ名] の値は、x_<company-code>_<spoke-name>_<spoke> の形式です。デフォルトでは、<company-code> は snc です。システムプロパティ glide.appcreator.company.code の値を設定することで、会社コードを設定できます。
この構成値は、値 [アプリスコープ名] が生成されるときに使用されます。
-
既存のスコープでスポークを作成する場合は、統合のロゴとして画像を選択し、フィールドに入力します。
ここでは、例として 360Learning との統合について説明します。
フィールド 説明 アプリケーション名 既存のアプリケーション名またはスコープ。 アプリスコープ名 選択したアプリケーション名に基づいて自動入力されるスコープ名。 説明 カスタムスポークの説明。
-
新しいスコープでスポークを作成する場合は、統合のロゴとして画像を選択し、フィールドに入力します。
- [続行] をクリックします。
- [ビルド情報] 画面で、スポークのビルドに使用する方法を選択します。
-
[Now Assist] を選択して [続行] をクリックし、必要なサードパーティ API ドキュメントスニペットを指定して、再利用可能なアクションを生成します。
-
[アクションの生成] 画面で、必要なコンテンツを 360Learning API ドキュメントから [Now Assist コンテキスト] に貼り付けます。
この例では、createGroup アクションに関連するドキュメントをコピーして、[Now Assist コンテキスト] に貼り付けます。注:一度に 1 つのアクションに関連するドキュメントのみを貼り付けるようにしてください。
-
[プレビューを生成] をクリックします。
アクションのプレビューが生成されます。アクションのプロパティ、入力、出力、およびステップの詳細が表示されます。
- オプション:
生成されたアクションを変更する場合は、 [Now Assist コンテキスト] で指定したコンテンツを適宜変更し、[プレビューを再生成] をクリックします。
[Now Assist コンテキスト]で指定したコンテンツに足りないフィールドがある場合、エラーメッセージが表示されます。
- [続行] をクリックします。
- [接続とカテゴリを選択] 画面の [接続および資格情報エイリアス] で、[新規作成] をクリックします。
-
[新しい接続および資格情報エイリアスを作成 (Create new connection and credential alias)] 画面で、フィールドに入力し、エイリアス情報を入力します。
フィールド 説明 接続および認証情報名 (Connection & Credential name) 接続および資格情報エイリアスレコードを識別するための名前です。 認証のための構成テンプレート この統合に必要な認証メカニズムです。認証メカニズムとサードパーティアプリケーションの間に互換性があることを確認します。 - [エイリアス作成して続行 (Create alias and continue)] をクリックします。
-
[接続および資格情報エイリアスの構成] 画面で、フィールドに入力し、エイリアスを構成します。
フィールド 説明 接続情報 接続名 接続レコードを識別する名前です。 接続 URL サードパーティのインスタンスまたはサーバーに接続するためのベース URL。 認証情報 選択した構成テンプレートに基づいて、関連する認証情報フィールドが表示されます。認証情報レコードを設定するために必要な値を指定します。 エイリアスレコードを後で設定する場合は、[後で行う] をクリックします。
-
[Submit (送信)] をクリックします。
接続エイリアスレコードが作成されます。
- オプション:
[接続とカテゴリを選択] 画面で次の操作を行います。
- 新しいスポークの場合は、カテゴリを空のままにします。必要に応じて、後でアクションのプロパティを更新できます。
- 既存のスポークには、既存のカテゴリをアサインします。
カテゴリを利用できない場合は、アクションカテゴリ [sys_hub_category] テーブルに、統合に必要なアクションカテゴリを作成します。カテゴリがスポークと同じアプリケーションスコープで作成されていることを確認する必要があります。
- 新しいスポークの場合は、カテゴリを空のままにします。必要に応じて、後でアクションのプロパティを更新できます。
-
[公開] をクリックします。
注:不足しているフィールドがある場合、アクションを公開できません。代わりに、[アクションをドラフトとして保存] をクリックして、アクションをドラフトとして保存できます。アクションが作成されます。別のスポークアクションを作成、または [スポーク] ページに移動できます。
アクションをドラフトとして保存した場合は、下のスポークの詳細ページでこれらのドラフトアクションにアクセスできます アクション > ドラフト.