Key Capabilities
- Comprehensive SAP IDoc integration supporting multiple connection methods (NetWeaver RFC SDK, Classic RFC SDK, JCO, and SOAP)
- Bidirectional data exchange with support for raw IDoc and IDoc XML formats
- Automatic schema refresh and validation with control record header management for multi-SAP-system routing
Overview
IDoc connectors can connect to SAP using the following methods: Windows- NetWeaver RFC SDK
- Classic RFC SDK
- Classic RFC SDK with Unicode support
- SOAP (send-only)
- Java connector (JCO)
- SOAP (send-only)
Prerequisites
If you are using the SAP IDoc connector in Send or Receive mode, you must have a live SAP IDoc system and a clear network path to that system from Arc. You also need to install the necessary dependencies on your machine. Follow the instructions below for your connection type.If you are using the connector in Translate mode, these prerequisites are not required.
Using NetWeaver RFC SDK
The following libraries from the NetWeaver RFC SDK must be placed into the Arcwww\\bin\\x64 folder (www\\bin\\x86 on 32-bit operating systems):
- sapnwrfc.dll
- icudt30.dll
- icuin30.dll
- icuuc30.dll
- libicudecnumber.dll
- libsapucum.dll
- The .dll names might be different based on the version of the SAP RFC SDK you have installed. The examples above are for version 3.0.
- You need to add the
sapgw00service to your listed services for the NetWeaver SDK connection to work on your client machine. You can add it to the services file atC:\\Windows\\System32\\drivers\\etc\\services.
Using Classic RFC SDK
The non-Unicode library does not require anything other than librfc32.dll. Place librfc32.dll into the Arcwww\\bin\\x64 folder (www\\bin\\x86 on 32-bit operating systems).
These libraries are provided in both x86 and x64, so you must use the same platform that the process is using. If the application is running on a 64-bit version of Windows, the process is 64-bit.
Using Classic RFC SDK with Unicode Support
The following libraries from the SAP RFC SDK must be placed into the Arcwww\\bin\\x64 folder (www\\bin\\x86 on 32-bit operating systems):
- librfc32u.dll
- icudt30.dll
- icuin30.dll
- icuuc30.dll
- The .dll names might be different based on the version of the SAP RFC SDK you have installed. The examples above are for version 3.0.
- These libraries are provided in both x86 and x64, so you must use the same platform that the process is using. If the application is running on a 64-bit version of Windows, the process is 64-bit.
Using the Java Connector
To use the Java connector, add sapjco3.jar to thelib folder of your Java servlet container.
Using SOAP
SOAP can only be used to send IDocs to SAP. You must use a different connection type to receive IDocs from SAP.This requires enabling SOAP connections on the SAP system.
Add a Connection
To allow Arc to send or receive SAP data, you must first establish a connection to SAP. You have two ways to establish this connection:- Add a SAP IDoc connector to your flow. Then, in the Settings tab, click Create next to the Connection drop-down list.
- Open the Arc Settings page, then open the Connections tab. Click Add, select SAP IDoc, and click Next.
- The login process is only required the first time the connection is created.
- Connections to SAP IDoc can be re-used across multiple SAP IDoc connectors.
Enter Connection Settings
After opening a new connection dialogue, give it a Name, then complete the other options.Host Configuration
Settings related to establishing the connection to the SAP system.Client Authentication
Settings related to authenticating against the SAP system.Language Settings
Settings related to communication language.Gateway
Settings related to communicating with SAP through a gateway.Logon Load Balancing
Settings related to logging in to the SAP system as a group to enable load balancing.Secure Network Communications (SNC)
Settings related to using an external security product to enhance the SAP connection security.
Click Test Connection to ensure that Arc can connect to SAP with the provided information. If an error occurs, check all fields and try again.
Click Add Connection to save your changes.
Settings Tab
Select an Action
When you add an SAP IDoc connector to a flow, you must choose the action that the connector should perform. The Settings tab then updates to display the relevant options. The following table outlines the available actions. Click the links in the table to access the specific settings for each action.Automation Tab
Automation Settings
Settings related to the automatic processing of files by the connector.Performance
コネクタへのリソースの割り当てに関する設定です。
| 設定 | 説明 |
|---|---|
| Max Workers | このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。 |
| Max Files | コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、Advanced Settings ページのPerformance Settings 部分にあるデフォルト設定が上書きされます。 |
Alerts Tab
SLAs Tab
Advanced Tab
Message
Message 設定は、コネクタがメッセージを検索する方法と、処理後にメッセージを管理する方法を決定します。
Note: 以下の設定は非推奨となり、デフォルトで非表示になっています。以前に有効化またはデフォルト以外の値に設定されていたコネクタにのみ表示されます。処理済みファイルのコピーを保持するには、フロー内のコネクタを右クリックし、成功パスを表示を選択して、成功パスをFile コネクタに接続してください。
| 設定 | 説明 |
|---|---|
| Sent フォルダに保存(非推奨) | コネクタが処理したファイルをSent フォルダにコピーします。デフォルトで無効です。Sent フォルダに保存されたファイルは保存データの暗号化の対象外です。 |
| Sent フォルダのスキーム(非推奨) | 選択した時間間隔でSent フォルダ内のファイルをグループ化します。Sent フォルダに保存が有効な場合のみ適用されます。 |
Logging
ログの作成と保存を制御する設定です。
| 設定 | 説明 |
|---|---|
| Log Level | コネクタが生成するログの詳細度です。サポートを依頼する際は、これをDebug に設定してください。 |
| Log Subfolder Scheme | 選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション(デフォルト)は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。 |
| Log Messages | 処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、Transactions タブからファイルのコピーをダウンロードできなくなる場合があります。 |
Other Settings
Processing Delay
| 設定 | 説明 |
|---|---|
| Processing Delay | Transactions タブに配置されたファイルの処理を遅延させる時間(秒単位)です。これはレガシー設定です。ベストプラクティスは、この設定の代わりにFile コネクタを使用してローカルファイルシステムを管理することです。 |
Miscellaneous 設定は、特定のユースケース向けの設定です。
| 設定 | 説明 |
|---|---|
| Other Settings | 非表示のコネクタ設定をセミコロン区切りのリストで設定できます(例:setting1=value1;setting2=value2)。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。 |
ログタブ
ログタブには、このコネクタが生成したサービスログが一覧表示されます。各行はログファイルを表し、更新日時、ファイル名、サイズ、ステータスが表示されます。特定のログを検索するには検索バーまたはステータスフィルタを使用し、ファイル名をクリックしてプレビューまたはダウンロードするか、すべてのログをダウンロードをクリックしてすべてのログを単一のzipファイルとしてダウンロードします。
Establishing a Connection
Configuring Services
In addition to the prerequisites described above, you must add the following services to%WINDIR%\\system32\\drivers\\etc\\services, or /etc/services if your system is running Linux or Mac OS X. If SAP NetWeaver is already installed on the machine, no further action is required.