CData BizTalk Adapter for Sage Intacct の Receive Location を構成する

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData BizTalk Adapter for Sage Intacct を使用して、BizTalk でSage Intacct のデータを取得します。Receive Location を使用して SQL コマンドを実行し、Sage Intacct でのアクションを自動化します。

この記事の手順に従って、Sage Intacct のデータに接続し、Static One-Way Receive Location を構成して、シンプルなテスト（Sage Intacct のデータを取得して XML ファイルに書き込む）を実行できます。

Receive Location は SQL コマンドを実行し、結果を含む BizTalk メッセージを作成できます。Updategram コマンドを実行する場合は、Send Port を使用してください。

Sage Intacct データ連携について

CData は、Sage Intacct のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています：

  • API の更新や変更を気にすることなく、Sage Intacct にアクセスできます。
  • 追加の構成手順なしで、Sage Intacct のカスタムオブジェクトやフィールドにアクセスできます。
  • Basic 認証による組み込み Web サービス認証情報を使用して、Sage Intacct にデータを書き戻すことができます。
  • SQL ストアドプロシージャを使用して、ベンダーの承認・却下、エンゲージメントの挿入、カスタムオブジェクトやフィールドの作成・削除などの機能的な操作を実行できます。

ユーザーは、Tableau、Power BI、Excel などの分析ツールと Sage Intacct を統合し、当社のツールを活用して Sage Intacct データをデータベースやデータウェアハウスにレプリケートしています。

他のお客様が CData の Sage Intacct ソリューションをどのように使用しているかについては、ブログをご覧ください：Drivers in Focus: Accounting Connectivity


はじめに


Receive Port の作成

アプリケーションに Receive Location を追加するには、まず Receive Port を追加する必要があります。Receive Port は複数の Receive Location からデータを受信できます。

  1. まだ行っていない場合は、BizTalk Administration Console でアプリケーションを開きます。
  2. アプリケーション内で、Receive Ports を右クリックし、New -> Static One-Way Receive Port をクリックします。Receive Port Properties ダイアログが表示されます。
  3. Name メニューで、Receive Port の名前を入力します。

Receive Location の作成

Receive Port を作成したら、Receive Location を作成し、Sage Intacct アダプターをトランスポートタイプとして使用するよう構成します。

  1. Receive Locations を右クリックし、New -> One-Way Receive Location をクリックします。
  2. 新しい Receive Location がメンバーとなる適切な Receive Port を選択します。Receive Location Properties ダイアログが表示されます。
  3. Name メニューで、Receive Location の名前を入力します。
  4. Receive Location プロパティで、Transport Type メニューから CData.SageIntacct を選択します。
  5. Receive pipeline メニューで、デフォルトオプションの PassThruReceive を選択します。

アダプターの構成

Transport Properties ダイアログで、アダプターが実行するコマンドを指定します。

  1. Receive Location プロパティで、Configure をクリックします。アダプターの Transport Properties ダイアログが表示されます。
  2. SQL Command プロパティに、コマンドを入力します。この例では 
    SELECT Name, TotalDue FROM Customer
    を使用します。
利用可能なアダプター構成プロパティについては、"Adapter Configuration" の章を参照してください。

接続文字列の構成

Connection String Options ダイアログで、認証情報やその他の接続プロパティを設定します。

  1. Receive Location プロパティで、Configure をクリックします。アダプタープロパティダイアログが表示されます。
  2. Connection String プロパティのボタンをクリックします。
  3. Connection String プロパティのボックスをクリックします。Connection String Options ダイアログが表示されます。
  4. 接続プロパティを入力します。一般的な接続文字列は以下のとおりです： 
    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 認証についてはヘルプドキュメントを参照してください。
  5. Test Connection をクリックして、接続値を確認し接続をテストします。

各種プロパティとその機能の説明については、ヘルプドキュメントを参照してください。

Send Port を使用してデータを XML ファイルに書き込む

これで Static One-Way Receive Location を Send Port と共に使用する準備が整いました。Receive Location が作成した BizTalk メッセージには Send Port を関連付ける必要があります。データをファイルに書き込むには、File Send Port を作成します。

  1. BizTalk Administration コンソールで、Send Ports -> New -> Static One-Way Send Port を右クリックします。

  2. 構成ウィンドウの上部に Send Port の名前を入力し、Type メニューから FILE を選択します。

  3. 宛先フォルダを構成します。これがディスク上にファイルが作成される場所になります。

  4. ファイル名には、マクロを使用してファイルが作成された日付を簡単に識別できます。デフォルトでは %MessageId%.xml が使用されます。ただし、これはランダムに生成された BizTalk ID であるため、ユーザーフレンドリーな名前ではありません。Customer_yyyy-MM-dd.xml 形式のファイルを作成するには、Customer_%Date%.xml と入力します。

    注：マクロの詳細については、ヘルプドキュメントの BizTalk Configuration セクションを参照してください。

  5. OK をクリックします。URI フィールドに値が入力されます。
  6. Send Port の構成画面の左側で Filters をクリックします。
  7. 以下のプロパティを設定します：
    Property：メニューから "BTS.InboundTransportLocation" を選択します。
    Operator：メニューから "==" を選択します。
    Value：Receive Location の URI を入力します。URI は Receive Location プロパティに表示されています。

これで、Send Port を使用して Receive Location から送信されたファイルを書き込めます。

Location と Port を Enlist および Enable する

最後のステップは、Send Port を Enlist し、Receive Location を Enable することです。Send Port を右クリックして Enlist をクリックします。次に、Receive Location を右クリックして Enable をクリックします。

注：Receive Location は最後に Enable してください。これにより、ファイルが Send Port によって確実に書き込み用にピックアップされます。

トラブルシューティング

エラーが発生しているかどうかを確認するには、Administration Console のナビゲーションツリーで "Event Viewer (Local)" を展開します。Windows Logs を展開し、Applications をクリックします。

ログにはシステム上のすべてのアプリケーションのエラーメッセージが含まれるため、エラーメッセージのソースが "CData BizTalk Sage Intacct Receive Adapter" であることを確認することが重要です。エラーメッセージの詳細から、エラーが発生している理由がわかります。エラーの解決方法については、[email protected]/jp にお問い合わせください。

はじめる準備はできましたか？

詳細：

Sage Intacct 連携ソリューション お問い合わせ

この記事の内容

関連記事