ServiceNow アプリケーションスコープ

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

ヒント: [ServiceNow アプリケーションスコープ] アクティビティでは標準認証 (ユーザー名およびパスワード) を使用できますが、以下の手順に従って、すべての接続に OAuth セキュリティを使用することを強くお勧めします。

ServiceNow アクティビティでは、OAuth 1.0 プロトコルを使用して UiPath と ServiceNow インスタンスの間で認証されたコネクションを確立します。この接続は、ロボットが ServiceNow API を呼び出し、ユーザーに代わってリソースにアクセスできるようにします。

認可を有効化するには、ServiceNow インスタンスに OAuth アプリケーションエンドポイントを作成します。このエンドポイントを作成すると、OAuth クライアントのアプリケーションレコード、クライアント ID、およびクライアントシークレットが生成され、インスタンスへの認証されたアクセスが有効化されます。

エンドポイントを作成した後で、アプリケーションエンドポイントの URL、クライアント ID、およびクライアントシークレットとともに、ServiceNow の資格情報を [ServiceNow アプリケーションスコープ] アクティビティに入力します。

ヒント:

連携ユーザーの ロール には、 このパッケージのアクティビティによって有効化されるタスクの実行に必要な最小限の権限 を割り当てることもできます (例: admin、itil、soap_ecc などは、 連携ユーザーのロールには使用すべきではありません)。テーブルを変更する受信 Web サービスの実行権限は、適切なシステムロールに限定して割り当てます。

詳細については、ServiceNow ドキュメントの「Roles」セクションをご覧ください。

動作のしくみ

以下の手順とメッセージシーケンスダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

「セットアップ」の手順を完了します。
各 SecureString 入力プロパティのためにアクティビティを追加します (例: パスワード用とクライアントシークレット用に 1 つずつ、合計 2 つ)。
プロジェクトに [ServiceNow アプリケーションスコープ] アクティビティを追加します。
[認証] セクションと [接続] セクションのプロパティ値を入力します。
[出力] セクションのプロパティのために IConnection 変数を作成し、入力します。
- この変数は、後続の [ServiceNow アプリケーションスコープ] アクティビティで使用できます。

標準認証を使用して問題が発生した場合は、「標準認証のヒント」をご覧ください。

アクティビティの本体

プロジェクトをビルドし、他のアクティビティでオブジェクトウィザードを有効化するには、[設定] ボタンをクリックして接続ウィザードを使用する必要があります。

詳細については、「ServiceNow について」の「ウィザード」セクションをご覧ください。

プロパティ

認証

ユーザー名 - ServiceNow インスタンスのユーザー名です。String 型変数を入力します。
- 複数のインスタンスがある場合、この値は ServiceNow アカウント名とは異なる場合があります。
- ユーザー名はパスワードと関連付けられています。「セットアップ」ガイドの「資格情報アセットを作成する」セクションに従って、String 型変数を作成することをお勧めします。
- String 変数を入力するには、資格情報アセットを出力する [資格情報を取得] アクティビティを使用します (以下の例を参照)。
パスワード - ServiceNow インスタンスの ([ユーザー名] に関連付けられた) パスワードです。String または String 型変数を入力します。
- 複数のインスタンスがある場合、この値は ServiceNow アカウント名とは異なる場合があります。
- ユーザー名はパスワードと関連付けられています。「セットアップ」ガイドの「資格情報アセットを作成する」セクションに従って、String 型変数を作成することをお勧めします。
- String 変数を入力するには、資格情報アセットを出力する [資格情報を取得] アクティビティを使用します (以下の例を参照)。
クライアントシークレット - UiPath と ServiceNow インスタンスの間の通信の認証に使用する SecureString です。SecureString 型変数を入力します。
- アプリケーションのレジストリを完了すると、ServiceNow インスタンスに対してクライアントシークレットが生成されます。詳細については、「セットアップ」ガイドの「OAuth を設定する」セクションをご覧ください。
- SecureString 型変数を生成するには、「セットアップ」ガイドの「資格情報アセットを作成する」セクションをご覧ください。
- SecureString 変数を入力するには、資格情報アセットを出力する [資格情報を取得] アクティビティを使用します (以下の例を参照)。
クライアント ID - アプリケーションレジストリに対して自動生成される一意の ID です。String 型変数を入力します。
- アプリケーションのレジストリを完了すると、ServiceNow インスタンスに対してクライアント ID が生成されます。詳細については、「セットアップ」ガイドの「OAuth を設定する」セクションをご覧ください。
- クライアント ID は クライアントシークレットと関連付けられています。「セットアップ」ガイドの「資格情報アセットを作成する」セクションに従って、String 型変数を作成することをお勧めします。
- String 変数を入力するには、資格情報アセットを出力する [資格情報を取得] アクティビティを使用します (以下の例を参照)。
OAuth 2.0 を使用 - ServiceNow の OAuth2 の認可コードフローを使用する場合はオンにします。

共通

表示名 - アクティビティの表示名です。 String または String 型変数を入力します。

コネクション

エンドポイント URL - ServiceNow インスタンスの URL です。String または String 型変数を入力します。 URL は、アプリケーションレジストリのリダイレクト URL ではなく、ServiceNow インスタンスの URL である必要があります。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

API エラーを例外として報告 - 選択すると、このアプリケーションスコープを使用するすべての子アクティビティにより API エラー応答がビジネスアクティビティ実行例外として報告されます。選択しないと、子アクティビティは API エラーメッセージを [応答ステータス] 出力プロパティに追加し、ワークフローの実行を続行します。ワークフローが正常に実行されたかどうかを確認するには [応答ステータス] プロパティを確認します。

出力

ServiceNow 接続 - 後続の [ServiceNow アプリケーションスコープ] アクティビティで使用できる、確立済み接続のレコードです。IConnection 型変数を入力します (UiPath.BAF.Models.Connection.IConnection)。

既存の接続を使用

既存の ServiceNow 接続 - 親の [ServiceNow アプリケーションスコープ] アクティビティから取得する接続レコードです。新しい接続を確立する代わりに使用できます。IConnection 型変数を入力します (UiPath.BAF.Models.Connection.IConnection)。
- IConnection 型変数は、以前に実行して、まだアクティブな接続を保っている [ServiceNow アプリケーションスコープ] アクティビティ (親) のものを使用する必要があります。
- このプロパティを使用して接続を確立できない場合は、親の [ServiceNow アプリケーションスコープ] アクティビティを再実行してみてください。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順および例は、クイックスタートガイドをご覧ください。

標準認証のヒント

ServiceNow アクティビティパッケージでは、アクティビティの実行に基本認証 (ユーザー名とパスワード) を使用できます。以下に、手順を示します。

設計時

設計時に、ユーザー名とパスワードをエンドポイント URL とともに入力して保存します。基本認証の資格情報は、スコープレベルでは ServiceNow で検証されません。基本認証の資格情報は、後で個別のアクティビティにおいて、つまりアクティビティの実行中に ServiceNow のエンティティが取得されるときにのみ、認証に使用されます。