CloverDX（旧CloverETL）で Acumatica のデータ に接続

CData JDBC Driver for Acumatica を使用すると、CloverDX（旧CloverETL）のデータ変換コンポーネントで Acumatica をソースおよびデスティネーションとして扱えます。この記事では、JDBC Driver for Acumatica を使用して、フラットファイルへのシンプルな転送を設定する方法を説明します。

JDBC データソースとして Acumatica に接続

1. Acumatica のデータ への接続を作成します。新規のCloverDX グラフで、Outline ペインの「Connections」ノードを右クリックし、「Connections」->「Create Connection」をクリックします。Database Connection ウィザードが表示されます。
2. プラスアイコンをクリックし、JAR からドライバーをロードします。インストールディレクトリのlib サブフォルダを参照し、cdata.jdbc.acumatica.jar ファイルを選択します。
3. JDBC URL を入力します。

   Acumatica 接続プロパティの取得・設定方法

   Acumatica への接続

   Acumatica データソースに接続するには、次の接続プロパティを指定する必要があります。

   • URL：（必須）Acumatica ERP インスタンスのベースURL。例：https://domain.acumatica.com/。
   • Schema：（オプション）異なるデータを含む2つのスキーマがあります。デフォルトはREST で、Acumatica REST コントラクトベースのAPI を使用し、OData スキーマはAcumatica OData API を使用します。OData スキーマはAcumatica Generic Inquiries へのクエリに使用されます。
   • Company：（一部必須）会社名またはテナント名に設定。Schema がOData に設定されている場合は必須です。
   • EndpointVersion：（オプション）Web Services エンドポイントのバージョン。例：24.200.001。これはREST スキーマにのみ適用されます。
   • EndpointName：（オプション）Web Services エンドポイントの名前。例：Default。これはREST スキーマにのみ適用されます。
   詳細はヘルプドキュメントの「接続の確立」セクションを参照してください。

   Acumatica への認証

   Acumatica データソースへの接続に使用できる認証方法は2つあります。Basic およびOAuth です。 Basic 認証では、AuthScheme をBasic に設定し、User とPassword をログイン資格情報に設定します。 OAuth 認証については、ヘルプドキュメントの「接続の確立」セクションにある「OAuth」を参照してください。

   組み込みの接続文字列デザイナー

   JDBC URL の構築には、Acumatica JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから実行します。

   java -jar cdata.jdbc.acumatica.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   一般的なJDBC URL は次のようになります：

   jdbc:acumatica:Url = https://try.acumatica.com/ISV/;EndpointName=Default;EndpointVersion=24.200.001;User=user;Password=password;Company=CompanyName;

DBInputTable コンポーネントで Acumatica のデータ をクエリ

1. Palette の「Readers」から「DBInputTable」をジョブフローにドラッグし、ダブルクリックして設定エディターを開きます。
2. 「DB connection」プロパティで、ドロップダウンメニューから Acumatica JDBC データソースを選択します。
3. SQL クエリを入力します。例：

   SELECT Id, location_displayname FROM Events

クエリの出力をUniversalDataWriter に書き込む

1. 「Writers」から「UniversalDataWriter」をジョブフローにドラッグします。
2. UniversalDataWriter をダブルクリックして設定エディターを開き、ファイルURL を追加します。
3. DBInputTable を右クリックし、「Extract Metadata」をクリックします。
4. DBInputTable の出力ポートをUniversalDataWriter に接続します。
5. UniversalDataWriter の「Select Metadata」メニューで、Events テーブルを選択します。（このメニューはUniversalDataWriter の入力ポートを右クリックしても開けます。）
6. 「Run」をクリックして、ファイルに書き込みます。