SAP ERP Connector for CData Sync

Build 25.0.9540
  • SAP ERP
    • 接続の確立
      • 依存関係の設定
      • サポートされているエディションおよびコンテンツ
      • SAP エンティティへのアクセス
      • カスタム Read Table 関数の使用
      • データアクセスのファインチューニング
    • 高度な機能
      • SSL の設定
      • ファイアウォールとプロキシ
    • データモデル
      • ビュー
        • SearchFunctions
      • ストアドプロシージャ
        • ClearCache
        • CreateFunctionSchema
        • CreateQuerySchema
        • CreateSchema
        • CreateTableSchema
        • ListQueries
        • PushIDoc
    • 接続文字列オプション
      • Authentication
        • ConnectionType
        • ConnectionScheme
        • Host
        • SystemNumber
        • User
        • Password
        • Client
        • X509Certificate
        • MessageServer
        • Group
        • SystemId
        • RFCURL
        • MessageServerService
      • Security
        • SNCMode
        • SNCName
        • SNCQop
        • SNCPartnerName
        • SNCLibPath
        • SNCSSO
      • SSL
        • SSLServerCert
      • Firewall
        • FirewallType
        • FirewallServer
        • FirewallPort
        • FirewallUser
        • FirewallPassword
      • Proxy
        • ProxyAutoDetect
        • ProxyServer
        • ProxyPort
        • ProxyAuthScheme
        • ProxyUser
        • ProxyPassword
        • ProxySSLType
        • ProxyExceptions
      • Logging
        • LogModules
      • Schema
        • BrowsableSchemas
        • Tables
        • Views
      • Miscellaneous
        • SAPEdition
        • BAPINameSeparator
        • Charset
        • CheckDecimalNotation
        • CustomTableFilter
        • EndianType
        • GatewayHost
        • GatewayService
        • GenerateSchemaFiles
        • InitialValueMode
        • Language
        • Location
        • MapNUMCToVarchar
        • MapRAWToVarchar
        • MaxRows
        • Other
        • Pagesize
        • PaginationScheme
        • PseudoColumns
        • QueryMode
        • ReadTableDelimiter
        • ReadTableFunction
        • ServerTimeZone
        • StoredProcedureFilter
        • SupportServerSideCount
        • TableMode
        • Timeout
        • TrimStrings
        • UseAdvancedReplication
        • UseInternalNames
        • UseLabels
        • UserDefinedViews
        • UseSimpleNames
        • UseUnicodeRFC
        • WhitespaceToNull
    • Third Party Copyrights

SAP ERP Connector for CData Sync

概要

CData Sync App は、SAP ERP データをデータベース、データレイク、またはデータウェアハウスに継続的にパイプライン化する簡単な方法を提供し、分析、レポート、AI、および機械学習で簡単に利用できるようにします。

SAP ERP コネクタはCData Sync アプリケーションから使用可能で、SAP ERP からデータを取得して、サポートされている任意の同期先に移動できます。

SAP ERP バージョンサポート

Sync App は、SAP R/3、NetWeaver、またはERP/ECC 6.0+ システムのテーブル、クエリ、およびファンクションモジュールへのリレーショナルアクセスを実現します。サポートされているSAPのエディションおよびコンテンツの詳細については、サポートされているエディションおよびコンテンツ を参照してください。

SAP ERP Connector for CData Sync

接続の確立

SAP ERP への接続を追加

SAP ERP への接続を追加するには:

  1. アプリケーションコンソールで、接続ページに移動します。
  2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
  3. SAP ERP アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからSAP ERP コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

RFC API との接続

CData Sync App はSAP RFC インターフェースを使用してSAP システムに接続します。 ConnectionType は接続に使用するRFC API を指定します。

接続するには、RFC API に対応するSAP ライブラリの入手が必要です。

必須RFC

CData Sync App が使用するRFC は次のとおりです。以下にリストされているものが利用できない場合、一部またはすべての機能が動作しない可能性があります。 T-Code SE37 を使用すると、SAP で利用可能な汎用モジュールを表示できます。

  • DDIF_FIELDINFO_GET
  • RFC_GET_FUNCTION_INTERFACE
  • RFC_GET_STRUCTURE_DEFINITION
  • RFC_GET_SYSTEM_INFO
  • RFC_GET_UNICODE_STRUCTURE
  • RFC_READ_TABLE
  • SLDAG_CHECK_FOR_UNICODE

SAP ERP への接続

接続するには以下を設定します。

  • Host:ターゲットシステムのホスト名。ホスト名はホストファイルに定義されている通常のホスト名、123.123.123.123 のようなIP アドレス、または"/H/hostname/S/port/H/host/S/port/ ..." のようなSAProuter アドレスにすることができます。
  • User:SAP システムに認証しているユーザー。
  • Password:SAP システムへの認証に使われるパスワード。
  • Client:SAP システムに認証しているクライアント。
  • SystemNumber:ターゲットシステムが定義される番号。
  • Language:SAP ERP へのログインに使用するISO 639-1 言語コード。デフォルトは"EN" です。

Host マシンとは別のマシンに接続するには、Host を以下に置き換えます。

  • GatewayHost:接続先のゲートウェイホスト。指定されない場合は、プロバイダーはHost によって指定されたSAP システムへの接続を試みます。
  • GatewayService:接続先のゲートウェイサービス。指定されない場合は、SAP システムはデフォルトの"sapgw##" を使用します。"##" はSystemNumber です。

分散システム、または別の構成のシステムに接続するには、データアクセスのファインチューニング を参照してください。

証明書

CData Sync App はユーザーとパスワードの認証に加え、証明書認証にも対応しています。証明書認証を使用するには、PEM 形式のX509 証明書を含むファイルを指すか、SAP ログオン時の認証に直接使用されるPEM blob を指すように、X509Certificate 接続プロパティを設定します。 X509Certificate の設定の他に、適切なSNC 接続プロパティの指定が必要です。 SNC 接続プロパティはデータアクセスのファインチューニング に記載されています。

SAP ERP Connector for CData Sync

依存関係の設定

Classic RFC SDK を使用した接続

ライブラリlibrfc32.dll で提供されるUnicode サポートのないClassic RFC SDK を使用するには、ConnectionType をClassic に設定します。 実行時にアクセス可能な場所(system32、またはインストールディレクトリや自身のパスのbin フォルダなど)にアセンブリを配置します。

Unicode サポートのClassic RFC SDK を使用した接続

Unicode サポートのあるClassic RFC SDK を使用するには、 ConnectionType をClassic_Unicode に設定します。

実行時にアクセス可能な場所(system32、またはインストールディレクトリのbin フォルダなど)に以下のアセンブリを配置します。

  • librfc32u.dll
  • icudt50.dll
  • icuin50.dll
  • icuuc50.dll

Note: 以前のSAP 構成では、ICU ライブラリのバージョン34が使用されていた場合があります。ただし、サポートされているSAP RFC SDK バージョンとの互換性のためにはバージョン50が必要です。

NetWeaver RFC SDK を使用した接続

接続する前に、有効なS-User Id を持ち、SAP ソフトウェアダウンロードサイトにアクセスできる必要があります。また、SAP ポータルからSAP コンテンツをダウンロードできる必要があります。 必要なSDK をダウンロードするには、以下の手順に従います。

  1. https://me.sap.com/softwarecenter に移動します。
  2. "Downloads" ページで、sap nw rfc を検索します。
  3. SAP NW FRC SDK 7.50 をクリックします。
  4. 使用するプラットフォームを選択し、ダウンロードします。

NetWeaver RFC SDK を使用するには、ConnectionType をNetWeaver に設定します。

実行時にアクセス可能な場所(system32、またはインストールディレクトリのbin フォルダなど)に以下のアセンブリを配置します。

SDK バージョン7.50 の場合、以下のDLL が利用可能であることを確認してください。

  • sapnwrfc.dll
  • icudt50.dll
  • icuin50.dll
  • icuuc50.dll
  • libicudecnumber.dll
  • libsapucum.dll

SOAP インターフェースおよびRFC URL を使用した接続

SOAP インターフェースを使用して接続するには、以下を設定します。

  • ConnectionType:Soap。
  • RFCURL:SAP システムのSOAP URL。

このタイプの接続が正しく動作するには、SOAP サービスがSAP システムで有効になっている必要があります。

JCo JAR ファイルを使用した接続

CData Sync App はSAP RFC を利用してクエリを実行してSAP からデータを取得します。RFC はJCo(Java コネクタ)JAR ファイルに依存します。

SAP との通信に使用されるRFC SDK へアクセスするには、SAP JCo(Java コネクタ)を使用できます。 ビルドパスにsapjco3.jar を含めて、JAR のネイティブライブラリの場所がsapjco3 ライブラリを含むフォルダに設定されていることを確認してください。

また、ライブラリのビット数(32ビットまたは64ビット)が、アプリケーションを実行しているJava 仮想マシン(JVM)のビット数と一致していることを確認する必要があります。 これらの間に不一致があると、JVM がネイティブライブラリをロードできず、SAP システムへの接続を確立できないというエラーが発生する可能性があります。 ダウンロードする前にシステムの構成を確認し、対応するバージョンのライブラリをダウンロードしてください。

  • Windows では、sapjco3.jar と同じディレクトリにsapjco3.dll を配置します。
  • Linux では、sapjco3.jar と同じディレクトリにlibsapjco3.so ファイルを配置します。
  • Mac OS X では、sapjco3.jar と同じディレクトリにlibsapjco3.jnilib ファイルを配置します。

以下の手順に従って、関連するjar ファイルをダウンロードします。

  1. SAP Java Connector を開きます。
  2. 使用するプラットフォームに適したJco バージョンを選択します。
  3. ダウンロードリンクをクリックします。ログインページが開きます。
  4. 有効なS-User ID でSAP サイトにログインします。
  5. パッケージをダウンロードします。

SAP ERP Connector for CData Sync

サポートされているエディションおよびコンテンツ

SAP と通信する方法

CData Sync App では、以下の方法を使用してSAP R/3 システムと通信できます:

  • Business Application Programming Interface(BAPI)
  • Remote Function Call(RFC)
  • SAP テーブル
  • SAP クエリ
  • IDoc メッセージ

用語説明

SAP:SAP とは、サポートされているすべてのSAP エディションの総称です。これは一般的にSAP ECC バージョン6+ および SAP S/4 Hana オンプレミス を示しますが、RFC SDK をサポートする他のエディションも含まれます。CData Sync App が機能するには、RFC SDK をサポートするSAP のエディションへの接続が必要です。

汎用モジュール:汎用モジュールとは、ほぼすべての操作を実行するために使用できるSAP のプログラムや機能の一種です。これらのモジュールは、SE37 TCode を介してSAP 内でテストおよび記述できます。

RFC:リモートファンクションコール(RFC)は、外部アプリケーションから実行できるAPI コールとしてモデル化された汎用モジュールの一種です。 これには、SAP サーバーにインストールされるSAP が配布するライブラリの使用が含まれ、sap.com からダウンロードすることもできます。 特定のRFC は、SAP のアップグレードで維持される場合とされない場合があります。SAP が提供する標準RFC があるため、違いがある場合や、古いエディションには存在しない場合があります。 カスタムRFC は、統合をサポートするために構築でき(多くの場合構築され)、SAP の顧客が維持する必要があります。 慣例により、カスタムRFC はZ から始まります。

