基本設定
# mulesoft Bmc Remedy Connector - Full Documentation
# BMC Remedy Connector
BMC Remedy Connector v3.0
BMC Remedy 用 Anypoint Connector (BMC Connector) は、BMC Remedy AR システム Java API v8.1 で構築されており、BMC Remedy AR システム 7.x 以降と互換性があります。このコネクタは、BMC Remedy AR システムの CRUD 操作を実行する方法を公開します。
BMC Remedy Connector は、BMC Remedy AR システムの組織の情報にアクセスしたり、その情報を更新したりするためのセキュアな入口として Mule アプリケーション内で機能します。
BMC Remedy AR システムに接続するアプリケーションを構築すると、BMC Remedy AR システムが公開するいくつかの操作をアプリケーションから RPC 経由で実行できます。
リリースノート: [BMC Remedy Connector リリースノート](#release-notes::connector/bmc-remedy-connector-release-notes-mule-4.adoc)
Exchange: [BMC Remedy AR システムコネクタ](https://www.mulesoft.com/exchange/com.mulesoft.connectors/mule-bmc-remedy-connector/)
## [](#始める前に)始める前に
この情報を使用するには、BMC Remedy API、Mule、Anypoint Connector、Anypoint Studio、Mule の概念、Mule フローの要素、グローバル要素に精通している必要があります。
BMC Remedy Connector を使用するには、以下が必要になります。
- BMC Remedy AR システム - BMC Remedy AR サーバーインスタンス v7.x 以降。コネクタは、BMC Remedy AR サーバー v9.1 インスタンスに対してテストされています。このドキュメントの「関連情報」セクションの「BMC インストール手順」リンクを参照してください。
- BMC Remedy AR システム Java API v8.1 - このドキュメントの「関連情報」セクションのリンクを使用してダウンロードできます。
## [](#pom-ファイル情報)POM ファイル情報
```xml
| パラメーター | 説明 |
|---|---|
Name (名前) |
参照する設定の名前を入力します。 |
Username (ユーザー名) |
ユーザー名を入力します。 |
Password (パスワード) |
パスワードを入力します。 |
サーバー |
ログイン要求を処理する AR サーバーの IP アドレスを入力します。 |
Server Port (サーバーポート) |
要求を処理するように AR サーバーが設定されているポート番号を入力します。 |
認証 |
認証文字列の別名を入力します。認証文字列の別名を使用して、ユーザーの正しい認証ドメインを識別できます。 |
Locale (ロケール) |
ロケールを入力します。 |
| パラメーター | 値 |
|---|---|
Display Name (表示名) |
HTTP |
Extension Configuration (拡張機能設定) |
まだ HTTP リスナー設定が作成されていない場合は、プラス記号をクリックして新しい HTTP リスナー設定を追加します。[Host (ホスト)] に localhost、[Port (ポート)] に 8081 の値を指定します。 |
Path (パス) |
/createUser |
| パラメーター | 説明 | 値 |
|---|---|---|
Name (名前) |
参照する設定の名前を入力します。 |
|
Username (ユーザー名) |
ユーザー名を入力します。 |
|
Password (パスワード) |
パスワードを入力します。 |
|
サーバー |
ログイン要求を処理する AR サーバーの IP を入力します。 |
|
Server Port (サーバーポート) |
要求を処理するように AR サーバーが設定されているポート番号を入力します。 |
|
| パラメーター | 値 |
|---|---|
Display Name (表示名) |
Create (作成) (または他の任意の名前)。 |
Extension Configuration (拡張機能設定) |
Remedy_Configuration - 作成したグローバル要素への参照名。 |
Remedy Form Type (Remedy フォーム種別) |
User (ユーザー) - 作成するフォーム種別。 |
エントリ |
|
| パラメーター | 値 |
|---|---|
Display Name (表示名) |
Logger (ロガー) (または他の任意の名前) |
Message (メッセージ) |
|
レベル |
INFO |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Name (名前) |
String (文字列) |
この設定の名前。コネクタはこの名前の設定を参照します。 |
x |
|
Connection (接続) |
基本設定 |
この設定に指定できる接続種別。 |
x |
|
Expiration Policy (有効期限ポリシー) |
ExpirationPolicy |
動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。ランタイムによって適切と判断されたときに、インスタンスがパージされます。 |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Username (ユーザー名) |
String (文字列) |
エンドユーザーの認証に必要なユーザー名。 |
x |
|
Password (パスワード) |
String (文字列) |
ユーザー名に関連付けられているパスワード。 |
x |
|
Server (サーバー) |
String (文字列) |
接続する Remedy サーバー URL。 |
x |
|
Server Port (サーバーポート) |
Number (数値) |
使用する serverPort。 |
||
Authentication (認証) |
String (文字列) |
|||
Locale (ロケール) |
String (文字列) |
|||
Reconnection (再接続) |
Reconnection (再接続) |
アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。 |
||
Cache Timeout Seconds (キャッシュタイムアウト (秒)) |
Number (数値) |
3600 |
||
Attachment As String (添付ファイル (文字列)) |
Boolean (ブール) |
true |
||
Enum As Id (列挙 (ID)) |
Boolean (ブール) |
false |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
エントリ |
Array of Object (オブジェクトの配列) |
作成するオブジェクトを表すマップのリスト。 |
|
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
Array of String (文字列の配列) |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
エントリ |
Object (オブジェクト) |
作成するオブジェクトを表すマップ。 |
|
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
String (文字列) |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
エントリが含まれる Remedy フォーム |
x |
|
Entry ID (エントリ ID) |
String (文字列) |
削除するエントリの ID。 |
x |
|
Delete Option (削除オプション) |
Number (数値) |
このパラメーターには 0 (将来の使用のために保持) を指定します。 |
x |
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
Entry ID (エントリ ID) |
Array of String (文字列の配列) |
取得するオブジェクトの ID が含まれるリスト |
|
|
Results use Field IDs (結果で項目 ID を使用) |
Boolean (ブール) |
省略可能 - 戻り値でキーとして項目 ID が使用されるかどうか。 |
false |
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。この式の出力は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
Array of Object (オブジェクトの配列) |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
Entry ID (エントリ ID) |
String (文字列) |
取得するオブジェクトの ID。 |
|
|
Result uses Field IDs (結果で項目 ID を使用) |
Boolean (ブール) |
省略可能 - 戻り値でキーとして項目 ID が使用されるかどうか。 |
false |
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。この式の出力は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
Object (オブジェクト) |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
Query |
String (文字列) |
解析する評価文字列 |
|
|
Result with Field ID (項目 ID が含まれる結果) |
Boolean (ブール) |
省略可能 - 戻り値でキーとして項目 ID が使用されるかどうか。 |
false |
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。この式の出力は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
Array of Object (オブジェクトの配列) |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
エントリ |
Array of Object (オブジェクトの配列) |
更新するオブジェクトの新しいバージョンを表すマップのリスト。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
エントリ |
Object (オブジェクト) |
更新するオブジェクトの新しいバージョンを表すマップ。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
エントリ |
Array of Object (オブジェクトの配列) |
作成または更新するオブジェクトを表すマップのリスト。 |
|
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。この式の出力は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
Array of String (文字列の配列) |
| Name (名前) | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Remedy Form Type (Remedy フォーム種別) |
String (文字列) |
使用する Remedy フォーム。 |
x |
|
エントリ |
Object (オブジェクト) |
作成または更新するオブジェクトを表すマップ |
|
|
Target Variable (対象変数) |
String (文字列) |
操作の出力が配置される変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。この式の出力は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
|
接続エラーが発生した場合の再試行戦略。 |
型 |
String (文字列) |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Fails Deployment (デプロイメントに失敗) |
Boolean (ブール) |
アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。 |
||
Reconnection Strategy (再接続戦略) |
|
使用する再接続戦略。 |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Frequency (頻度) |
Number (数値) |
再接続する頻度 (ミリ秒)。 |
||
Count (数) |
Number (数値) |
再接続の試行回数。 |
||
blocking (ブロック) |
Boolean (ブール) |
false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。 |
true |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Frequency (頻度) |
Number (数値) |
再接続する頻度 (ミリ秒)。 |
||
blocking (ブロック) |
Boolean (ブール) |
false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。 |
true |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Max Idle Time (最大アイドル時間) |
Number (数値) |
有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。 |
||
Time Unit (時間単位) |
Enumeration (列挙)。次のいずれかになります。
|
maxIdleTime 属性の時間単位。 |