ServiceNow モジュール

Adobe Workfront Fusion のシナリオでは、ServiceNow を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりできます。

シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。

モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

ServiceNow モジュールを使用するには、ServiceNow アカウントが必要です。

ServiceNow API 情報

ServiceNow コネクタでは、以下を使用します。

ベース URL
https://{{connection.instance}}/api
API タグ
v1.5.13

ServiceNow を Workfront Fusion に接続

ServiceNow モジュールへの接続を作成するには、以下を実行します。

  1. 最初の ServiceNow モジュールの設定を開始するときは、「接続」ボックスの横にある「追加」をクリックします。

  2. 以下の情報を入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection name 新しい ServiceNow 接続の名前を入力します。
    Username ServiceNow ユーザー名を入力します。
    Password ServiceNow パスワードを入力します。
    Instance https://を付けずにServiceNowアカウントのアドレスを入力します(通常は<company>.service-now.com)。

ServiceNow モジュールとそのフィールド

ServiceNow モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の ServiceNow フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

NOTE
カスタムレコードが「レコードタイプ」フィールドで選択された場合、カスタムフィールドの読み込みに時間がかかる場合があります。
カスタムレコードがない場合、ドロップダウンは空になります。

レコードを監視

このトリガーモジュールは、レコードが作成またはアップデートされたときにシナリオをアクティブ化します。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事にあるServiceNow を Workfront Fusion に接続を参照してください。
Table type
監視するテーブルがカスタムテーブルであるか標準テーブルであるかを選択します。
Record type
監視するレコードのタイプを選択します。
Display
表示する値のタイプを選択します。
Outputs
モジュールから出力するフィールドを選択します。
Filter
新しいレコードまたは更新されたレコードのどちらを監視するかを選択します。
Limit
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。

カスタム API 呼び出し

このアクションモジュールは、ServiceNow API に対して認証済みのカスタム呼び出しを実行します。これにより、他の ServiceNow モジュールでは不可能なデータフロー自動処理を作成できます。

このモジュールを設定する際には、次のフィールドが表示されます。

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNow を Workfront Fusion に接続を参照してください。
Relative URL

モジュールとやり取りする web サーバー上のアドレスを入力します。

相対 URL を入力できます。つまり、http:// などのプロトコルを最初に含める必要はありません。これは、web サーバー上でやり取りが発生していることを示しています。

例: /api/conversations.create

Method
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例: {"name":"something-urgent"}

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などを条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を置きます。

レコードの読み取り

このアクションモジュールは、システム IDを使用して ServiceNow レコードを読み取ります。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNow を Workfront Fusion に接続を参照してください。
Record System ID
モジュールが読み取るレコードの一意の ServiceNow ID を入力またはマッピングします。
Table type
読み取るレコードがカスタムテーブルか標準テーブルかを選択します。
Record Type
モジュールが読み取る ServiceNow レコードのタイプを選択します。
Display
表示する値のタイプを選択します。
Outputs
モジュールから出力するフィールドを選択します。

ユーザーを非アクティブ化する

このアクションモジュールは、システム ID を使用することで ServiceNow でユーザーを非アクティブ化します。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNow を Workfront Fusion に接続を参照してください。
User System ID
モジュールを非アクティブ化するユーザーの一意の ServiceNow ID を入力またはマッピングします。

添付ファイルのダウンロード

このアクションモジュールは、ServiceNow レコードの添付ファイルをダウンロードします。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNow を Workfront Fusion に接続を参照してください。
Attachment System ID
モジュールでダウンロードする添付ファイルの一意の ServiceNow ID を入力またはマッピングします。

添付ファイルをアップロード

このアクションモジュールは、添付ファイルを ServiceNow レコードにアップロードします。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNow を Workfront Fusion に接続を参照してください。
Table name
添付ファイルをアップロードするテーブルの名前を入力またはマッピングします。
System ID
添付ファイルをアップロードするシステムの一意の ServiceNow ID を入力またはマッピングします。
File name
添付ファイルの名前を入力またはマッピングします
File content
ServiceNow にアップロードするファイルを入力またはマッピングします。

レコードを作成

このアクションモジュールは、新しい ServiceNow レコードを作成します。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事にあるServiceNow を Workfront Fusion に接続を参照してください。
Table type
カスタムテーブルと標準テーブルのどちらでレコードを作成するかを選択します。
Record Type
モジュールで作成する ServiceNow レコードのタイプを選択します。その後で、このレコードタイプで使用可能なフィールドに入力できます。

レコードをアップデート

このアクションモジュールは、新しい ServiceNow レコードを作成します。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNow を Workfront Fusion に接続を参照してください。
Record System ID
モジュールでアップデートするレコードの一意の ServiceNow ID を入力またはマッピングします。
Table type
アップデートするレコードがカスタムテーブルにあるか、標準テーブルにあるかを選択します。
Record Type
モジュールでアップデートする ServiceNow レコードのタイプを選択します。その後で、このレコードタイプで使用可能なフィールドに入力できます。

レコードの削除

このアクションモジュールは、インシデントやユーザーを削除します。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事の ServiceNowWorkfront Fusion への接続を参照してください。
Record Type
インシデントを削除するか、ユーザーを削除するかを選択します。
System ID
モジュールで削除するレコードの一意の ServiceNow ID を入力またはマッピングします。

レコードの検索

このモジュールは、選択した条件を使用してレコードを検索します。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

Connection
ServiceNow アカウントを Workfront Fusion に接続する手順については、この記事にあるServiceNow を Workfront Fusion に接続を参照してください。
Table type
検索するテーブルがカスタムテーブルか標準テーブルかを選択します。
Record type
検索するレコードのタイプを選択します。
Result set
モジュールが条件に一致するすべてのレコードを返すか、条件に一致する最初のレコードのみを返すかを選択します。
Maximal count of records
各シナリオの実行サイクル中に、モジュールが返すレコードの最大数を入力またはマッピングします。
Search type

モジュールで実行する検索のタイプを選択します。

  • Advanced query

  • Simple

    • Search Criteria

      モジュールで検索する条件を入力します。検索フィルターの設定に関して詳しくは、Adobe Workfront Fusion でシナリオにフィルターを追加を参照してください。

    • Sort by

      モジュールで結果を並べ替える基準となるフィールドと、結果を昇順または降順のどちらで並べ替えるかを指定します。

Display
表示する値のタイプを選択します。
Outputs
モジュールから出力するフィールドを選択します。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43