> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAP ERP

CData Sync アプリケーションからSAP ERP コネクタを使用して、SAP ERP からデータを取得してサポートされている任意の同期先に移動できます。これを行うには、コネクタを追加し、コネクタへの認証を行い、接続を完了する必要があります。

> [!NOTE]
>
> このコネクタは Sync セルフホスト環境でのみ利用できます。

## 前提条件

SAP ERP に接続する前に、以下のコンポーネントをセットアップする必要があります：

1. お使いのオペレーティングシステムに対応するSoftware Developer Kit（SDK）を、[SAP Java Connector](https://support.sap.com/en/product/connectors/jco.html?anchorId=section_2129803369) からダウンロードします。
2. 次の手順で、SDK からsapjco3.jar ファイルとsapjco3.dll ファイルをダウンロードします：
   1. SAP Java connector を開き、お使いのプラットフォームに対応するJCo バージョンを選択します。
   2. ダウンロードリンクをクリックします。ログインページが開きます。
   3. 有効なS-user 識別子（Id）でSAP サイトにログインします。
   4. パッケージをダウンロードします。
3. sapjco3.jar ファイルを、アプリケーションディレクトリ内の `/libs/ext` フォルダにコピーします。
4. sapjco3.dll ファイルを、アプリケーションディレクトリ内の `/libs/ext` フォルダにコピーします（Sync インスタンスがLinux マシン上にある場合は、libsapjco3.so を使用します）。

## SAP ERP コネクタを追加

Sync でSAP ERP のデータを使用できるようにするには、まず以下の手順でコネクタを追加する必要があります：

<ol>
  <li>Sync のダッシュボードから**接続**ページを開きます。</li>
  <li>**接続を追加**をクリックして**コネクタを選択**ページを開きます。</li>
  <li>**データソース**タブをクリックして
  **SAP ERP** 行に移動します。</li>

  <li>
    行末にある**接続を設定**アイコンをクリックして、**新しい接続**ページを開きます。この操作により、
    **接続を追加**ダイアログボックスが開きます。

    **Note：** **接続を設定**アイコンが表示されない場合は、**コネクタをダウンロード**アイコンをクリックして SAP ERP コネクタをインストールしてください。
  </li>

  <li>**接続を追加**ダイアログボックスに接続名を入力します。</li>
  <li>**追加**をクリックして、コネクタの**設定**タブを開きます。</li>
</ol>

新しいコネクタのインストールについての詳細は、
[接続](https://docs.sync.cdata.com/26.4/ja/connections/connections.md)を参照してください。

## SAP ERP への認証

コネクタを追加したら、必要なプロパティを設定します。

* **User：** SAP ERP への認証に使用するユーザー名を入力。
* **Password：** SAP ERP アカウントへの認証に使用するパスワードを入力。
* **Client：** SAP システムへの認証に使用するクライアント名を入力。
* **Connection Type：** 使用する接続タイプを選択。デフォルトのタイプは**JCo** です。
* **Connection Scheme：** 使用する接続スキームを選択。デフォルトのスキームは**ApplicationServer** です。

## 接続を完了する

接続を完了するには：

1. 次のプロパティを指定します：
   * **Host：** ターゲットシステムのホスト名を入力。通常のホスト名、IP アドレス、またはSAP ルーターアドレスを指定できます。
   * **System Number：** ターゲットシステムを定義する番号を選択。デフォルト値は**0** です。
2. **高度な設定** タブで詳細な接続設定を定義します。（ただし、ほとんどの場合、これらの設定は必要ありません。）
3. **SAP ERP への接続**をクリックしてSAP ERP アカウントに接続します。
4. **作成およびテスト**をクリックして接続を作成します。

## Enabling CDC in CData Sync

SAP ERP ソース接続でCDC を使用するように構成するには、次の手順に従います：

1. SAP ERP ソースページの **高度な設定** タブを開き、**Miscellaneous** カテゴリに移動します。
2. **Table Mode** プロパティで**ChangeDataCapture** を選択します。
3. **作成およびテスト**をクリックして、接続の変更を保存します。
4. Sync でSAP ERP をソースとするジョブを作成し、**Type** オプションで **変更データキャプチャ** を選択します。

CDC ジョブを作成すると、**タスク**リストにはCDC が有効になっているテーブルのみが表示されます。CDC ジョブの**タスク**リストに表示したいカスタムテーブルがある場合は、先にSAP GUI でそれらのテーブルの追跡を有効にする必要があります。次のセクションでは、そのようなテーブルの追跡を有効にする方法を説明します。

## SAP カスタムテーブルのCDC を有効化

Sync でCDC を使用するためにSAP カスタムテーブルを準備するには、以下のセクションの手順を実行します。

#### ステップ1：変更ドキュメントフラグ付きでカスタムテーブルとデータ要素を作成

SAP GUI で、次の手順でカスタムテーブルを作成します：

1. SAP ERP を開き、トランザクション**SE11** に移動します。

2. **ABAP Dictionary: Initial Screen** ページで、**Database Table** ラジオボタンを選択し、関連するテキストボックスにカスタムテーブルの名前（例：**ZMACHINES\_TABLE**）を入力します。

   > [!NOTE]
   >
   > SAP ERP のカスタムオブジェクトの名前には、先頭にZ が必要です。

3. **Create** をクリックします。**Create Table** ページが開きます。

4. **Create Table** ページで、テーブルの簡単な説明（例：**Machines Table**）を入力します。

5. ウィンドウ上部のメニューバーで**Technical Settings** をクリックします。

6. **Dictionary: Define Technical Settings** ページの**General Properties** タブで、次の操作を行います：
   1. **Data Class** リストで**APPL0** を選択します。これはマスターデータおよびトランスペアレントなアプリケーションテーブルで一般的な選択です。

   2. **Log Data Changes** チェックボックスを選択して変更を保存します。

      ![Log Data Changes チェックボックスを表示しているDictionary Define Technical Settings ページ](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP-Source_enabling-cdc-for-SAP-ERP_1.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=1f67e3211b4619108971b178e15b244d)

   3. **Cancel** をクリックして前のページに戻ります。

7. **Fields** タブをクリックし、次の手順で必要な新しいフィールドを作成します。
   1. **Fields** 列にフィールド名（例：**NEW\_FIELD**）を入力します。

   2. **Data Element** フィールドに、新しい要素の名前を入力します。カスタムデータ要素を作成するには、文字Z で始まる名前（例：**ZNEWDATAELEMENT**）を入力します。要素がまだ存在しない場合は、SAP が新しい要素の作成を求めます。

      ![データ要素の構成を表示しているFields タブ](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP-Source_enabling-cdc-for-SAP-ERP_2.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=a05fd2700d027c848323bb2e582ad2d5)

   3. 入力した名前をダブルクリックします。SAP は、他の列（**Data Type**、**Length**、**Description**）の追加構成を求めます。

8. メニューバーの**Activate** アイコンをクリックして、テーブルをアクティブ化します。

   ![メニューバーのActivate アイコン](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP-Source_enabling-cdc-for-SAP-ERP_3.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=2333d66358a060a686e6d83e5174ac66)

#### ステップ2：変更ドキュメントオブジェクトの作成と構成

次の手順で、変更ドキュメントオブジェクト（SCDO）を作成して構成します：

1. トランザクション**SCDO** を開きます。

2. **Object** テキストボックスにオブジェクトの名前（例：**ZMACHLOG**）を入力します。

3. **Create** をクリックして新しい変更ドキュメントオブジェクトを作成し、**Create Object Directory Entry** ダイアログボックスを開きます。

   ![Create Object Directory Entry ダイアログボックス](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP-Source_enabling-cdc-for-SAP-ERP_4.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=60c13ce297c29f2d47adbc00712db1e9)

4. **Package** リストから**Local Object** を選択します。オブジェクトの簡単な説明（例：「Change Document Object for Machines Tab」）を入力します。

5. **Table** タブをクリックして、カスタムテーブルを変更ドキュメントオブジェクトに割り当てます。
   1. テーブル名（例：**ZMACHINES\_TABLE**）を追加します。

   2. 以下のように、**Delete Documentation** 列と**Insert Documentation** 列を選択します：

      ![Delete Documentation 列とInsert Documentation 列が選択されているTable タブ](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP_create-and-configure-change-document-object_1.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=0d9aab790ff94b3fbca4f2238b90b818)

   3. ウィンドウ上部のタスクバーで**Save** アイコンをクリックします。

6. タスクバーで**Generate** をクリックします。

7. **Generate Update Pgm.** ダイアログボックスの**Function group** テキストボックスに名前（例：**ZMACHLOG\_WRITE\_DOCUMENT**）を入力します。

8. ダイアログボックス下部の**Generate** をクリックします。

9. 次のページで、ファンクショングループの名前（**ZMACHLOG\_WRITE\_DOCUMENT**）をダブルクリックします。トランザクションSE37 に移動します。

   ![トランザクションSE37 のファンクショングループ名](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP_create-and-configure-change-document-object_2.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=68b1e95fbea96dc4be7b257348111cd1)

   SAP は、このオブジェクトが関与するたびに実行されるファンクションモジュールを生成します。シナリオに応じて、挿入、更新、削除を処理するようロジックを調整する必要がある場合があります。このモジュールは、シナリオに応じて変更できます。

10. **Validate** アイコン（![Validate アイコン](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP_create-and-configure-change-document-object_3.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=faac70adfdd8b1acaedc732aa5a4282b)）をクリックして、モジュールの構文をチェックします。

11. **Activate** アイコン（![Activate アイコン](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP_create-and-configure-change-document-object_4.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=0d5f5a5953164acb9cc772ab2dcf9bd1)）をクリックして、ファンクションモジュールをアクティブ化します。

この時点で、SAP における変更ドキュメントの基盤が整いました。ただし、システムが生成したファンクションモジュール（ZMACHLOG\_WRITE\_DOCUMENT）が呼び出されるまで、エントリは記録されません。この呼び出しは、テーブルを変更するアプリケーションロジック、更新モジュール、またはカスタムプログラム内で行う必要があり、これにより各変更が明示的に取得・記録されます。

#### ステップ3：テーブルがCDC に対応していることを確認

次に、ターゲットテーブルが変更ドキュメントキャプチャ（CDC）に対応していることを確認します。これにより、作成したSCDO オブジェクトがシステムに認識され、以降の変更が正しく記録されることを確認できます。

1. トランザクション**SE16** を開きます。

2. テーブル名**TCDOB** を入力します。

   ![TCDOB テーブルエントリを表示しているData Browser](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP-Source_verify-CDC-is-enabled-for-table_1.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=5e6d0f68a6ba9a1eefa2aaaf2225188c)

3. **Data Browser - Table TCDOB** ページで、**TABNAME** テキストボックスに**ZMACHINES\_TABLE** を入力してフィルタリングします。

   これにより、作成したSCDO オブジェクトがテーブルにリンクされ、CDC を処理できる状態になっていることを確認できます。

   ![ZMACHINES\_TABLE にリンクされたSCDO オブジェクトを表示しているData Browser](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/SAP-ERP-Source_verify-CDC-is-enabled-for-table_2.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=1ed564752ce5d88b7daaa186465e5de7)

## 詳細について


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.