機能別URL
概要
Zoho CreatorのURLパターンのトピックでは、Zoho Creatorアプリケーションとそのフォーム、レポート、ページにアクセスするための標準のURLについて説明しました。このトピックでは、フォーム項目に初期値を設定する、URLでデータIDを渡して個別のデータを編集する、レポートやページの条件を設定する、印刷する、といった機能別URLについて説明します。
すべてのURL形式で、次の値を使用します。
| <base_url> | お使いのCreatorアカウントのベースURL たとえば、アカウントがZohoの米国DCに属している場合はcreatorapp.zoho.com、ZohoのEU DCに属している場合はcreatorapp.zoho.euです。 |
| <account_owner_name> | アプリケーションが存在するCreatorアカウントの所有者のユーザー名 |
| <app_link_name> | Zoho Creatorアプリケーションのリンク名 |
|
<form_link_name> |
それぞれのコンポーネント（フォーム、レポート、ページ）のリンク名 |
フォーム、レポート、ページのパーマリンク
Zoho Creatorアプリケーション内のコンポーネント（フォーム、レポート、ページ）には、パーマリンクを使用してアクセスすることもできます。パーマリンクとは、その名のとおり永続的なリンクで、特定のWebページ（ここではフォーム、レポート、ページ）のURLを指します。
アプリのコンポーネントのパーマリンク形式は次のとおりです。
| フォームのパーマリンク |
次の形式を使用すると、Webサイトやブログなどにフォームを埋め込むことができます。 |
| レポートのパーマリンク |
次の形式を使用すると、Webサイトやブログなどにレポートを埋め込むことができます。 |
| ページのパーマリンク |
次の形式を使用すると、Webサイトやブログなどにページを埋め込むことができます。 |
フォーム用の機能別URL
フォーム項目の初期値を設定するには
フォーム項目の初期値は、フォームのURLに追加パラメーターを渡すことで設定できます。たとえば、Employee Managerアプリケーションの［Employee ID］項目に値を自動的に読み込むには、フォームのURLで初期値をクエリー文字列（Employee_ID=1234）として渡します。ここで、Employee_IDはEmployeeフォーム内の項目の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内で値をコンマ区切りで指定する必要があります。たとえば、Employeeフォームの［Roles］項目に「Manager」と「Programmer」の値を設定する場合、URLは次のようになります。https://creatorapp.zoho.com/zchelp/employee-manager/#Form:Employee?Roles=Manager,Programmer
項目にフォーカスせずにフォームを読み込むには
Zoho Creatorアプリケーションでフォームにアクセスすると、フォームの最初の項目にフォーカスが設定されます。つまり、カーソルがフォームの最初の項目に表示されます。
Webサイトまたはブログにフォームを埋め込んでいるとします。Webページにアクセスすると、この初期設定の自動フォーカス動作により、フォームが配置されている位置までWebページがスクロールされます。そのため、埋め込みフォームより上にあるコンテンツがスキップされ、ユーザー体験に影響する場合があります。これに対応するため、Zoho Creatorではzc_Focusパラメーターを提供しています。
| zc_Focusの値 | 想定される動作 |
| true |
|
| false |
|
URLでデータIDを渡して個別のデータを編集するには
データIDを使用して個別のデータを表示、編集するための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の従業員データのみを表示するURL（Name=Daniel）は次のとおりです。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Name=Daniel - このレポートで、従業員IDが2466の従業員データのみを表示するURL（Employee_ID=2466）は次のとおりです。
https://creatorapp.zoho.com/zchelp/employee-manager/#Report:Employee_View?Employee_ID=2466 - このレポートで、入社日が13-May-2019の従業員データのみを表示するURL（Date_of_Joining=13-May-2019）は次のとおりです。
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には、数値、小数、日付を指定できます
例：入社日が2019年9月10日から2020年3月30日までの間に該当する従業員データのみをこのレポートに表示する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 |
レポートを印刷するには
例：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 GREATER_THAN 1235の条件でデータを印刷する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をボタンパネルとして設定することで、ユーザーが1回のクリックで直接データをインポートできるようにすることもできます。ユーザーがボタンをクリックすると、インポート画面に移動します。請求書ファイルを選択すると、指定したレポートにデータがインポートされます。
https://creatorapp.zoho.com/zchelp/sales-management/report/invoices/インポート
レポートから複合項目とサブフォーム項目のデータをエクスポートするには
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
ページの機能別URL
ページでもURLパラメーターを受け付けることができます。次のURLを例として確認できます（パラメーターempに値が渡されています）。
https://creatorapp.zoho.com/sampleapps/employees/#Page:Complete_Employee_details?emp=##PROTECTED_0##
パラメーター付きのページを印刷するには
各要素の説明
| paramName | ページで定義されているパラメーターの名前です |
| paramValue | ページで定義されているパラメーターに渡される値です |
例：ページ「TestHTML」を、paramName「dept」とparamValue「Engineering」で印刷するURLは次のとおりです。ここで、paramName「dept」は、指定したparamValueでデータを取得するためにページで定義されたパラメーター名です。
https://creatorapp.zoho.com/zchelp/employee-manager/print/TestHTML?dept=Engineering
ページをPDFに変換するには
たとえば、https://creatorapp.zoho.com/エクスポート/sampleapps/customer-support/pdf/More_Details_Html_View?ticketID=104
ここで、ticketIDはページで定義されたパラメーター名です
出力PDFの一部の設定をカスタマイズするには、次のパラメーターを追加できます。
|
パラメーター
|
値
|
初期値
|
目的
|
|
zc_FileName
|
（必要に応じて）
|
ページの表示名
|
|
|
zc_PdfOrientation
|
portrait, landscape
|
portrait
|
|
|
zc_PdfSize
|
Letter, A4, Legal, Executive
|
Letter
|
出力PDFファイルのページサイズを設定します。例：
https://creatorapp.zoho.com/エクスポート/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_PdfSize=A4 |
| zc_PdfHeight | 20～5,600 | A4の高さ（297mm／1,122px） | |
|
zc_PdfWidth
|
20～5,600 |
A4の幅（210mm／793px）
|
|
|
zc_PageNumber
|
true, false |
false
|
- 高さ（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 Name項目で並べ替えて、Employee_Dashboardページに埋め込む場合、埋め込みレポートでその並べ替えを保持するには、次のURLを使用できます。
https://creatorapp.zoho.com/zchelp/employee-manager/#Page:Employee_Dashboard?zc_RetainChanges=true
制限事項
- ページ内にdivで埋め込まれたフォーム／レポートには対応していません。詳しくは、このフォーラムの投稿で説明されています。（これは、Delugeで#include、つまりサーバー側インクルードディレクティブに対応した後にのみ実施されます。PDF出力を有効にするには、対応後に新しい実装へ変更する必要があります）。詳細については、制限事項ページを参照してください。
- 現在の認証情報が必要な画像／CSSなどの認証が必要なコンテンツには対応していません。つまり、PDFに変換するページ内のリンク／埋め込みは、公開コンテンツである必要があります。