BAPI:Business API(BAPI)は、SAP が配布および管理しているRFC の一種で、ビジネスロジックの操作にアクセスできるようにするためのものです。 BAPI には、ビジネスオブジェクトの種類に固有のメソッドがあります。例えば、Customer オブジェクトのみに関連するBAPI が約60あります。 実際には、通常使用されるものはごくわずかです。

SAP テーブル:SAP テーブルは、SAP にデータを格納するテーブルです。これらはビジネスオブジェクトとは異なります。例えば、SAP にはPurchase Order テーブルはありません。 代わりに、EBAN、EBKN、EINA、EKPO、など、購買発注データを含む多くのテーブルがあります。 カスタムテーブルは、慣例によりZ から始まります。

SAP クエリ :SAP クエリは、1つ以上のテーブルから取得する情報の詳細を記述した、SAP に保存されたオブジェクトです。これらは通常、レポート目的で使用されます。

SAP エディション

弊社のRFC 接続のサポートとは、RFC 接続をサポートしているSAP のすべてのエディションと接続に必要な特定のRFC が動作することを意味します。具体的には、以下への接続をサポートしています:

  • SAP BW
  • SAP ECC
  • SAP ERP
  • SAP R/3
  • SAP S/4 Hana オンプレミス

RFC 接続をサポートしている他のエディションもサポートされる可能性があります。

利用可能なコンテンツ

以下のSAP コンテンツはCData Sync App からアクセス可能です。

SAP テーブル:SAP テーブルは、TableMode 接続プロパティを介して自動的にビューとして公開されます。 扱いたいSAP テーブルが正確にわかっている場合は、TableMode をオーバーライドするViews 接続プロパティ経由で指定できます。 テーブルにはビジネスオブジェクトの一部が含まれているため、SAP ではテーブル自体を直接変更することを推奨していません。 代わりに、BAPI を使用してテーブル状のデータを変更することをお勧めしています。このため、当社のツールはSAP テーブルの直接の変更をサポートしていません。

BAPI およびRFC:BAPI およびRFC は、ストアドプロシージャとして直接公開されます。デフォルトでは、キーワードBAPI で始まるすべてのRFC は、利用可能なストアドプロシージャとして表示されます。 この動作は、StoredProcedureFilter 接続プロパティを変えることで変更できます。

SAP クエリ :SAP クエリもビューとして公開されますが、デフォルトではオフになっています。これらは、SAP テーブルやBAPI ほど一般的には必要とされていません。 SAP クエリを公開したい場合は、QueryMode 接続プロパティを変更してください。

未処理のIDoc および IDoc XML:Intermediate Document(IDoc)ファイルは、あるシステムから別のシステムへ、電子メッセージの形でビジネストランザクションデータを伝送するSAP オブジェクトです。 IDocs は、電子データ交換(EDI)システムを介して、SAP からSAP 以外のシステムにデータを転送します。 転送が2つのSAP システム間で行われる場合、IDocs はALE 技術を採用します。

詳しくは、データモデル を参照してください。

SAP ERP Connector for CData Sync

SAP エンティティへのアクセス

SAP システム内のエンティティの数によって、すべてのエンティティが同時に表示されているときに作業が難しくなる可能性があります。次のセクションでは、どのSAP エンティティを選択するかの概要を説明します。

SAP エンティティの操作の詳細については、データモデル を参照してください。

SAP エンティティのフィルタリング

次の接続プロパティは、必要なエンティティを選択するための基本的な機能を提供します。

  • TableMode:SAP のDD02L システムテーブルからテーブルをフィルタリング。
  • QueryMode:SAP ワークスペースでクエリをフィルタリング。
  • StoredProcedureFilter:ストアドプロシージャとしてモデル化されたSAP 汎用モジュールをフィルタリング。
SAP エンティティをより制御する必要があるユーザーは、スキーマファイルを使用できます。スキーマをファイルに保存することで、ビューやストアドプロシージャを個別に簡単に含めることができます。Location フォルダには、表示したいエンティティが含まれています。GenerateSchemaFiles 接続プロパティとLocation を設定して、実行時にスキーマファイルを生成します。

SAP ERP Connector for CData Sync

カスタム Read Table 関数の使用

RFC_READ_TABLE

Sync App は、SAP RFC_READ_TABLE 関数を使ってSAP テーブルからデータを取得します。しかし、これには一定の制限があります。

例えば、DATA_BUFFER_EXCEEDED 例外を考えてみます。SAP RFC_READ_TABLE は、512 バイトの固定サイズがあります。 データの各行に対してバッファできるため、このバッファに収まる量を超えるカラムを選択することはできません。 512 バイトを超えて選択した場合は、各行に許容された最大バッファサイズを超過したため選択するカラム数を減らす必要がある旨を示す例外が発生します。

RFC_READ_TABLE2

Sync App は、RFC_READ_TABLE2 テーブルリード関数もサポートします。ReadTableFunction を"/SAPDS/RFC_READ_TABLE2" に設定することで、アクティブなテーブルリード関数をRFC_READ_TABLE2 に切り替えることができます。

カスタムRead Table 関数

カスタムRead Table RFC のインストール

Sync App には、Z_CUSTOM_READ_TABLE コードが含まれます。これは、SAP RFC_READ_TABLE に類似していますが、DATA_BUFFER_EXCEEDED 問題に対処し、その他のRFC_READ_TABLE の制限を回避するためにより大きなバッファを備えたカスタムread-table RFC です。

下記の手順に従って、付属のカスタムread-table RFC を使ってデフォルトのRFC_READ_TABLE の制限を回避します。

  1. RFC_READ_TABLE 関数を新しい関数のテンプレートとして使用します。トランザクションコードSE37 とSDTX Function Group を選択し、RFC_READ_TABLE を新しい汎用グループまたはワーキングの汎用グループにコピーします。この例では、RFC_READ_TABLE は"Z_CUSTOM_READ_TABLE" にコピーされます。
  2. SAP 画面の[属性]タブで、"リモート対応モジュール" を選択します。
  3. [テーブル]タブで、DATA パラメータを"CHAR8000" に設定します(右クリックしてから"Display <-> Change" をクリックする必要がある場合があります)。
  4. [ソースコード]タブで、インストールディレクトリの"db" サブフォルダにあるRFC_READ_TABLE 汎用モジュールの代替サンプルソースコードを貼り付けます。コードはZ_CUSTOM_READ_TABLE.txt にありますが、SAP ERP インスタンスがABAP バージョン7.52以降を実行している場合は、Z_CUSTOM_READ_TABLE_752.txt が推奨されます(以下のセクションを参照してください)。[保存]をクリックします。
  5. インポート、テーブル、および例外を、提供されたカスタムread テーブルに記載されているとおりに定義します。
  6. 汎用モジュールをアクティベートし、接続文字列でReadTableFunction をZ_CUSTOM_READ_TABLE または汎用モジュール名に設定します。

ABAP 7.52 カスタムRead Table

Z_CUSTOM_READ_TABLE.txt と共に、ABAP バージョン7.52 以降に対応するZ_CUSTOM_READ_TABLE_752.txt ファイルも存在します。

これはほぼZ_CUSTOM_READ_TABLE と同じですが、ABAP 7.52 で新たに利用可能になったキーワードを利用して、ABAP スクリプト自体ではなく、データベース内でページングを実行します。これにより、ページングがはるかに効率的になり、大きなテーブルを扱う際に非常に顕著なパフォーマンスの向上が期待できます。

可能な限りZ_CUSTOM_READ_TABLE_752 RFC の使用が推奨されます。 Note:次のリンク:https://www.cdata.com/kb/entries/sap-custom-read-table-function.rst に従ってZ_CUSTOM_READ_TABLE_752.txt およびZ_CUSTOM_READ_TABLE_752.txt ファイルを入手できます。

SAP ERP Connector for CData Sync

データアクセスのファインチューニング

データアクセスのファインチューニング

  • UseSimpleNames:SAP ERP は、多くのデータベース指向のツールがサポートしていない特殊文字を使った属性名をサポートしています。このプロパティを使用すると、英数字以外の文字をアンダースコアで置き換えられます。
  • InitialValueMode:未定義または未知の値を持つフィールドに対して、null またはSAP から返された正確な値を返すように設定します。デフォルトでは、Sync App はnull を返します。

分散SAP システムへの接続

ロードバランシングを使用するシステムのような分散SAP システムに接続する場合は、次の追加プロパティを設定する必要があります。 管理者は、[System Entry Properties]ダイアログの[Connection]タブでこれらの接続プロパティを取得できます。

  • SystemId:[System Id]ボックスの値に設定。

    SystemId プロパティは、SAP システムのSystem Id またはR3Name です。System Id は最大3文字の文字列です。

  • MessageServer:[Message Server]ボックスの値に設定。SAProuter ボックスに値が指定されている場合は、SAProuter ボックスの値をMessageServer 接続文字列プロパティの値の前に付加します。

    ロードバランシングを使用するSAP システムに接続する場合は、MessageServer プロパティを指定する必要があります。

  • Group:値が指定されている場合は、このプロパティを[Group/Server]ボックスの値に設定します。

    Group プロパティは使われているログオングループを指定します。大抵のSAP システムでは、デフォルトはPUBLIC です。

HTTP 以外のメッセージサーバーサービスを使用している場合は、MessageServerService を設定します。

カスタムアプリケーションサーバーへの接続

専用アプリケーションサーバーまたはカスタムアプリケーションサーバーを使用してSAP システムに接続する場合は、[System Entry Properties]ダイアログの[Connection]タブで次の接続プロパティを取得できます。

  • SystemId:[System Id]ボックスの値に設定。

    SystemId プロパティは、SAP システムのSystem Id またはR3Name です。System Id は最大3文字の文字列です。

  • Host:[Application Server]ボックスの値に設定。

    Host プロパティはターゲットシステムのホスト名を指定します。 この値には、通常のホスト名、IP アドレス、またはSAProuter アドレスを使用できます。

  • SystemNumber:SystemNumber ボックスの値に設定。

    SystemNumber プロパティはターゲットシステムを定義します。

セキュアネットワーク通信の設定

管理者がSecure Network Communication(SNC;セキュアネットワーク通信) を設定している場合は、次の追加プロパティを設定する必要があります。[System Entry Properties]ダイアログの[Network]タブで、次のSNC 接続文字列プロパティを取得できます。

  • SNCMode:"Activate Secure Network Connections" チェックボックスが有効になっている場合は、SNCMode 接続文字列プロパティをTrue に設定します。このチェックボックスが無効の場合は、SNCMode 接続プロパティをFalse に設定します。

    SNCMode 接続プロパティは、SNC を使用しているかどうかを決定するboolean 値です。デフォルト値はFalse です。

  • SNCPartnerName:[SNC Name]ボックスの値に設定。

    SNCPartnerName プロパティは、アプリケーションサーバーのSNC 名を指定します。例:p:CN=IDS, OU=IT, O=CSW, C=DE

  • SNCName:オプション。[SNC Name]ボックスの値に設定。

    SNCName プロパティは、SNC 接続の名前を指定します。このプロパティを設定して、接続に正しいSNC 名が使用されていることを確認します。

  • SNCQop:[Secure Network Settings]セクションの選択されたオプションに設定。例えば、Integrity オプションが選択されている場合、SNCQop プロパティを3 に設定します。

    SNCQop プロパティはデータ保護のレベル(または品質)を指定します。 このプロパティが指定されていない場合は、このプロパティに整数 -1 が設定されます。有効な値は1、2、3、8、または9で、以下の保護レベルに対応します。

    1 認証のみ。コミュニケーションパートナーのアイデンティティが検証されます。
    2 整合性保護。SAP システムは、交換されたデータの変更または操作を検出します。
    3 プライバシー保護。このレベルは完全性と認証を提供します。SAP システムは転送されるメッセージを暗号化します。2 つのコミュニケーションパートナー以外誰もデータを読み取ったり改ざんしたりできません。これは最大レベルの保護です。
    8 デフォルト保護。
    9 最大の保護。

  • SNCLibPath:SNC ライブラリのパスおよびファイル名に設定。

    SNCLibPath プロパティは、使用しているセキュリティライブラリの完全パスを指定します。例えば、C:\Secude\secude.xll です。

