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 スニペットコンテナ内に読み込まれます。
同様に、アプリケーションのページ自体を埋め込みコンテナ内に表示することもできます。
関連トピック
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho Campaigns Resources
Zoho WorkDrive Resources
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
Related Articles
zc_LoadInパラメーターの設定方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 zc_LoadIn ページパラメーターの詳細については、こちらをクリックしてください。 アプリコンポーネントをポップアップで開く アプリコンポーネントを HTML/iframe コンテナで開く アプリコンポーネントをポップアップで開くには 以下の手順に従って、ページ読み込み時に ...埋め込みフォームとレポートのスタイル別URL設定
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 このトピックでは、Zoho Creator のフォームとレポートの外観をカスタマイズするために使用できるパラメーターを一覧で紹介します。これらのパラメーターは、ページに埋め込んだフォームやレポートにも適用できます。 フォームのプロパティ 説明 パラメーター／値 ...HTMLスニペットの作成と管理
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 スニペットは、単体で利用できる再利用可能なコードで、追加の機能を実装するために使用します。HTML スニペットとは、HTML で記述されたコードの一部分です。これを使って、リスト表示、スタイルの異なるボタン、テキスト表示、カスタマイズした検索バーなど、さまざまな要素を作成できます。 ...Zoho Creator ウィジェットキット
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 1. このキットの目的 このキットは、既存の Figma デザインを利用して Zoho Creator でウィジェットを作成する際に役立つよう設計されています。Creator ...フォームへのデータメール送信の理解
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 フォームにメールまたは一行テキスト項目を追加します。その項目リンク名をZC_Fromに設定します。これはメールの差出人アドレスを取得するためです。 ...