SAP IDoc Connector

Version 24.2.9039

SAP IDoc Connector

An SAP IDoc is a data container that is used to exchange information between SAP and another process that can understand the syntax and semantics of the data. The connector supports sending and receiving IDoc files to and from a variety of SAP systems. You can also use it to translate IDocs without needing to connect to SAP.

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

Java connector (JCO)
SOAP (send-only)

IDoc connectors can send, receive, and translate files formatted either as raw IDoc or as IDoc XML.

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.

Note: 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 Arc www\\bin\\x64 folder (www\\bin\\x86 on 32-bit operating systems):

sapnwrfc.dll
icudt30.dll
icuin30.dll
icuuc30.dll
libicudecnumber.dll
libsapucum.dll

Notes:

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 sapgw00 service to your listed services for the NetWeaver SDK connection to work on your client machine. You can add it to the services file at C:\\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 Arc www\\bin\\x64 folder (www\\bin\\x86 on 32-bit operating systems).

Note: 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 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 Arc www\\bin\\x64 folder (www\\bin\\x86 on 32-bit operating systems):

librfc32u.dll
icudt30.dll
icuin30.dll
icuuc30.dll

Notes:

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 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 the lib 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.

Note: 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.

Notes:

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.

Connect Type The method with which to connect to SAP. See the Establishing a Connection section for your method for additional information.
SAP Host Hostname or IP address of the target SAP system.
System Number The number by which the target SAP system is defined. Valid values are 0-99, and often this value should be 0.

Client Authentication

Settings related to authenticating against the SAP system.

Client The client that is authenticating to the SAP system.
User The username credential for authentication.
Password The password for the specified user.

Language Settings

Settings related to communication language.

Language The language value to be used when connecting to the SAP system. Set this to the ISO 639-1 value for the language the SAP system uses.

Gateway

Settings related to communicating with SAP through a gateway.

Gateway Host The hostname or IP address of the gateway through which to connect.
Gateway Service The gateway service to use.

Logon Load Balancing

Settings related to logging in to the SAP system as a group to enable load balancing.

Message Server The service name of the load balancer.
System ID Identifies the SAP system.
Logon Group The group to use when load balancing.

Secure Network Communications (SNC)

Settings related to using an external security product to enhance the SAP connection security.

SNC Name The SNC name for the machine making the connection.
SNC Partner Name The SNC name of the SAP system the connector is connecting to.
SNC Quality of Protection Level The level of protection added by the SNC product.
SNC Library The path to the external security product’s library.

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.

Tip: Establishing a connection is not required if you are translating an IDoc.

Settings Tab

コネクタId コネクタの静的な一意の識別子。
コネクタの種類 コネクタ名とその機能の説明が表示されます。
コネクタの説明 コネクタとフローにおけるロールについて自由形式の説明を記載するオプションのフィールド。
Connection Choose a connection from the list.

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.

Action	Description
Send	Connector settings specific to sending IDoc files to SAP.
Receive	Connector settings specific to receiving IDoc files from SAP.
Translate	Connector settings specific to translating IDoc files.

Automation Tab

Automation Settings

Settings related to the automatic processing of files by the connector.

Send Whether files arriving at the connector are automatically sent.
Retry Interval The amount of time before a failed send is retried.
Max Attempts The maximum number of times a failed send is retried.

Performance

コネクタへのリソースの割り当てに関する設定。

最大ワーカー数 このコネクタでファイルを処理するためにスレッドプールで消費されるワーカースレッドの最大数。設定された場合、これは設定 > オートメーションページのデフォルト設定をオーバーライドします。
最大ファイル数 コネクタに割り当てられた各スレッドが送信するファイルの最大数。設定された場合、これは設定 > オートメーションページのデフォルト設定をオーバーライドします。

アラートタブ

アラートとサービスレベル（SLA）の設定に関連する設定。

コネクタのE メール設定

サービスレベル（SLA）を実行する前に、通知用のE メールアラートを設定する必要があります。アラートを設定をクリックすると、新しいブラウザウィンドウで設定ページが開き、システム全体のアラートを設定することができます。詳しくは、アラートを参照してください。

サービスレベル（SLA）の設定

サービスレベルでは、フロー内のコネクタが送受信すると予想される処理量を設定し、その量が満たされると予想される時間枠を設定できます。CData Arc は、サービスレベルが満たされていない場合にユーザーに警告するE メールを送信し、SLA を At Risk（危険） としてマークします。これは、サービスレベルがすぐに満たされない場合に Violated（違反） としてマークされることを意味します。これにより、ユーザーはサービスレベルが満たされていない理由を特定し、適切な措置を講じることができます。At Risk の期間内にサービスレベルが満たされなかった場合、SLA はViolated としてマークされ、ユーザーに再度通知されます。