SAP ERP Connector for CData Sync

高度な機能

このセクションでは、SAP ERP Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。

SSL の設定

SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、SAP ERP にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくは、クエリ処理 を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングに必要なのは2つの接続プロパティだけですが、より詳細なロギングをサポートする多くの機能があり、LogModules 接続プロパティを使用してロギングする情報のサブセットを指定することができます。

SAP ERP Connector for CData Sync

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

SAP ERP Connector for CData Sync

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

  • ProxyServer:HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
  • ProxyPort:プロキシサーバーが起動しているTCP ポート。
  • ProxyAuthScheme:プロキシサーバーに対して認証する際にSync App が使用する認証方法。
  • ProxyUser:プロキシサーバーに登録されているユーザーアカウントのユーザー名。
  • ProxyPassword:ProxyUser に紐付けられたパスワード。

その他のプロキシ

次のプロパティを設定します。

  • プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
  • 接続をトンネルするには、FirewallType をTUNNEL に設定します。
  • 認証するには、FirewallUser とFirewallPassword を設定します。
  • SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

SAP ERP Connector for CData Sync

データモデル

CData Sync App はSAP テーブル、クエリ、および汎用モジュールのスキーマを、実行時に動的に取得します。ただし、SAP システム全体のメタデータを取得することは非効率的な場合があるため、Sync App はまたデフォルトのフィルタを適用してSAP システムの一片のみを表示します。

以下では、Sync App がSAP オブジェクトの各タイプをどのようにモデル化するかを説明します。Sync App が何を表示するかを決定する方法は、非常にカスタマイズ可能です。SAP オブジェクトの選択についての詳細は、SAP エンティティへのアクセス を参照してください。

SAP テーブル

SAP テーブルはビューとして表示されます。これは、SAP テーブルに直接変更を加えることをSAP が強く嫌っているためです。代わりに、BAPIs などの汎用モジュールを使用してテーブルデータを変更する必要があります。詳しくは、汎用モジュールを参照してください。

テーブルデータは、RFC_READ_TABLE またはZ_CUSTOM_READ_TABLE のいずれか(インストールされている場合)の汎用モジュールを使用して、SAP から取得されます。これらは基本的なSQL サポートへのアクセスを可能にしますが、join やgroup by などのより複雑なクエリはローカルで処理しなければなりません。さらに複雑なクエリは、Sync App によって自動的に処理されます。

RFC_READ_TABLE の制限を回避するための詳細は、カスタム Read Table 関数の使用 を参照してください。

SAP クエリ

テーブル同様に、SAP クエリをリレーショナルビューとして扱うこともできます。デフォルトでは、多すぎるオプションでSync App が乱雑になるのを避けるためにオフになっています。これは、QueryMode 接続プロパティを使用してオンにできます。

テーブルとは異なり、SAP クエリでは、特定の値を入力として指定する必要がある場合があります。これらのクエリ入力は、SQL のpredicate の一部として指定できます。次に例を示します。

SELECT * FROM Z_SAP_QUERY WHERE InputName='x'
すべてのSAP クエリビューにはVariant カラムが含まれ、projection の一部としても入力できます。

SAP クエリの入力のみの値は、指定された値と同じ値として結果に反映されることに注意してください。これは、実際にSAP がそのように値を返したことを示すものではありません。これは、SQL ステートメントを有効にしておくために必要なことです。

汎用モジュール

SAP の汎用モジュールは、ほぼすべてのタスクに使用できます。これにはRFC_READ_TABLE などのSync App のRFC 呼び出しや、BAPI_PO_CREATE などのデータを変更する汎用モジュールが含まれます。

汎用モジュールは、ストアドプロシージャとして直接実行できます。SAP の汎用モジュールは、プリミティブ値と複雑な構造を受け入れて返します。対応するストアドプロシージャはSQL の型およびテーブルを受け入れて返します。次に例を示します。

EXEC STFC_CONNECTION

より複雑な例については、RFC_READ_TABLE を試してください。

  EXEC RFC_READ_TABLE @QUERY_TABLE='MARA', @FIELDS='FIELDS#TEMP', @ROWCOUNT=1

上記の例では、MARA テーブルを返すためにRFC_READ_TABLE 汎用モジュールが実行されています。QUERY_TABLE およびROWCOUNT パラメータはプリミティブ値として渡されています。この汎用モジュールでは、FIELDS は入力テーブルです。この入力を提供するには、#TEMP構文とINSERT ステートメントを使用してテンポラリテーブルを作成します。次に例を示します。

  INSERT INTO FIELDS#TEMP (FIELDNAME) VALUES ('MANDT');
  INSERT INTO FIELDS#TEMP (FIELDNAME) VALUES ('MATNR');
  INSERT INTO FIELDS#TEMP (FIELDNAME) VALUES ('ERSDA');
  INSERT INTO FIELDS#TEMP (FIELDNAME) VALUES ('ERNAM');

あるいは、JSON またはXML を使用して、#TEMP テーブルの使用が難しい環境用のテーブル形式データを送信できます。次に例を示します。

  EXEC RFC_READ_TABLE OPTIONS='{ \"TEXT\": \"TABNAME LIKE ''MARA%''\" }', QUERY_TABLE='DD02L', ROWCOUNT='1', ReturnTables='DATA'

ストアドプロシージャスキーマのカスタマイズ

動的なインメモリスキーマを使用する代わりに、GenerateSchemaFiles を使ってカスタマイズが容易な静的スキーマファイルを保存することができます。一般的なユースケースは、Sync App がストアドプロシージャにレポートする不要で余計な入出力を削除することです。

SAP には、汎用モジュールのテーブルを入力または出力のいずれかとして区別するメタデータはありません。どのテーブルが実際に入力として使用され、どのテーブルが出力として使用されているかを知る方法がないため、Sync App はテーブルを入力と出力の両方で使用可能であるとレポートします。

スキーマファイルを生成するには、GenerateSchemaFiles を"OnUse" に設定してストアドプロシージャを呼び出します。 また、Location プロパティをスキーマを出力したいフォルダに設定します。

スキーマファイルを変更するには、Location フォルダにある生成されたスキーマファイルをテキストエディタで開きます。それから不要な<input> または<output> タグを見つけて削除します。Sync App で接続をリフレッシュして、スキーマと変更内容を取得します。

SAP ERP Connector for CData Sync

ビュー

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

SAP ERP Connector for CData Sync ビュー

Name Description
SearchFunctions 接続されたSAP システムで利用可能なすべてのSAP リモート対応汎用モジュールのリストを表示し、検出や統合に役立ちます。

SAP ERP Connector for CData Sync

SearchFunctions

接続されたSAP システムで利用可能なすべてのSAP リモート対応汎用モジュールのリストを表示し、検出や統合に役立ちます。

Columns

Name Type Description
Name String 検索で返されたSAP リモート対応汎用モジュールの名前。
Group String SAP 汎用モジュールが属する汎用グループで、通常は論理モジュールまたはエリアを表します。
Filter String SAP 汎用モジュールを名前やグループでフィルタリングして検索するために使用される検索語またはパターン。

デフォルト値はRFC*です。

SAP ERP Connector for CData Sync

ストアドプロシージャ

ストアドプロシージャはファンクションライクなインターフェースで、SAP ERP の単純なSELECT 処理にとどまらずSync App の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにSAP ERP から関連するレスポンスデータを返します。

SAP ERP Connector for CData Sync ストアドプロシージャ

Name Description
ClearCache JCoRepository のキャッシュをクリアしてSAP の関数やテーブルのメタデータ定義を更新し、最新バージョンを使用できるようにします。
CreateFunctionSchema 指定されたSAP 汎用モジュールのメタデータに基づいて.rsd スキーマファイルを生成し、統合ツールがその構造をマッピングできるようにします。
CreateQuerySchema 指定されたSAP クエリのスキーマファイルを構築し、外部ツールがデータ抽出のための入力および出力フィールドを理解できるようにします。
CreateTableSchema RFC_READ_TABLE を使用して特定のSAP テーブルのスキーマファイルを生成し、リモート関数呼び出しを通じてSAP バックエンドからデータを取得できるようにします。
ListQueries 利用可能なSAP クエリとそのフィールドに関するメタデータを取得し、ユーザーがデータ抽出のための正しいクエリ構造を選択するのを支援します。
PushIDoc 同期または非同期モードを使用してIDoc またはIDoc XML データをSAP システムに送信します。これは、B2B メッセージング、システム統合、またはトランザクション更新に役立ちます。

SAP ERP Connector for CData Sync

ClearCache

JCoRepository のキャッシュをクリアしてSAP の関数やテーブルのメタデータ定義を更新し、最新バージョンを使用できるようにします。

ストアドプロシージャ固有情報

このストアドプロシージャには入力パラメーターはありません。

このプロシージャを実行するには、以下を入力します:

    EXEC ClearCache

SAP ERP Connector for CData Sync

CreateFunctionSchema

指定されたSAP 汎用モジュールのメタデータに基づいて.rsd スキーマファイルを生成し、統合ツールがその構造をマッピングできるようにします。

Input

Name Type Description
Function String スキーマが生成されるSAP 汎用モジュールの名前。
FunctionDescription String 処理対象のSAP 汎用モジュールに関するユーザー提供のオプションの説明。
ReturnTables String スキーマに含めるSAP 汎用モジュールのテーブルのカンマ区切りリスト。すべての利用可能なテーブルを返すには、アスタリスク(*)を使用します。

デフォルト値は*です。

SchemaType String フラットスキーマやネストされた構造を使用するものなど、生成するスキーマ形式を指定します。

使用できる値は次のとおりです。StoredProcedure, View

デフォルト値はStoredProcedureです。

Result Set Columns

Name Type Description
Result String スキーマ生成プロセスが正常に完了したかどうかを示します。
SchemaFile String SAP 汎用モジュールの構造を表す生成されたスキーマファイルのパスまたは名前。
Columns String 生成されたスキーマに含まれる検出されたカラムの総数。

SAP ERP Connector for CData Sync

CreateQuerySchema

指定されたSAP クエリのスキーマファイルを構築し、外部ツールがデータ抽出のための入力および出力フィールドを理解できるようにします。

Input

Name Type Description
Query String スキーマを生成するクエリ。これはSAP Query (SQ01)で定義されたクエリと一致している必要があります。
UserGroup String 指定されたクエリを所有、またはクエリにアクセスできるSAP ユーザーグループ。
Variant String クエリを実行する際に適用するデフォルトのバリアント。これにより、フィールドの選択やフィルタを事前に定義できます。
QueryDescription String ドキュメントや表示の目的で使用される、SAP クエリの任意の説明。
Workspace String 生成されたスキーマを整理または分類するための任意のワークスペース名。

使用できる値は次のとおりです。Global, Local

デフォルト値はGlobalです。

TableName String 結果のテーブルまたはスキーマファイルに割り当てる名前。指定しない場合は、デフォルトでクエリ名が使用されます。

Result Set Columns

