機能別URL
概要
「Zoho CreatorのURLパターン」では、Zoho Creatorアプリケーション、およびそのフォーム、レポート、ページにアクセスするための標準URLについて説明しました。ここでは、フォーム項目の初期値の設定、URLでデータIDを渡して個々のデータを編集、レポートの条件設定、レポートやページの印刷を行うための機能別URLについて説明します。
すべてのURL形式で、次の値を使用します。
| <base_url> | CreatorアカウントのベースURL たとえば、アカウントがZohoの米国データセンターに属する場合はcreatorapp.zoho.com、EUデータセンターに属する場合はcreatorapp.zoho.euです。 |
| <account_owner_name> | アプリケーションが存在するCreatorアカウントの所有者のユーザー名 |
| <app_link_name> | Zoho Creatorアプリケーションのリンク名 |
|
<form_link_name> |
各コンポーネント（フォーム、レポート、ページ）のリンク名 |
フォーム、レポート、ページのパーマリンク
Zoho Creatorアプリケーション内のコンポーネント（フォーム、レポート、ページ）には、パーマリンクを使用してアクセスすることもできます。パーマリンクとは、特定のWebページ（こちらではフォーム、レポート、ページ）を示す、永続的なURLです。
アプリケーションの各コンポーネントのパーマリンク形式は、次のとおりです。
| フォームのパーマリンク |
次の形式を使用すると、フォームをWebサイトやブログなどに埋め込むことができます。 |
| レポートのパーマリンク |
次の形式を使用すると、レポートをWebサイトやブログなどに埋め込むことができます。 |
| ページのパーマリンク |
次の形式を使用すると、ページをWebサイトやブログなどに埋め込むことができます。 |
フォーム用の機能別URL
フォーム項目の初期値を設定するには
フォームのURLに追加パラメーターを渡すことで、フォーム項目の初期値を設定できます。たとえば、従業員管理アプリケーションの［従業員ID］項目に値を自動入力するには、フォームのURLで初期値をクエリー文字列（Employee_ID=1234）として渡します。Employee_IDは、従業員フォーム内の項目のDelugeスクリプト名です。
クエリー文字列を含むフォームのURL形式は、次のとおりです。
- アプリケーション内からアクセスする場合：
https://creatorapp.zoho.com/zchelp/employee-manager/#Form:Employee?Employee_ID=1234 - パーマリンクからアクセスする場合：
https://creatorapp.zoho.com/zchelp/employee-manager/form-perma/Employee?Employee_ID=1234 - 別のWebページに埋め込まれたフォームにアクセスする場合：
https://creatorapp.zoho.com/zchelp/employee-manager/form-embed/Employee?Employee_ID=1234
複数選択項目とチェックボックス項目では、複数の値を設定する場合があります。この場合、URL内の値をコンマで区切る必要があります。たとえば、従業員フォームの［役割］項目に「マネージャー」と「プログラマー」を設定する場合、URLは次のようになります。https://creatorapp.zoho.com/zchelp/employee-manager/#Form:Employee?Roles=Manager,Programmer
項目にフォーカスせずにフォームを読み込むには
Zoho Creatorアプリケーション内のフォームにアクセスすると、フォームの最初の項目にフォーカスが設定され、その項目にカーソルが表示されます。
フォームを埋め込んだWebサイトやブログがあるとします。ユーザーがWebページにアクセスすると、初期設定のオートフォーカス動作により、フォームが配置されている位置までページがスクロールします。その結果、埋め込みフォームより上にあるコンテンツがスキップされ、ユーザーの利便性が損なわれる可能性があります。これを防ぐため、Zoho Creatorではzc_Focusパラメーターを使用できます。
| zc_Focusの値 | 動作 |
| true |
|
| false |
|
URLでデータIDを渡して個別のデータを編集するには
データIDを使用して個別のデータを表示、編集するためのURLを以下に示します。このURLを使用すると、Zoho Creatorのフォームが編集モードで表示されます。
詳細については、データIDを使用したデータの編集を参照してください。
別のURLにリダイレクトするには
レポートの機能別URL
データを詳細表示するには
レポートに表示されるデータを絞り込むには
レポートのURLにフィルター条件をクエリー文字列として設定すると、レポートに表示されるデータを絞り込むことができます。複数の条件による絞り込みにも対応しています。2つの項目と値のペアは、アンパサンド（&）で区切ります。以下は、Employee ManagerアプリケーションのEmployee Viewレポートを絞り込む例です。このレポートのURLは次のとおりです。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View
EQUALS演算子を使用してレポートを絞り込む場合のURL形式
ここで、FieldName1とFieldName2は、フォーム内の項目のリンク名です
例：
- 従業員名がDaniel（Name=Daniel）のデータのみをこのレポートに表示するURL：
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Name=Daniel - 従業員IDが2466（Employee_ID=2466）のデータのみをこのレポートに表示するURL：
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Employee_ID=2466 - 入社日が13-May-2019（Date_of_Joining=13-May-2019）の従業員データのみをこのレポートに表示するURL：
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining=13-May-2019
メモ：こちらの日付「13-May-2019」は、このEmployee Managerアプリケーションの［設定］で指定されている日付形式に従っています。レポートのURLにクエリー文字列として追加する日付の値は、アプリケーションで設定されている日付形式と一致させる必要があります。
STARTS WITH演算子を使用してレポートを絞り込む場合のURL形式
ここで、
| Fieldname1 | フォーム内の項目のリンク名です |
| Fieldname1_op | 項目と演算子を関連付けるパラメーターです |
| constant | 各項目に適用される演算子を示す値です。すべての演算子とその定数の一覧については、この表を参照してください。 |
例。
- 従業員名がDanで始まる従業員レコードのみをこのレポートに表示するURLは、次のとおりです。このアプリケーションの［名前］項目は一行形式で、24はSTARTS WITH演算子を示す定数です。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Name=Dan&Name_op=24 - 従業員IDが246で始まる従業員レコードのみをこのレポートに表示するURLは、次のとおりです。このアプリケーションの［従業員ID］は数値項目です。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Employee_ID=246&Employee_ID_op=24
CONTAINS演算子に基づいてレポートを絞り込むためのURL形式
たとえば、何らかの管理職に就いている従業員のレコードのみをこのレポートに表示するURLは、次のとおりです。このアプリケーションの［役職］はチェックボックス項目で、26はCONTAINS演算子を示す定数です。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Roles=Admin&Roles_op=26
BETWEEN演算子に基づいてレポートを絞り込むためのURL形式
ここで、StartingValueとEndingValueには、数値、小数値、または日付を指定できます
例：入社日が10-Sep-2019から30-Mar-2020までの従業員レコードのみをこのレポートに表示するURLは、次のとおりです。このアプリケーションの［入社日］項目は日付形式で、58はBETWEEN演算子を示す定数です。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining=10-Sep-2019;30-Mar-2020&Date_of_Joining_op=58
その他の日付／日時固有の演算子に基づいてレポートを絞り込むためのURL形式
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining_op=51
- ［入社日］が過去n年以内の従業員レコードのみをこのレポートに表示するURLは、次のとおりです。ここで、70は、LAST N YEAR演算子を示す定数です。この形式は、NEXT N YEAR、LAST N MONTH、LAST N WEEK、LAST N DAYSなどの演算子にも適用されます。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining=2&Date_of_Joining_op=70 - ［入社日］が当年と前年の従業員レコードのみをこのレポートに表示するURLは、次のとおりです。ここで、56は、CURRENT_PREVIOUS_YEAR演算子を示す定数です。この形式は、CURR_PREV_MONTHやCURRENT_PREVIOUS_WEEKなどの演算子にも適用されます。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining_op=56
演算子と定数の一覧
| 演算子 | 定数 |
| EQUAL | 18 |
| NOT_EQUAL | 19 |
| LESS_THAN | 20 |
| GREATER_THAN | 21 |
| LESS_EQUAL | 22 |
| GREATER_EQUAL | 23 |
| STARTS_WITH | 24 |
| ENDS_WITH | 25 |
| CONTAINS | 26 |
| NOT_CONTAINS | 27 |
| LIKE | 28 |
| 空 | 29 |
| 空ではない | 30 |
| 昨日 | 31 |
| 今日 | 32 |
| 明日 | 33 |
| 過去7日間 | 34 |
| 過去30日間 | 35 |
| 過去60日間 | 36 |
| 過去90日間 | 37 |
| 過去120日間 | 38 |
| 今後7日間 | 39 |
| 今後30日間 | 40 |
| 今後60日間 | 41 |
| 今後90日間 | 42 |
| 今後120日間 | 43 |
| 先月 | 44 |
| 今月 | 45 |
| 来月 | 46 |
| 今月と先月 | 47 |
| 今月と来月 | 48 |
| 真 | 49 |
| 偽 | 50 |
| 昨年 | 51 |
| 今年 | 52 |
| 来年 | 53 |
| 過去2年間 | 54 |
| 今後2年間 | 55 |
| 今年と昨年 | 56 |
| 今年と来年 | 57 |
| 範囲内 | 58 |
| 今週 | 59 |
| 先週 | 60 |
| 来週 | 61 |
| 今週と先週 | 62 |
| 今週と来週 | 63 |
| 過去N日間 | 64 |
| 今後N日間 | 65 |
| 過去N週間 | 66 |
| 今後N週間 | 67 |
| 過去Nか月間 | 68 |
| 今後Nか月間 | 69 |
| LAST_N_YEAR | 70 |
| NEXT_N_YEAR | 71 |
| IN | 72 |
レポートを印刷するには
例：https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View
条件を指定してレポートを印刷するには
-
「=」（等しい）演算子を使用し、条件を指定してレポートを印刷するURLの形式は次のとおりです。
例：「Engineering」部門に所属する従業員のレコードを印刷するURLは次のとおりです。
https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View?Department=Engineering -
「=」（等しい）以外の演算子を使用し、条件を指定してレポートを印刷するURLの形式は次のとおりです。
各値の説明は次のとおりです。
FieldName1とFieldName2 フォーム内の項目のDelugeスクリプト名です FieldName1_opとFieldName2_op 演算子のパラメーター名です（「FieldName」の末尾に「_op」を追加） constant 各演算子に割り当てる値です。すべての演算子とその定数の一覧については、こちらの表を参照してください 例：Employee IDが1,235より大きいレコードを印刷するURLは次のとおりです。
https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View?Employee_ID=1235&Employee_ID_op=21 -
「between」演算子を使用し、条件を指定してレポートを印刷するURLの形式は次のとおりです。
ここで、<StartingValue>と<EndingValue>には、任意の数値、小数、日付を指定できます。
例：Date_of_Joiningが任意の2つの日付の間にあるレコードを印刷するURLは次のとおりです。こちらでは、Date_of_Joiningは日付項目です。
https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View?Date_of_Joining=18-Jan-2006;30-Apr-2007&Date_of_Joining_op=58
レポートにデータをインポートするには
例：販売管理アプリで、ユーザーが請求書データを請求書レポートにインポートする場合を考えます。ユーザーは通常の方法でインポートすることもできます。また、アプリのページにURLをボタンパネルとして追加することで、ユーザーがワンクリックでデータを直接インポートできるようにすることもできます。ユーザーがボタンをクリックすると、インポート操作画面に移動します。請求書ファイルを選択すると、指定したレポートにデータがインポートされます。
https://creatorapp.zoho.com/zchelp/sales-management/report/invoices/import
レポートから複合項目とサブフォーム項目のデータをエクスポートするには
https://<base_url>/<account_owner_name>/<app_link_name>/<export_format>/<report_link_name>?splitFields= <value>
https://<base_url>/<account_owner_name>/<app_link_name>/<export_format>/<report_link_name>?splitFields=column
https://<base_url>/<account_owner_name>/<app_link_name>/<export_format>/<report_link_name>?splitFields=sheet
https://<base_url>/<account_owner_name>/<app_link_name>/<export_format>/<report_link_name>?splitFields=custom&column=[field1,field2]&sheet=[subform1,subform2]
- 複合項目は、個別の列としてのみエクスポートできます。複合項目を「=sheet」パラメーターに指定した場合、その項目は無視されます。
- 対応形式：
- 複合項目のエクスポートは、CSV、TSV、JSON、XML、XLSX形式に対応しています。
- サブフォームのエクスポートは、XLSX形式にのみ対応しています。
- sheetパラメーターは、XLSX形式でのサブフォームのエクスポートにのみ対応しています。レポートからのデータのエクスポートについて、詳細をご確認ください。
レポートを並べ替えるには
項目名を渡して並べ替え条件として使用することで、レポート内のレコードを並べ替え、並べ替え後のレポートを直接表示できます。昇順または降順で並べ替えることができます。これには、sortByパラメーターを使用します。
並べ替え用のURL形式
https://<base_url>/<account_owner_name>/<app_link_name>/#Report:<report_link_name>?sortBy=<Fieldname1>:true;<Fieldname2>:false
各値の説明
|
Fieldname1, Fieldname2 |
フォーム内の項目のリンク名 |
|
true |
昇順で並べ替えることを示します |
|
false |
降順で並べ替えることを示します |
例
- 従業員レポートを入社日の昇順で並べ替えるURL
https://creatorapp.zoho.in/zchelp/employee-management#Report:Employee_Details?sortBy=DateofJoining:true - レポートを名前の昇順、入社日の降順で並べ替えるURL
https://creatorapp.zoho.in/zchelp/employee-management#Report:Employee_Details?sortBy=Name:true;DateofJoining:false
レポートをグループ化するには
項目名を渡してグループ化条件として使用することで、レポート内のレコードをグループ化し、グループ化されたレポートを直接表示できます。複数の項目名を使用してレポートをグループ化することもできます。これには、groupByパラメーターを使用します。
グループ化用のURL形式
https://<base_url>/<account_owner_name>/<app_link_name>/#Report:<report_link_name>?groupBy=<Fieldname1>:true;<Fieldname2>:false
各値の説明
|
Fieldname1, Fieldname2 |
フォーム内の項目のリンク名 |
|
true |
グループを昇順で表示することを示します |
|
false |
グループを降順で表示することを示します |
例
- 従業員レポートを部署ごとに昇順でグループ化するURL
https://creatorapp.zoho.in/zchelp/employee-management#Report:Employee_Details?groupBy=Department:true - 部署を昇順、所在地を降順にしてグループ化し、レポートを表示するURL
https://creatorapp.zoho.in/zchelp/employee-management#Report:Employee_Details?groupBy=Department:true;location:false
カレンダーレポートのデフォルトの日付を設定するには
zc_DefaultDateパラメーターを使用すると、カレンダーレポートのデフォルトの日付を設定できます。表示される日付は、選択したカレンダー表示によって異なります。
-
日表示では、指定した日付が表示されます。
-
週表示では、指定した日付を含む週が表示されます。
-
月表示では、指定した日付を含む月が表示されます。
2020年6月5日をデフォルトの日付としてカレンダーレポートを開くURL：https://creatorapp.zoho.com/sampleapps/employee-manager/#Report:Calendar_View?zc_DefaultDate=05-Jun-2020
カレンダーレポートのデフォルトの月と年を設定するには
1月（月の値：0）と2025年をデフォルトとしてカレンダーレポートを開くURL：
https://creatorapp.zoho.com/sampleapps/employee-manager/#Report:Calendar_View?month=0&year=2025
メモ：値には、Creatorアカウントで設定した日時設定が適用されます。
機能別のページ用URL
ページでもURLパラメーターを受け取ることができます。例として、以下のURLにアクセスできます（パラメーターempに値が渡されます）。
パラメーターを指定してページを印刷するには
各値の説明：
| paramName | ページで定義されているパラメーター名 |
| paramValue | ページで定義されているパラメーターに渡す値 |
例：paramNameを「dept」、paramValueを「Engineering」として、「TestHTML」という名前のページを印刷するURLは以下のとおりです。こちらでは、paramNameの「dept」は、指定したparamValueに該当するデータを取得するためにページで定義されているパラメーター名です。
https://creatorapp.zoho.com/zchelp/employee-manager/print/TestHTML?dept=Engineering
ページをPDFに変換するには
メモ：Creator 5のアカウントでは、このURLのクエリー文字列にisc5page=trueを含める必要があります
出力するPDFの特定の要素をカスタマイズするには、以下のパラメーターを追加できます。
|
パラメーター
|
値
|
初期値
|
用途
|
|
zc_FileName
|
（必要に応じて指定）
|
ページの表示名
|
|
|
zc_PdfOrientation
|
portrait, landscape
|
portrait
|
ページのコンテンツをエクスポートする向きを設定します。例：
https://creatorapp.zoho.com/export/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_PdfOrientation=landscape |
|
zc_PdfSize
|
Letter, A4, Legal, Executive
|
Letter
|
出力するPDFファイルのページサイズを設定します。例：
https://creatorapp.zoho.com/export/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_PdfSize=A4 |
| zc_PdfHeight | 20～5,600 | A4の高さ（297mm／1122px） | |
|
zc_PdfWidth
|
20～5,600 |
A4の幅（210mm／793px）
|
|
|
zc_PageNumber
|
true, false |
false
|
出力するPDFファイルのページに番号を付けます。例：
https://creatorapp.zoho.com/export/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_PageNumber=true |
- 高さ（zc_PdfHeight）と幅（zc_PdfWidth）のパラメーターを使用する場合、zc_PdfSizeは指定しないでください。
- 初期設定では、PDFファイルはA4サイズになります。高さまたは幅のいずれかのパラメーターが指定されていない場合、もう一方はA4サイズに合わせて調整されます。
埋め込みレポートの変更を保持するためのURL形式
URL形式：
https://<base_url>/<account_owner_name>/<app_link_name>/#Page:<page_link_name>?zc_RetainChanges=true
zc_RetainChangesパラメーターには、次の値を指定できます：
-
true：変更の保持を有効にします。
-
false：変更の保持を無効にします。
たとえば、レポートを従業員名フィールドで並べ替えて、Employee_Dashboardページに埋め込む場合、埋め込みレポートの並べ替えを保持するには、次のURLを使用します：
https://creatorapp.zoho.com/zchelp/employee-manager/#Page:Employee_Dashboard?zc_RetainChanges=true
制限事項
- このフォーラム投稿ですでに説明されているように、ページ内でdivを使用して埋め込まれたフォーム／レポートはサポートされていません。（この機能は、Delugeで#include、つまりサーバー側インクルードディレクティブがサポートされた後にのみ実装されます。実装後、PDF出力を有効にするには、新しい実装に切り替える必要があります）。詳細については、制限事項ページをご参照ください。
- 現在の認証情報を必要とする画像やCSSなどの認証済みコンテンツはサポートされません。PDFに変換するページ内のリンクや埋め込みコンテンツは、一般公開されている必要があります。