セットアップ

はじめに

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

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

1. OAuth を設定します。

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

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

   

OAuth を設定する

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

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

注:

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

1. ServiceNow インスタンスにサインインします (例: https://dev74293.service-now.com/login)

2. [System Definitions] > [Plugins] に移動し、OAuth プラグインの [Status] が **[Active]** であることを確認します。

   

3. [System OAuth] > [Application Registry] に移動し、[New] をクリックします。

   • 「What kind of OAuth application?」というメッセージが表示された場合は、**[Create an OAuth API endpoint for external clients]** をクリックします。

     

4. アプリケーション名 (例: UiPathQuickstart) を [Name] に入力して [Submit] をクリックします (正常に完了すると、[Application Registries] リストにリダイレクトされます)。

   

5. [Application Registries] リストで新しいアプリケーションを見つけ、その名前をクリックして詳細ページを開きます。

6. [Client Secret] の横の錠前アイコンをクリックすると、値が表示されます。

7. [Client ID] と [Client Secret] の値をメモします (これらの値は [ServiceNow アプリケーション スコープ] アクティビティに入力します)。

   

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

   重要:

   v1.3.8 より、ローカル ポートがサポートされるようになりました。[ServiceNow アプリケーション スコープ] で利用可能な [ローカル ポート] パラメーターの使用は任意であり、設定可能です。既定では、この値は 10001 に設定されています (例: http://127.0.0.1:10001/authorize/)。OAuth アプリケーションを構成する場合、[リダイレクト URL] を「 http://127.0.0.1:{LocalPort}/authorize/に設定します。たとえば、ローカル ポート が 10002の場合、[リダイレクト URL] は「 http://127.0.0.1:10002/authorize/」になります。同じプロジェクト内でローカル ポートを変更することはお勧めできません。ポートを変更するときは、新しいプロジェクトまたはワークフローを作成し、キャッシュ エラーが発生した場合にエラーを回避します。

   

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

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

1. プロジェクトで使用する Orchestrator テナントにサインインします。

2. 左側のナビゲーションで [アセット] をクリックし、[アセット] ページを開きます。

3. プラス (+) アイコンをクリックして新しいアセットを作成します ([アセットを作成] ウィンドウが開きます)。

   

4. [アセット名] に入力し、 [種類] ドロップダウン リストから **[Credential]** を選択します。

5. [ユーザー名] フィールドに、ServiceNow アプリケーション レジストリの**クライアント ID** を入力します。

6. [パスワード] フィールドに、ServiceNow アプリケーション レジストリの**クライアント シークレット**を入力します。

7. [Create] をクリックします。

   

8. 手順 3 - 7 を繰り返し、ServiceNow のユーザー名とパスワードのために別のアセットを作成します。

   

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

1. 新しいオートメーション プロジェクトを作成します。

   1. UiPath Studio を開きます。

   2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。

   3. プロジェクトの [名前]、[場所]、[説明] を入力します。

   4. [Create] をクリックします。

      

2. UiPath.ServiceNow.Activities パッケージをインストールします。
   1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
   2. [すべてのパッケージ] の下の [Beta] をクリックします。
   3. [検索] バーに「ServiceNow」と入力します。
   4. [インストール] をクリックし UiPath.ServiceNow.Activities のライセンスに同意します。
      • UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

完了です!

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

次のステップ

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

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