Workato で Harvest のリアルタイムデータを使った自動ワークフローを構築
Workato は、アプリケーションの統合とワークフローの自動化を支援するクラウドベースの自動化プラットフォームです。CData Connect AI と組み合わせることで、クラウド間でリアルタイムにHarvest のデータにアクセスし、ビジュアライゼーションやダッシュボードなどを作成できます。この記事では、Harvest に接続し、Workato でリアルタイムのHarvest のデータを使ったワークフローを構築する方法をご紹介します。
CData Connect AI は、Harvest 向けに純粋な SQL Server インターフェースをクラウド間で提供します。Workato でリアルタイムのHarvest のデータから簡単にビジュアライゼーションを作成できます。自動化を構築する際、Workato はデータを収集するための SQL クエリを生成します。Connect AI は、フィルタや JOIN などの SQL 操作をHarvestに直接プッシュする最適化されたデータ処理により、サーバーサイド処理を活用してHarvest のデータをすばやく取得します。
Harvest への接続を設定（Workato 向け）
Workato から Harvest への接続は、CData Connect AI を介して行います。それでは、Harvest のデータを Workato から利用できるようにするため、Harvest への接続を作成していきましょう。
- Connect AI にログインして「Sources」をクリック、次に「 Add Connection」をクリック
- 接続を追加パネルから「Harvest」を選択
-
Harvest に接続するために必要な認証プロパティを入力します。
まず、Profile 接続プロパティをディスク上のHarvest プロファイルの場所に設定します（例：C:\profiles\Harvest.apip）。次に、ProfileSettings 接続プロパティをHarvest の接続文字列に設定します（以下を参照）。
Harvest API プロファイル設定
Harvest に認証するには、トークン認証またはOAuth 標準のいずれかを使用できます。自分のデータに接続するにはBasic 認証を使用します。他のユーザーが自分のデータに接続できるようにするにはOAuth を使用します。
トークン認証の使用
トークン認証を使用するには、ProfileSettings 接続プロパティでAPIKey にHarvest パーソナルアクセストークンを設定します。APIKey に加えて、ProfileSettings でAccountId を設定して接続します。
OAuth 認証の使用
まず、Harvest でOAuth2 アプリケーションを登録します。アプリケーションはHarvest ID の「Developers」セクションから作成できます。
以下の接続プロパティを設定すると、接続できるようになります。
- ProfileSettings：ProfileSettings でAccountId を設定します。
- AuthScheme：OAuth に設定します。
- OAuthClientId：アプリ設定で指定したclient ID に設定します。
- OAuthClientSecret：アプリ設定で指定したclient secret に設定します。
- CallbackURL：アプリ設定で指定したRedirect URI に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、ドライバーがOAuthAccessToken を取得および更新する方法を管理できます。
- 「Save & Test」をクリック
-
Harvest 接続の追加ページで「Permissions」タブに移動し、ユーザーベースの権限を更新します。
パーソナルアクセストークンを追加
REST API、OData API、または仮想 SQL Server を通じて Connect AI に接続する場合は、パーソナルアクセストークン（PAT）を使用して認証を行います。アクセス管理を細かく制御するため、サービスごとに個別の PAT を作成することをお勧めします。
- Connect AI アプリの右上にある歯車アイコン（）をクリックして設定ページを開きます。
- 設定ページで「Access Tokens」セクションに移動し、「 Create PAT」をクリックします。
-
PAT に名前を付けて「Create」をクリックします。
- パーソナルアクセストークンは作成時にのみ表示されます。必ずコピーして、今後の利用のために安全に保管してください。
接続の設定と PAT の生成が完了したら、Workato からHarvest のデータに接続する準備は完了です。
Workato で Harvest ワークフローを自動化
Workato から CData Connect AI 仮想 SQL Server への接続を確立するには、以下の手順に従います。
- Workato にログインします。
- ナビゲーションバーで Projects をクリックします。
- 新規（または既存の）プロジェクトで、Create > Connection をクリックします。
- 検索バーに「SQL Server」と入力し、Connect to SQL Server 画面を開きます。
- Connect to SQL Server で、接続名と以下の接続設定を入力します。
- Location: プロジェクトの名前を入力
- Connection type: Cloud を選択
- Host: tds.cdata.com を入力
- Port: 14333 を入力
- Username: CData Connect AI のユーザー名を入力。CData Connect AI インターフェースの右上に表示されています（例: [email protected]）
- Password: 先ほど生成した PAT を入力
- Database: 接続したい CData Connect AI データソースの接続名を入力（例: API1）
- Connect をクリックして Connection established メッセージを確認します。
- 次に、レシピを設定します。プロジェクトで Create > Recipe をクリックします。
- Set up your recipe で、レシピの名前と場所を入力します。
- Run on a schedule を選択します。
- スケジュールで実行するアクションを選択します。
- Connect AI 接続からテーブルと適用するフィルタを選択します。
- Save をクリックしてレシピを保存します。
- Test Jobs をクリックしてレシピをテストします。
クラウドアプリケーションから Harvest へのリアルタイムアクセス
これで、Workato からワークフローと自動化用にHarvest のデータへのダイレクトなクラウド間接続が完成しました。Workato などのクラウドアプリケーションから 100 以上の SaaS、ビッグデータ、NoSQL ソースへのライブアクセスの詳細については、Connect AI のページをご覧ください。