Name Type Description
Result String スキーマ生成が成功したか失敗したかを示します。
SchemaFile String クエリ結果の構造を表す、生成されたスキーマファイルのパスまたはファイル名。
Columns String クエリで識別され、生成されたスキーマに含まれるカラムの総数。

SAP ERP Connector for CData Sync

CreateSchema

指定されたSAP テーブルまたはビューのスキーマファイルを作成し、外部アプリケーションからSAP データへの構造化されたアクセスを容易にします。

ストアドプロシージャ固有情報

このプロシージャを実行するには、以下を入力します:
    EXEC CreateSchema TableName = 'MARA', FileName = 'C:\schemas\MARA.rsd'

TableName 入力はSAP テーブルまたはビューを指定し、FileName 入力は生成されるスキーマファイルのパスを定義します。

Input

Name Type Description
TableName String スキーマを生成するSAP テーブルまたはビューの名前。これはSAP システムからメタデータを取得するために使用されます。
FileName String 生成されたスキーマファイルのフルパスとファイル名。例:'C:\\Users\\User\\Desktop\\SmartSheet\\sheet.rsd'。

Result Set Columns

Name Type Description
Result String スキーマ作成プロセスが成功したか失敗したかを示します。

SAP ERP Connector for CData Sync

CreateTableSchema

RFC_READ_TABLE を使用して特定のSAP テーブルのスキーマファイルを生成し、リモート関数呼び出しを通じてSAP バックエンドからデータを取得できるようにします。

Input

Name Type Description
Table String スキーマを生成するSAP テーブルの名前。これは通常、RFC_READ_TABLE と共に使用され、メタデータおよびデータを取得します。
TableDescription String ドキュメント目的で使用される、SAP テーブルに関するユーザー定義の任意の説明。

Result Set Columns

Name Type Description
Result String スキーマ生成が成功したか、エラーが発生したかを示します。
SchemaFile String SAP テーブルの構造を表す生成されたスキーマファイルの名前またはパス。
Columns String 指定されたSAP テーブルで識別され、スキーマに含まれるカラムの数。

SAP ERP Connector for CData Sync

ListQueries

利用可能なSAP クエリとそのフィールドに関するメタデータを取得し、ユーザーがデータ抽出のための正しいクエリ構造を選択するのを支援します。

ストアドプロシージャ固有情報

このプロシージャを実行するには、以下を入力します:
    EXEC ListQueries UserGroup = 'ZGROUP', Query = 'ZQUERY', Workspace = 'Global'

UserGroup 入力はSAP ユーザーグループを指定し、Query 入力は結果を特定のクエリ名でフィルタリングします。

Input

Name Type Description
UserGroup String 利用可能なクエリをリストするためのSAP ユーザーグループ。ユーザーグループはSAP Query(SQ01)内のクエリへのアクセスを制御します。
Query String 指定されたユーザーグループ内で特定のクエリを名前で返すためのオプションフィルタ。
Workspace String クエリメタデータ結果を整理するために使用されるワークスペースのオプション名。

使用できる値は次のとおりです。Global, Local

デフォルト値はGlobalです。

Result Set Columns

Name Type Description
QueryName String 結果セットで返されるSAP クエリの名前。
UserGroup String 返されたクエリに関連付けられたSAP ユーザーグループ。
Variant String クエリ用に設定されたデフォルトのバリアントで、選択基準とレイアウトオプションを事前に入力するために使用されます。

SAP ERP Connector for CData Sync

PushIDoc

同期または非同期モードを使用してIDoc またはIDoc XML データをSAP システムに送信します。これは、B2B メッセージング、システム統合、またはトランザクション更新に役立ちます。

Input

Name Type Description
IDocFile String SAP システムに送信するIDoc またはIDoc XML ファイルのフルファイルパス。
FileType String アップロードされるファイルの形式。標準形式の場合は'IDoc'、構造化されたXML コンテンツの場合は'XML' など。

使用できる値は次のとおりです。XML, IDoc

デフォルト値はIDocです。

Mode String IDoc の送信方法を指定します。オプションには、synchronous(即時応答)またはasynchronous(バックグラウンド処理)が含まれます。

使用できる値は次のとおりです。Sync, ASync

デフォルト値はASyncです。

Result Set Columns

Name Type Description
Result String IDoc がSAP に正常に送信されたかどうかを示します。'Success' または'Failure' を返します。
Message String SAP またはインターフェースから返される説明メッセージで、送信に失敗した場合にエラーを特定するために特に役立ちます。

SAP ERP Connector for CData Sync

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication


プロパティ説明
ConnectionTypeSAP ERP データへの接続に使用する方法。
ConnectionSchemeメッセージサーバーを使用してSAP システムに接続するか(GroupServer)、使用せずに接続するか(ApplicationServer)を指定します。
HostターゲットSAP システムのホスト名。
SystemNumberHost 接続プロパティで指定されたサーバーに関連付けられたインスタンス番号。
UserSAP システムに認証しているユーザー。
PasswordSAP システムへの認証に使われるパスワード。
ClientターゲットSAP インストール内のクライアントの中で、接続先とするSAP クライアントの名前。
X509CertificateUser とPassword によるログインの代わりに、ログインに使用するX.509 証明書。
MessageServerSAP データへの接続に使用するメッセージサーバー(セントラルロードバランシングサーバー)のホスト名またはIP アドレス。
Group現在のユーザーが属する、メッセージサーバー上のログオングループ。
SystemIdMessageServer 接続プロパティで指定されたメッセージサーバーのシステムID またはR3Name。
RFCURLSAP への接続に使用するSOAP インターフェースのURL。
MessageServerServiceMessageServer 接続プロパティで指定されたメッセージサーバーに到達できるサービスの名前。

Security


プロパティ説明
SNCModeSpecifies whether to use Secure Network Communications (SNC).
SNCNameAn optional input with the name of your SNC connection.
SNCQopThe quality of protection for your SNC connection.
SNCPartnerNameThe SNC name of the SAP instance you want to connect to.
SNCLibPathAn optional input detailing the path and file name of the SAP cryptographic library.
SNCSSOSpecifies whether to connect via the SAP SSO (using the Secure Login Library).

SSL


プロパティ説明
SSLServerCertTLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

Firewall


プロパティ説明
FirewallTypeprovider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServerファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPortプロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUserプロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPasswordプロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

Proxy


プロパティ説明
ProxyAutoDetectprovider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServerHTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。
ProxyPortクライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。
ProxyAuthSchemeProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUserProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。
ProxyPasswordProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。
ProxySSLTypeProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。
ProxyExceptionsProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。

Logging


プロパティ説明
LogModulesログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

Schema


プロパティ説明
BrowsableSchemasレポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tablesレポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Viewsレポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Miscellaneous


プロパティ説明
SAPEditionThe edition of SAP you want to use.
BAPINameSeparatorクエリ結果で、異なるテーブルから取得されたが同じ名前を持つカラムを区別するために使用される接頭辞。これらのカラムには、それぞれ所属するテーブルの名前と、この接続プロパティで指定された文字から構成される接頭辞が付けられます。
CharsetThe system code page to use when converting SAP Unicode byte arrays to strings.
CheckDecimalNotationSpecifies whether to read decimal values using the decimal notation specified in the user profile of the connected SAP user.
CustomTableFilterSpecifies which SAP ERP tables are displayed as views when the TableMode is set to 'Custom'.
EndianTypeThe endian type of your SAP server.
GatewayHostThe gateway host you want to connect to.
GatewayServiceThe port used to connect to the SAP Gateway server specified in the GatewayHost connection property.
GenerateSchemaFilesDetermines how and when schema files are generated.
InitialValueModeControls whether empty column values are displayed as NULL or an initial (non-NULL) value.
LanguageThe ISO 639-1 language code used by your SAP system.
LocationThe path where generated schema files are placed.
MapNUMCToVarcharSpecifies whether to map SAP table fields of NUMC and ACCP types to Varchar type.
MapRAWToVarcharSpecifies whether to map the SAP RAW and LRAW types to Varchar type.
MaxRows集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
PagesizeThe maximum number of records per page the provider returns when requesting data from SAP ERP. Only used for SAP tables.
PaginationSchemeDetermines how to handle the pagination query.
PseudoColumnsテーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
QueryModeDetermines which SAP Queries are displayed as views, if any.
ReadTableDelimiterThe delimiter used by the read table function specified in the ReadTableFunction connection property.
ReadTableFunctionThe function to use for reading table data.
ServerTimeZoneThe timezone by which the server is expected to report date and times values.
StoredProcedureFilterA filter controlling which function modules are reported as stored procedures.
SupportServerSideCountEnables server-side execution of the COUNT function in supported SAP installations.
TableModeSpecifies which SAP ERP tables are displayed as views.
Timeoutprovider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
TrimStringsSpecifies which, if any, leading and trailing whitespaces are omitted from varchar columns.
UseAdvancedReplicationIndicates if advanced replication features should be used when caching data.
UseInternalNamesSpecifies whether to use the internal names of columns in query results rather than the display name.
UseLabelsControls whether the human-readable names or internal names of tables and columns are displayed in query results.
UserDefinedViewsカスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
UseSimpleNamesテーブルとカラムに簡略名を使用するかどうかを指定します。
UseUnicodeRFCSpecifies whether to use the RFC_GET_UNICODE_STRUCTURE function module to get structure information.
WhitespaceToNullSpecifies whether to return string fields with an empty value as null.
SAP ERP Connector for CData Sync

Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。


プロパティ説明
ConnectionTypeSAP ERP データへの接続に使用する方法。
ConnectionSchemeメッセージサーバーを使用してSAP システムに接続するか(GroupServer)、使用せずに接続するか(ApplicationServer)を指定します。
HostターゲットSAP システムのホスト名。
SystemNumberHost 接続プロパティで指定されたサーバーに関連付けられたインスタンス番号。
UserSAP システムに認証しているユーザー。
PasswordSAP システムへの認証に使われるパスワード。
ClientターゲットSAP インストール内のクライアントの中で、接続先とするSAP クライアントの名前。
X509CertificateUser とPassword によるログインの代わりに、ログインに使用するX.509 証明書。
MessageServerSAP データへの接続に使用するメッセージサーバー(セントラルロードバランシングサーバー)のホスト名またはIP アドレス。
Group現在のユーザーが属する、メッセージサーバー上のログオングループ。
SystemIdMessageServer 接続プロパティで指定されたメッセージサーバーのシステムID またはR3Name。
RFCURLSAP への接続に使用するSOAP インターフェースのURL。
MessageServerServiceMessageServer 接続プロパティで指定されたメッセージサーバーに到達できるサービスの名前。
SAP ERP Connector for CData Sync

ConnectionType

SAP ERP データへの接続に使用する方法。

解説

Sync App は、指定された方法を使用してSAP ERP データに接続します。

利用可能な方法は以下のとおりです。

  • SOAP を使用すると、SAP SOAP フレームワークを使用して接続します。
    • この方法を使用する場合は、RFCURL 接続プロパティも設定する必要があります。

SAP ERP Connector for CData Sync

ConnectionScheme

メッセージサーバーを使用してSAP システムに接続するか(GroupServer)、使用せずに接続するか(ApplicationServer)を指定します。

解説

この接続プロパティを次のいずれかの値に設定します:

ApplicationServer(デフォルト) メッセージサーバーを使用せずに、SAP システムに直接接続します。
GroupServer メッセージサーバーを使用してSAP システムに接続します。ロードバランシングサーバーを使用している場合は、このオプションを選択してください。

