機能ベースのURL
概要
トピックZoho Creator URL パターンでは、Zoho Creator アプリケーションやそのフォーム、レポート、ページにアクセスするための初期設定URLについて学びました。本トピックでは、機能別URLを利用してフォーム項目の初期値を設定したり、URLでデータIDを渡して個人データを編集したり、レポートやページの条件設定や印刷について参照します。
すべてのURL書式は以下を使用します。
| CreatorアカウントのベースURL 例として、アカウントがZohoのUS DCの場合はcreatorapp.Zoho.com、EU DCの場合はapp.zohocreator.euとなります。 |
|
| アプリケーションが既存するCreatorアカウントの担当者のユーザー名 | |
| Zoho Creatorアプリケーションのリンク名 | |
|
|
各コンポーネントのリンク名（フォーム、レポート、ページ） |
フォーム、レポート、ページのパーマリンク
Zoho Creatorアプリケーション内の各コンポーネント（フォーム、レポート、ページ）には、そのパーマリンクを利用してアクセスできます。パーマリンクとは、その名の通り恒久的なリンクであり、特定のウェブページ（ここではフォーム、レポート、またはページ）のURLを指します。
アプリの各コンポーネントのパーマリンクの形式は以下の通りです。
| フォームのパーマリンク |
下記の形式を利用することで、フォームをWebサイトやブログなどに埋め込むことも可能です。 |
| レポートのパーマリンク |
下記の形式を使用することで、レポートをWebサイトやブログなどに埋め込むことができます。 |
| ページのパーマリンク |
下記の形式を使用することで、ページをWebサイトやブログなどに埋め込むことができます。 |
フォームの機能別URL
フォーム項目の初期設定値を設定する方法
フォーム項目の初期設定値は、フォームのURLに追加のパラメーターを指定することで設定できます。たとえば、従業員Managerアプリケーションの従業員ID項目に自動的に値を入力する場合、初期値はフォームのURL内のクエリ文字列（Employee_ID=1234）として指定します。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 - 他のWebページに埋め込まれたフォームにアクセスする場合：
https://creatorapp.Zoho.com/zchelp/従業員-manager/form-embed/従業員?Employee_ID=1234
multi-選択するおよびチェックボックス項目では、複数の値を設定する必要がある場合があります。その場合は、URL内で値をカンマで区切って入力してください。例えば、従業員フォームのRoles項目に「Manager」と「Programmer」を設定したい場合、URLは次のようになります：https://creatorapp.Zoho.com/zchelp/従業員-manager/#Form:従業員?Roles=Manager,Programmer
項目にフォーカスせずにフォームを読み込む方法
Zoho Creatorアプリケーションでフォームにアクセスすると、フォーカスが最初の項目に設定され、カーソルが最初の項目に表示されることに気付く場合があります。
Webサイトやブログにフォームを埋め込んでいる場合、ウェブページへアクセスすると、この初期設定の自動フォーカス動作により、ページがフォームの位置まで自動的にスクロールします。その結果、フォームより上にあるコンテンツがスキップされ、ユーザー体験に影響する可能性があります。これを回避するために、Zoho Creatorではzc_Focusパラメーターが用意されています。
| 値 for zc_Focus | 意図された動作 |
| 真 |
|
| 無効 |
|
URLにデータIDを指定して個人データを編集する
データIDを使用して個人データを表示・編集するためのURLは以下の通りです。これにより、Zoho Creatorフォームが編集モードで表示されます。
詳細については、トピック「データをデータIDで編集する」をご参照ください。
機能別URLによるレポートへのアクセス
データを詳細表示で表示する方法
レポートで表示されるデータをフィルターする方法
レポートで表示されるデータは、URL内のクエリ文字列としてフィルター条件を設定することで絞り込めます。複数条件でのフィルターも可能で、その際はアンパサンド（&）を使って2つの項目-値ペアを区切ります。以下に、従業員マネージャーアプリケーションの従業員表示レポートをフィルターする例を示します。このレポートの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は以下の通りです。このアプリケーションの役割はチェックボックス項目であり、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は以下の通りです。このアプリケーションの日付 of Joining項目は日付種類の項目です。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
- 従業員データのうち、日付 of Joiningが過去n年間に含まれるもののみを表示する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を設定することで、ワンクリックで直接データをインポートすることも可能です。ボタンをクリックするとインポート画面に遷移し、請求書ファイルを選択することで、指定したレポートへデータがインポートされます。
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= :真; :無効
where
|
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
|
縦、横
|
縦
|
ページ内容をエクスポート済みにする際の向きを設定します。例：
https://creatorapp.Zoho.com/エクスポートする/sampleapps/顧客-サポート/pdf/Most_Recent_Solution?zc_PdfOrientation=landscape |
|
zc_PdfSize
|
レター、A4、リーガル、エグゼクティブ
|
レター
|
出力PDFファイルの用紙サイズを設定します。例：
https://creatorapp.Zoho.com/エクスポートする/sampleapps/顧客-サポート/pdf/Most_Recent_Solution?zc_PdfSize=A4 |
| zc_PdfHeight | 20 ～ 5600 | A4の高さ（297mm／1122px） | |
|
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=真
制限事項
- Div埋め込みフォーム／レポートのPages内での「次の値と等しくない」は、すでにこのフォーラム投稿で説明している通り、現時点ではサポートされていません。（これは、#含めるサポート、つまり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はさまざまな地域に複数のデータセンターを設置しました。 ...Zoho CreatorのURLパターン
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 このドキュメントでは、Zoho ...