Power Automate (Microsoft Flow) は、オンプレやクラウドの複数のシステムからのデータを含むタスクを自動化することができます。CData API Server およびMYOB AccountRight ADO.NET Provider (または220+ の他のADO.NET Providers) を使用すると、基幹業務ユーザーはPower Automate のMYOB AccountRight トリガーに基づく、アクションのネイティブな作成が可能になります。API Server は、Power Automate などのSaaS アプリケーションを、OData やSwagger などのデータアクセス標準を通じてMYOB AccountRight とシームレスに統合できます。この記事では、Power Automate のウィザードとMYOB AccountRight API Server を使い、検索条件に一致するエンティティであるトリガーを作成し、結果に基づいて電子メールを送信する方法を示します。
API サーバーをセットアップ
以下のステップに従って、安全でSwaggerに対応するMYOB AccountRight API の作成を開始します。
デプロイ
API サーバーは独自のサーバーで実行されます。Windows では、スタンドアロンサーバーまたはIIS を使用して展開できます。Java サーブレットコンテナで、API Server WAR ファイルをドロップします。詳細とハウツーについては、ヘルプドキュメントを参照してください。
API Server は、Microsoft Azure、Amazon EC2、Heroku にも簡単にデプロイできます。
MYOB AccountRight に接続
デプロイ後、API Server 管理コンソールで［Settings］->［Connections］とクリックし、認証値とその他の接続プロパティを指定します。
次に、［Settings］->［Resources］をクリックして、API サーバーへのアクセスを許可する エンティティを選択できます。
これらのプロパティは会社のファイルに接続するときに必要です（クラウドインスタンスおよびオンプレミスインスタンスの両方）。
オンプレミスインスタンスへの接続：
InitiateOAuth:OFF に設定。
オンプレミスインスタンスに接続する場合は、上記に加えて、次の接続プロパティを設定する必要があります。
クラウドインスタンスへの接続：
MYOB のクラウドインスタンスに接続するには、OAuth アプリを作成する必要があります。このプロセスの詳細は、カスタムOAuth アプリの作成 にあります。
また、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
MYOB AccountRight データをFlow に追加する
組み込みのHTTP + Swagger コネクタを使用し、ウィザードを使用してMYOB AccountRight プロセスフローを設計できます。
- ［Power Automate］で、［My Flows］->［Create from Blank］をクリックします。
- ［Recurrence］アクションを選択し、電子メールを送信する時間間隔を選択します。この記事では、［1日］にします。
- Swagger を検索してHTTP + Swagger アクションを追加します。
- Swagger メタデータドキュメントのURL を入力します。
https://MySite:MyPort/api.rsc/@MyAuthtoken/$oas
- ［Return Accounts］操作を選択します。
MYOB AccountRight を取得するためのOData クエリを作成します。この記事では、$filter ボックスで次のOData フィルタ形式を定義します。
Type eq 'Bank'
サポートされているOData のフィルタリングと例の詳細については、API Server のヘルプドキュメントを参照してください。
アクションをトリガー
これで、プロセスフローでAccounts エンティティを操作できます。以下のステップに従って、自動メールを送信します。
- E メール送信アクションであるSMTP を追加します。
- SMTP サーバーのアドレスと資格情報を入力し、接続に名前を付けます。サーバーでサポートされている場合には、必ず暗号化を有効にしてください。
- メッセージのヘッダーと本文を入力します。これらのボックスにMYOB AccountRight カラムを追加できます。
