Sage Intacct のデータで Updategram を使用する

この記事では、CData BizTalk Adapter for Sage Intacct で実行できる Updategram を作成します。スキーマを設計し、それをテンプレートとして挿入、更新、削除の Updategram を生成します。

はじめに

---

Sage Intacct 用アダプターをプロジェクトに追加する

Add Adapter ウィザードを使用して、Visual Studio の BizTalk Server プロジェクトにアダプターを追加します。アダプターを使用して、変更したいテーブルに関するメタデータを Sage Intacct に問い合わせます。

1. Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
2. 表示されるダイアログボックスで Add Adapter Metadata を選択します。
3. 表示される Add Adapter Wizard で、リストビューから CData BizTalk Adapter for Sage Intacct を選択します。
4. Port メニューでは、選択を空白のままにします。または、アダプターを使用するよう構成された Receive Location か Send Port を選択します。
5. Next をクリックすると、Schema Wizard が表示されます。

Updategram 用のスキーマを生成する

以下の手順で、Visual Studio の BizTalk Server プロジェクトでスキーマを作成します。

1. まだ行っていない場合は、Sage Intacct アダプターをプロジェクトに追加します。
2. Add Adapter ウィザードの Connection String ページで、Send Port または Receive Location で構成されていない場合は、認証情報やその他の接続プロパティを入力します。一般的な接続文字列は以下のとおりです：

   User=myusername;CompanyId=TestCompany;Password=mypassword;SenderId=Test;SenderPassword=abcde123;
   

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

   独自のWeb サービスクレデンシャル、埋め込みクレデンシャル（Basic 認証）、またはOkta クレデンシャルのいずれかを使用して、Sage Intacct への接続を確立できます。

   Sage Intacct への認証

   Sage Intacct は2種類の認証をサポートします。Basic およびOkta です。選択した認証方法に関連するプロパティを設定して、接続を構成します。

   Basic 認証

   Basic 認証スキームでは、埋め込みクレデンシャルを使用してデータの読み書きが可能です。オプションとして、独自のWeb サービスクレデンシャルを指定することもできます。

   Basic 認証を使用して認証を行うには、以下のプロパティを設定します。

   • AuthScheme：Basic。
   • CompanyID：Sage Intacct にログインする際に会社を識別するために使用するID。
   • User：Sage Intacct へのログインに使用するログイン名。
   • Password：ログインクレデンシャル用のパスワード。
   • （オプション）SenderID およびSenderPassword：Web サービスのSender ID およびパスワード（独自のWeb サービスクレデンシャルを使用している場合のみ）。

   独自のWeb サービスクレデンシャルではなく、埋め込みクレデンシャルを使用する場合は、以下を実行する必要があります：

   • Web サービスダッシュボードで、会社 -> 会社情報 -> セキュリティタブに移動します。
   • Web サービス認証に"CData" を追加します。これは大文字・小文字が区別されます。これを行うには、会社 -> 会社情報（新しいUI では、設定 -> 会社）-> セキュリティ -> Web サービス認証 / 編集に移動します。
   Okta 認証についてはヘルプドキュメントを参照してください。

   必要な接続プロパティの詳細については、ヘルプドキュメントの "BizTalk Configuration" の章を参照してください。

   
3. Schema Information ページで、General Options セクションの Send Port をクリックします。CommandType メニューから Updategram を選択します。Solicit-Response Send Port でアダプターを使用している場合は、One-Way オプションを無効にします。

4. 次のページ（Statement Information）で、Updategram のタイプ（Insert、Update、Delete）を選択します。テーブル名とスキーマに含めるカラムを選択します。Update または Delete を行う場合は、Id カラムが必要です。

   注：Updategram を作成する際、スキーマに含めたカラムのみを変更できます。

   
5. Next をクリックしてスキーマのサマリーを表示し、ウィザードを終了してスキーマを作成します。生成された .xsd ファイルがプロジェクトに追加されます。

Insert、Update、Delete のインスタンスメッセージを生成する

Updategram スキーマを作成したら、.xsd ファイルを使用して Updategram を生成できます。Solution Explorer で .xsd ファイルを右クリックし、Generate Instance を選択します。このファイルをテンプレートとして、手動で Updategram を作成することもできます。以下は、Insert、Update、Delete 用に生成された Updategram インスタンスの例です：

Insert

INSERT の例を以下に示します。このインスタンスでは、データがどのように変更されるかを指定する after ブロックのみがあります。

<ns0:parameters xmlns:ns0="http://www.cdata.com/jp/SageIntacctProvider">
  <ns0:sync>
    <ns0:before></ns0:before>
    <ns0:after>
      <ns0:Customer Name="Name_0" TotalDue="TotalDue_1" />
    </ns0:after>
  </ns0:sync>
</ns0:parameters>

Update

UPDATE の例を以下に示します。このインスタンスでは、before ブロック（テーブルの現在のデータ）と after ブロック（データがどのように変更されるか）の両方があります。

<ns0:parameters xmlns:ns0="http://www.cdata.com/jp/SageIntacctProvider">
  <ns0:sync>
    <ns0:before>
      <ns0:Customer Id=001d000000YBRseAAH></ns0:Customer>
    </ns0:before>
    <ns0:after>
      <ns0:Customer Name="Name_0" TotalDue="TotalDue_1" ></ns0:Customer>
    </ns0:after>
  </ns0:sync>
</ns0:parameters>

Delete

DELETE の例を以下に示します。after ブロックは空になり、アイテムが削除されることを示します。

<ns0:parameters xmlns:ns0="http://www.cdata.com/jp/SageIntacctProvider">
  <ns0:sync>
    <ns0:before>
      <ns0:Customer Id=001d000000YBRseAAH></ns0:Customer>
    </ns0:before>
    <ns0:after></ns0:after>
  </ns0:sync>
</ns0:parameters>

スキーマの処理

Updategram を使用して Sage Intacct レコードの挿入、更新、削除を行う方法については、チュートリアルを参照してください。