Remedy リソースアダプタは、com.waveset.adapter.RemedyResourceAdapter クラスで定義されます。

このアダプタは、次のバージョンの Remedy Help Desk をサポートします。

4.5

5.0



注	Remedy Active Sync アダプタ (com.waveset.adapter.RemedyActiveSyncResourceAdapter) は、Identity Manager 5.0 SP1 以後は非推奨になりました。現在、このアダプタのすべての機能は Remedy アダプタに含まれています。Remedy Active Sync アダプタの既存のインスタンスは引き続き機能しますが、これらのインスタンスの新しいインスタンスは作成できなくなります。

リソースを設定する際の注意事項

ARTCPPORT 環境変数および ARRPC 環境変数を設定した場合、それらの値は「Remedy TCP ポート」および「Remedy RPC ソケット」リソースパラメータに指定された値を上書きします。

Identity Manager 上で設定する際の注意事項

このリソースに必要な追加のインストール手順はありません。

使用上の注意

Identity Manager 5.5 より前の Remedy Active Sync アダプタは、「変更時に実行するプロセス」フィールドを使用して、変更が検出されたときに起動するプロセスを判断していました。このフィールドで指定されていたプロセスは、現在は Active Sync 解決プロセス規則に指定されます。この規則は、Active Sync が有効になっている場合に必要です。

Active Sync 機能を有効にしない場合、Remedy アダプタは Remedy チケットを Identity Manager ワークフローに自動的に統合します。

Active Sync 機能を使用する場合は、次の機能をサポートするようにアダプタを設定できます。

Remedy チケットスキーマの問い合わせ

静的条件 (status = 'new' など) に基づくチケットのフィルタリング

動的条件 (最後に取得されたチケットなど) に基づくチケットのフィルタリング

チケットが一致するたびに起動されるワークフローの指定

Active Sync が有効な場合、Remedy アダプタは「更新検索フィルタ」、「付加する結合子」、および「LAST FETCHED フィルタ」の各リソースパラメータを使用して、返されるチケットを判定します。「更新検索フィルタ」、「LAST FETCHED フィルタ」、またはその両方を使用するようにしてください。

「更新検索フィルタ」パラメータは、実行可能な Remedy 検索式を含む省略可能なパラメータです。このパラメータには、Remedy ユーザーアプリケーションの詳細検索条件に入力できる有効な検索式を含めることができます。有効な検索式には、フィールド、選択値、およびキーワードを含めることができます。このアダプタは、検索式の有効性を確認しません。

次の例は、Remedy User アプリケーションに用意されている Help Desk Cases サンプルフォームで使用できる検索式を示しています。

'Status' = "New"

'Case Type' = "Problem"



注	Remedy のフィールド名は一重引用符で囲み、値は二重引用符で囲みます。

「LAST FETCHED フィルタ」パラメータを使用する場合は、「付加する結合子」パラメータも指定します。「付加する結合子」パラメータには、次のいずれかの値を含めることができます。

AND - 「更新検索フィルタ」フィールドと「LAST FETCHED フィルタ」フィールドの両方の条件が論理的に真である必要があります。

OR - 「更新検索フィルタ」フィールドと「LAST FETCHED フィルタ」フィールドのいずれかの条件が論理的に真である必要があります。

「LAST FETCHED フィルタ」パラメータはもう 1 つの Remedy 検索式を指定しますが、この式には Identity Manager で定義された 1 つ以上のユーザー属性を含めることができます。この機能を使用して、前のポーリングで返された値を現在のポーリングで返された値と比較する式を作成できます。たとえば、Remedy フォーム上の Case ID+ フィールドに各チケットの一意の ID が含まれる場合は、この値をポーリングごとに比較できます。現在のポーリングの値が前のポーリングの値より大きい場合は、チケットに関する情報を返します。次の式は、この機能を示しています。

括弧内に指定する値は、スキーママップページで指定された Waveset ユーザー属性にします。$(caseId) トークンは、前のポーリングで返された値に置き換えられます。たとえば、HD0000045 などの値になります。



注	アダプタが最初にポーリングを行なったときは、前に取得された値が存在しないため、「LAST FETCHED フィルタ」は適用されません。このフィルタは、その後のすべてのポーリングで実行されます。

このアダプタは、「更新検索フィルタ」、「付加する結合子」、「LAST FETCHED フィルタ」の各リソースパラメータを連結し、次のような検索式を送信します。

セキュリティーに関する注意事項

ここでは、サポートされる接続と特権の要件について説明します。

サポートされる接続

Identity Manager は、Remedy API を使用して Remedy アダプタと通信します。

必要な管理特権

Remedy サーバーへのログインに使用されるアカウントは、Identity Manager によってアクセスされるすべての Remedy オブジェクトのアクセス権リストに含まれている必要があります。

プロビジョニングに関する注意事項

次の表に、このアダプタのプロビジョニング機能の概要を示します。


機能	サポート状況
アカウントの有効化/無効化	該当しない
アカウントの名前変更	使用不可
パススルー認証	使用不可
前アクションと後アクション	使用不可
データ読み込みメソッド	Active Sync リソースからインポート

アカウント属性

Remedy アダプタにはデフォルトのアカウント属性が用意されていません。カスタム属性を追加する場合は、次のガイドラインを使用してください。

フォームとワークフローでは、Waveset ユーザー属性値を使用できます。Remedy Active Sync アダプタでは、この値を「LAST FETCHED フィルタ」リソースパラメータに指定する値の一部として使用できます。

リソースユーザー属性は、有効な Remedy フィールド ID である必要があります。Remedy フォームのすべてのフィールドには、そのフォーム内で一意である整数フィールド ID が必要です。

Remedy Administrator の内部でフィールドの ID を表示するには、フォームを開いてそのフィールドを選択します。フィールド ID が「Find Field」ドロップダウンメニューに括弧付きで表示されます。

リソースユーザー属性が「Remedy Diary」フィールドに対応している場合、その属性は複数の値を取ります。値リストの各値は、次の形式を取ります。

Timestamp User Message

各表記の意味は次のとおりです。

Timestamp - 1970 年 1 月 1 日 (UTC) を起点とする秒数を示す整数。

User - ダイアリにメッセージを追加した Remedy ユーザー。

Message - ダイアリのエントリ。

Remedy アダプタにパスワードの変更を許可するには、次を実行してください。

「パスワードのサポート」リソースパラメータを選択します。

アイデンティティーシステムユーザー属性名が password で、属性タイプが暗号化されているアカウント属性を、スキーママップに追加します。このリソースユーザー属性は、ユーザーパスワードを保持する Remedy フィールド ID にします。

リソースオブジェクトの管理

アイデンティティーテンプレート

Remedy のアイデンティティーテンプレートは、Remedy システムによって生成されます。Identity Manager によって構築されたアイデンティティーテンプレートは無視されます。

サンプルフォーム

トラブルシューティング

Identity Manager のデバッグページを使用して、次のクラスにトレースオプションを設定します。

また、リソースインスタンスに対して次の Identity Manager ロギングパラメータを設定できます。

また、次のメソッドに対してトレースを有効にすることで接続の問題について診断できます。

前へ目次索引次へ
Sun Java™ System Identity Manager 7.0 リソースリファレンス