データ接続は、ソリューションと、データベース、参照データ、ソリューション データなどの外部データ ソースとの間の接続です。データ接続を使用して、データのクエリと送信の両方を行うことができます。データ接続には 2 つの読み込みタイプがあります。
次のタイプのデータ接続を作成 (「追加」) できます。
- SQL Server
- OLEDB
- ODBC
- リファレンス データ
- ソリューション データ
- グループのユーザー
- LDAP クエリ
- SharePoint ライブラリまたはリスト
- EnterWorks リポジトリ
- Enterworks CodeSet
- REST API
クエリおよび/またはデータ送信を行うワークフローソリューションの場合、最初にデータ ソースに接続する必要があります。
すべてのデータ接続のタイプ (リファレンス データおよび EnterWorks データ接続以外) に対してフォーム フィールドを作成するには、データ接続名を右クリックしてから、[フォーム フィールドの作成] を選択します。
リファレンス データおよび EnterWorks データ接続用のフォーム フィールドを作成するには、[フィールド マッピングの作成] を選択します。このオプションを使用すると、フォームを介してデータを取得または保存する Get/Save 操作を使用できます。
フォーム ソリューションのデータ接続機能を使用して Evolve フォームにデータをダウンロードする場合、次のいずれかを行うことができます。
- フォームでのユーザー アクションに関するデータをダウンロードします。
- データ接続アダプター プラグインを使用して、バックグラウンドでデータをダウンロードします。
ソリューションでは、大量 (1000 件以上のレコード) のデータをフォームにダウンロードしない設計をお勧めします。このような大量のデータをフォームに保存すると、RAM または CPU のリソース使用率が高くなる可能性があります。これは、アプリケーションの他の機能に影響を与え、応答が遅くなったり、ジョブの処理が遅れたりする可能性があります。
たとえば、クエリの入力パラメータであるフォーム フィールドは、クエリが 1000 を超えるレコードを返さないように設定する必要があります。これを行うには、入力パラメータを必須にすることができます。REST API を使用していて、その API が任意のクエリまたはフィルタで返されるレコードの最大数をサポートしている場合 (OData API には通常カウントまたは $count パラメータ)、そのようなパラメータは、ソリューションの設計時に制限値 (1000 未満) で設定する必要があります。そのため、フォームのエンド ユーザーが意図せずに間違ったフィルターや入力を提供しても、何千ものレコードが返されないようにする必要があります。
データ接続の作成:
- データ接続では、フォームで使用されているフィールドのみを使用してください。たとえば、LDAP データ接続の場合、マネージャー フィールドがフォームにない場合は、データ接続を作成するときにマネージャー列を使用しないでください。
- 参加者リゾルバーのデータ接続を作成する場合は、[フォームを開いたときにデータを自動的に取得する] チェックボックスをオフにして [非同期] を選択します。LDAP データ接続を参加者リゾルバーとして使用する場合は、非同期データ接続をフィルタして作成し、[マネージャー] フィールドはチェックしないでください。これにより、参加者リゾルバーのパフォーマンスが向上します。
データ接続の編集:
データ接続がデータ接続ライブラリに追加されると、ソリューションで使用されていない 場合にのみデータ接続を編集できます。
SQL Server 、OLEDB、または ODBC データ接続を作成する
SQL Server 、OLEDB、または ODBC データ接続を作成するには、最初にアプリ (ローカル) またはグローバル レベルで接続を作成します。
ソリューションでデータ接続を作成するソリューション設計者は、グローバル レベルで作成された接続と、使用しているアプリのレベル (ローカル レベル) で作成された接続を確認できます。接続の作成方法の詳細については、「データベース接続の作成」を参照してください。
SQL Server 、OLEDB、または ODBC データ接続を作成するには、次の手順を実行します。
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[SQL Server] または [OLEDB] または [ODBC] を選択します。
- 接続ドロップダウン リストから接続を選択します。グローバル レベルおよびソリューションを作成しているアプリのレベルで作成されたすべての接続が表示されます。
- [テーブル] で、ドロップダウン矢印をクリックして、アクセスするテーブルを選択します。
- [列] で、アクセスする列のチェックボックスをオンにします。
- [並べ替え] で、[並べ替えフィールドの追加] をクリックします。データ接続の値を並べ替えるためのフィールドが追加されます。複数のフィールドで並べ替えを行うことができます。
- 並べ替え順序 (昇順または降順) を選択します。
- [OK] をクリックします。
リファレンス データのデータ接続を作成する
ソリューションでリファレンス データを使用するには、最初にデータ接続を作成します。リファレンス データのデータ接続を作成するには、ユーザー アプリまたはリファレンス データ アプリのいずれかでリファレンス データリストを作成します。
ソリューションでデータ接続を作成するソリューション設計者は、ユーザー アプリまたはリファレンス データ アプリ (ローカル レベル) で作成されたすべてのリファレンス データ リストを表示できます。リファレンス データを作成する方法の詳細については、「リファレンス データ」を参照してください。
リファレンス データのデータ接続を作成するには、次の手順を実行します。
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[リファレンス データ] を選択します。
- リファレンス データのソリューション名を選択します。グローバル レベルおよびリファレンス データ アプリ (ローカル レベル) で確立されたすべてのリファレンス データ リストが表示されます。
- [列] で、アクセスする列のチェックボックスをオンにします。
- [並べ替え] で、[並べ替えフィールドの追加] をクリックします。データ接続の値を並べ替えるためのフィールドが追加されます。複数のフィールドで並べ替えを行うことができます。
- 並べ替え順序 (昇順または降順) を選択します。
- [OK] をクリックします。
-
リファレンス データの列名を読み取る際に、フォームはすべての特殊文字を '_' として扱います。col-1 や col_1 問題が発生する可能性があるため、リファレンス データ スキーマを慎重に作成してください。
-
ドロップダウン フィールド フィルターで比較演算子 (より大きいなど) を使用し、右側に既定値が指定されていない場合、データ接続から完全なデータが返されます。「数値」タイプのフィールドの場合、空白の値は 0 と見なされ、それに応じてフィルター結果が表示されます。
-
管理アプリの操作ページを介してタスクからフォーム ソリューションを開く場合、データ接続を伴う機能 (PR、ドロップダウン、クエリ) はサポートされません。フォームは、アプリ レベルで定義された参照リストを利用します。
ソリューション データのデータ接続を作成する
ソリューションでソリューション データを使用するには、最初にデータ接続を作成します。ソリューション データのデータ接続を作成するには、アプリまたはグローバル レベルでソリューション データ リストを作成します。
ソリューションでデータ接続を作成するソリューション設計者は、グローバル レベルと使用しているアプリのレベル (ローカル レベル) で作成されたすべてのソリューション データ ライブラリを表示できます。
ソリューション データのデータ接続を作成するには、次の手順を実行します。
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[ソリューション データ] を選択します。
- ソリューション データ ライブラリ名を選択します。グローバル レベルおよびソリューションを作成しているアプリ内 (ローカル レベル) で確立されたすべてのソリューション データ ライブラリが表示されます。
- [列] で、アクセスする列のチェックボックスをオンにします。
- [並べ替え] で、[並べ替えフィールドの追加] をクリックします。データ接続の値を並べ替えるためのフィールドが追加されます。複数のフィールドで並べ替えを行うことができます。
- 並べ替え順序 (昇順または降順) を選択します。
- [OK] をクリックします。
グループのユーザーのデータ接続を作成する
任意のアプリの特定のユーザー グループを含むソリューションを作成するには、グループのユーザーのデータ接続を使用します。ソリューションでデータ接続を作成するソリューション設計者は、使用しているユーザー アプリからすべてのユーザー グループを表示できます。ユーザー グループの作成の詳細については、「 グループの管理」を参照してください。
グループのユーザーのデータ接続を作成するには、次の手順を実行します。
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[グループのユーザー] を選択します。
- [グループ名] ドロップダウン リストからグループの名前を選択します。ユーザー アプリ (ソリューションが作成されている内部) のすべての ユーザー グループが表示されます。
- [列] で、アクセスする列のチェックボックスをオンにします。
- [並べ替え] で、[並べ替えフィールドの追加] をクリックします。データ接続の値を並べ替えるためのフィールドが追加されます。複数のフィールドで並べ替えを行うことができます。
- 並べ替え順序 (昇順または降順) を選択します。
- [OK] をクリックします。
-
グループのユーザーのデータ接続 (非同期モード) では、ドロップダウンにデータを入力するときにフィルタが機能しません。
-
ユーザーが無効な IDP グループ データ接続を追加してソリューションを展開すると、実行時にエラーが受信されます。
-
エラーを回避するために、ユーザーは有効なグループ名を入力する必要があります。
-
[グループからのユーザー] タイプのデータ接続が [ルックアップ コントロール] で選択されている場合、生の where 句は無効になります。これはアップグレードされたソリューションに影響しますが、検索条件は引き続き編集可能です。
LDAP クエリ データ接続を作成する
LDAP クエリを使用すると、Active Directory 構造をクエリして、その構造をソリューションで使用できます。LDAP クエリ データ接続 を使用して、Active Directory ユーザーをソリューションに取り込みます。
LDAP クエリ データ接続を作成するには、次の手順を実行します。
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[LDAP クエリ] を選択します。
- [列] で、アクセスする列のチェックボックスをオンにします。
- [並べ替え] で、[並べ替えフィールドの追加] をクリックします。データ接続の値を並べ替えるためのフィールドが追加されます。複数のフィールドで並べ替えを行うことができます。
- 並べ替え順序 (昇順または降順) を選択します。
- [OK] をクリックします。
SharePoint ライブラリまたはリスト データ接続を作成する
SharePoint ライブラリまたはリスト データ接続を作成するには、次の手順を実行します。
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[SharePoint ライブラリまたはリスト] を選択します。
- [列] で、アクセスする列のチェックボックスをオンにします。
- [並べ替え] で、[並べ替えフィールドの追加] をクリックします。データ接続の値を並べ替えるためのフィールドが追加されます。複数のフィールドで並べ替えを行うことができます。
- 並べ替え順序 (昇順または降順) を選択します。
- [OK] をクリックします。
EnterWorks リポジトリ データ接続
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[EnterWorks リポジトリ] を選択します。
- [接続] で、EnterWorks タイプのデータベース接続の参照を選択します。
- [リポジトリ] で、上記の接続を使用してフェッチしたリポジトリから目的のリポジトリを選択します。
- [ユーザー設定]で、上記のリポジトリで定義されているすべての設定から設定を選択します。
- [保存されたセット]で、値を選択して追加します。
- [保存された検索]で、値を選択して追加します。
- [列] で、リポジトリで使用可能な属性のリストから属性を選択します。ここで選択した属性のみがデータ セットの一部になります。
- [OK] をクリックします。
EnterWorks CodeSet データ接続を作成する
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[EnterWorks コード セット] を選択します。
- [接続] で、EnterWorks タイプのデータベース接続の参照を選択します。
- [EnterWorksコード セット] で、EnterWorks で使用可能なコード セットを選択します。
- [列] で、コード セットで使用可能な属性のリストから属性を選択します。コードはコード セット アイテムの値であり、説明 はコード セットアイテムの説明です。
- [OK] をクリックします。
REST API データ接続を作成する
- ユーザー アプリを開きます。
- [ソリューション] ページに移動します。
- ソリューションを選択し、[ソリューションの編集] をクリックします。これにより、ソリューション デザイナー / コンポーザーが開きます。
- Composer のリボンで、[ソリューション] タブをクリックし、[データ接続の追加] をクリックします。
- [名前]に、接続のわかりやすい名前を入力します。
- [タイプ] で、ドロップダウン矢印をクリックし、[REST API] を選択します。
- [接続] で、使用可能な REST API 接続から選択します。
- デフォルトでは、データ接続の作成時に定義されたベース API URL が表示されます。特定のエンドポイントからデータを取得するには、要件に従ってこの URL を構成します。
- [HTTP 操作] で、現在の API 接続の使用に従って値を選択します。REST API は、HTTP 動詞を使用してリクエスト タイプを指定します。つまり、読み取り / 更新 / 削除または作成です。
- [API 入力スキーマ] で、[参照] をクリックし、 [ファイル] から、または [テキスト] フィールドに直接コピーして JSON スキーマを入力します。入力スキーマは、API に送信されるデータ用です (つまり、JSON のリクエスト ペイロードです)。
- [API 出力スキーマ] で、[参照] をクリックし、 [ファイル] から、または [テキスト] フィールドに直接コピーして JSON スキーマを入力します。出力スキーマは、API から受信するデータ用です (つまり、JSON のレスポンス ペイロードです)。
- [API エラー スキーマ] で、[参照] をクリックし、 [ファイル] から、または [テキスト] フィールドに直接コピーして JSON スキーマを入力します。
- [リクエスト ヘッダー] で、API 仕様に従って、予想されるリクエスト ヘッダーをキーと値のペアで指定します。
- [レスポンス ヘッダー] で、API 仕様に従って、予想されるレスポンス ヘッダーをキーと値のペアで指定します。
- [OK] をクリックします。
新しい REST API データ接続の作成中に、データ接続の名前は自動入力されません。
REST API タイプのデータ接続の詳細については、「REST API データ接続」 を参照してください。REST API 統合の例については、「Salesforce 統合」と「SAP S4 HANA 統合」を参照してください。
読み込みタイプ
データ接続には 2 つの読み込みタイプがあります。読み込みタイプを選択するには、[フォームを開いたときにデータを自動的に取得する] チェックボックスを使用します。チェックボックスをオンにすると、読み込みタイプが 同期に設定されます。チェックボックスをオフのままにすると、読み込みタイプを 非同期に設定します。
- 非同期 (async) 読み込みでは、データ接続に依存するドロップダウン リスト (または同様の要素) を実装するまでデータ接続が呼び出されないため、フォームのブラウザでの読み込みが速くなります。async ではデータ セット全体を読み込む必要があるため、データ接続でフィルタリングする要素では機能しないことに注意してください。
- 同期 (sync) 読み込みは、フォームがブラウザに読み込まれる処理の一部としてデータ接続データ セットを読み込みます。これにより、フォームの起動が遅れる場合があります。ただし、適切にインデックス付けされた SQL Server テーブルを使用すると、読み込みの遅延をごくわずかな時間に短縮できます。
データ ソース全体がフィルタリングされずに使用されることがわかっている 場合は、[フォームを開いたときにデータを自動的に読み込む] チェックボックスをオフにします。
既知の制約
〆 などの制限された文字を含む列名は、タイプ SQL 、ODBC、OLEDB の Composer データ接続ではサポートされていません。
フォーム XML 生成で問題を引き起こす可能性のある文字もサポートされていない可能性があります。
こういったデータ接続が追加されると、フォームの起動時にエラーがスローされます。