コンタクト先へのE メール送信、SNS へのポスト、CRM やERP の同期などを自動化します。
Power Automate (Microsoft Flow) は、オンプレやクラウドの複数のシステムからのデータを含むタスクを自動化することができます。CData API Server およびQuickBooks POS ADO.NET Provider (または230+ の他のADO.NET Providers) を使用すると、基幹業務ユーザーはPower Automate のQuickBooks POS トリガーに基づく、アクションのネイティブな作成が可能になります。API Server は、Power Automate などのSaaS アプリケーションを、OData やSwagger などのデータアクセス標準を通じてQuickBooks POS とシームレスに統合できます。この記事では、Power Automate のウィザードとQuickBooks POS API Server を使い、検索条件に一致するエンティティであるトリガーを作成し、結果に基づいて電子メールを送信する方法を示します。
API サーバーをセットアップ
以下のステップに従って、安全でSwaggerに対応するQuickBooks POS API の作成を開始します。
デプロイ
API サーバーは独自のサーバーで実行されます。Windows では、スタンドアロンサーバーまたはIIS を使用して展開できます。Java サーブレットコンテナで、API Server WAR ファイルをドロップします。詳細とハウツーについては、ヘルプドキュメントを参照してください。
API Server は、Microsoft Azure、Amazon EC2、Heroku にも簡単にデプロイできます。
QuickBooks POS に接続
デプロイ後、API Server 管理コンソールで［Settings］->［Connections］とクリックし、認証値とその他の接続プロパティを指定します。 次に、［Settings］->［Resources］をクリックして、API サーバーへのアクセスを許可する エンティティを選択できます。
ローカルQuickBooks インスタンスに接続する場合は、接続プロパティを設定する必要はありません。
本製品 はリモートコネクタ経由でQuickBooks にリクエストを作成します。リモートコネクタはQuickBooks POS と同じマシン上で動作し、軽量の組み込みWeb サーバーを介して接続を受け入れます。サーバーはSSL/TLS をサポートし、ユーザーにリモートマシンからのセキュアな接続を可能にします。
初めて接続するときは、リモートコネクタをQuickBooks POS で認可する必要があります。詳細はヘルプドキュメントの「はじめに」を参照してください。
また、CORS を有効にし、［Settings］->［Server］ページで次のセクションを定義する必要があります。［*］なしですべてのドメインを許可するオプションを選択することもできます。
- Access-Control-Allow-Origin:［*］の値に設定するか、接続を許可するドメインを指定します。
- Access-Control-Allow-Methods:値を［GET,PUT,POST,OPTIONS］に設定します。
- Access-Control-Allow-Headers:［x-ms-client-request-id, authorization, content-type］に設定します。
API サーバーユーザーを承認
作成するOData サービスを決定したら、［Settings］->［Users］をクリックしてユーザーを承認します。API サーバーは、認証トークンベースの認証を使用して主要な認証スキームをサポートします。SSL を使用して、接続を認証及び暗号化することができます。アクセスはIP アドレスによって制限することもできます。デフォルトでは、ローカルマシンのみに制限されています。
簡単にするために、API ユーザーの認証トークンをURL で渡すことができます。データディレクトリにあるsettings.cfg ファイルの［Application］セクションに設定を追加する必要があります。Windows でこれは、アプリケーションルートのapp_data サブフォルダにあたります。Java エディションでは、データディレクトリの場所はオペレーティングシステムによって異なります。
- Windows:C:\ProgramData\CData
- Unix or Mac OS X: ~/cdata
[Application]
AllowAuthtokenInURL = true
QuickBooks POS データをFlow に追加する
組み込みのHTTP + Swagger コネクタを使用し、ウィザードを使用してQuickBooks POS プロセスフローを設計できます。
- ［Power Automate］で、［My Flows］->［Create from Blank］をクリックします。
- ［Recurrence］アクションを選択し、電子メールを送信する時間間隔を選択します。この記事では、［1日］にします。
- Swagger を検索してHTTP + Swagger アクションを追加します。
- Swagger メタデータドキュメントのURL を入力します。
https://MySite:MyPort/api.rsc/@MyAuthtoken/$oas - ［Return Customers］操作を選択します。
QuickBooks POS を取得するためのOData クエリを作成します。この記事では、$filter ボックスで次のOData フィルタ形式を定義します。
LastName eq 'Cook'
サポートされているOData のフィルタリングと例の詳細については、API Server のヘルプドキュメントを参照してください。
アクションをトリガー
これで、プロセスフローでCustomers エンティティを操作できます。以下のステップに従って、自動メールを送信します。
- E メール送信アクションであるSMTP を追加します。
- SMTP サーバーのアドレスと資格情報を入力し、接続に名前を付けます。サーバーでサポートされている場合には、必ず暗号化を有効にしてください。
- メッセージのヘッダーと本文を入力します。これらのボックスにQuickBooks POS カラムを追加できます。
