機能ベースのURL
概要
「Zoho Creator URL Patterns」のトピックでは、Zoho Creatorアプリケーションおよびそのフォーム、レポート、ページへアクセスするための初期設定URLについて学びました。本トピックでは、フォーム項目の初期設定値を設定するための機能別URLや、URLにデータIDを渡して個人データを編集する方法、条件を指定してレポートやページを印刷する方法について解説します。
すべてのURL形式は以下を使用します。
| お使いのCreatorアカウントのベースURLです。 例として、アカウントがZohoのUS DCに属している場合はcreatorapp.Zoho.com、EU DCの場合はcreatorapp.Zoho.euとなります。 |
|
| アプリケーションが存在するCreatorアカウントの担当者のユーザー名です。 | |
| Zoho Creatorアプリケーションのリンク名です。 | |
|
|
各コンポーネント（フォーム、レポート、ページ）のリンク名です。 |
フォーム、レポート、ページのパーマリンク
Zoho Creatorアプリケーション内の各コンポーネント（フォーム、レポート、ページ）には、それぞれのパーマリンクからアクセスできます。パーマリンクとは、特定のWebページ（この場合はフォーム、レポート、ページ）のURLを指す、恒久的なリンクです。
アプリの各コンポーネントのパーマリンクの形式は以下の通りです。
| フォームのパーマリンク |
下記の形式を使用して、フォームをWebサイトやブログなどに埋め込むことも可能です。 |
| レポートのパーマリンク |
下記の形式を利用することで、レポートをWebサイトやブログなどに埋め込むことができます。 |
| ページのパーマリンク |
下記の形式を利用して、ページをWebサイトやブログなどに埋め込むことが可能です。 |
フォーム機能別URL
フォーム項目の初期設定値を設定する方法
フォーム項目の初期設定値は、フォームのURLに追加のパラメーターを付与することで設定できます。例えば、従業員Managerアプリケーションの従業員ID項目に自動的に値を読み込ませたい場合、初期値をクエリ文字列（Employee_ID=1234）としてフォームのURLに渡します。ここで、Employee_IDは従業員フォーム内のDelugeスクリプト名です。
クエリ文字列を含むフォームのURLは、以下の形式となります。
- アプリケーション内からアクセスする場合：
https://creatorapp.Zoho.com/zchelp/従業員-manager/#Form:従業員?Employee_ID=1234 - パーマリンクからアクセスする場合：
https://creatorapp.Zoho.com/zchelp/従業員-manager/form-perma/従業員?Employee_ID=1234 - 他のウェブページに埋め込まれたフォームにアクセスする場合：
https://creatorapp.Zoho.com/zchelp/従業員-manager/form-embed/従業員?Employee_ID=1234
multi 選択するや checkbox項目では、複数の値を設定する必要がある場合があります。その場合、値はURL内でカンマ区切りで指定する必要があります。 例として、「Manager」と「Programmer」を項目 Roles（従業員フォーム）に設定する場合、URLは次のようになります: https://creatorapp.Zoho.com/zchelp/従業員-manager/#Form:従業員?Roles=Manager,Programmer
項目にフォーカスせずにフォームを表示する方法
Zoho Creatorアプリケーションでフォームにアクセスすると、フォーカスが最初の項目に自動的に設定され、カーソルが最初の項目に表示されることがあります。
Webサイトやブログにフォームを埋め込んだ場合、ウェブページにアクセスすると、この初期設定の自動フォーカス動作により、ページがフォームの位置まで自動的にスクロールされます。その結果、埋め込みフォームより上にあるコンテンツがユーザーにスキップされ、閲覧体験が損なわれる場合があります。これに対応するため、Zoho Creatorではzc_Focusパラメーターが用意されています。
| zc_Focus の値 | 意図された動作 |
| 真 |
|
| 無効 |
|
URLにデータIDを指定して個別データを編集する
データIDを使って個別データを表示・編集するためのURLは以下の通りです。これにより、Zoho Creatorフォームが編集モードで表示されます。
編集 データ（データID指定）のトピックもご参照ください。
機能別URL（レポート用）
データを詳細表示する場合
レポートの表示データをフィルターする場合
レポートの表示データは、URLのクエリストリングにフィルター条件を設定することで絞り込みが可能です。複数条件でのフィルタリングも対応しており、2つの項目-値ペアを区切る場合はアンパサンド記号（&）を使用します。下記は従業員 Managerアプリケーションの従業員 表示するレポートをフィルタリングする例です。このレポートのURL：
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View
EQUALS演算子によるレポートフィルタリングのURL形式
ここで、FieldName1およびFieldName2はフォーム内の項目のリンク名です。
例:
- このレポートで従業員の名前がDaniel（名前=Daniel）の従業員データのみを表示するURL：
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?名前=Daniel - このレポートで従業員IDが2466（Employee_ID=2466）の従業員データのみを表示するURL：
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Employee_ID=2466 - 従業員の入社日が2019年5月13日（Date_of_Joining=13-May-2019）の従業員データのみを表示するURL：
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Date_of_Joining=13-May-2019
メモ: ここで、日付「13-May-2019」はこの従業員Managerアプリケーションの設定で設定された日付の形式に従っています。レポートのURLにクエリ文字列として追加する日付の値は、アプリケーションで設定されている日付の形式と一致している必要があります。
STARTS WITH演算子を使用してレポートをフィルタリングする場合のURL形式
ここで、
| Fieldname1 | フォーム内の項目のリンク名前です。 |
| Fieldname1_op | 項目と演算子を関連付けるパラメーターです。 |
| constant | 該当する項目に対して機能する演算子を示す値です。すべての演算子とそれぞれの定数の一覧はこの表をご参照ください。 |
例：
- 従業員の名前がDanで始まる従業員データのみを表示するURLは以下の通りです。このアプリケーションの名前項目はsingle 折れ線グラフ種類であり、24は「STARTS WITH」演算子を示す定数です。
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?名前=Dan&Name_op=24 - 従業員IDが246で始まる従業員データのみを表示するURLは以下の通りです。このアプリケーションで従業員IDは番号項目です。
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Employee_ID=246&Employee_ID_op=24
CONTAINS演算子を使用してレポートをフィルタリングするためのURL形式
例として、従業員が管理者の役割を含む従業員データのみを表示するURLは以下の通りです。このアプリケーションで役割はcheckbox項目であり、26は「CONTAINS」演算子を示す定数です。
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Roles=Admin&Roles_op=26
が次の間演算子を使用してレポートをフィルタリングするためのURL形式
ここで、StartingValue および EndingValue には番号、小数値、または日付を指定できます。
例: 入社日が10-Sep-2019から30-Mar-2020の間である従業員データのみを表示するためのURLは以下の通りです。このアプリケーションにおける入社日項目は日付の種類であり、58は「が次の間」演算子を識別する定数です。
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Date_of_Joining=10-Sep-2019;30-Mar-2020&Date_of_Joining_op=58
他の日付／日付-時間専用演算子を使ったレポートのフィルタリング用URL形式
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Date_of_Joining_op=51
- 過去n年間に日付 of Joiningが含まれる従業員データのみを表示するURLは以下の通りです。ここで、70はLAST N YEAR演算子を示す定数です。この形式は、次 N YEAR、LAST N MONTH、LAST N WEEK、LAST N 日などの演算子にも適用されます。
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Date_of_Joining=2&Date_of_Joining_op=70 - 現在および去年が日付 of Joiningに含まれる従業員データのみを表示するURLは以下の通りです。ここで、56はCURRENT_PREVIOUS_YEAR演算子を示す定数です。この形式は、CURR_PREV_MONTHやCURRENT_PREVIOUS_WEEKなどの演算子にも適用されます。
https://creatorapp.Zoho.com/zchelp/従業員-manager/#レポート:Employee_View?Date_of_Joining_op=56
演算子と定数一覧
| 演算子 | 定数 |
| EQUAL（等しい） | 18 |
| NOT_EQUAL（等しくない） | 19 |
| LESS_THAN（より小さい） | 20 |
| GREATER_THAN（より大きい） | 21 |
| 以下または等しい | 22 |
| 以上または等しい | 23 |
| で始まる | 24 |
| で終わる | 25 |
| 含む | 26 |
| 含まない | 27 |
| 類似 | 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 |
| 前々年度 | 54 |
| 翌々年度 | 55 |
| 本年度・前年度 | 56 |
| 本年度・翌年度 | 57 |
| が次の間 | 58 |
| 今週 | 59 |
| 先週 | 60 |
| 来週 | 61 |
| 現在週・前週 | 62 |
| 現在週・翌週 | 63 |
| 直近N日間 | 64 |
| 今後N日間 | 65 |
| 過去N週間 | 66 |
| 今後N週間 | 67 |
| 過去Nか月間 | 68 |
| 今後Nか月間 | 69 |
| 過去N年間 | 70 |
| 今後N年間 | 71 |
| IN | 72 |
レポートを印刷する
例: https://creatorapp.Zoho.com/zchelp/従業員-manager/印刷する/Employee_View
条件付きでレポートを印刷する
-
'='（イコール）演算子を使用した条件付きレポート印刷のURL形式：
例: 'Engineering' 部署に所属する従業員データを印刷するためのURLは、
https://creatorapp.Zoho.com/zchelp/従業員-manager/印刷する/Employee_View?部署=Engineering -
URL 形式で、「＝（等しい）」以外の演算子を使用してレポートを印刷する方法：
ここで、
FieldName1& FieldName2 フォーム内の項目に対応する Deluge スクリプト名です。 FieldName1_op& FieldName2_op 演算子用のパラメータ名（「FieldName」に「_op」を付加したもの）です。 constant 各演算子に割り当てられる値です。すべての演算子とそれぞれの定数については、この表をご参照ください。 例：従業員 ID が 1235 より大きいデータを印刷するための URL は、
https://creatorapp.Zoho.com/zchelp/従業員-manager/印刷する/Employee_View?Employee_ID=1235&Employee_ID_op=21 -
URL 形式で、「が次の間」演算子を使用して条件付きでレポートを印刷する方法 -
ここで、 および には、任意の番号、小数、または日付を指定できます。
例：Date_of_Joiningが任意の2つの日付の間であるデータを印刷するためのURLは以下の通りです。ここで、Date_of_Joiningは日付項目です。
https://creatorapp.Zoho.com/zchelp/従業員-manager/印刷する/Employee_View?Date_of_Joining=18-Jan-2006;30-Apr-2007&Date_of_Joining_op=58
レポートへデータをインポートする方法
例: 営業管理アプリケーションで、ユーザーが請求書データを請求書レポートにインポートしたい場合を考えます。ユーザーは従来の方法で実行することもできますが、URLをアプリケーションページのボタンパネルとして設定すれば、1クリックで直接データをインポートできます。ユーザーがボタンをクリックするとインポート画面に遷移し、請求書ファイルを選択することで、指定したレポートにデータがインポートされます。
https://creatorapp.Zoho.com/zchelp/営業-management/レポート/請求書/インポートする
レポートから複合項目およびサブフォーム項目データをエクスポートする方法
https:// / / / / ?splitFields= <値>
https:// / / / / ?splitFields=列
https:// / / / / ?splitFields=sheet
https:// / / / / ?splitFields=カスタム&列=[field1,field2]&sheet=[subform1,subform2]
- Composite 項目は、別々の列でのみエクスポート可能です。'=sheet' パラメーターで Composite 項目が指定された場合は無視されます。
- 対応形式:
- Composite 項目のエクスポートは、CSV、TSV、JSON、XML、および XLSX 形式に対応しています。
- Subform のエクスポートは、XLSX 形式のみに対応しています。
- sheet パラメーターは、XLSX 形式での Subform エクスポート時のみ対応しています。レポートからデータをエクスポートする方法の詳細はこちらをご覧ください。
レポートを並べ替える方法
レポート内のデータは、並べ替え基準となる項目名を指定することで並べ替えることができ、ユーザーは並べ替えられたレポートを直接表示できます。昇順または降順での並べ替えが可能です。sortBy パラメーターを使用して実現できます。
並べ替え用URL形式
https:// / / /#レポート: ?s ortBy= :真; :無効
ここで
|
Fieldname1、Fieldname2 |
は、フォーム内の項目のリンク名です。 |
|
真 |
は、昇順で並べ替えることを示します。 |
|
無効 |
は、降順で並べ替えることを示します。 |
例
- 従業員レポートを入社日で昇順に並べ替えるURL
https://creatorapp.Zoho.in/zchelp/従業員-management#レポート:Employee_Details?sortBy=DateofJoining:真 - レポートを名前で昇順、かつ入社日で降順に並べ替えるURL
https://creatorapp.Zoho.in/zchelp/従業員-management#レポート:Employee_Details?sortBy=名前:真;DateofJoining:無効
レポートをグループ化する方法
レポート内のデータをグループ化するには、グループ化の基準となる項目名を指定します。これにより、ユーザーはグループ化されたレポートを直接表示できます。複数の項目名でレポートをグループ化することも可能です。groupByパラメーターを使用することで実現できます。
グループ化用のURL形式
https:// / / /#レポート: ?groupBy= :真; :無効
ここで
|
Fieldname1, Fieldname2 |
フォーム内の項目のリンク名です。 |
|
真 |
グループ化は昇順で表示されることを示します。 |
|
無効 |
グループ化は降順で表示されることを示します。 |
例
- 従業員レポートを部署ごとに昇順でグループ化して表示するためのURL
https://creatorapp.Zoho.in/zchelp/従業員-management#レポート:Employee_Details?groupBy=部署:真 - 部署は昇順、場所は降順でグループ化してレポートを表示するためのURL
https://creatorapp.Zoho.in/zchelp/従業員-management#レポート:Employee_Details?groupBy=部署:真;場所:無効
ページの機能別URL
ページはURLパラメーターも承認できます。以下のURLは、empというパラメーターに値を渡す例としてアクセスできます。
https://creatorapp.Zoho.com/sampleapps/従業員/#Page:Complete_Employee_details?emp=サポート@zohocreator。com
パラメーター付きページを印刷する方法
各項目の説明：
| paramName | ページで定義されているパラメーターの名前です |
| paramValue | ページで定義されたパラメーターに渡す値です |
例：ページ名が「TestHTML」で、paramNameが「dept」、paramValueが「Engineering」の場合にページを印刷するためのURLです。paramName「dept」は、指定したparamValueを利用してデータを取得するためにページで定義されたパラメーター名です。
https://creatorapp.Zoho.com/zchelp/従業員-manager/印刷する/TestHTML?dept=Engineering
ページをPDFに変換する方法
例： https://creatorapp.Zoho.com/エクスポートする/sampleapps/顧客-サポート/pdf/More_Details_Html_View?ticketID=104
ここで、ticketIDはページで定義されたパラメーター名です。
出力されるPDFの特定の項目をカスタマイズするために、以下のパラメーターを追加できます。
|
パラメーター
|
値
|
初期値
|
用途
|
|
zc_FileName
|
(必須)
|
ページの表示名
|
|
|
zc_PdfOrientation
|
縦向き、横向き
|
縦向き
|
|
|
zc_PdfSize
|
レター、A4、リーガル、エグゼクティブ
|
レター
|
出力されるPDFファイルの用紙サイズを指定します。例：
https://creatorapp.Zoho.com/エクスポートする/sampleapps/顧客-サポート/pdf/Most_Recent_Solution?zc_PdfSize=A4 |
| zc_PdfHeight | 20～5600 | A4の高さ（297mm/1122px） |
出力されるPDFファイルの高さを指定します。例：
https://creatorapp.Zoho.com/エクスポートする/sampleapps/顧客-サポート/pdf/Most_Recent_Solution?zc_PdfHeight=1000 |
|
zc_PdfWidth
|
20 〜 5600 |
A4の幅、つまり210mm/793px
|
|
|
zc_PageNumber
|
真, 無効 |
無効
|
出力PDFファイルのページ番号を付与します。例:
https://creatorapp.Zoho.com/エクスポートする/sampleapps/顧客-サポート/pdf/Most_Recent_Solution?zc_PageNumber=真 |
- zc_PdfSizeは、高さ（zc_PdfHeight）や幅（zc_PdfWidth）パラメーターが使用中の場合は指定しないでください。
- 初期設定では、PDFファイルはA4サイズとなります。高さまたは幅パラメーターのいずれかが未指定の場合、もう一方はA4サイズに合わせて調整されます。
埋め込みレポートで変更を保持するためのURL形式
URL形式:
https://
/
/
/#Page:
?
zc_RetainChanges=真
zc_RetainChangesパラメータでは、以下の値が使用できます。
-
真: 変更の保持を有効にします。
-
無効: 変更の保持を無効にします。
例えば、レポートを従業員 名前項目で並べ替え、「Employee_Dashboard」ページに埋め込む場合、次のURLを使用することで、埋め込みレポートでも並べ替えを保持できます:
https://creatorapp.Zoho.com/zchelp/従業員-manager/#Page:Employee_Dashboard?zc_RetainChanges=真
制限事項
- ページ内へのフォームやレポートの埋め込みは、既にこのフォーラム投稿で説明されている通り、サポートされていません。（これは、#含めるサポート、つまりDelugeでサーバーサイドの含めるディレクティブを提供した後にのみ対応予定です。完了後は、新しい実装へ変更する必要があり、PDF出力を有効にできます）。詳細は、制限事項ページをご参照ください。
- 画像やCSSなど、認証が必要なコンテンツ（現在の認証情報が必要なもの）はサポートされません。つまり、PDFに変換するページ内のリンクや埋め込みは、公開されているコンテンツである必要があります。
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho Campaigns Resources
Zoho WorkDrive Resources
Related Articles
「あなたのクリエイターアカウントの基本URLを知ろう」
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 今日のデータプライバシーおよび保護法により、収集されたデータは、それぞれの国または地域にあるデータセンターに格納する必要があります。 遵守を容易にするため、Zohoはさまざまな地域に複数のデータセンターを設置しました。 ...