セットアップ

はじめに

正常に接続を確立し、ServiceNow API に要求を送信するには、[ServiceNow アプリケーションスコープ] アクティビティに ServiceNow テナントのエンドポイント URL、ユーザー名、およびパスワードを設定する必要があります。必要に応じて、ServiceNow テナントから OAuth アクセストークンを取得できます。 OAuth アクセストークンを取得するには、ServiceNow インスタンスのクライアント ID、クライアントシークレット、およびエンドポイント URL が必要です。

OAuth を使用する場合は、次の手順に従って、[ServiceNow アプリケーションスコープ] アクティビティに OAuth アクセストークンを取得する機能を設定し、他のアクティビティが ServiceNow の API に要求を正常に送信できるようにする必要があります。

1. OAuth を設定する

ServiceNow ドキュメントの「Set up OAuth」の手順を完了します。ドキュメントに記載されている手順は ServiceNow プラットフォームのすべてのリージョンで同じであると考えられますが、違いがある場合に備えて、Madrid、New York など、特定のリージョン向けの手順に従ってください。

参考までに、今回の例で OAuth を設定する方法を次に示します。

注: ServiceNow インスタンスに OAuth を設定済みの場合、アプリケーションレジストリに割り当てられたクライアント ID とクライアントシークレットをメモし、「資格情報アセットを作成する」の手順に進みます。

ServiceNow インスタンスにサインインします (例: https://dev74293.service-now.com/login)。
[ System Definitions > Plugins] に移動し、OAuth プラグインの [Status] が [Active] であることを確認します。
[System OAuth] > [Application Registry] に移動し、[New] をクリックします。
- 「What kind of OAuth application?」というメッセージが表示された場合は、[Create an OAuth API endpoint for external clients] をクリックします。
アプリケーション名 (例: UiPathQuickstart) を [Name] に入力して [ Submit ] をクリックします (正常に完了すると、[ Application Registries ] リストにリダイレクトされます)。
[Application Registries] リストで新しいアプリケーションを見つけ、その名前をクリックして詳細ページを開きます。
[Client Secret] の横の錠前アイコンをクリックすると、値が表示されます。
[ クライアント ID ] と [ クライアントシークレット ] の値をメモします (これらの値は [ServiceNow アプリケーションスコープ] アクティビティに入力します)。

重要: OAuth2 を使用するには、リダイレクト URL http://127.0.0.1:10001/authorize/ を指定する必要があります。
この OAuth アプリケーションで OAuth2 をサポートする場合は、[リダイレクト URL] を http://127.0.0.1:10001/authorize/ に設定する必要があります。

2. 資格情報アセットを作成する

[ServiceNow アプリケーションスコープ] アクティビティには、ServiceNow の資格情報 ([パスワード] と [クライアントシークレット]) のため SecureString 型変数の入力が必要です。SecureString 型変数を生成するには、Orchestrator のテナントに 2 つの資格情報アセットを作成します。

プロジェクトで使用する Orchestrator テナントにサインインします。
左側のナビゲーションで [アセット] をクリックし、[アセット] ページを開きます。
プラス (+) アイコンをクリックして新しいアセットを作成します ([アセットを作成] ウィンドウが開きます)。
[アセット名] に入力し、 [種類] ドロップダウンリストから [Credential] を選択します。
[ユーザー名] フィールドに、ServiceNow アプリケーションレジストリのクライアント IDを入力します。
[パスワード] フィールドに、ServiceNow アプリケーションレジストリのクライアントシークレットを入力します。
[作成] をクリックします。
手順 3 - 7 を繰り返し、ServiceNow のユーザー名とパスワードのために別のアセットを作成します。

3. プロジェクトをビルドする

新しいオートメーションプロジェクトを作成します。
1. UiPath Studio を開きます。
2. [新規プロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。
3. プロジェクトの [名前]、[場所]、[説明] を入力します。
4. [作成] をクリックします。
UiPath.ServiceNow.Activities パッケージをインストールします。
1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
2. [すべてのパッケージ] の下の [Beta] をクリックします。
3. [検索] バーに「ServiceNow」と入力します。
4. [インストール] をクリックし UiPath.ServiceNow.Activities のライセンスに同意します。
  - UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

完了です!

以上で設定が完了したので、プロジェクトへの ServiceNow アクティビティの追加を開始できます。

次のステップ

アクティビティの実践的な使い方を学び、すぐに使用を開始するには「クイックスタート」のページをご覧ください。このガイドには、各種アクティビティの実用的なサンプルを作成するためのステップバイステップの手順が記載されており、ServiceNow インスタンスへの接続を確認したり、入/出力プロパティに習熟したりすることができます。

ServiceNow アクティビティの詳細 (プロパティの入力/出力の例を含む) については「アクティビティ」をご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。