サービスレベルを定義するには、予想処理量の条件を追加をクリックします。

コネクタに個別の送信アクションと受信アクションがある場合は、ラジオボタンを使用してSLA に関連する方向を指定します。
検知基準（最小）を、処理が予想されるトランザクションの最小値（量）に設定し、毎フィールドを使用して期間を指定します。
デフォルトでは、SLA は毎日有効です。これを変更するには、毎日のチェックをOFF にし、希望する曜日のチェックをON にします。
期間終了前にステータスを’At Risk’ に設定するタイミングを使用して、SLA がAt Risk としてマークされるようにします。
デフォルトでは、通知はSLA が違反のステータスになるまで送信されません。これを変更するには、‘At Risk’ 通知を送信のチェックをON にします。

次の例は、月曜日から金曜日まで毎日1000ファイルを受信すると予想されるコネクタに対して構成されたSLA を示しています。1000ファイルが受信されていない場合、期間終了の1時間前にAt Risk 通知が送信されます。

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.

Service Name	Connector Number/Protocol
sapdp00	3200/tcp
sapdp01	3201/tcp
sapdp02	3202/tcp
sapdp03	3203/tcp
sapdp04	3204/tcp
sapdp05	3205/tcp
sapdp06	3206/tcp
sapdp07	3207/tcp
sapdp08	3208/tcp
sapdp09	3209/tcp
sapdp10	3210/tcp
sapdp11	3211/tcp
sapdp12	3212/tcp
sapdp13	3213/tcp
sapdp14	3214/tcp
sapdp15	3215/tcp
sapdp16	3216/tcp
sapdp17	3217/tcp
sapdp18	3218/tcp
sapdp19	3219/tcp
sapdp20	3220/tcp
sapdp21	3221/tcp
sapdp22	3222/tcp
sapdp23	3223/tcp
sapdp24	3224/tcp
sapdp25	3225/tcp
sapdp26	3226/tcp
sapdp27	3227/tcp
sapdp28	3228/tcp
sapdp29	3229/tcp
sapdp30	3230/tcp
sapdp31	3231/tcp
sapdp32	3232/tcp
sapdp33	3233/tcp
sapdp34	3234/tcp
sapdp35	3235/tcp
sapdp36	3236/tcp
sapdp37	3237/tcp
sapdp38	3238/tcp
sapdp39	3239/tcp
sapdp40	3240/tcp
sapdp41	3241/tcp
sapdp42	3242/tcp
sapdp43	3243/tcp
sapdp44	3244/tcp
sapdp45	3245/tcp
sapdp46	3246/tcp
sapdp47	3247/tcp
sapdp48	3248/tcp
sapdp49	3249/tcp
sapdp50	3250/tcp
sapdp51	3251/tcp
sapdp52	3252/tcp
sapdp53	3253/tcp
sapdp54	3254/tcp
sapdp55	3255/tcp
sapdp56	3256/tcp
sapdp57	3257/tcp
sapdp58	3258/tcp
sapdp59	3259/tcp
sapdp60	3260/tcp
sapdp61	3261/tcp
sapdp62	3262/tcp
sapdp63	3263/tcp
sapdp64	3264/tcp
sapdp65	3265/tcp
sapdp66	3266/tcp
sapdp67	3267/tcp
sapdp68	3268/tcp
sapdp69	3269/tcp
sapdp70	3270/tcp
sapdp71	3271/tcp
sapdp72	3272/tcp
sapdp73	3273/tcp
sapdp74	3274/tcp
sapdp75	3275/tcp
sapdp76	3276/tcp
sapdp77	3277/tcp
sapdp78	3278/tcp
sapdp79	3279/tcp
sapdp80	3280/tcp
sapdp81	3281/tcp
sapdp82	3282/tcp
sapdp83	3283/tcp
sapdp84	3284/tcp
sapdp85	3285/tcp
sapdp86	3286/tcp
sapdp87	3287/tcp
sapdp88	3288/tcp
sapdp89	3289/tcp
sapdp90	3290/tcp
sapdp91	3291/tcp
sapdp92	3292/tcp
sapdp93	3293/tcp
sapdp94	3294/tcp
sapdp95	3295/tcp
sapdp96	3296/tcp
sapdp97	3297/tcp
sapdp98	3298/tcp
sapdp99	3299/tcp
sapgw00	3300/tcp
sapgw01	3301/tcp
sapgw02	3302/tcp
sapgw03	3303/tcp
sapgw04	3304/tcp
sapgw05	3305/tcp
sapgw06	3306/tcp
sapgw07	3307/tcp
sapgw08	3308/tcp
sapgw09	3309/tcp
sapgw10	3310/tcp
sapgw11	3311/tcp
sapgw12	3312/tcp
sapgw13	3313/tcp
sapgw14	3314/tcp
sapgw15	3315/tcp
sapgw16	3316/tcp
sapgw17	3317/tcp
sapgw18	3318/tcp
sapgw19	3319/tcp
sapgw20	3320/tcp
sapgw21	3321/tcp
sapgw22	3322/tcp
sapgw23	3323/tcp
sapgw24	3324/tcp
sapgw25	3325/tcp
sapgw26	3326/tcp
sapgw27	3327/tcp
sapgw28	3328/tcp
sapgw29	3329/tcp
sapgw30	3330/tcp
sapgw31	3331/tcp
sapgw32	3332/tcp
sapgw33	3333/tcp
sapgw34	3334/tcp
sapgw35	3335/tcp
sapgw36	3336/tcp
sapgw37	3337/tcp
sapgw38	3338/tcp
sapgw39	3339/tcp
sapgw40	3340/tcp
sapgw41	3341/tcp
sapgw42	3342/tcp
sapgw43	3343/tcp
sapgw44	3344/tcp
sapgw45	3345/tcp
sapgw46	3346/tcp
sapgw47	3347/tcp
sapgw48	3348/tcp
sapgw49	3349/tcp
sapgw50	3350/tcp
sapgw51	3351/tcp
sapgw52	3352/tcp
sapgw53	3353/tcp
sapgw54	3354/tcp
sapgw55	3355/tcp
sapgw56	3356/tcp
sapgw57	3357/tcp
sapgw58	3358/tcp
sapgw59	3359/tcp
sapgw60	3360/tcp
sapgw61	3361/tcp
sapgw62	3362/tcp
sapgw63	3363/tcp
sapgw64	3364/tcp
sapgw65	3365/tcp
sapgw66	3366/tcp
sapgw67	3367/tcp
sapgw68	3368/tcp
sapgw69	3369/tcp
sapgw70	3370/tcp
sapgw71	3371/tcp
sapgw72	3372/tcp
sapgw73	3373/tcp
sapgw74	3374/tcp
sapgw75	3375/tcp
sapgw76	3376/tcp
sapgw77	3377/tcp
sapgw78	3378/tcp
sapgw79	3379/tcp
sapgw80	3380/tcp
sapgw81	3381/tcp
sapgw82	3382/tcp
sapgw83	3383/tcp
sapgw84	3384/tcp
sapgw85	3385/tcp
sapgw86	3386/tcp
sapgw87	3387/tcp
sapgw88	3388/tcp
sapgw89	3389/tcp
sapgw90	3390/tcp
sapgw91	3391/tcp
sapgw92	3392/tcp
sapgw93	3393/tcp
sapgw94	3394/tcp
sapgw95	3395/tcp
sapgw96	3396/tcp
sapgw97	3397/tcp
sapgw98	3398/tcp
sapgw99	3399/tcp

