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