コネクター固有の構成プロパティーは、コネクターが実行時に必要とする情報を提供します。 また、コネクター固有のプロパティーを使用すると、コネクターのコー ド変更や再ビルドを行わなくても、コネクター・フレームワークおよびコネクターの アプリケーション固有コンポーネント内の静的情報またはロジックを変更でき ます。
表 55 は、コネクター固有構成プロパティーの早見表です。「モジュール」列には、関連付けられているプロパティーを使用する コネクター・モジュールのリストが記載されています。
名前 | 指定可能な値 | デフォルト値 | モジュール |
---|---|---|---|
ABAPDebug | true または false | false | ABAP Extension
BAPI HDR |
AleEventDir | パス | ALE | |
AleUpdateStatus | true または false | false | ALE |
AleSelectiveUpdate | IDocType:MessageType | ALE | |
AleStatusMsgCode | MessageCode | ALE | |
AleSuccessCode | 52 または 53 | 52 | ALE |
AleFailureCode | 68 または 58 | 68 | ALE |
AleSuccessText | SuccessText | ALE | |
AleFailureText | FailureText | ALE | |
ApplicationPassword | SOFTWARE | すべて | |
ApplicationUserName | CROSSWORLDS | すべて | |
ArchiveDays | ALE | ||
Client | すべて | ||
Group | アプリケーション・サーバーのグループを表すログオン・グループの有効な名前 | すべて | |
gwService | ゲートウェイ・サーバー ID | sapgw00 | RFC Server ALE |
Hostname | IP-address または server-name | すべて | |
InDoubtEvents | Reprocess、 FailOnStartUp、 LogError、または Ignore | Ignore | ABAP Extension |
Language | E | すべて | |
MaxNumberOfConnections | 2 | ABAP Extension、
ALE (要求処理のみ)、 BAPI HDR |
|
Modules | ModuleName | すべて | |
Namespace | true または false | true | ABAP Extension |
NumberOfListeners | 任意の正整数 | 1 | RFC Server、
ALE |
PollQuantity | 任意の正整数 | 20 | ABAP Extension、
ALE |
RefreshLogonCycle | true | true | すべて |
RfcProgramId | プログラム ID | CWLDSERVER | RFC Server、
ALE |
RfcTraceOn | true または false | false | すべて |
SAPALE_Archive_Queue | 任意の有効な WebSphere MQ キュー名 | ALE | |
SAPALE_Event_Queue | 任意の有効な WebSphere MQ キュー名 | ALE | |
SAPALE_Wip_Queue | 任意の有効な WebSphere MQ キュー名 | ALE | |
SAPALE_Error_Queue | |||
SAPALE_Unsubscribed_Queue | |||
SAPSystemID | SAP システムの論理名 | すべて | |
SAPtid_MQChannel | 任意の有効な MQ チャネル | ALE | |
SAPtid_MQPort | 任意の有効な MQ ポート | ALE | |
SAPtid_Queue | 任意の有効な MQ キュー名 | ALE (要求処理のみ) | |
SAPtid_QueueManager | 任意の有効な MQ キュー・マネージャー名 | ALE | |
SAPtid_QueueManagerHost | 任意の有効な MQ キュー・マネージャー・ホスト名 | ALE | |
SAPtid_QueueManagerLogin | 任意の有効な MQ キュー・マネージャー・ログイン名 | ALE | |
SAPtid_QueueManagerPassword | 任意の有効な MQ キュー・マネージャー・パスワード | ALE | |
Sysnr | システム番号 | 00 | すべて |
DateTimeFormat | なしまたはレガシー | すべて | |
TransIdCollabName | 現在サポートはありません | ||
UpdateIDocStatus | true または false | True | ALE |
IDocSuccessCode | 12 | ALE | |
IDocFailureCode | 11 | ALE | |
IDocSuccessText | Dispatched Okay | ALE | |
IDocFailureText | Dispatch failed | ALE | |
UseDefaults | true または false | false | ABAP Extension
ALE BAPI |
コネクターでビジネス・オブジェクトの処理を開始する際に、適切な機能モジュール用の ABAP Debugger を呼び出すかどうかを指定します。このプロパティーを true に設定すると、コネクターは次のコネクター・モジュール用の ABAP Debugger をオープンします。
コネクターで ABAP Debugger が呼び出されるのは、次の場合のみです。
デフォルト値は false です。
ALE Module がイベントの記録およびリカバリーのために使用する event ディレクトリーに 対応するルート・ディレクトリー (¥ale) の場所を指定します。コネクターが最初に始動したときに、始動元のディレクトリー内にこのルート・ディレクトリーが存在しない場合、コネクターはルート・ディレクトリーと event サブディレクトリーを作成します。
例えば、コネクターの場所が ¥connectors¥SapConnector1 (製品ディレクトリー内) の場合、コネクターは次のディレクトリーを作成します。
¥connectors¥SapConnector1¥ale
コネクターを最初に始動する際に、コネクターが配置されているディレクトリー以外のディレクトリーから始動した場合、コネクターはこのプロパティーの値に関係なく、コネクターを始動したディレクトリーにルート・ディレクトリーを作成します。
コネクターを最初に始動する際に、コネクターが配置されているディレクトリー以外のディレクトリーから始動した場合、コネクターはこのプロパティーの値に関係なく、コネクターを始動したディレクトリーにルート・ディレクトリーを作成します。
詳細については、ALE Module の概要を参照してください。
デフォルト値は次のとおりです。
$<ProductNameDir>/connectors/SAP/ale
$<ProductNameDir>/connectors/SAP/ale
%ProductNameDir%¥connectors¥SAP¥ale
すべてのメッセージ・タイプに対して監査証跡を必要とするかどうかを指定します。ALE Module がイベント処理のために IDoc オブジェクトを検索した後で、コネクターで標準の SAP 状況コードが更新されるようにするためには、このプロパティーを true に設定する必要があります。
詳細については、ALE Module の概要を参照してください。
デフォルト値は false です。
コネクターで標準の SAP 状況コードが更新されるように構成した場合、どの IDocType と MessageType の組み合わせを更新するかを指定します。このプロパティーの値は、AleUpdateStatus が true に設定されている場合にのみ定義できます。
このプロパティーの構文は次のとおりです。
IDocType:MessageType[,IDocType:MessageType [,...]]
ここで、コロン (:) 区切り文字はそれぞれの IDocType と MessageType を分離し、コンマ (,) 区切り文字はエントリーをセットごとに分離します。下の例では、セットが 2 つある場合が示されています。この例で、MATMAS03 と DEBMAS03 は IDoc、MATMAS と DEBMAS はメッセージ・タイプです。
MATMAS03:MATMAS,DEBMAS03:DEBMAS
詳細については、ALE Module の概要を参照してください。
必要があれば、コネクターが ALEAUD メッセージ IDoc (ALEAUD01) を通知する際に使用するメッセージ・コードを指定します。このメッセージ・コードは、受信側のパートナー・プロファイルで構成してください。このプロパティーの値は、AleUpdateStatus が true に設定されている場合にのみ定義できます。
詳細については、IDoc の状況を更新するための SAP の構成を参照してください。
Application Document Posted の正常状況コードを指定します。ALE Module がイベント処理のために IDoc オブジェクトを検索した後で、コネクターで SAP 正常状況コードが更新されるようにするには、このプロパティーに値を指定する必要があります (52 または 53)。SAP では、この値を状況 41 (Application Document Created in Receiving System) に変換します。
詳細については、ALE Module の概要を参照してください。
ディスパッチ失敗に対する状況コードを指定します。ALE Module がイベント処理のために IDoc オブジェクトを検索した後で、コネクターで SAP 失敗状況コードが更新されるようにするには、このプロパティーに値を指定する必要があります (68 または 58)。SAP はこの値を 40 に変換します。
詳細については、ALE Module の概要を参照してください。
正常な Application Document Posted に対する記述テキストを指定します。このプロパティー値の設定は、AleUpdateStatus を true に設定した場合でも省略可能です。
詳細については、ALE Module の概要を参照してください。
ディスパッチ失敗に対する記述テキストを指定します。このプロパティー値の設定は、AleUpdateStatus を true に設定した場合でも省略可能です。
詳細については、ALE Module の概要を参照してください。
SAP アプリケーションでのコネクターのユーザー・アカウントのパスワードです。デフォルトは SOFTWARE です。
SAP アプリケーションでのコネクターのユーザー・アカウントの名前です。デフォルトは CROSSWORLDS です。
TIDManagement ファイルを要求ディレクトリーから削除する必要が生じたあとの日数は、ArchiveDays コネクター構成のプロパティーによって決まります。内部的に保守されるデフォルト値は、7 日です。半端な日数値 (例: 1.234) を指定することもできます。
コネクターがログインする際のクライアント番号で、多くの場合 100 です。
ロード・バランシング用のコネクターを構成しているときには、アプリケーション・サーバーのグループを表すログオン・グループの名前を指定します。詳細については、ロード・バランシングの活用を参照してください。
ゲートウェイ・サーバーの ID。多くの場合、sapgw00 です。00 は、SAP Gateway を実行しているサーバー (通常はアプリケーション・サーバー) のシステム番号で、複数存在する場合は 00 を指定することはできません。デフォルトは sapgw00 です。
ロード・バランシング用のコネクターを構成しているときには、メッセージ・サーバーの名前を指定します。ロード・バランシングなしに実行するコネクターを構成しているときには、コネクターのログイン先となるアプリケーション・サーバーの IP アドレスまたは名前を指定します。いずれの場合も、コネクターは、ゲートウェイ・ホストの名前がこのプロパティーに対して指定された値と同じと仮定します。
InDoubtEvents は、イベント表の進行中のイベントの処理法を記述します。Reprocess は、イベント表の進行中のイベントを再処理します。FailOnStartup は、コネクターをシャットダウンし、進行中のイベントがあった場合 は致命的エラーをログに記録します。LogError は、進行中のイベントがイベント表にあることを通知するエラーを ログに記録します。Ignore は、進行中のイベントを無視します。
コネクターがログインする際の言語です。デフォルトは、E で、英語に設定されます。
コネクターと SAP アプリケーションとの間の、同時実行可能な相互作用の最大数。これらの相互作用には、イベントのポーリングや、サービス呼び出し要求の処理が含まれます。このプロパティーは、ABAP Extension Module、BAPI Module、および ALE Module でのみ使用されます。ALE Module は、サービス呼び出し要求のためにのみこのプロパティーを使用します。
各相互作用は SAP アプリケーション・サーバー上でダイアログ・プロセスを使用するため、接続の数は、使用可能なダイアログ・プロセスの数を超えることはできません。 詳細については、同時実行可能な複数の相互作用の処理を参照してください。
このプロパティーに値を設定しない場合、コネクターではデフォルト値の 2 が使用されます。
コネクターが init()、pollForEvents()、および Terminate() の要求を実行するために使用するモジュールを指定します。具体的には、Vision コネクター・フレームワークで使用されるコネクター・モジュールを指定します。複数のコネクター・モジュールを指定する場合は、それぞれの値をコンマで区切ります。スペースは入れないでください。
サポートされるコネクター・モジュールと、それらを指定するための構文は次のとおりです。
ABAP Extension Module--Extension
ALE Module--ALE
BAPI Module--Bapi
RFC Server Module--RfcServer
コネクターが、コネクター・ネーム・スペース /CWLD/ で定義された ABAP コンポーネントを使用するかどうか を指定します。コネクターがネーム・スペースで定義された ABAP コンポーネントを使用するようにするには、値を true に設定する必要があります。デフォルトは true です。
コネクターが初期化される際に作成されるリスナー・スレッドの数を指定します。1 つのリスナー・スレッドは、一度に 1 つの要求を処理できます。それぞれのリスナー・スレッドは一度に 1 つのイベントを処理します。そのため、複数のリスナー・スレッドが作成されていると、コネクターは複数のイベントを並行処理できます。デフォルトは、1 です。
リスナー・スレッドの数は、SAP で使用可能な作業プロセスの数を超えないことを推奨します。
単一のポーリングで選出されるイベントの最大数を定義します。デフォルトは 20 です。
SAP クライアントの接続について、すべてのリソースを解放するかどうかを指定します。デフォルトは false です。
リスナー・スレッドが RFC 対応機能からのイベントを処理できるように、コネクターが SAP Gateway に登録する ID です。この値は、SAP アプリケーションに登録されたプログラム ID (トランザクション SM59) と一致している必要があります。デフォルトは CWLDSERVER です。
SAP アプリケーション内のプログラム ID の構成の詳細については、RFC Server Module の SAP gateway への登録を参照してください。
各リスナー・スレッドに関する RFC アクティビティーの詳細を記述したテキスト・ファイルを生成するかどうかを指定します。指定できる値は true または false です。true を指定するとトレースが活動化し、トレースがテキスト・ファイルに生成されます。これらのテキスト・ファイルは急速に大きくなるため、これらのファイルを開発環境のみで使用することをお勧めします。デフォルトは false です。
ALE Module がイベントの処理を終えた後、TID と IDoc データを アーカイブする WebSphere MQ キューを指定します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
ALE Module によるイベント処理の間、TID と IDoc データを保管する WebSphere MQ キューを指定します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
ALE Module がイベント・キューあての MQ メッセージを作成しているとき、TID と IDoc データを 保持する WebSphere MQ 処理中 (wip) キューを指定します。コネクターは、1 つのイベントのデータをすべて受信した後、このキューのデータを SAPALE_Event_Queue に移します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
WIP キューとイベント・キューの間で失敗した MQ メッセージを処理するための キューを定義します。詳細については、ALE Module の概要を参照してください。
アンサブスクライブされた IDoc オブジェクトを収集するためのキューを定義します。以前は、アンサブスクライブされた IDoc オブジェクトはアーカイブ・キューに 置かれていました。これらのメッセージは、イベント管理ユーティリティーを 使用して再サブミットできます。コネクターは、SAP からコネクターへのデータを処理するときに サブスクリプションを検査するようになったため、トランザクションは コラボレーションが開始されるまで SAP に残ります。詳細については、ALE Module の概要を参照してください。
ロード・バランシング用のコネクターを構成しているときには、SAP システムの論理名 (R3name とも呼びます) を指定します。詳細については、ロード・バランシングの活用を参照してください。
WebSphere MQ キュー・マネージャー用のクライアント・チャネルを指定します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
ALE Module 用のキューを処理する WebSphere MQ キュー・マネージャーとの通信に使用するポートを指定します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
TID と TID 状況が設定されているメッセージが存在する WebSphere MQ キューを指定します。このプロパティーは、ALE Module が要求を処理するときにのみ使用します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
TID および IDoc データを格納するキューを管理する WebSphere MQ キュー・マネージャーの名前です。このプロパティーは、ALE Module がイベントおよび要求を処理するときに使用します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
WebSphere MQ キュー・マネージャーが存在するホストの名前です。このプロパティーは、ALE Module がイベントおよび要求を処理するときに使用します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
WebSphere MQ キュー・マネージャーにログインするためのユーザー名です。このプロパティーは、ALE Module がイベントおよび要求を処理するときに使用します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
WebSphere MQ キュー・マネージャーにユーザーがログインするためのパスワードです。このプロパティーは、ALE Module がイベントおよび要求を処理するときに使用します。詳細については、ALE Module の概要を参照してください。
デフォルト値はありません。
アプリケーション・サーバーのシステム番号です。この値は 2 桁の数値で、多くの場合 00 です。デフォルトは 00 です。
DATE および TIME の各フィールド値で 指定された区切り文字を保存します。Legacy に設定すると、コネクターは DATE および TIME フィールドの 区切り文字を保存します。それ以外の場合は、区切り文字が除去され、値の長さが属性で定義された長さに合わせられます。
監査証跡がすべてのメッセージ・タイプに必要とするかどうかを指定します。
正常なディスパッチの場合の標準の IDoc 状況コード。
ディスパッチの失敗の場合の標準の IDoc 状況コード。
正常なディスパッチの場合の、IDocSuccessCode に関連付けられた IDoc 状況メッセージのテキスト。
ディスパッチの失敗の場合の、IDocFailureCode に関連付けられた IDoc 状況メッセージのテキスト。
Create または Update 操作の場合、UseDefaults が true に設 定されていれば、統合ブローカー用のアダプター・フレームワークは、必要に応じてマーク付けされた各ビジネス・オブジェクト属性に有効な値またはデフォルト値が指定されているか検査します。値が指定されている場合には、Create または Update は正常に実行されます。パラメーターが false に設定されていると、コネクターは有効な値のみチェックし、値が設定されていなければ、Create 処理または Update 処理は失敗します。デフォルトは false です。