1. Homepage
  2. ServiceNow Connector (6.9)

  3. ServiceNow Connector リファレンス

All Connectors

ServiceNow Connector 6.9 リファレンス

ServiceNow 用 Anypoint Connector (ServiceNow Connector) は、Mule Runtime EngineMule (Mule) アプリケーションと ServiceNow アプリケーション間の接続を提供します。

設定

設定

パラメーター

名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定に指定する接続型。

x

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、Runtime がインスタンスをパージします。

接続種別

基本認証
パラメーター
名前 型 説明 デフォルト値 必須

Service Address (サービスアドレス)

String (文字列)

ServiceNow サービスのアドレス。

x

ServiceNow Version (ServiceNow バージョン)

Enumeration (列挙)。次のいずれかになります。

  • EUREKA

  • FUJI

  • GENEVA

  • HELSINKI

  • ISTANBUL

  • JAKARTA

  • KINGSTON

  • MADRID

  • NEW_YORK​

  • ORLANDO

  • PARIS

  • QUEBEC

ServiceNow API バージョン。

QUEBEC

User Tables List (ユーザーテーブルリスト)

Array of String (文字列の配列)

ユーザー定義テーブルのリスト。

Encoding (エンコード)

String (文字列)

Character encoding (文字エンコード)

UTF-8

User Name (ユーザー名)

String (文字列)

User Name (ユーザー名)

x

Password (パスワード)

String (文字列)

Password (パスワード)

x

Transport Configuration (トランスポート設定)

次のいずれかになります。

Sign Security Strategy (署名セキュリティ戦略)

Wss Sign Security Strategy Adapter (WSS 署名セキュリティ戦略アダプター)

署名セキュリティ戦略の WSS 設定

Username Token Security Strategy (ユーザー名トークンセキュリティ戦略)

WSS Username Token Security Strategy Adapter (WSS ユーザー名トークンセキュリティ戦略アダプター)

ユーザー名トークンセキュリティ戦略の WSS 設定

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Pooling Profile (プーリングプロファイル)

Pooling Profile (プーリングプロファイル)

接続プールの特性
OAuth 2.0 認証コード
パラメーター
名前 型 説明 デフォルト値 必須

Service Address (サービスアドレス)

String (文字列)

ServiceNow サービスのアドレス。

x

ServiceNow Version (ServiceNow バージョン)

Enumeration (列挙)。次のいずれかになります。

  • EUREKA

  • FUJI

  • GENEVA

  • HELSINKI

  • ISTANBUL

  • JAKARTA

  • KINGSTON

  • MADRID

  • NEW_YORK​

  • ORLANDO

  • PARIS

  • QUEBEC

ServiceNow API バージョン。

QUEBEC

User Tables List (ユーザーテーブルリスト)

Array of String (文字列の配列)

ユーザー定義テーブルのリスト。

Encoding (エンコード)

String (文字列)

Character encoding (文字エンコード)

UTF-8

Custom Transport Configuration (カスタムトランスポート設定)

OAuth2 HTTP Message Dispatcher Provider (OAuth2 HTTP メッセージディスパッチャープロバイダー)

Sign Security Strategy (署名セキュリティ戦略)

Wss Sign Security Strategy Adapter (WSS 署名セキュリティ戦略アダプター)

署名セキュリティ戦略の WSS 設定

Username Token Security Strategy (ユーザー名トークンセキュリティ戦略)

WSS Username Token Security Strategy Adapter (WSS ユーザー名トークンセキュリティ戦略アダプター)

usernameToken WSS 設定

Reconnection (再接続)

Reconnection (再接続)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Consumer Key (コンシューマーキー)

String (文字列)

サービスプロバイダーに登録されている OAuth consumerKey。

x

Consumer Secret (コンシューマーシークレット)

String (文字列)

サービスプロバイダーに登録されている OAuth consumerSecret。

x

Authorization Url (認証 URL)

String (文字列)

サービスプロバイダーの認証エンドポイント URL。

https://{instance-id}.service-now.com/oauth_auth.do

Access Token Url (アクセストークン URL)

String (文字列)

サービスプロバイダーの accessToken エンドポイント URL。

https://{instance-id}.service-now.com/oauth_token.do

Scopes (スコープ)

String (文字列)

OAuth ダンス時に要求する OAuth スコープ。指定しない場合、デフォルトのアノテーションの範囲になります

Resource Owner Id (リソースオーナー ID)

String (文字列)

各コンポーネントがリソースオーナー ID を参照しない場合に使用するリソースオーナー ID。

Before (前)

String (文字列)

OAuth ダンスを開始する直前に実行するフローの名前。

After (後)

String (文字列)

accessToken が受信された直後に実行するフローの名前。

リスナー設定

String (文字列)

