- 日付と数値の形式
ISO と Ticks のみ (つまり Microsoft JSON 日付形式) がサポートされています。例: Ticks: / Date(1492041600000)/、ISO: “2021-04-13T14:48:00.000Z”。また、UTC 日付値のみが読み取られ、フォーム フィールドに設定されます。日付値にオフセットが定義されている場合は、UTC 日付値を取得するように調整されます。単純な数値の場合、1000 区切り文字を使用せず、小数点記号としてドットを使用する形式、つまり 1345612.45。
-
ドロップダウン、クエリ コントロール、ルックアップ コントロール、参加者クエリ、データ接続をクエリするルールに対する REST API のサポート:
-
コントロールとして、ドロップダウン、クエリ コントロール、ルックアップ コントロール、参加者クエリ、およびクエリ データ接続のルールは表形式のデータのみをサポートするため、REST API でこれらの機能を使用することは、データをテーブル形式に変換できる場合にのみサポートされます。また、ネストされた構造からのデータ (つまり、テーブル内のテーブルまたは配列の配列など) はサポートされていません。例:
[{ "id": "int", "name": "string", "productType": "string", "sizes": ["string"] "otherDetails": { "colors": ["string"], "versions": ["int"] }, "Plant":[{ "PlantNo":"string", "PlantName":"string" }]}]
このペイロードでは、プロパティ「id」、「name」、および「productType」のみを管状構造に変換でき、上記のコントロールで使用することもできます。
ネストされた配列 (単一のフィールド タイプの配列または「複数のフィールド」 / 複合型) は、上記のコントロールではサポートされていません。
-
ルックアップ コントロール フィルターの動作
-
ルックアップ コントロール: 検索フィルターのプロパティ (つまり検索列、検索操作、検索キー フィールド) はサポートされていません。
-
ルックアップ コントロール: Where 句: 繰り返しテーブル フィールドはコンマ区切りの値に置き換えられ、その API 実行に対してフィルターが実行されます。したがって、クエリまたは URL は、列内の値はすべてコンマで区切られます。現在の行データに対してのみルックアップ コントロールを実行することはサポートされていません。したがって、ルックアップ コントロールは現在の行の (つまり、URL に現在の行テーブルのフィールドがある場合) データを取得できません。
-
-
これらのコントロールでは、Get 操作を使用した REST API 接続のみがサポートされています。
[ルックアップ コントロール] の次のフィールドは、Rest API データ接続には関係ありません。
-
テーブル
-
検索列
-
検索処理
-
検索キー フィールド
-
最小検索キー サイズ
-
自動ワイルド カード終了
-
自動ワイルド カード開始
-
Where 句 --> 他のデータ接続と同様、URL ビルダーのフィールドのフォーム フィールド/ソリューション フィールド (サポートされていません)
-
生のクエリ (クエリ コントロールの場合は関係ありません)
-
-
ドロップ ダウンによる URL 編集のサポート
-
API URL のフォーム フィールドで定義されている非同期 REST API データ接続 (つまり「フォームを開いたときにデータを自動的に取得する」チェックボックスがオフになっている) は、ドロップダウンで使用すると機能しません。別の方法として、URL 部分をドロップダウンのフィルターで定義する必要があります。この制限は、データ接続の URL にフォームフィールドがある場合にのみ存在します。すべての非反復フィールドは API URL での定義がサポートされています。また、ドロップダウンが反復テーブルに追加されると、すべての非反復フォーム フィールドと現在の行フィールドがサポートされます。
-
同期 REST API データ接続 (つまり「フォームを開いたときにデータを自動的に取得する」チェックボックスがオンになっている): API URLのフォーム フィールドで定義され、ドロップダウンで区切られた REST API データ接続。非反復フォーム フィールドのみがサポートされます (つまり、繰り返しテーブルまたはセクションにないフィールド)。また、データ接続の同期動作については、フォームの読み込み時に実行されるため、「サーバーに保存されたフォームの値」または「新しいフォームのデフォルト値」が API URL の代わりに使用されます。
-
コントロール フィルターにデータが指定されていない場合、アプリケーションは、ソリューションの REST API データ接続に保存されている完全な REST API URL を考慮します。
-
-
API ペイロード (入力/出力/エラー): すべての反復要素
反復/配列内のすべての反復/配列タイプのプロパティを持つ API ペイロード (すなわち反復テーブルにはすべて繰り返しテーブルのみがあり、単純なプロパティはない) はサポートされていません。以下に例を示します。
[{ "sizes": ["string"], "codes": ["int"], "listedDates": ["date"], "results": [{ "countryCode": "string", "city": "string", "address": "string" }]}]
注: 上記の例では、ルートの最初のテーブルにプロパティ「sizes」、「codes」、「listedDates」、「results」があり、これらはすべて配列またはテーブル タイプであり、このようなスキーマはまだサポートされていません。 -
API サーバーへの入力ペイロード/「データのプッシュ」 (つまり転記、配置、パッチなど)
配列または複数のレコードの入力を受け取る API (つまり、配列または複数のデータを受け取ることができる入力ペイロード) もサポートされています。次に例を示します。
[{ "id": "int", "name": "string", "productType": "string","price": "decimal" }]
{ "products":[{ "id": "int", "name": "string", "productType": "string", "price": "decimal" }]}
[{ "id": "int", "name": "string", "productType": "string","price": "decimal", "to_Description": { "results": [{ "language": "string", "description": "string" }]}}]
また、単一レコードで、スキーマの後半に反復または配列型のデータがある以下の例もサポートされています。
{ "id": "int", "name": "string", "to_Description": { "results": [{ "language": "string", "description": "string" }]}, "to_Plant":{ "results": [{ "PlantName":"string", "to_location":{ "results":[{ "locationName":"string", "field2":"string" }]}}]}}
-
以下の文字を含むフィールド名はサポートされていません
-
ドット文字すなわち「.」フィールド名にドットが含まれているフィールド (field3.test など) はサポートされていません。
-
かっこ文字、( または ) など。たとえば、「Product(description」または「Product(description)」はサポートされていません。
-
-
Web サービスまたはデータ接続アダプター プラグイン: 実行
-
フォーム フィールドの作成: [反復セクションの生成] がオフになっている: API の URL に反復スキーマのフォーム フィールド (テーブルのフォーム フィールド) が含まれている REST API データ接続は、Web サービス コントロールまたはデータ接続アダプタープラグインで実行すると機能しないか、サポートされません。
-
フォームフィールドの作成: [反復セクションの生成] がオンになっている:
-
現在の行フィールドのみ (つまりこのデータ接続でマップされた、allow_run フィールドを持つ繰り返しテーブル) は API の URL でサポートされており、他のフィールド値は置き換えられません。
-
REST API データ接続のリクエスト / 応答ヘッダーは、現在の行の反復テーブル フォーム フィールドにマップする必要があります。他のフォーム フィールド (非反復) または反復しテーブルの現在の行の一部ではないフィールドの場合、機能しません。
-
-
-
API ペイロードとフィールド マッピング (フォーム フィールドの生成)
-
異なる API データ接続に同じグループ名をマッピングすることはお勧めしません。ユーザーは、既存のフォーム フィールドをさまざまな REST API 接続にマップすることを選択できます。たとえば、2 つの REST API を追加し、同じフォーム フィールド グループの下にフォーム フィールドを作成する以下のユース ケースは機能しません。
以下のようなスキーマを持つ 1st Rest API 接続 (GET) を作成します (つまり、単一のデータ レコード)
{ "f1": "string", "grp1": { "grp2": [ {"f2": "int"}]} }
次のようなスキーマを持つ 2 番目の Rest API 接続 (GET) を作成します (つまり、上記の 1 番目の Rest API スキーマの複数のレコード)。
[{ "f1": "string", "grp1": { "grp2": [ {"f2": "int"}]} }]
-
-
API ペイロードとフィールド マッピング (フォーム フィールドの生成)
Composer- Rest API データ接続はプラグイン → 関数 → データ接続ではサポートされていません
-
繰り返しテーブルと同様に、REST API では 2 レベルのネストのみがサポートされています。
-
REST API では、応答ヘッダーのみがサポートされています。Content-Type ヘッダーは、応答コンテンツ ヘッダーであるため、サポートされていません。