Logging on to SAP

The following settings are required to connect with your SAP system.

SAP Host Host name of the target system. Host names can be regular host names defined in a hosts file, an IP address like 123.123.123.123, or an SAProuter address such as /H/hostname/S/connector/H/host/S/connector/...
System Number The number by which the target system is defined. The valid range is 0 to 99, but in general this is 0.
Client The client authenticating to the SAP system.
User The user that is authenticating to the SAP system.
Password The password for the authenticating user.

Gateway

When connecting to SAP via a gateway, use the options in the Gateway section of the Advanced tab.

Load Balancing

To log on via load balancing, set the properties in the Logon Load Balancing section of the Advanced tab.

Secure Network Communications (SNC)

To enable secure network communications, check the Enable SNC box in the Secure Network Communications (SNC) section of the Advanced tab. Set SNC Library to the .dll of the SNC library you want to use to connect with SAP.

Macros

ファイルの命名規則にマクロを使用することで、組織の効率とデータの文脈的理解を高めることができます。マクロをファイル名に組み込むことで、識別子、タイムスタンプ、ヘッダー情報などの関連情報を動的に含めることができ、各ファイルに有益なコンテキストを付与できます。これにより、組織にとって重要な詳細をファイル名に反映させることができます。

CData Arc はこれらのマクロをサポートしており、すべて次の構文を使用します：%Macro%

