1. データソースの作成
1.1 データソースの作成方法
「追加」ボタンをクリックして、新しいデータソースの作成を開始します。作成可能なデータソースは3種類あり、作成時に選択できます。作成後にタイプを切り替えることはできません。- 変数:ローカル変数
- リモートリクエスト:サーバーサイド API から取得するデータ
- パラメータデータソース:システムがデフォルトで渡すデータソースで、現在の url に含まれるパラメータを取得するために使用します。例えば url が a.html?key1=value1&key2=value2 の場合、パラメータデータソースの値は以下のようになります。
1.2 変数データソース
変数データソースは通常、設定項目(リモート API プレフィックス apiUrlPrefix など)やページの一時変数などの保存に使用されます。string、object、array、Number、bool など、すべての JS データ型に対応しています。1.3 リモートリクエスト
API レスポンスのデータ形式 リモートデータソースには、データ形式に関するいくつかの必須の制約があります。- GET
- POST
- JSONP(この方式はサーバーサイドでの対応が必要です)
1.4 自動読み込み
「自動読み込み」を有効にしたデータソースは、ページのレンダリング前にリモート API へリクエストを送信します。自動読み込みのすべてのデータソースの読み込みが完了した後に、ページのレンダリングが開始されます。通常、ページの初期データ読み込みに使用します。 注意:「自動読み込み」のデータソースが多すぎるとページのレンダリング時間が長くなります。乱用しないでください。1.5 読み込み方式(先に「自動読み込み」オプションをオンにする必要があります)
シリアル:すべてのシリアルデータソースは、上から下へ順に実行されます。依存関係がある場合は、依存されるデータソースを先に配置する必要があります。 パラレル:すべてのパラレルデータソースは同時に実行されます。 リクエストによるページレンダリングのブロックを避けるため自動読み込みを選択したくないが、シリアル読み込みを実現したい場合は、現時点では「ページ読み込み完了時」関数内で手動でデータソースの読み込みをトリガーする方法があります。コード例:最初のリモートデータソースリクエストをトリガーし、リクエストが返された後に2番目のリモートデータソースリクエストをトリガーします。1.6 リクエストの可否
真偽値を渡して、このリクエストを送信するかどうかを判定できます。この入力フィールドは変数式にも対応しており、リクエストを送信する必要があるかどうかを判定できます。1.7 willFetch
リクエスト前処理関数。willFetch を使用すると、リクエストを送信する前に各種リクエストパラメータを変更できます。コード例:1.8 fit
リクエスト戻り時のデータアダプター。fit を使用すると、リクエストの生のレスポンスを変更して、対応するデータリクエスト形式に適合させることができます。コード例:1.9 didFetch
リクエスト完了コールバック関数。didFetch を使用すると、受信したデータを変更できます。fit と異なり、API から返される success が true の場合にのみ実行されます。コード例:1.10 onError
リクエストエラーハンドリング関数。onError はリモートデータソースの API エラーをキャッチするために使用されます。API から返される success が false の場合に実行されます。コード例:1.11 デフォルトデータ
デフォルトデータは通常、ファーストスクリーンのレンダリングシーンで使用されます。リモートデータソースのリクエストがまだ返っていない際に、初期のデフォルト値を提供します。注意:デフォルトデータのデータ形式は didFetch 層で返されるデータ形式であり、直接バインドして使用できます。1.12 コネクタデータソース NEW
コネクタデータソースでは、コネクタをデータソースとして使用でき、システム間・Webページ間のクロスオリジンや認証の制限を突破することを目的としています。詳細はドキュメント カスタムデータコネクタを使用してクロスオリジン問題を解決する をご参照ください。2. データソースの使用
2.1 コンポーネント内でのバインド
YiDA コンポーネントの属性設定パネルでは、属性に変数をバインドすることで動的な効果を実現できます。方法は以下の通りです。- 変数をサポートするすべての属性には、下図のアイコンがあります。アイコンをクリックすると「変数バインドパネル」が開きます。
- 「変数バインドパネル」は以下の種類の変数のバインドに対応しており、クリックするだけで直接使用できます。
2.2 開発者センター Trial 体験
- このリンクをクリックしてお試しください
3. FAQ
3.1 データソースリクエスト後にデータがない場合
以下をご確認ください。- API パスと HTTP メソッドが正しいか。
- デフォルトリクエストが有効になっている、または手動呼び出しが有効化されているか。
- リクエスト対象の API サービスをホストするサーバーにアクセスホワイトリストの制限がないか。
- 入力パラメータの形式が誤っていないか。
- API が www.yidaapps.com からのクロスオリジンアクセスに対応しているか。
- API が https で、証明書が「安全」となっているか。
3.2 トラブルシューティング手順
- データソースの読み込み方式が手動読み込みか自動読み込みかを確認します。手動読み込みの場合は、データソース読み込みのコード箇所にブレークポイントを設定してデバッグします。
- ページをプレビュー/アクセスします。
- ブラウザのコンソールを開きます。
- データソースの読み込みをトリガーします。
- コンソール内の該当リクエスト情報を確認し、トラブルシューティングを行います。
3.3 YiDA プラットフォーム API 呼び出し時に 307 エラーが発生する場合
社内でセカンドレベルドメインが有効化されているかご確認ください。セカンドレベルドメインが有効化されている場合は、API のアクセスアドレスをwww.yidaapps.com/... から相対アドレス /dingtalk/web/APP_X1X2X3X4/v1/process/startInstance.json に変更することで、このエラーを回避できます。