SAP ERP Connector for CData Sync

Host

ターゲットSAP システムのホスト名。

解説

この接続プロパティは、ConnectionScheme 接続プロパティがApplicationServer に設定されており、かつConnectionType がSOAP 以外の値に設定されている場合に必要です。

ホスト名はホストファイルに定義されている通常のホスト名、123.123.123.123 のようなIP アドレス、または"/H/hostname/S/port/H/host/S/port/ ..." のようなSAProuter アドレスにすることができます。

この値は、SAP Logon で接続を右クリックし、Properties を選択して、Connection タブのApplication Server フィールドを確認することで見つけることができます。

SAP ERP Connector for CData Sync

SystemNumber

Host 接続プロパティで指定されたサーバーに関連付けられたインスタンス番号。

解説

この接続プロパティは、ConnectionType 接続プロパティがSOAP に設定されている場合を除き、常に必要です。

この接続プロパティの有効な値の範囲は0から99です。通常、この値は0です。

この値は、SAP Logon で接続を右クリックし、Properties を選択して、Connection タブのInstance Number フィールドを確認することで見つけることができます。

SAP ERP Connector for CData Sync

User

SAP システムに認証しているユーザー。

解説

R/3 サーバーへの認証にはClient、User、およびPassword の設定が必要です。

SAP ERP Connector for CData Sync

Password

SAP システムへの認証に使われるパスワード。

解説

R/3 サーバーへの認証にはClient、User、およびPassword の設定が必要です。

SAP ERP Connector for CData Sync

Client

ターゲットSAP インストール内のクライアントの中で、接続先とするSAP クライアントの名前。

解説

Sync App を介してSAP ERP データに接続するには、クライアント名を指定する必要があります。

使用可能なクライアント値は、T000 SAP テーブルのMANDT カラムで確認できます。

このテーブルにアクセスするには、SAP UI でトランザクションコードSE16 を使用するか、Sync App のテーブルリストから参照してください(このテーブルは、TableMode がTransparentCustomer に設定されている場合にアクセス可能です)。

SAP ERP Connector for CData Sync

X509Certificate

User とPassword によるログインの代わりに、ログインに使用するX.509 証明書。

解説

この接続プロパティは、SNC を使用して接続する場合にのみサポートされます(この場合、SNCMode 接続プロパティをTrue に設定する必要があります)。

この接続プロパティには、次のいずれかを含むファイルを指すパスを設定します:

  • PEM 形式のX.509 証明書、または
  • "-----BEGIN ..." ヘッダー付きのPEM blob、または
  • "-----BEGIN ..." ヘッダーなしのPEM blob

SAP ERP Connector for CData Sync

MessageServer

SAP データへの接続に使用するメッセージサーバー(セントラルロードバランシングサーバー)のホスト名またはIP アドレス。

解説

この接続プロパティは、ロードバランシングを使用するSAP システムに接続する場合に設定する必要があります(この場合、ConnectionScheme 接続プロパティをGroupServer に設定する必要があります)。

この接続プロパティが設定されている場合、個別のアプリケーションサーバーではなく、この接続プロパティの値で指定されたメッセージサーバーを使用して接続します。

SAP ERP Connector for CData Sync

Group

現在のユーザーが属する、メッセージサーバー上のログオングループ。

解説

この接続プロパティは、主にロードバランシングを使用するSAP システムへの接続に使用されます。このような状況では、ConnectionScheme をGroupServer に設定する必要があります。

大抵のSAP システムのデフォルトグループ名は"PUBLIC" です。

SAP ERP Connector for CData Sync

SystemId

MessageServer 接続プロパティで指定されたメッセージサーバーのシステムID またはR3Name。

解説

この接続プロパティは、メッセージサーバーに接続する場合に必要です。

この値は、SAP Logon で接続を右クリックし、Properties を選択して、Connection タブのSystem ID フィールドを確認することで見つけることができます。

SAP ERP Connector for CData Sync

RFCURL

SAP への接続に使用するSOAP インターフェースのURL。

解説

SOAP インターフェース経由でSAP に接続する場合は、このプロパティをSAP システムのSOAP URL に設定する必要があります。

例えば、http://localhost:8000/sap/bc/soap/rfc です。

このタイプの接続が正しく動作するには、SOAP サービスがSAP システムで有効になっている必要があります。

SOAP サービスを有効にする手順は、SAP のバージョンによって異なります。SAP インストールでSOAP サービスを有効にする場合は、SAP 管理者にお問い合わせください。

SAP ERP Connector for CData Sync

MessageServerService

MessageServer 接続プロパティで指定されたメッセージサーバーに到達できるサービスの名前。

解説

この接続プロパティは、ConnectionScheme 接続プロパティがGroupServer に設定されている場合に必要です。

この接続プロパティの値を確認するには、SAP GUI を開いて次の手順に従います:

  • トランザクションコード"SMMS" を使用してメッセージサーバーモニタを開きます。
  • MessageServer 接続プロパティで指定したメッセージサーバーを選択します。
  • メニューバーで、Goto -> Parameters -> Change に移動します。Profile Parameters ウィンドウが開きます。
  • Profile Parameters ウィンドウで、パラメータ"rdisp/msserv" のNew Value カラムの値を確認します。
  • この接続プロパティに、確認した値を設定します。

指定されない場合、Sync App はHTTP で接続します。

Windows マシンでは、これらのサービスとポートのマッピングはC:\windows\system32\drivers\etc\services に格納されています。

Unix マシンでは、これらのマッピングは/etc/services ファイルまたはドメインネームサーバーに格納されています。

SAP ERP Connector for CData Sync

Security

このセクションでは、本プロバイダーの接続文字列で設定可能なSecurity プロパティの全リストを提供します。


プロパティ説明
SNCModeSpecifies whether to use Secure Network Communications (SNC).
SNCNameAn optional input with the name of your SNC connection.
SNCQopThe quality of protection for your SNC connection.
SNCPartnerNameThe SNC name of the SAP instance you want to connect to.
SNCLibPathAn optional input detailing the path and file name of the SAP cryptographic library.
SNCSSOSpecifies whether to connect via the SAP SSO (using the Secure Login Library).
SAP ERP Connector for CData Sync

SNCMode

Specifies whether to use Secure Network Communications (SNC).

解説

SAP Secure Network Communications (SNC) provides an interface for augmenting SAP with additional non-native security features.

If you have SNC features enabled in your SAP instance, set this connection property to True.

If your SAP instance has SNC features enabled, you must describe the details of your SNC configuration to the Sync App to connect.

See the SNCSSO, SNCName, SNCLibPath, SNCPartnerName, SNCQop connection properties for more information.

You can only enable SNC security features when the ConnectionType connection property is set to CLASSIC, CLASSIC_UNICODE, or NETWEAVER.

SAP ERP Connector for CData Sync

SNCName

An optional input with the name of your SNC connection.

解説

Although this parameter is optional, it is recommended that you set it in order to ensure that the correct SNC name is used for the connection.

To find the value you need to specify, open SAP Logon, right-click your connection and select Properties. In the System Entry Properties dialog, click the Network tab and look at the value in Secure Network Settings -> SNC Name.

SAP ERP Connector for CData Sync

SNCQop

The quality of protection for your SNC connection.

解説

You can set an integer up to 9 depending on your application server.

Valid values are 1, 2, 3, 8, or 9, which correspond to the following protection levels:

1Apply authentication only.
2Apply integrity protection (authentication).
3Apply privacy protection (integrity and authentication).
8Apply the default protection.
9Apply the maximum protection.

SAP ERP Connector for CData Sync

SNCPartnerName

The SNC name of the SAP instance you want to connect to.

解説

Setting this connection property is required when using SNC (when the SNCMode connection property is set to True).

The value for this connection property can be found as follows:

  • In the SAP GUI use T-Code "RZ11" to access the Profile Parameter Maintenance form.
  • In the Profile Parameter Maintenance form's Parameter Name field, type "snc/identity/as" and click Display.
  • Under Value of Profile Parameter snc/identity/as, note the value for the Default Profile.
  • Set this connection property to the noted value.

SAP ERP Connector for CData Sync

SNCLibPath

An optional input detailing the path and file name of the SAP cryptographic library.

解説

Set this connection property to the file path of the version of the SAP cryptographic library specific to your operating system.

On Windows systems, this assembly is called "sapcrypto.dll".

On Linux systems, this assembly is called "libsapcrypto.dll".

These libraries are available for download from SAP.

By default, the Sync App uses the library defined in the environment variable SNC_LIB.

SAP ERP Connector for CData Sync

SNCSSO

Specifies whether to connect via the SAP SSO (using the Secure Login Library).

解説

The default value is 1. Valid values are 0,1.

The SNCMode connection property must be set to True to use this feature.

Available values are:

0Use User/password or other non-SSO identity-related connection properties to authenticate.
1Authenticate via SNC SSO (using the Secure Login Library).

SAP ERP Connector for CData Sync

SSL

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。


プロパティ説明
SSLServerCertTLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。
SAP ERP Connector for CData Sync

SSLServerCert

TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

解説

TLS/SSL 接続を使用している場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。このプロパティに値を指定すると、マシンによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります:

説明 例
フルPEM 証明書(例では省略されています) -----BEGIN CERTIFICATE-----
MIIChTCCAe4CAQAwDQYJKoZIhv......Qw==
-----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。 C:\cert.cer
公開鍵(例では省略されています) -----BEGIN RSA PUBLIC KEY-----
MIGfMA0GCSq......AQAB
-----END RSA PUBLIC KEY-----
MD5 Thumbprint(hex 値はスペースまたはコロン区切り) ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint(hex 値はスペースまたはコロン区切り) 34a929226ae0819f2ec14b4a3d904f801cbb150d

Note:'*' を使用してすべての証明書を受け入れるように指定することも可能ですが、セキュリティ上の懸念があるため推奨されません。

SAP ERP Connector for CData Sync

Firewall

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。


プロパティ説明
FirewallTypeprovider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServerファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPortプロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUserプロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPasswordプロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。
SAP ERP Connector for CData Sync

FirewallType

provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Note:デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。

次の表は、サポートされている各プロトコルのポート番号情報です。

プロトコル デフォルトポート 説明
TUNNEL 80 Sync App がSAP ERP への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。
SOCKS4 1080 Sync App がSAP ERP への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。
SOCKS5 1080 Sync App がSAP ERP にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

SAP ERP Connector for CData Sync

FirewallServer

ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

SAP ERP Connector for CData Sync

FirewallPort

プロキシベースのファイアウォールで使用するTCP ポートを指定します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

SAP ERP Connector for CData Sync

FirewallUser

プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

SAP ERP Connector for CData Sync

FirewallPassword

プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

SAP ERP Connector for CData Sync

Proxy

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。


プロパティ説明
ProxyAutoDetectprovider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServerHTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。
ProxyPortクライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。
ProxyAuthSchemeProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUserProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。
ProxyPasswordProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。
ProxySSLTypeProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。
ProxyExceptionsProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。
SAP ERP Connector for CData Sync

ProxyAutoDetect

provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。

解説

この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします(プロキシサーバーの詳細を手動で入力する必要はありません)。

この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を構成する場合は、ProxyAutoDetect をFalse に設定します。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

SAP ERP Connector for CData Sync

ProxyServer

HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレスを指定します。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。

ProxyAutoDetect がTrue(デフォルト)に設定されている場合、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。

SAP ERP Connector for CData Sync

ProxyPort

クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバーのTCP ポートを指定します。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたProxyServer ポートを通じてのみHTTP トラフィックをルーティングします。

ProxyAutoDetect がTrue(デフォルト)に設定されている場合、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。

その他のプロキシタイプについては、FirewallType を参照してください。

SAP ERP Connector for CData Sync

ProxyAuthScheme

ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。

解説

サポートされる認証の種類:

  • BASIC:Sync App はHTTP Basic 認証を行います。
  • DIGEST:Sync App はHTTP ダイジェスト認証を行います。
  • NTLM:Sync App はNTLM トークンを取得します。
  • NEGOTIATE: Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
  • NONE:ProxyServer が認証を必要としないことを示します。

NONE 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

SAP ERP Connector for CData Sync

ProxyUser

ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名を提供します。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。

ProxyAuthScheme の値 ProxyUser に設定する値
BASIC プロキシサーバーに登録されているユーザーのユーザー名。
DIGEST プロキシサーバーに登録されているユーザーのユーザー名。
NEGOTIATE プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。
NTLM プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。
NONE ProxyPassword 接続プロパティは設定しないでください。

Note:Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。 ProxyAutoDetect がTrue(デフォルト)に設定されている場合、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。

SAP ERP Connector for CData Sync

ProxyPassword

ProxyUser 接続プロパティで指定されたユーザーのパスワードを指定します。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。

ProxyAuthScheme の値 ProxyPassword に設定する値
BASIC ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
DIGEST ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
NEGOTIATE ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NTLM ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NONE ProxyPassword 接続プロパティは設定しないでください。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

Note:Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。 ProxyAutoDetect がTrue(デフォルト)に設定されている場合、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。

SAP ERP Connector for CData Sync

ProxySSLType

ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプを指定します。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。

AUTOデフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。
ALWAYS接続は、常にSSL 有効となります。
NEVER接続は、SSL 有効になりません。
TUNNEL接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。

SAP ERP Connector for CData Sync

ProxyExceptions

ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリストを指定します。

解説

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

Note:Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。 この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。

SAP ERP Connector for CData Sync

Logging

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。


プロパティ説明
LogModulesログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。
SAP ERP Connector for CData Sync

LogModules

ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

解説

Sync App は、実行する各操作の詳細を Logfile 接続プロパティで指定されたログファイルに書き込みます。

ログに記録される各操作は、モジュールと呼ばれるカテゴリに分類されます。各モジュールには対応する短いコードがあり、個々の Sync App の操作がどのモジュールに属するかを示すラベルとして使用されます。

この接続プロパティにモジュールコードをセミコロン区切りのリストで設定すると、指定したモジュールに属する操作のみがログファイルに書き込まれます。この設定は今後のログ記録にのみ適用され、既存のログファイルの内容には影響しません。例: INFO;EXEC;SSL;META;

デフォルトでは、すべてのモジュールの操作がログに含まれます。

モジュールを明示的に除外するには、先頭に「-」を付けます。例: -HTTP

サブモジュールにフィルターを適用するには、<モジュール名>.<サブモジュール名> の構文で指定します。たとえば、次の値を設定すると、Sync App は HTTP モジュールに属するアクションのみをログに記録し、さらに HTTP モジュールの Res サブモジュールに属するアクションを除外します: HTTP;-HTTP.Res

Verbosity 接続プロパティによるログファイルのフィルタリングは、この接続プロパティによるフィルタリングよりも優先されます。そのため、Verbosity 接続プロパティで指定したレベルよりも高い詳細レベルの操作は、この接続プロパティで指定したモジュールに属していても、ログファイルには出力されません。

使用可能なモジュールとサブモジュールは次のとおりです。

モジュール名 モジュールの説明 サブモジュール
INFO 一般情報。接続文字列、製品バージョン(ビルド番号)、および初期接続メッセージが含まれます。
  • Connec — 接続の作成または破棄に関連する情報。
  • Messag — 接続、接続文字列、製品バージョンに関するメッセージの汎用ラベル。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
EXEC クエリ実行。ユーザーが記述した SQL クエリ、解析済み SQL クエリ、正規化済み SQL クエリの実行メッセージが含まれます。クエリおよびクエリページの成功/失敗メッセージもここに表示されます。
  • Messag — クエリ実行に関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
  • Normlz — クエリの正規化ステップ。クエリの正規化とは、ユーザーが送信したクエリを、最適なパフォーマンスで同じ結果を得られるように書き換える処理です。
  • Origin — ユーザーの元のクエリ(ユーザーが実行した正確で未変更の非正規化クエリ)を記録するメッセージに適用されるラベル。
  • Page — クエリのページングに関連するメッセージ。
  • Parsed — クエリの解析ステップ。解析とは、ユーザーが送信したクエリを、処理しやすい標準化された形式に変換するプロセスです。
HTTP HTTP プロトコルメッセージ。HTTP リクエスト/レスポンス(POST メッセージを含む)、および Kerberos 関連のメッセージが含まれます。
  • KERB — Kerberos に関連する HTTP リクエスト。
  • Messag — HTTP プロトコルに関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
  • Unpack — サービス API から返された圧縮データを製品が解凍する際のメッセージに適用されるラベル。
  • Res — HTTP レスポンスを含むメッセージ。
  • Req — HTTP リクエストを含むメッセージ。
WSDL WSDL/XSD ファイルの生成に関するメッセージ。 —
SSL SSL 証明書メッセージ。
  • Certif — SSL 証明書に関するメッセージ。
AUTH 認証関連の失敗/成功メッセージ。
  • Messag — 認証に関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
  • OAuth — OAuth 認証に関連するメッセージ。
  • Krbros — Kerberos 関連の認証メッセージ。
SQL SQL トランザクション、SQL 一括転送メッセージ、および SQL 結果セットメッセージが含まれます。
  • Bulk — 一括クエリ実行に関するメッセージ。
  • Cache — パフォーマンス向上のため、製品のキャッシュへの行データの読み書きに関連するメッセージ。
  • Messag — SQL トランザクションに関するメッセージ。これらのメッセージは通常、サービスから直接受信して転送されるものではなく、Sync App 固有のものです。
  • ResSet — クエリの結果セット。
  • Transc — 実行されたジョブ数やバックアップテーブルの処理に関する情報を含む、トランザクション処理に関連するメッセージ。
META メタデータキャッシュとスキーマメッセージ。
  • Cache — パフォーマンス向上のため、製品のキャッシュ内のカラムおよびテーブル定義の読み取りと変更に関連するメッセージ。
  • Schema — サービススキーマからのメタデータの取得またはサービススキーマの変更に関連するメッセージ。
  • MemSto — インメモリメタデータキャッシュへの書き込みまたは読み取りに関連するメッセージ。
  • Storag — メモリ内ではなく、ディスクまたは外部データストアへのメタデータの保存に関連するメッセージ。
FUNC SQL 関数の実行に関連する情報。
  • Errmsg — SQL 関数の実行に関連するエラーメッセージ。
TCP TCP トランスポートレイヤーメッセージでの送受信生バイト。
  • Send — TCP プロトコル経由で送信された生データ。
  • Receiv — TCP プロトコル経由で受信した生データ。
FTP File Transfer Protocol に関するメッセージ。
  • Info — FTP プロトコルでの通信に関連するステータスメッセージ。
  • Client — FTP 通信中に FTP クライアント(製品)が実行したアクションに関連するメッセージ。
  • Server — FTP 通信中に FTP サーバーが実行したアクションに関連するメッセージ。
SFTP Secure File Transfer Protocol に関するメッセージ。
  • Info — SFTP プロトコルでの通信に関連するステータスメッセージ。
  • To_Server — SFTP 通信中に SFTP クライアント(製品)が実行したアクションに関連するメッセージ。
  • From_Server — SFTP 通信中に SFTP サーバーが実行したアクションに関連するメッセージ。
POP Post Office Protocol 経由で転送されるデータに関するメッセージ。
  • Client — POP 通信中に POP クライアント(製品)が実行したアクションに関連するメッセージ。
  • Server — POP 通信中に POP サーバーが実行したアクションに関連するメッセージ。
  • Status — POP プロトコルでの通信に関連するステータスメッセージ。
SMTP Simple Mail Transfer Protocol 経由で転送されるデータに関するメッセージ。
  • Client — SMTP 通信中に SMTP クライアント(製品)が実行したアクションに関連するメッセージ。
  • Server — SMTP 通信中に SMTP サーバーが実行したアクションに関連するメッセージ。
  • Status — SMTP プロトコルでの通信に関連するステータスメッセージ。
CORE 他のモジュールでカバーされていない、さまざまな製品内部操作に関連するメッセージ。 —
DEMN SQL リモーティングに関連するメッセージ。 —
CLJB 一括データアップロード(クラウドジョブ)に関するメッセージ。
  • Commit — 一括データアップロードの送信。
SRCE 他のモジュールに属さない、製品が生成するその他のメッセージ。 —
TRANCE 低レベルの製品操作に関する高度なメッセージ。 —

SAP ERP Connector for CData Sync

Schema

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。


プロパティ説明
BrowsableSchemasレポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tablesレポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Viewsレポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。
SAP ERP Connector for CData Sync

BrowsableSchemas

レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

SAP ERP Connector for CData Sync

Tables

レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。

解説

データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。

SAP ERP Connector for CData Sync

Views

レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

解説

データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。

SAP ERP Connector for CData Sync

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。


プロパティ説明
SAPEditionThe edition of SAP you want to use.
BAPINameSeparatorクエリ結果で、異なるテーブルから取得されたが同じ名前を持つカラムを区別するために使用される接頭辞。これらのカラムには、それぞれ所属するテーブルの名前と、この接続プロパティで指定された文字から構成される接頭辞が付けられます。
CharsetThe system code page to use when converting SAP Unicode byte arrays to strings.
CheckDecimalNotationSpecifies whether to read decimal values using the decimal notation specified in the user profile of the connected SAP user.
CustomTableFilterSpecifies which SAP ERP tables are displayed as views when the TableMode is set to 'Custom'.
EndianTypeThe endian type of your SAP server.
GatewayHostThe gateway host you want to connect to.
GatewayServiceThe port used to connect to the SAP Gateway server specified in the GatewayHost connection property.
GenerateSchemaFilesDetermines how and when schema files are generated.
InitialValueModeControls whether empty column values are displayed as NULL or an initial (non-NULL) value.
LanguageThe ISO 639-1 language code used by your SAP system.
LocationThe path where generated schema files are placed.
MapNUMCToVarcharSpecifies whether to map SAP table fields of NUMC and ACCP types to Varchar type.
MapRAWToVarcharSpecifies whether to map the SAP RAW and LRAW types to Varchar type.
MaxRows集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Other特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。
PagesizeThe maximum number of records per page the provider returns when requesting data from SAP ERP. Only used for SAP tables.
PaginationSchemeDetermines how to handle the pagination query.
PseudoColumnsテーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
QueryModeDetermines which SAP Queries are displayed as views, if any.
ReadTableDelimiterThe delimiter used by the read table function specified in the ReadTableFunction connection property.
ReadTableFunctionThe function to use for reading table data.
ServerTimeZoneThe timezone by which the server is expected to report date and times values.
StoredProcedureFilterA filter controlling which function modules are reported as stored procedures.
SupportServerSideCountEnables server-side execution of the COUNT function in supported SAP installations.
TableModeSpecifies which SAP ERP tables are displayed as views.
Timeoutprovider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
TrimStringsSpecifies which, if any, leading and trailing whitespaces are omitted from varchar columns.
UseAdvancedReplicationIndicates if advanced replication features should be used when caching data.
UseInternalNamesSpecifies whether to use the internal names of columns in query results rather than the display name.
UseLabelsControls whether the human-readable names or internal names of tables and columns are displayed in query results.
UserDefinedViewsカスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
UseSimpleNamesテーブルとカラムに簡略名を使用するかどうかを指定します。
UseUnicodeRFCSpecifies whether to use the RFC_GET_UNICODE_STRUCTURE function module to get structure information.
WhitespaceToNullSpecifies whether to return string fields with an empty value as null.
SAP ERP Connector for CData Sync