アクセストークンコールバックエンドポイントをキャッチするリスナーの作成に使用する <http:listener-config /> への参照。

x

Callback Path (コールバックパス)

String (文字列)

アクセストークンコールバックエンドポイントのパス。

x

Authorize Path (認証パス)

String (文字列)

OAuth ダンスをトリガーするローカル HTTP エンドポイントのパス。

x

External Callback Url (外部コールバック URL)

String (文字列)

コールバックエンドポイントがプロキシの背後にあるか、直接 URL 以外でアクセスする必要がある場合、このパラメーターを使用して OAuth プロバイダーに、コールバックへのアクセスに使用すべき URL を指示します。

Object Store (オブジェクトストア)

String (文字列)

各リソースオーナー ID のデータの保存に使用するオブジェクトストアへの参照。指定されていない場合、Mule が自動的にデフォルトのオブジェクトストアをプロビジョニングします。

サポートされている操作

操作

Invoke

<servicenow:invoke>

これが ServiceNow SOAP 呼び出しのデフォルトの操作です。

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

API を使用した

String (文字列)

x

Operation (操作)

String (文字列)

サービスの操作名。

x

Show Reference Values (参照値を表示)

String (文字列)

参照項目で返す値を選択します。​sys_ids​ または ​display value​、あるいは両方を返すことができます。このオプションは、​get​ および ​getRecords​ 操作でのみ使用します。

Body (本文)

Binary (バイナリ)

SOAP メッセージに含める XML 本文。必要なパラメーターをすべて含みます。パラメーターが必要でない場合は null。

#[payload]

Headers (ヘッダー)

Binary (バイナリ)

SOAP メッセージに含める XML ヘッダー。

Attachments (添付ファイル)

Object (オブジェクト)

SOAP 要求に含める添付ファイル。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力に対して評価される式。この式の結果が対象変数に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

型

SOAP Output Envelope (SOAP 出力エンベロープ)

Attributes Type (属性型)

SOAP Attributes (SOAP 属性)

次の設定の場合

スロー

  • SERVICENOW:RETRY_EXHAUSTED

  • SERVICENOW:SOAP_FAULT

  • SERVICENOW:PROCESSING_ERROR

  • SERVICENOW:BAD_RESPONSE

  • SERVICENOW:TIMEOUT

  • SERVICENOW:CONNECTIVITY

  • SERVICENOW:BAD_REQUEST

  • SERVICENOW:CANNOT_DISPATCH

  • SERVICENOW:INVALID_WSDL

  • SERVICENOW:ENCODING

Unauthorize

<servicenow:unauthorize>

この操作は、特定のリソースオーナー ID のアクセストークン情報をすべて削除して、OAuth ダンスが繰り返されない限り、そのユーザー向けの操作を実行できないようにします。

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Resource Owner Id (リソースオーナー ID)

String (文字列)

アクセスを無効にするリソースオーナーの ID。

次の設定の場合

型

