Info*Engine サーバー

Info*Engine サーバーは、ユーザーまたはカスタムアプリケーションが表示および受信するデータを読み込み、操作するためのメカニズムを提供します。

デフォルトでは、Info*Engine サーバーエントリは使用されなくなりました。ただし、エントリを作成し、Info*Engine のレガシースタンドアロンインストールと連携させることはできます。

代わりに Windchill アダプタが使用されるようになりました。

ここに記載されていないプロパティに関する情報、および利用可能なフォームボタンを使用したり、属性値を正しく入力したりする方法については、共通のプロパティおよび操作を参照してください。

資格証明マッピングは、サーバーを通して、使用する認証ファイルを指定することで設定できます。ユーザーは認証ファイルにより、1 つ以上のアダプタに対して適切な資格証明を使用してサーバーにログインできます。

通常、資格証明マッピングプロパティは、プロパティ管理ユーティリティを使用せずに、wt.properties ファイルで設定します。ただし、新規アダプタを設定する場合は、プロパティ管理ユーティリティを使用して資格証明マッピングプロパティを取得できます。

Info*Engine を通じてユーザーを認証するためにサイトが作成した認証タスクのへ相対パス。このパスは設定済みのタスクのルートへの相対パスで指定します。このプロパティはオプションです。

ビジネスタスクを実行するためにビジネスタスクプロセッサが呼び出されると、credentialsMapper プロパティが確認されます。このプロパティが設定されている場合、タスクプロセッサは割当済みのタスクを実行する前に認証マッピングタスクを実行します。認証マッピングタスクはユーザー名をキーとして、アダプタ経由でアクセス可能な 1 つまたは複数の情報システムからユーザー固有の認証情報を取得します。取得した認証情報からは出力グループを作成できます。

credentialsMapper プロパティを指定しない場合、Info*Engine サーバーは指定されたタスクを実行してからでなければサーバーベースの認証マッピングタスクを実行しません。

サイトが各ユーザーの認証マッピングファイルを保存するために作成したディレクトリへの相対パス。各マッピングファイルの名前は、Info*Engine サーバーに渡される認証済みユーザー名と一致する必要があります。ディレクトリパスは設定済みのタスクのルートへの相対パスです。このプロパティはオプションです。

◦ このプロパティを指定した場合、Info*Engine は提供されたユーザー名に対応する認証マッピングファイルを開いて読み取ろうとします。

このファイルは、ビジネスタスクの実行前、credentialsMapper プロパティで指定されたタスクを実行する前に開かれます。

credentialsTimeToLive

このプロパティでは、タスクプロセッサがキャッシュから認証情報を読み取れるようにすることで、パフォーマンスを向上します。このプロパティを指定しない場合、タスクプロセッサは認証ファイルが読み取られるたび、または認証マップタスクが実行されるたびに認証情報を取得します。

このプロパティの値は、再表示まで認証情報がキャッシュされる時間 (ミリ秒単位) です。値は正の整数である必要があり、それ以外は無視されます。このプロパティが定義されない場合、認証グループ情報はキャッシュされず、パフォーマンスは変わりません。

コンパイラプロパティを指定することにより、コンパイル済みタスクの場所と、クラスパスに追加する必要があるその他のファイルを設定できます。

コンパイル済みタスクを配置するディレクトリ。

タスクをコンパイルする場合にクラスパスに追加するその他の JAR ファイルおよびクラスファイル。標準の Java クラスパスを入力します。(;) を使用します。UNIX システムでは、パスのセパレータとしてコロン (:) を使用します。

compiler.libDirectoryn

その他の JAR ファイルおよびクラスファイルをクラスパスに追加する場合、このフィールドを使用してこれらのファイルを配置するディレクトリを指定します。

n の最初の値は 1 で、その後連続して増加する必要があります。

Info*Engine のルートインストールディレクトリ。Info*Engine のルートインストールディレクトリは、Windchill のルートインストールディレクトリ (wt.home) と同じです。