SAPEdition

The edition of SAP you want to use.

解説

Set this connection property to OnPremise to connect to an on-premises SAP instance.

Set this connection property to Cloud to connect to SAP S/4 HANA Cloud.

To connect to SAP S/4 HANA Cloud, you need the SAP JCO 3.1.2 or later.

SAP ERP Connector for CData Sync

BAPINameSeparator

クエリ結果で、異なるテーブルから取得されたが同じ名前を持つカラムを区別するために使用される接頭辞。これらのカラムには、それぞれ所属するテーブルの名前と、この接続プロパティで指定された文字から構成される接頭辞が付けられます。

解説

ファンクションモジュール(Sync App はファンクションモジュールをストアドプロシージャとして利用可能にします)が、1つ以上のカラム名を共有する複数のストラクチャから選択を行う場合、同一名の各カラムには、所属するテーブルの名前と、この接続プロパティで指定された文字から構成される接頭辞が付けられます。

例えば、この接続プロパティが "_" に設定されていて、"X" と"Y" というストラクチャから選択を行うファンクションモジュールに対応するストアドプロシージャを実行し、それらのストラクチャが両方とも"FIELD" というカラムを含んでいる場合、クエリ結果には"X_FIELD" と "Y_FIELD" という2つのカラムが表示されます。

SAP ERP Connector for CData Sync

Charset

The system code page to use when converting SAP Unicode byte arrays to strings.

解説

SAP returns data in byte arrays, which the Sync App converts to a string.

This property specifies the code page the Sync App uses to do the conversion. For example, 'UTF-8'.

This property can be useful to fix Unicode-to-multibyte encoding problems. For instance, if you are on a U.S. machine and reading from a Japanese SAP server with Japanese characters, you may need to set Charset to 'shift_jis' to display the characters properly.

SAP ERP Connector for CData Sync

CheckDecimalNotation

Specifies whether to read decimal values using the decimal notation specified in the user profile of the connected SAP user.

解説

When this connection property is set to False (the default), decimal values are read in US format.

When this connection property is set to True, the Sync App detects the decimal format from the connected SAP user profile's decimal format setting. Set this connection property to True when the Sync App returns improperly formatted decimal values in query results.

SAP ERP Connector for CData Sync

CustomTableFilter

Specifies which SAP ERP tables are displayed as views when the TableMode is set to 'Custom'.

解説

The Sync App lists SAP ERP tables as read-only views. If you need to write to SAP ERP tables, you can use BAPIs.

Most SAP ERP installations contain a very large number of tables. While the Sync App can list all tables as available views, this may result in long load times. This property allows you to define a custom filter against the DD02L system table to retrieve only the tables important to your use case.

To use this property, set the TableMode to Custom and define a valid SQL WHERE clause here (without the "WHERE" keyword). For example, to retrieve transparent tables used for application data:

CustomTableFilter = TABCLASS = 'TRANSP' AND CONTFLAG = 'A' AND AS4LOCAL = 'A'

Overriding Default Filtering Behavior

By default, the Sync App applies internal filters to exclude certain tables, such as those with names containing forward slashes. For example, Customer/Orders.

To override this behavior and explicitly include such tables, you can set a custom filter that matches your use case. For example, to retrieve only tables with slashes in their names:

CustomTableFilter = TABNAME LIKE '/%'

Note: Use custom filters with caution. Tables containing slashes are often system or namespace-reserved and may not be appropriate for general access.

SAP ERP Connector for CData Sync

EndianType

The endian type of your SAP server.

解説

The endian type of your SAP server determines whether it orders bytes from the most significant to least significant bytes (big-endian) or from the least significant to most significant byte (little-endian).

The Sync App needs to know the endian type of your SAP server in order to retrieve SAP data.

If you do not know the endian type for the SAP server, set this value to Auto. The Sync App attempts to automatically detect the endian type.

However, if the Sync App returns an error indicated that your SAP server does not have the RFC needed to automatically determine its endian type, use this connection property to set the Endian type manually. If you need to set this manually and you do not know the value that you should set, ask your SAP administrator for assistance.

SAP ERP Connector for CData Sync

GatewayHost

The gateway host you want to connect to.

解説

Set this connection property if you want to connect to your SAP installation via a specific SAP Gateway server.

If not specified, the Sync App attempts to connect to the SAP system specified by the Host connection property.

SAP ERP Connector for CData Sync

GatewayService

The port used to connect to the SAP Gateway server specified in the GatewayHost connection property.

解説

If no value is specified in this connection property, the Sync App uses the value "sapgw##", where the "##" is the value specified in the SystemNumber connection property, to connect.

SAP ERP Connector for CData Sync

GenerateSchemaFiles

Determines how and when schema files are generated.

解説

The Sync App can generate schema files corresponding to views returned by the Sync App. Editing these generated schema files gives you granular control over the metadata (such as columns) returned by the Sync App when the corresponding views are queried.

For example, removing a column (<attr> element) from a generated schema file causes that column not to be reported.

Schema files generated by the Sync App are output to the folder specified in the Location connection property.

When this connection property is set to OnUse, upon making a metadata request for a view, the Sync App generates a schema file for that view.

When this connection property is set to OnStart, the Sync App generates schema files for all the views that are discovered when the connection begins.

Schema files are not overwritten if they already exist in the Location folder. To update a specific schema file with updated metadata, first delete that schema file from this folder, then trigger the schema file creation again.

SAP ERP Connector for CData Sync

InitialValueMode

Controls whether empty column values are displayed as NULL or an initial (non-NULL) value.

解説

Some fields in SAP tables are configured to have an initial value.

This means that, when a record is inserted into the SAP table without including a value for those fields, instead of being considered NULL, the fields are initialized with a set generic value that represents an empty value without technically being NULL.

For example, a field may be set to initialize with the value 0, or "" (empty string) instead of being NULL.

When this connection property is set to Null, records in fields with the InitialValue indicator enabled in SAP, and whose value matches the initial value for their data type (0, "", etc.), are returned as NULL in query results.

When this connection property is set to InitialValue, records in fields with the InitialValue indicator enabled in SAP, and whose value matches the initial value for their data type (0, "", etc.), are returned as-is in query results.

SAP ERP Connector for CData Sync

Language

The ISO 639-1 language code used by your SAP system.

解説

Set this connection property to the language value you specify when you log into SAP.

By default, "EN" (English) is used. Other codes include "DE" for German and "JA" for Japanese.

This connection property's value informs the column names returned when querying SAP tables. See the UseLabels connection property for more details.

SAP ERP Connector for CData Sync

Location

The path where generated schema files are placed.

解説

Through the use of schema files, you can customize the metadata returned by views and stored procedures. Any view with a corresponding schema file in the path set in this connection property are always persisted in the list of queryable views, regardless of the current value of TableMode.

Schema files can be generated manually by executing stored procedures such as CreateSchema, or generated automatically when the conditions specified in the GenerateSchemaFiles connection property are met.

Schema files generated by the Sync App are output to the directory specified in this connection property.

The value of this connection property can be an absolute path or a relative path from the location of the Sync App executable.

SAP ERP Connector for CData Sync

MapNUMCToVarchar

Specifies whether to map SAP table fields of NUMC and ACCP types to Varchar type.

解説

The SAP NUMC type is a long character field that only allows numeric entries. The length of this field is limited to a maximum of 255 characters.

The SAP ACCP type represents a posting period. This field is 6 characters long, with the format YYYYMM.

If this connection property is set to False, NUMC and ACCP type fields are returned with a numeric type.

If this connection property is set to True, NUMC and ACCP fields are returned as Varchar type.

SAP ERP Connector for CData Sync

MapRAWToVarchar

Specifies whether to map the SAP RAW and LRAW types to Varchar type.

解説

If this connection property is set to True, the Sync App maps the SAP RAW and LRAW types to Varchar type.

If this connection property is set to False, the Sync App maps RAW and LRAW types to Binary type.

SAP ERP Connector for CData Sync

MaxRows

集計やGROUP BY を含まないクエリで返される最大行数を指定します。

解説

このプロパティのデフォルト値である-1 は、クエリに明示的にLIMIT 句が含まれていない限り、行の制限が適用されないことを意味します。 (クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。)

MaxRows を0より大きい整数に設定することで、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し、過剰なリソース消費を防ぐのに役立ちます。

SAP ERP Connector for CData Sync

Other

特定の問題に対処するため、特殊なシナリオ向けの高度な接続プロパティを指定します。このプロパティは、サポートチームの指示がある場合にのみ使用してください。

解説

このプロパティにより、シニアユーザーはサポートチームのアドバイスに基づいて、特定の状況に対応する隠しプロパティを設定できます。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。

Note:特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。

統合およびフォーマット

プロパティ説明
DefaultColumnSizeデータソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT=True日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換します。デフォルト値はFalse(ローカルタイムを使用)です。
RecordToFile=filename基底のソケットデータ転送を指定のファイルに記録します。

SAP ERP Connector for CData Sync

Pagesize

The maximum number of records per page the provider returns when requesting data from SAP ERP. Only used for SAP tables.

解説

When processing a query, instead of requesting all of the queried data at once from SAP ERP, the Sync App can request the queried data in pieces called pages.

This connection property determines the maximum number of results that the Sync App requests per page.

The RFC_READ_TABLE function module uses the rowcount and rowskips parameters for paging. This can cause unusual behavior if you are paging through data while it is being interacted with.

For instance, if a new row is inserted to a table while you are paging through data, you may see a duplicate entry show up.

Also, if a row is deleted from a table, the results you get back may be missing a row.

This can be avoided by increasing the page size to such a degree that the Sync App only needs one page to return all data requested in the problematic query.

Note that, while setting large page sizes can resolve this issue and may improve overall query execution time, doing so also causes the Sync App to use more memory when executing queries and risks triggering a timeout.

SAP ERP Connector for CData Sync

PaginationScheme

Determines how to handle the pagination query.

解説

Allowed values are:

  • Default: Performs LIMIT and OFFSET clauses to retrieve each page via the Remote Function Call (RFC) function.
  • Key: Paginates the query by the primary key and LIMIT (page size). If the table does not support a server-side ORDER BY clause or lacks a primary key, the driver automatically falls back to Default.
  • MaxRows: Retrieves the entire table in a single request rather than using pagination. While full ACID guarantees are not provided, this approach reduces the likelihood of inconsistent results caused by concurrent writes when querying small tables.

Note: When PaginationScheme is set to Default or Key, the driver orders results by the table's primary key(s) only when the table class supports a server-side ORDER BY clause. This behavior prevents duplicate records across paginated result sets.

If a table does not support server-side ORDER BY, the driver does not apply primary-key ordering by default. In this case, if an ORDER BY clause is explicitly specified in the query, it is not sent to SAP; instead, the driver applies the ordering client-side.

SAP ERP Connector for CData Sync

PseudoColumns

テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。

解説

このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。

