zc_LoadInパラメーターの理解
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
パラメーターとは、クエリ文字列としてページ URL に付加される名前付きの値です。 この URL 形式により、ブラウザーの更新や再読み込みを行ってもデータが保持され、ページの読み込み時に動的な値を設定できます。 Creator では、ページパラメーターを設定してページに値を渡し（関数に引数を渡すのと同様）、ページ内の各種要素（パネル、チャート、ゲージ、フォーム、レポートなど）に、目的の結果を表示できます。通常、パラメーターが渡されるたびにページ全体が読み込まれ、結果が表示されます。ただし、ページを再読み込みせずに、同じページ上の特定のコンテナー内に Creator コンポーネントを読み込みたい場合があります。 zc_LoadIn ページパラメーターを使用すると、Creator アプリケーションのコンポーネント（フォーム、レポート、ページ）を、ポップアップウィンドウとして、または埋め込みコンテナー内に、同じウィンドウで開くことができます。 また、名前を <div> コンテナーに指定し、他のページ要素（ボタンなど）から参照として使用することもできます。
注意事項
- Creator アプリケーションのコンポーネントは、HTML 埋め込みとiframe 埋め込みの両方で読み込むことができます。これらはコンポーネントを保持するコンテナーとして機能し、ページで設定したアクションが実行されたときにコンポーネント（Creator コンポーネント）を読み込みます。
- div 埋め込みコンテナーには名前を指定する必要があります。この名前には英数字とアンダースコアのみを使用できます。
- div コンテナーの名前は、埋め込み/iframe コンテナーのname 属性に指定する必要があります。以下は、myformが div コンテナーの名前であるサンプルコードです。
<div 名前='myform' elName='zc-component' formLinkName='Development_Tracking' params='zc_Header=無効&zc_SuccMsg=Data Added Successfully!&zc_SubmitVal=送信する&zc_ResetVal=リセットする'>読み込み中 Form...</div> - zc_LoadInパラメーターは、ハッシュ(#) に付加された Creator コンポーネントの URL でのみ機能します。たとえば、ページの読み込み時にフォームをポップアップで開きたい場合は、次の形式でフォーム URL を指定する必要があります。openUrl('#Form:Order_Details?zc_LoadIn=dialog', 'same window');
メモ: - Creator コンポーネントの URL をハッシュ部分に指定すると、zc_LoadIn パラメーターは、ハッシュの後にある前のコンポーネントを置き換えて、指定したコンポーネントを読み込みます。上記の URL では、zc_LoadIn を使用して、Order_Details フォームの代わりにレポート（#Report:All_Orders）を読み込むことができます。
- Creator コンポーネントの完全な URL や、www.zoho.com(または) www.google.comなどの外部 URL を指定した場合でも、zc_LoadIn パラメーターは現在の URL を置き換えて指定した URL を読み込みます。ただし、想定される動作は実行されません。つまり、zc_LoadIn=dialogの場合はポップアップは開かれず、zc_LoadIn=embed-<container 名前>の場合は、指定した埋め込みコンテナー内にコンポーネントは読み込まれません。
- また、ハッシュに付加した URL を指定することで、他の Creator アプリケーションコンポーネント（フォーム、レポート、ページ）を現在のページ内に読み込むこともできます。
- この場合でも、別のアプリケーションのコンポーネントの完全な URL を使用した場合は、現在のページの URL は、そのコンポーネントの URL に置き換えられます。
- div コンテナーの名前は、openUrl()タスク内で指定するか、HTML/iframe 埋め込み内の href タグで使用できます。
- zc_LoadInパラメーターは、次のボタン要素のアクションでも設定できます：URL を開く、フォームを開く、レポートを開く、ページを開く。
- コンポーネントをコンテナー内に読み込みたいにもかかわらず、ページ内に必要なコンテナーが存在しない場合は、URL は新しいタブで開かれます。たとえば、zc_LoadInパラメーターをボタンアクションとして設定しているものの、そのパラメーターを使用しているページにコンテナーがない場合、URL は新しいタブで開かれます。
- 同じ div コンテナー名を、複数の HTML/iframe 埋め込み、または HTML 埋め込みと iframe 埋め込みの両方で使用している場合、指定したコンテンツは、そのコンテナー名が最初に指定されている HTML 埋め込みコンテナーにのみ読み込まれます。
構文
zc_LoadIn パラメーターは、openUrl()タスクとhrefリンクの両方で使用できます。設定したパラメーターは、その後パネルアクションで使用できます。
メモ: 以下の表では、次の項目を例として使用しています。
- Order_Detailsはフォームの名前です。
- same windowはウィンドウの種類です。
- orderFormDiv は div コンテナーの名前です。
openUrl の構文
|
開き方
|
構文
|
構文の作成
（コンポーネントを読み込むコンテナーの作成）
|
URL での使用
|
パネルアクションでの使用
|
|
ポップアップ/ダイアログ
|
zc_LoadIn=dialog
|
該当なし（コンテナーへの依存なし）
|
openUrl('#Form:Order_Details?zc_LoadIn=dialog','same window');
|
フォーム/レポート/ページを開くアクション：zc_LoadIn=dialog
|
|
埋め込みコンテナー
|
zc_LoadIn=embed-<container 名前>
|
<div 名前='orderFormDiv' formLinkName='Order_Details' params=''></div>
|
openUrl('#Form:Product_Details?zc_LoadIn=embed-orderFormDiv','same window');
|
フォーム/レポート/ページを開くアクション：zc_LoadIn=embed-orderFormDiv
|
|
Iframe
|
zc_LoadIn=embed-<iframe 名前>
|
<iframe src='order_Details' 名前='orderFormDiv'></iframe>
|
openUrl('#Form:Product_Details?zc_LoadIn=embed-orderFormDiv','same window');
|
フォーム/レポート/ページを開くアクション：zc_LoadIn=embed-orderFormFrame
|
href の構文
|
開く方法
|
構文
|
構文の作成（コンポーネントを読み込むコンテナの作成）
|
例
|
|
ポップアップ／ダイアログ
|
zc_LoadIn=dialog
|
該当なし
|
<a href='#Form:Order_Details?zc_LoadIn=dialog'></a> |
|
埋め込みコンテナ
|
zc_LoadIn=embed-<コンテナ名>
|
<div 名前='orderFormDiv' formLinkName='Order_Details' params=''></div>
|
<a href='#Form:Order_Details?zc_LoadIn=embed-OrderFormDiv&zcHeader=真'></a>
|
|
iframe
|
zc_LoadIn=embed-<iframe 名>
|
<iframe src='<コンポーネントの埋め込みURL>' 名前='orderFormDiv'></iframe>
|
想定される動作
|
開く方法 |
項目の種類 |
動作 |
|
ポップアップ／ダイアログ |
フォーム、レポート、ページなどの Creator コンポーネント |
コンポーネントをポップアップウィンドウで開きます。 |
|
公開 URL |
URL を同じウィンドウで開き、現在の（親）URL を置き換えます。ただし、想定されている操作は実行されません。つまり、ポップアップは開きません。 |
|
|
埋め込みコンテナ
|
フォーム、レポート、ページなどの Creator コンポーネント |
指定した埋め込みコンテナ内でコンポーネントを開きます。 |
|
公開 URL |
URL を同じウィンドウで開き、現在の（親）URL を置き換えます。ただし、想定されている操作は実行されません。つまり、コンポーネントは指定した埋め込みコンテナ内には読み込まれません。 |
|
|
iframe |
フォーム、レポート、ページなどの Creator コンポーネント |
指定した iframe 内でコンポーネントを開きます。 |
|
公開 URL |
URL を同じウィンドウで開き、現在の（親）URL を置き換えます。ただし、想定されている操作は実行されません。つまり、コンポーネントは指定した埋め込みコンテナ内には読み込まれません。 |
ポップアップで開く（zc_LoadIn=dialog）
このクエリパラメーターを使用すると、Creator アプリのコンポーネントをポップアップウィンドウで読み込むことができます。ページ内でフォームやレポート、ページなどのアプリコンポーネントをポップアップとして開き、ユーザーエクスペリエンスを向上させてデータ入力をしやすくしたい場合に使用します。
例
Hospitality Management というアプリを作成し、その中にダッシュボードというページを作成したとします。Complaints を追加フォームをHTML スニペットとして埋め込み、3 つのボタン（Water Complaint、Food Complaint、Restroom Complaint）を含むパネルを追加し、それぞれのボタンの操作で対応する苦情フォームがポップアップで開くように設定します。これは、各ボタンのクエリパラメーターにzc_LoadIn=dialog パラメーターを指定することで実現します。
公開済みアプリでページにアクセスすると、Water Complaint、Food Complaint、Restroom Complaint のいずれかのボタンをクリックすると、それぞれの苦情フォームがポップアップウィンドウで読み込まれます。必要な詳細を入力してフォームを送信できます。この例の手順についてはこちらを参照してください。
埋め込みコンテナで開く（zc_LoadIn=embed-<component_name>）
このクエリパラメーターを使用すると、ページを再読み込みせずに、同じウィンドウ内の任意の埋め込みコンテナにアプリコンポーネントを読み込むことができます。div 埋め込みコンテナに名前を付けておき、他の場所からその名前で参照できます。Creator アプリケーションのコンポーネントは、HTML 埋め込みとiframe 埋め込みの両方で読み込むことができます。
Creator コンポーネントを使用する場合、iframe 埋め込みは HTML 埋め込みと同様に動作します。外部 URL を指定した場合は、そのリソースは現在の URL を置き換えて、指定したウィンドウで開かれます。
フォームを開く操作を使用する
例として、Hospitality Management というアプリを作成し、その中に ダッシュボード というページを作成したとします。HTML スニペット内に Complaints を追加 フォームを埋め込み、さらに 3 つのボタン（Water Complaint、Food Complaint、Restroom Complaint）を含むパネルを追加し、それぞれのボタンの操作で、対応する苦情フォームが HTML スニペット内で開くように設定します。これは、ボタンのクエリパラメーターで埋め込みコンテナの名前を参照することで実現します。
公開済みアプリでページにアクセスすると、HTML スニペットコンテナ内に Complaints を追加 フォームが表示されます。ユーザーは Water Complaint、Food Complaint、Restroom Complaint のいずれかのボタンをクリックすると、それぞれの苦情フォームが HTML スニペットコンテナ内に読み込まれます。
レポートを開く操作を使用する
レポートでは、検索はデータ内の個々の項目に基づいて行われます。カスタムフィルターを使用して検索結果を絞り込むことができます。ただし、これらのカスタムフィルターは、現在のページを再読み込みすることなく、同じレポートのフィルター済みバージョンを表示します。同じレポートのフィルター結果を動的に表示したい場合は、zc_LoadIn クエリパラメーターを使用して、ページを再読み込みせずに、同じウィンドウ内の任意の埋め込みコンテナにアプリケーションのレポートを読み込むことができます。
例として、Hospitality Management というアプリを作成し、その中に ダッシュボード というページを作成したとします。このアプリには Complaints を追加 フォームがあり、その中に Complaint 種類 というドロップダウン項目があり、選択肢として Water、Food、Restroom の 3 つが設定されているとします。Complaint 詳細 レポートを HTML スニペット に埋め込み、選択された Complaint 種類 に基づいてデータを絞り込むフィルターを追加します。さらに、3 つのボタン（Water Complaint、Food Complaint、Restroom Complaint）を含むパネルを追加し、各ボタンについては前述の例と同様の設定を行います。
公開済みアプリで ダッシュボード ページにアクセスすると、HTML スニペットコンテナ内に Complaint 詳細 レポートが表示されます。ユーザーが Water Complaint、Food Complaint、Restroom Complaint のいずれかのボタンをクリックすると、それぞれの苦情の詳細が HTML スニペットコンテナ内に読み込まれます。
同様に、アプリケーションのページ自体を埋め込みコンテナ内に表示することもできます。