Harvest に接続したNintex ワークフローの作成

Nintex Workflow Cloud は、コーディングなしでドラッグアンドドロップを使用して単純 / 複雑なプロセスを自動化するワークフローを設計できる、クラウドベースのプラットフォームです。CData Connect AI と組み合わせると、ビジネスアプリケーション用にHarvest のデータにクラウドベースでアクセスできます。この記事では、Connect AI にHarvest の仮想データベースを作成し、Nintex でHarvest のデータから単純なワークフローを構築する方法を説明します。

CData Connect AI は、Harvest にクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなくNintex Workflow Cloud でリアルタイムHarvest のデータからワークフローを作成できるようにします。Nintex では、SQL クエリを使用してデータに直接アクセスできます。CData Connect AI は、最適化されたデータ処理を使用してサポートされているすべてのSQL 操作（フィルタ、JOIN など）をHarvest に直接プッシュし、サーバー側の処理を利用して、要求されたHarvest のデータを高速で返します。

Connect AI からHarvest に接続する

1. Connect AI にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「Harvest」を選択します。
3. 必要な認証情報を入力し、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 を取得および更新する方法を管理できます。
   
4. Create & Test をクリックします。
5. Edit Harvest Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

パーソナルアクセストークンを追加する

OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（Personal Access Token, PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
2. PAT の名前を入力して Create をクリックします。
3. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

接続が構成されたら、Nintex Workflow Cloud からHarvest のデータに接続できるようになります。

Nintex からHarvest に接続する

以下のステップは、（Connect AI を介して）Nintex からHarvest のデータへの新しい接続を作成する方法の概要です。

1. Nintex Workflow Cloud にログインします。
2. Connections タブで「Add new」をクリックします。
3. コネクタとして「Microsoft SQL Server」を選択し、「Connect」をクリックします。
4. SQL Server の接続ウィザードで以下のプロパティを設定します。
   • Connection Name：a Connect AI
   • Username：Connect AI のユーザー名（例：[email protected]）
   • Password：Connect AI のユーザーのPAT
   • Database Host：tds.cdata.com
   • Database Name：Harvest 接続（例：API1）
   
5. 「Connect」をクリックします。
6. 接続権限を構成し、「Save permissions」をクリックします。

単純なHarvest ワークフローを作成する

CData Connect AI への接続が構成され、Harvest にアクセスする単純なワークフローを作成する準備ができました。まずは、「Create workflow」ボタンをクリックします。

開始イベントアクションを構成する

1. 開始イベントタスクをクリックし、「Form」イベントを選択します。
2. 「Design form」をクリックします。
3. 「Text - Long」エレメントをForm にドラッグし、エレメントをクリックして設定します。
   • 「Title」を「Enter SQL query」に設定します。
   • 「Required」をtrue に設定します。
4. 「Text - Short」エレメントを「Form」にドラッグし、エレメントをクリックして構成します。
   • 「Title」を「Enter desired result column」に設定します。
   • 「Required」をtrue に設定します。


「Execute a Query」アクションを構成する

1. 「Start event: Form」アクションのあとに「Execute a query」アクションを追加し、クリックしてアクションを構成します。
2. 「Start event」アクションから「SQL Script」を「Enter SQL Query」変数に設定します。
3. 「Start event」アクションから「Column to retrieve」を「Enter desired result column」変数に設定します。
4. 「Retrieved column」を新しい変数に設定します。（例：「values」）


「Send an Email」アクションを構成する

1. 「Execute a query」アクションののち、「Send an email」アクションを追加し、クリックしてアクションを構成します。
2. 「Recipient email address」を設定します。
3. 「Subject」を設定します。
4. 「Message body」を取得したカラム用に作成された変数に設定します。


アクションを構成したら、「Save」をクリックしてワークフローに名前を付け、もう一度「Save」をクリックします。これで、SQL を使用してHarvest をクエリし、結果をメールで送信する単純なワークフローができました。

クラウドアプリケーションから直接数百種類のSaaS 、ビッグデータ、NoSQL データソースにリアルタイムアクセスする方法の詳細は、CData Connect AI を参照してください。無償トライアルにサインアップして、ご不明な点があればサポートチームにお問い合わせください。