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

加藤龍彦
デジタルマーケティング

CData Connect AI を使用してNintex Workflow Cloud からPostgreSQL に接続し、PostgreSQL のデータをリアルタイムで使用してカスタムワークフローを構築します。

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

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

Connect AI からPostgreSQL に接続する

CData Connect AI は直感的なクリック操作ベースのインターフェースを使ってデータソースに接続します。

Connect AI にログインし、 Add Connection をクリックします。
Add Connection パネルから「PostgreSQL」を選択します。
必要な認証情報を入力し、PostgreSQL に接続します。
PostgreSQL への接続には、Server、Port（デフォルトは5432）、Database、およびUser、Password のプロパティを設定します。Database プロパティが設定されない場合には、User のデフォルトデータベースに接続します。

パスワード方式によるSSH 接続

パスワード方式によるSSH接続時に必要なプロパティ一覧を以下に示します。
- User: PostgreSQL のユーザ
- Password: PostgreSQL のパスワード
- Database: PostgreSQL の接続先データベース
- Server: PostgreSQL のサーバー
- Port: PostgreSQL のポート
- UserSSH: "true"
- SSHAuthMode: "Password"
- SSHPort: SSH のポート
- SSHServer: SSH サーバー
- SSHUser: SSH ユーザー
- SSHPassword: SSH パスワード
接続文字列形式では以下のようになります。
```
User=admin;Password=adminpassword;Database=test;Server=postgresql-server;Port=5432;UseSSH=true;SSHPort=22;SSHServer=ssh-server;SSHUser=root;SSHPassword=sshpasswd;
```
公開鍵認証方式によるSSH 接続

公開鍵認証によるSSH接続時に必要なプロパティ一覧を以下に示します。
- User: PostgreSQL のユーザ
- Password: PostgreSQL のパスワード
- Database: PostgreSQL の接続先データベース
- Server: PostgreSQL のサーバー
- Port: PostgreSQL のポート
- UserSSH: "true"
- SSHAuthMode: "Public_Key"
- SSHClientCertType: キーストアの種類
- SSHPort: SSH のポート
- SSHServer: SSH サーバー
- SSHUser: SSH ユーザー
- SSHClientCert: 秘密鍵ファイルのパス
接続文字列形式では以下のようになります。
```
User=admin;Password=adminpassword;Database=test;Server=PostgreSQL-server;Port=5432;UseSSH=true;SSHClientCertType=PEMKEY_FILE;SSHPort=22;SSHServer=ssh-server;SSHUser=root;SSHClientCert=C:\Keys\key.pem;
```
Create & Test をクリックします。
Edit PostgreSQL Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

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

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

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

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

Nintex からPostgreSQL に接続する

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

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

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

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

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

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