Macro	説明
ConnectorID	コネクタのConnectorID を返します。
Ext	コネクタが処理中のファイルの拡張子を返します。
Filename	コネクタが処理中のファイルのファイル名（拡張子を含む）を返します。
FilenameNoExt	コネクタが処理中のファイルのファイル名（拡張子なし）を返します。
MessageId	コネクタがアウトプットするメッセージのMessageId を返します。
RegexFilename:pattern	コネクタで処理中のファイルのファイル名にRegEx パターンを適用します。
Header:headername	コネクタが処理中のメッセージのヘッダー（`headername`）の値を返します。
LongDate	システムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で返します。
ShortDate	システムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で返します。
DateFormat:format	システムの現在の日時を指定されたフォーマット（`format`）で返します。使用可能な日付フォーマットについては、サンプル日付フォーマットを参照してください。
Vault:vaultitem	指定されたvault 項目の値を返します。
ARCKEY	Evaluates to the key for the external message archive.
CIMTYP	Evaluates to the custom extension defined by the user.
CREDAT	Evaluates to the creation date of the IDoc.
CRETIM	Evaluates to the creation time of the IDoc.
DIRECT	Evaluates to the direction of the IDoc (it indicates if the IDoc is inbound or outbound).
DOCNUM	Evaluates to the unique number assigned to the IDoc.
DOCREL	Evaluates to the SAP release number for the IDoc.
EXPRSS	Evaluates to the value of the EXPRSS flag.
IDOCTYP	Evaluates to the name of the basic type of the IDoc.
MANDT	Evaluates to the client number.
MESCOD	Evaluates to the message code.
MESFCT	Evaluates to the message function.
MESTYP	Evaluates to the message type.
OUTMOD	Evaluates to the output mode.
RCVLAD	Evaluates to the recipient’s logical address.
RCVPFC	Evaluates to the recipient’s partner function.
RCVPOR	Evaluates to the receiver port value.
RCVPRN	Evaluates to the receiver partner number.
RCVPRT	Evaluates to the receiver partner type.
RCVSAD	Evaluates to the recipient’s address.
REFGRP	Evaluates to the message group (such as EDI Message Group).
REFINT	Evaluates to the transmission file (such as EDI Interchange).
REFMES	Evaluates to the message (such as EDI Message)
SERIAL	Evaluates to the EDI serialization field.
SNDLAD	Evaluates to the sender’s logical address.
SNDPFC	Evaluates to the sender’s partner function.
SNDPOR	Evaluates to the sender’s port.
SNDPRN	Evaluates to the sender’s partner number.
SNDPRT	Evaluates to the sender’s partner type.
SNDSAD	Evaluates to the sender’s address.
STATUS	Evaluates to the status of the IDoc.
STD	Evaluates to a flag indicating the EDI standard.
STDMES	Evaluates to the EDI message type.
STDVRS	Evaluates to the EDI standard, version and release.
TABNAM	Evaluates to the name of the table structure.
TEST	Evaluates to the value of the test flag.

例

%Ext% や%ShortDate% などの引数を必要としないマクロもありますが、引数を必要とするマクロもあります。引数を渡すマクロはすべて次の構文を用います：%Macro:argument%

以下は、引数を渡すマクロの例です。

%Header:headername%：headername はメッセージのヘッダー名です。
%Header:mycustomheader% は、インプットメッセージで設定されたmycustomheader ヘッダーの値を返します。
%Header:ponum% は、インプットメッセージで設定されたponum ヘッダーの値に対応します。
%RegexFilename:pattern%：pattern は正規表現パターンです。例えば、%RegexFilename:^([\w][A-Za-z]+)% はファイル名の最初の単語と照合し、大文字と小文字を区別せずに結果を返します（test_file.xml はtest に変換されます）。
%Vault:vaultitem%:vaultitem は、vault のアイテム名です。例えば、%Vault:companyname% はVault に保存されているcompanyname アイテムの値を返します。
%DateFormat:format%：format は使用可能な日付フォーマットです（詳細はサンプル日付フォーマットを参照してください）。例えば、%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% はファイルの日付とタイムスタンプを返します。

以下の例に示すように、より詳細なマクロを作成することもできます。

複数のマクロを1つのファイル名にまとめる：%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
マクロの外側にテキストを含める：MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
マクロ内にテキストを含める：%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%