個々の擬似カラムを指定するには、以下の形式を使用します。

Table1=Column1;Table1=Column2;Table2=Column3

すべてのテーブルのすべての擬似カラムを含めるには、次を使用してください:

*=*

SAP ERP Connector for CData Sync

QueryMode

Determines which SAP Queries are displayed as views, if any.

解説

Like SAP tables, SAP Queries can also be displayed as views.

If this connection property is set to None, SAP Queries are not included in the data model of the Sync App. This is the default behavior.

You can expose some or all of your SAP Queries as views:

  • Set this connection property to Global to expose cross-client Query objects accessible to your user account as views.
  • Set this connection property to Local to expose Query objects specific to your user account as views.
  • Set this connection property to All to expose both user-specific and cross-client Query objects as views.

SAP ERP Connector for CData Sync

ReadTableDelimiter

The delimiter used by the read table function specified in the ReadTableFunction connection property.

解説

If your SAP installation includes SAP Note 2246160, the Sync App uses "~" as the default delimiter for the RFC_READ_TABLE function module. If your data contains the "~" character in any records, change the delimiter to a character that does not appear in any of your records. If your SAP installation does not include SAP Note 2246160, the Sync App does not use a delimiter by default.

SAP ERP Connector for CData Sync

ReadTableFunction

The function to use for reading table data.

解説

The Sync App can use various read table functions when retrieving SAP ERP data, including custom function that remove limitations on the buffer size.

See カスタム Read Table 関数の使用 for more information.

SAP ERP Connector for CData Sync

ServerTimeZone

The timezone by which the server is expected to report date and times values.

解説

The CData Sync App uses the CDPOS and CDHDR tables to replicate data incrementally. SAP ERP does not actually store a timezone when it returns a date and time to the CData Sync App from these tables. In order to ensure dates can be converted from your local time to SAP ERP, you may specify the ServerTimeZone. For example, EST, JST, PST. The CData Sync App will assume values coming from CDPOS and CDHDR match the specified timezone so that when values are passed to it requesting only the latest results, nothing is skipped over when converting from your local time to the server's.

SAP ERP Connector for CData Sync

StoredProcedureFilter

A filter controlling which function modules are reported as stored procedures.

解説

The Sync App can execute remote enabled function modules, and makes them available for query in the form of stored procedures.

Due to the large number of function modules available in your SAP installation, you may find it useful to hide a portion of these stored procedures in the reported metadata of the Sync App.

Use wildcards (*) to select the procedures you want to include based on a name pattern.

For example, the default value for this connection property, "BAPI*" matches all remote enabled function modules that start with "BAPI", and function modules whose names do not start with "BAPI" are not displayed.

Note that not all function modules in SAP are remote enabled. If there is a function module you are interested in using that does not display, check the TFDIR system table to verify its FMODE column is set to 'R'. If TFDIR is not visible in your metadata listing, set TableMode to TransparentSystem to make it available for querying.

SAP ERP Connector for CData Sync

SupportServerSideCount

Enables server-side execution of the COUNT function in supported SAP installations.

解説

The feature enabled by this connection property is only supported in SAP installations that include SAP Note 3390051.

SAP ERP Connector for CData Sync

TableMode

Specifies which SAP ERP tables are displayed as views.

解説

The Sync App lists SAP ERP tables as read-only views. If you need to write to SAP ERP tables, you can use BAPIs.

Most SAP ERP installations contain a very large number of tables, and while the Sync App can list all tables in your installation as available views, the more tables you have access to, the longer the process of displaying this list takes.

This property allows you to only list the tables that are important to you. This both avoids the need to scroll through a massive list of tables and allows the Sync App to display the now-filtered list of tables more quickly.

The Sync App retrieves the list of tables from the DD02L system table. Set this property either to the name of one of the filter presets below, or write a custom filter for DD02L directly in this connection property's value.

Internal Filtering Behavior

In addition to the selected filter, the Sync App applies internal filtering logic to avoid displaying system-reserved or special-use tables. For example, by default, the Sync App excludes tables that contain a forward slash in the name. This can cause tables such as /Customer/Orders/ to be omitted from the table list, even if they would otherwise match your selected filter.

Using CustomTableFilter to Override Default Filters

To override the default filtering behavior, you can set the TableMode to Custom and define your own filter using the CustomTableFilter property.

Available values:

SettingFilterDescription
TransparentApplication TABCLASS = 'TRANSP' AND CONTFLAG = 'A'Master and transaction data.
TransparentCustomer TABCLASS = 'TRANSP' AND ( CONTFLAG = 'C' OR CONTFLAG = 'G' )Data maintained by the customer only.
TransparentSystem TABCLASS = 'TRANSP' AND ( CONTFLAG = 'E' OR CONTFLAG = 'S' OR CONTFLAG = 'W' )Customer namespaces, program status changes, development environment tables, etc.
Pooled TABCLASS = 'POOL'All pooled tables.
Cluster TABCLASS = 'CLUSTER'All cluster tables such as BSEG and KONV.
InternalTable TABCLASS = 'INTTAB'All internal tables.
View TABCLASS = 'VIEW'All general view tables.
AppendTable TABCLASS = 'APPEND'All append tables.
AllAll tables regardless of type. Warning: This will cause a massive amount of tables to be retrieved and may result in a noticeable delay in table listing.
None No filter. No SAP tables are displayed. This may be useful if you intend to use schema files or SAP queries.
Custom User-defined filter. Please set this filter in the CustomTableFilter property.

SAP ERP Connector for CData Sync

Timeout

provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。

解説

タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。

タイムアウトはデフォルトで60秒に設定されています。タイムアウトを無効にするには、このプロパティを0に設定します。

タイムアウトを無効にすると、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。

Note: このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

SAP ERP Connector for CData Sync

TrimStrings

Specifies which, if any, leading and trailing whitespaces are omitted from varchar columns.

解説

In SAP, the RFC_READ_TABLE function module pads Varchar columns with spaces.

Typically, trailing spaces are not deliberately added to SAP table records, so the Sync App defaults to removing any trailing spaces in query results.

If, however, you have deliberately added trailing spaces in your SAP table records, you may use this connection property to customize (or disable) this behavior.

Value of TrimStringsDescription
TrimLeftTrim the leading spaces of the string value.
TrimRightTrim the trailing spaces of the string value.
TrimAllTrim the leading and trailing spaces of the string value.
NoneDo not trim any spaces from the string value.

SAP ERP Connector for CData Sync

UseAdvancedReplication

Indicates if advanced replication features should be used when caching data.

解説

Typically replication is done using a modified column on the specific table to incrementially cache the data to a database. However, many SAP tables lack a a modified date column, or use a different name for this column. To get around this limitation, we attempt to use the CDHDR and CDPOS tables to find changes that have occurred to records in tables. This is not a perfect solution as CDHDR and CDPOS do not contain entries for every possible table. Setting UseAdvancedReplication to true will attempt to use CDHDR and CDPOS tables for replication in most tables.

SAP ERP Connector for CData Sync

UseInternalNames

Specifies whether to use the internal names of columns in query results rather than the display name.

解説

When this connection property is set to False (the default), the Sync App displays columns by their display names (a more readable name for the column specific to your SAP client's language).

When this connection property is set to True, the Sync App displays columns by their internal names.

For example, the ADRC table has a column with the internal name "ADDRNUMBER".

If this connection property is set to False and you have your SAP client language set to "en", the Sync App uses the name "Address Number" for the column.

If this connection property is set to True, the Sync App uses the internal name ("ADDRNUMBER") as-is for the column name.

SAP ERP Connector for CData Sync

UseLabels

Controls whether the human-readable names or internal names of tables and columns are displayed in query results.

解説

You can set this connection property to one of the following values:

  • NONE - Tables and columns are displayed with the internal names used in SAP.
  • Columns - Columns are displayed with a more user-friendly name specific to the language set in your SAP client.
  • Tables - Tables are displayed with a more user-friendly name specific to the language set in your SAP client.
  • TablesAndColumns - Both tables and columns are displayed with a more user-friendly name specific to the language set in your SAP client.
Note: The language used comes from the value of the Language connection property.

If you have set this connection property to display human-readable names for tables/columns, and no human-readable name exists for a specific column or table, the Sync App displays its internal name instead.

SAP ERP Connector for CData Sync

UserDefinedViews

カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

解説

UserDefinedViews を使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。 これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。

次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM MARA WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 次に例を示します。

UserDefinedViews=C:\Path\To\UserDefinedViews.json
UserDefinedViews でビューを指定すると、Sync App はそのビューだけを参照します。

詳しくは、ユーザー定義ビュー を参照してください。

SAP ERP Connector for CData Sync

UseSimpleNames

テーブルとカラムに簡略名を使用するかどうかを指定します。

解説

SAP ERP テーブルでは、標準的なデータベースでは通常許可されない特殊文字を名前に含めることができます。このプロパティを使用すると、Sync App を従来のデータベースツールでより簡単に使用できるようになります。

UseSimpleNames をTrue に設定すると、返されるカラム名をシンプルにします。 表示されるカラム名において、アルファベット文字およびアンダースコアのみを有効とするネーミングスキームを強制します。

Notes:

  • 英数字以外の文字はアンダースコアに置き換えられます。
  • カラム名やテーブル名が128 文字を超える場合は、SQL Server 標準に準拠するために128文字に切り詰められます。

SAP ERP Connector for CData Sync

UseUnicodeRFC

Specifies whether to use the RFC_GET_UNICODE_STRUCTURE function module to get structure information.

解説

This connection property must be set to True (this is the default) when using SAP systems that are Unicode-enabled.

If you are connecting with a SOAP service (when the ConnectionType connection property is set to SOAP) and that SOAP service is not Unicode-enabled, set this connection property to False.

You can confirm whether your SAP system is Unicode-enabled by navigating in the SAP GUI to System > Status > SAP System data > Unicode System.

SAP ERP Connector for CData Sync

WhitespaceToNull

Specifies whether to return string fields with an empty value as null.

解説

When this connection property is set to True, empty column values (empty strings or strings that only contain whitespace characters) are returned as null.

This connection property only affects fields with the datatype "string".

SAP ERP Connector for CData Sync

Third Party Copyrights

LZMA from 7Zip LZMA SDK

LZMA SDK is placed in the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original LZMA SDK code, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

LZMA2 from XZ SDK

Version 1.9 and older are in the public domain.

Xamarin.Forms

Xamarin SDK

The MIT License (MIT)

Copyright (c) .NET Foundation Contributors

All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

NSIS 3.10

Copyright (C) 1999-2025 Contributors THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.

1. DEFINITIONS

"Contribution" means:

a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and b) in the case of each subsequent Contributor:

i) changes to the Program, and

ii) additions to the Program;

where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.

"Contributor" means any person or entity that distributes the Program.

"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.

"Program" means the Contributions distributed in accordance with this Agreement.

"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.

2. GRANT OF RIGHTS

a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.

b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.

c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.

d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.

3. REQUIREMENTS

A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that:

a) it complies with the terms and conditions of this Agreement; and

b) its license agreement:

i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;

ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;

iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and

iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.

When the Program is made available in source code form:

a) it must be made available under this Agreement; and

b) a copy of this Agreement must be included with each copy of the Program.

Contributors may not remove or alter any copyright notices contained within the Program.

Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.

4. COMMERCIAL DISTRIBUTION

Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.

For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.

5. NO WARRANTY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.

6. DISCLAIMER OF LIABILITY

EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

7. GENERAL

If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.

If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.

All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.

Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.

This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 25.0.9540