Node.js からXero WorkflowMax データをクエリ

API Server は、データを外部に公開します。CData API Server のOData エンドポイントを使って、Node.js からXero WorkflowMax へのCRUD クエリを実行します。

CData API Server とADO.NET Provider for Xero WorkflowMax(もしくは220+ の他のADO.NET Providers)を使って、Xero WorkflowMax をOData エンドポイントして公開し、Node.js からシンプルなHTTP リクエストでクエリを実現します。本記事ではAPI Server を使ってJSON でフォーマットされたXero WorkflowMax データをNode.js でリクエストする方法を説明します。

API サーバーをセットアップ

以下のステップに従って、安全なXero WorkflowMax OData サービスの作成を開始します。

デプロイ

API サーバーは独自のサーバーで実行されます。Windows では、スタンドアロンサーバーまたはIIS を使用して展開できます。Java サーブレットコンテナで、API Server WAR ファイルをドロップします。詳細とハウツーについては、ヘルプドキュメントを参照してください。

API Server は、Microsoft AzureAmazon EC2Heroku にも簡単にデプロイできます。

Xero WorkflowMax に接続

API サーバーとADO.NET Provider for Xero WorkflowMax を展開した後、[Settings]->[Connections]をクリックし、API サーバー管理コンソールで新しい接続を追加してXero WorkflowMax に接続するために必要な認証値とその他の接続プロパティを指定します。

To connect to the WorkflowMax API, obtain an APIKey and AccountKey from Xero. This can only be done by contacting Xero support (https://www.workflowmax.com/contact-us).

After obtaining an API Key and Account Key, set the values in the APIKey and AccountKey connection properties. Once these are set, you are ready to connect.

次に、[Settings]->[Resources]をクリックして、API サーバーへのアクセスを許可するXero WorkflowMax エンティティを選択できます。

API サーバーユーザーを承認

作成するOData サービスを決定したら、[Settings]->[Users]をクリックしてユーザーを承認します。API サーバーは、認証トークンベースの認証を使用して主要な認証スキームをサポートします。IP アドレスに基づいてアクセスを制限することもできます。ローカルマシンを除くすべてのIP アドレスはデフォルトで制限されています。SSL を使用して、接続を認証及び暗号化することができます。

Node.js からXero WorkflowMax OData フィードを消費

OData フィードはNode.js で簡単に使用できます。Node.js のHTTP クライアントを使用して、API サーバーのOData エンドポイントからJSON 形式のデータをリクエストできます。リクエストを行った後、レスポンスの本文を作成し、JSON.parse() 関数を呼び出してレコードに解析できます。

以下のコードはClients データに対して認証されたリクエストを行います。 以下のURL の例では、Name カラムの値がCynthia のレコードを検索する単純なフィルターを適用しています。

var http = require('http'); http.get({ protocol: "http:", hostname:"MyServer.com", port:MyPort, path: "/api.rsc/Clients?$filter=" + encodeURIComponent("Name eq 'Cynthia'"), auth:'MyUser:MyAuthtoken' }, function(res) { var body = ''; res.on('data', function(chunk) { body += chunk; }); res.on('end', function() { console.log(body); var jsonData = JSON.parse(body); }); }).on('error', function(e) { console.log("Error: ", e); });
 
 
ダウンロード