Wss Sign Security Strategy Adapter (WSS 署名セキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Key Store Configuration (キーストア設定)

Wss Key Store Configuration (Wss キーストア設定)

メッセージに署名するときに使用するキーストア。

x

Sign Algorithm Configuration (署名アルゴリズム設定)

WSS Signing Configuration Adapter (WSS 署名設定アダプター)

署名に使用するアルゴリズム。

Wss Key Store Configuration (Wss キーストア設定)

項目 型 説明 デフォルト値 必須

Key Store Path (キーストアのパス)

String (文字列)

x

Alias (別名)

String (文字列)

Password (パスワード)

String (文字列)

x

Key Password (キーパスワード)

String (文字列)

Type (型)

String (文字列)

jks

WSS Signing Configuration Adapter (WSS 署名設定アダプター)

項目 型 説明 デフォルト値 必須

Signature Key Identifier (署名キー識別子)

Enumeration (列挙)。次のいずれかになります。

  • DIRECT_REFERENCE​

  • X509_KEY_IDENTIFIER

X509_KEY_IDENTIFIER

Signature Algorithm (署名アルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • RSAwithSHA1

  • RSAwithSHA224

  • RSAwithSHA256

  • RSAwithSHA384

  • RSAwithSHA512

Signature Digest Algorithm (署名ダイジェストアルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • SHA1

  • SHA256

  • SHA224

  • SHA384

  • SHA512

SHA1

Signature C14n Algorithm (署名 C14n アルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • Canonical​XML_1_0​

  • Canonical​XML_1_1​

  • ExclusiveXMLCanonicalization_​1_0

ExclusiveXMLCanonicalization_1_0

WSS Username Token Security Strategy Adapter (WSS ユーザー名トークンセキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

サービスに対する認証に必要なユーザー名。

x

Password (パスワード)

String (文字列)

サービスに対する認証に必要な提供されたユーザー名のパスワード。

x

Password Type (パスワードの種類)

Enumeration (列挙)。次のいずれかになります。

  • DIGEST

  • TEXT

#password パラメーター。

DIGEST

Reconnection (再接続)

項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイメントに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。​true​ に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

Reconnect Forever (繰り返し再接続)

項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

Pooling Profile (プーリングプロファイル)

項目 型 説明 デフォルト値 必須

Max Active (最大アクティブ)

Number (数値)

一度にセッションから借りることができる Mule コンポーネントの数を制御します。負の値に設定した場合、同時にアクティブにできるコンポーネントの数に制限はありません。指定された値が maxActive を超えた場合、プールは枯渇したと見なされます。

Max Idle (最大アイドル)

Number (数値)

プール内で同時にアイドル状態のままにできる Mule コンポーネントの最大数。負の値に設定した場合、同時にアイドルにできる Mule コンポーネントの数に制限はありません。

Max Wait (最大待機)

Number (数値)

プールが枯渇し、exhaustedAction が ​WHEN_EXHAUSTED_WAIT​ に設定されている場合に、プールされたコンポーネントが使用可能になるまで待機する時間 (ミリ秒) を指定します。

Min Eviction Millis (最小除去時間)

Number (数値)

オブジェクトが除去対象となるまでにオブジェクトをプール内でアイドル状態のままにできる最小時間を決定します。正の値以外の場合、アイドル時間のみによってオブジェクトがプールから削除されることはありません。

Eviction Check Interval Millis (除去確認間隔)

Number (数値)

オブジェクトエビクターの実行間隔 (ミリ秒) を指定します。正の値以外の場合、オブジェクトエビクターは実行されません。

Exhausted Action (枯渇アクション)

Enumeration (列挙)。次のいずれかになります。

  • WHEN_EXHAUSTED_GROW​

  • WHEN_EXHAUSTED_WAIT​

  • WHEN_EXHAUSTED_FAIL

Mule コンポーネントプールが枯渇した場合のプールの動作を指定します。

  • WHEN_EXHAUSTED_GROW
    新しい Mule インスタンスを作成して返し、​maxActive​ を無効にします。

  • WHEN_EXHAUSTED_WAIT
    新規またはアイドルオブジェクトが利用可能なるまで、​Object.wait(long)​ を呼び出してブロックする。

  • WHEN_EXHAUSTED_FAIL
    NoSuchElementException​ をスローする。

正の ​maxWait​ 値を指定した場合、最大でその時間 (数ミリ秒) ブロックされた後、​NoSuchElementException​ がスローされます。​maxThreadWait​ が負の値の場合、無期限にブロックされます。

Initialisation Policy (初期化ポリシー)

Enumeration (列挙)。次のいずれかになります。

  • INITIALISE_NONE​

  • INITIALISE_ONE​

  • INITIALISE_ALL

プールのコンポーネントを初期化する方法を決定します。

  • INITIALISE_NONE
    起動時にコンポーネントをプールに一切読み込まない。

  • INITIALISE_ONE
    起動時に 1 つの初期コンポーネントをプールに読み込む。

  • INITIALISE_ALL
    起動時にすべてのコンポーネントをプールに読み込む。

Disabled

OAuth2 HTTP Message Dispatcher Provider (OAuth2 HTTP メッセージディスパッチャープロバイダー)

項目 型 説明 デフォルト値 必須

Read Timeout (読み取りタイムアウト)

Number (数値)

5000

Read Timeout Unit (読み取りタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

MILLISECONDS

Expiration Policy (有効期限ポリシー)

項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 属性の時間単位。

SOAP Output Envelope (SOAP 出力エンベロープ)

項目 型 説明 デフォルト値 必須

Attachments (添付ファイル)

Object (オブジェクト)

Body (本文)

Binary (バイナリ)

Headers (ヘッダー)

Object (オブジェクト)

SOAP Attributes (SOAP 属性)

項目 型 説明 デフォルト値 必須

Additional Transport Data (追加トランスポートデータ)

Object (オブジェクト)

Protocol Headers (プロトコルヘッダー)

Object (オブジェクト)

HTTP Requester Based Transport Provider (HTTP リクエスターベースのトランスポートプロバイダー)

項目 型 説明 デフォルト値 必須

Requester Config (リクエスター設定)

String (文字列)

x

Basic Authentication HTTP Message Dispatcher Provider (基本認証 HTTP メッセージディスパッチャープロバイダー)

項目 型 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

x

Password (パスワード)

String (文字列)

x

Read Timeout (読み取りタイムアウト)

Number (数値)

5000

Read Timeout Unit (読み取りタイムアウト単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

MILLISECONDS

関連情報