Info*Engine の起動時に特定のタスクが実行されるように設定できます。たとえば、キューの生成やイベント購読を自動化できます。n の最初の値は 1 である必要があり、次の例に示すように値が順次増加する必要があります。

このプロパティの値は、Info*Engine 起動時に開始されるタスクのパスです。

詳細については、Info*Engine タスクを参照してください。

request.xmlParser.debug

XML パーサーデバッグを有効にします。デバッグを目的として受信 XML を解析する際に情報を出力します。

request.xmlStream.debug

XML ログ作成リクエストを有効にします。デバッグを目的とする受信 XML を出力します。

SERVICE パラメータなしで呼び出される MSG Webject と WES Webject に使用される JMS サービスの名前。

以下のプロパティは、Java Messaging Service (JMS) を使用して Info*Engine を設定する際に一般的に設定されます。プロパティの説明は、フォーム内のプロパティの場所と実行する機能に基づいて分類されています。

JMS MOM を使用して Info*Engine を設定する場合は、代わりに新しい JMS サービスエントリを作成する方法が最良です。プロパティエディタを使用して、その JMS サービスエントリのコアプロパティと追加プロパティを指定できます。

その後、JMS サービスのサービス名を MSG および WES Webject の SERVICE パラメータとして入力できます。また、Info*Engine サーバーまたはアダプタの「デフォルト JMS サービス」プロパティの値としても入力できます。

管理オブジェクトの検索時に初期 JNDI コンテキストを返すために使用されるファクトリのクラス名。未指定の場合、管理オブジェクトは LDAP に保存されているものと見なされます。

デフォルト値は com.sun.jndi.ldap.LdapCtxFactory です。

JMS 関連 URI (Uniform Resource Indicator) に対して相対的な LDAP URI。

JMS 関連の管理オブジェクトがあるベースロケーションとして機能します。

jms.baseUri.principal

関連付けられた JNDI ユーザーを認証するために JMS ベース URI に渡されるユーザー名。

jms.baseUri.password

JMS ベース URI プリンシパルに関連付けられたパスワード。

JMS プロバイダまたは MOM に関連付けられたデフォルトのユーザー。

JMS プロバイダまたは MOM に接続するために使用するデフォルトのパスワード。

msg.queueConnectionFactory

JMS MOM によって使用される管理 JMS キュー接続ファクトリの場所。

wes.topicConnectionFactory

管理 JMS トピック接続ファクトリの場所。完全修飾 URI または設定されているベース URI に対する相対識別名を指定できます。詳細については、メッセージングと Web イベントサービスの実装を参照してください。

wes.subscriptionIdentifier

トピック購読の作成時に使用する一意の識別子。1 台のホストの複数の Info*Engine プロセスで同じトピックの購読を生成する場合、このプロパティを設定します。

各 Info*Engine サービスには、一意の識別子が必要です。このプロパティを指定しない場合、ホスト名およびイベント名に基づいて識別子が生成されます。

JMS サービスとの通信に必要なサードパーティ JAR ファイルを配置するディレクトリ。JAR ファイルがすでにサービスクラスパスに含まれている場合、このプロパティはオプションです。

JMS サービスを使用して Info*Engine を設定する際は、以下のプロパティも設定できます。プロパティの説明は、フォーム内のプロパティの場所と実行する機能に基づいて分類されています。

jms.recoveryRetryInterval

MOM の接続が切断された場合に、接続の再確立を試行するまでの待機時間 (秒単位)。

デフォルト値は 30 です。

Info*Engine リクエストに変換できないメッセージを受信した場合、このプロパティによってメッセージを配置するキューが定義されます。このプロパティが定義されない場合、無効なメッセージは破棄されます。

管理オブジェクトルックアップの実行中に Windchill の初期コンテキストに戻すために使用するファクトリのクラス名。

デフォルト値は com.sun.jndi.ldap.LdapCtxFactory です。

WES 関連の管理オブジェクトを検索できる LDAP URI (Uniform Resource Indicator) (LDAP ディレクトリ内のサブツリー)。

