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

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

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

Connect AI からCosmos DB に接続する

1. Connect AI にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「Cosmos DB」を選択します。
3. 必要な認証情報を入力し、Cosmos DB に接続します。

   CosmosDB 接続プロパティの取得・設定方法

   SQL API を使ってCosmos DB アカウントに接続するために必要な接続文字列を取得するには、Azure Portal にログインして「Azure Cosmos DB」を選択し、自分のアカウントを選択します。「Settings」セクションで、「Connection String」をクリックして次の値を設定します。

   • AccountEndpoint：この値は、Cosmos DB アカウントの「Keys」ブレードからのCosmos DB アカウントURL に設定してください。
   • AccountKey：Azure ポータルで、Cosmos DB サービスに移動してAzure Cosmos DB アカウントを選択します。リソースメニューから、 「Keys」ページに移動します。「PRIMARY KEY」値を見つけ、Token をこの値に設定します。
   
4. Create & Test をクリックします。
5. Edit Cosmos DB Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

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

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

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

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

Nintex からCosmos DB に接続する

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

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

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

CData Connect AI への接続が構成され、Cosmos DB にアクセスする単純なワークフローを作成する準備ができました。まずは、「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 を使用してCosmos DB をクエリし、結果をメールで送信する単純なワークフローができました。

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