指定しない場合、jms.baseUri プロパティが使用されます。

JMS MOM への接続時に提供する必要がある WES ユーザー名。

指定しない場合、jms.username プロパティが使用されます。

WES ユーザーに関連付けられたパスワード。

指定しない場合、jms.password プロパティが使用されます。

指定しない場合、jms.badMessageQueue プロパティが使用されます。

管理オブジェクトの検索時に初期 JNDI コンテキストを返すために使用されるファクトリのクラス名。

デフォルト値は com.sun.jndi.ldap.LdapCtxFactory です。

キュー関連の管理オブジェクトを検索できる LDAP URI (Uniform Resource Indicator) (LDAP ディレクトリ内のサブツリー)。

指定しない場合、jms.baseUri プロパティが使用されます。

JMS MOM への接続時に提供する必要があるユーザー名。

指定しない場合、jms.username プロパティが使用されます。

キューユーザーに関連付けられたパスワード。

指定しない場合、jms.password プロパティが使用されます。

指定しない場合、jms.badMessageQueue プロパティが使用されます。

msg.defaultExecutionQueue

管理キューの LDAP 識別名。値は設定されているベース URI を基準とする LDAP 相対識別名または完全修飾 LDAP 識別名です。相対の場合に、明示的に指定されていない場合、cn= (共有名の属性) は暗黙的です。

このキューの場所は、次の Webject で使用されます。

◦ Queue-Task - キュータスクが配置される場所。このプロパティを指定しない場合は、Webject の QUEUE パラメータを指定する必要があります。

◦ Subscribe-Queue - Webject の使用時に購読するキュー。このプロパティを指定しない場合は、Webject の QUEUE パラメータを指定する必要があります。

msg.defaultResultsQueue

このキューの場所は、次の Webject で使用されます。

◦ Query-Results - 結果が配置されるキューの場所。このプロパティを指定しない場合は、Webject の QUEUE パラメータを指定する必要があります。

◦ Delete-Results - 結果が配置されるキューの場所。このプロパティを指定しない場合は、Webject の QUEUE パラメータを指定する必要があります。

◦ Queue-Task - 結果が配置されるキューの場所。このパラメータを指定しない場合は、Webject の DESTINATION パラメータを指定する必要があります。

Send-Mail Webject は、電子メールメッセージを作成して送信します。Send-Mail Webject プロパティを設定すると、Webject の実行時に特定のデフォルト値を設定できます。

Send-Mail Webject で使用されるデフォルトの発信者 (メッセージの送信元の電子メールアドレス)。

Webject の FROM パラメータに対応します。

Send-Mail Webject で使用されるデフォルトのサーバー。

SMTP サーバーへの接続時に提供されるデフォルトのユーザー名。

USERNAME パラメータに対応します。

デフォルト SMTP ユーザー名に関連付けられたデフォルトのパスワード。

PASSWORD パラメータに対応します。

サービスまたはアダプタのコンフィギュレーション情報は、サービスまたはアダプタの実行中に更新できるので、再起動を要求することなくプロパティを更新できます。

「有効期間」プロパティは、サービスまたはアダプタのプロパティを自動的に再ロードするまでの経過時間を分数で指定します。プロパティが自動的に再読み込みされるのは、アクセスされている場合だけです。デフォルトでは、プロパティは期限切れになりません。

フォームでプロパティが定義されていない場合は、「その他のプロパティ」フィールドでプロパティを追加できます。その他のプロパティを追加するとき、プロパティ名はアダプタエントリ名 (サービス名) にプロパティ名が続くフォーマットになります。例:

適切なフィールドで、サービスまたはアダプタによって使用されるプロパティと、そのプロパティの値を指定します。新しいプロパティ名の隣にある「追加」をクリックして、プロパティ値を修正できるテキストボックスを開きます。

値が長くなりすぎて全体が表示されない場合は、「編集」ボタンが表示されます。「編集」をクリックして、もっと大きなテキスト領域のある新規ブラウザウィンドウを表示します。