「機能を基にしたURL」

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

このトピックでは、Zoho Creatorアプリケーションおよびそのフォーム、レポート、ページへのアクセスのためのデフォルトのURLについて学びました。Zoho Creator URL Patterns。このトピックでは、フォームフィールドのデフォルト値を設定するための機能ベースのURL、レコードIDをURLに渡して個々のレコードを編集する、レポートとページの条件を設定して印刷するなどの機能を学びます。

すべてのURL形式は以下を使用します：

<base_url>	Creator アカウントのベースURLです。例えば、アカウントが Zoho の US DC に属している場合は app.zohocreator.com、EU DC に属している場合は app.zohocreator.eu です。
<account_owner_name>	Creator アカウントの所有者のユーザー名です。
<app_link_name>	Zoho Creator アプリケーションのリンク名です。
<form_link_name> <report_link_name> <page_link_name>	フォーム、レポート、ページの各コンポーネントのリンク名です。

フォーム、レポート、ページのパーマリンク

Zoho Creatorアプリケーション内のフォーム、レポート、ページなどのコンポーネントには、パーマリンクを使用してアクセスすることができます。言葉の通り、パーマリンクは永続的なリンクであり、特定のWebページ（ここではフォーム、レポート、ページ）のURLを指します。

アプリのコンポーネントのパーマリンクの形式は以下の通りです：

フォームのパーマリンク	https://<base_url>/<account_owner_name>/<app_link_name>/form-perma/<form_link_name> 例: https://app.zohocreator.com/sampleapps/employee-manager/form-perma/Basic_Information 以下の形式を使用して、ウェブサイト、ブログなどにフォームを埋め込むことができます。 <iframe height='500px' width='100%' frameborder='0' allowTransparency='true' scrolling='auto' src='https://<base_url>/<account_owner_name>/<app_link_name>/form-embed/<form_link_name>'></iframe>
レポートのパーマリンク	https://<base_url>/<account_owner_name>/<app_link_name>/report-perma/<report_link_name> 例: https://app.zohocreator.com/sampleapps/employees/report-perma/All_Employees 以下のフォーマットを使用して、ウェブサイト、ブログなどにレポートを埋め込むことができます。 <iframe height='500px' width='100%' frameborder='0' allowTransparency='true' scrolling='auto' src='https://<base_url>/<account_owner_name>/<app_link_name>/report-embed/<report_link_name>'></iframe>
ページのパーマリンク	https://<base_url>/<account_owner_name>/<app_link_name>/page-perma/<page_link_name> 例: https://app.zohocreator.com/sampleapps/employees/page-perma/Complete_Employee_details 以下のフォーマットを使用して、Webサイト、ブログなどにページを埋め込むことができます。 <iframe height='500px' width='100%' frameborder='0' allowTransparency='true' scrolling='auto' src='https://<base_url>/<account_owner_name>/<app_link_name>/page-embed/<page_link_name>'></iframe>

注：使用其固定链接访问组件需要最终用户登录。

要允许公共访问应用组件，请参阅发布和嵌入表单、发布和嵌入报表以及发布和嵌入页面。

フォームのための機能ベースのURL

フォームフィールドの初期値を設定する

フォームフィールドのデフォルト値は、フォームのURLに追加パラメータを渡すことで設定できます。例えば、従業員マネージャーアプリケーションのフィールド従業員IDに自動的に値をロードするには、従業員フォームのDelugeスクリプト名であるEmployee_ID（Employee_ID = 1234）をクエリ文字列としてフォームのURLに渡します。

フォームのURLは以下の形式です：

アプリケーション内でのアクセス：
https://app.zohocreator.com/zchelp/employee-manager/#Form:Employee?Employee_ID=1234
パーマリンクを介してのアクセス：
https://app.zohocreator.com/zchelp/employee-manager/form-perma/Employee?Employee_ID=1234
別のウェブページに埋め込まれたフォームへのアクセス：
https://app.zohocreator.com/zchelp/employee-manager/form-embed/Employee?Employee_ID=1234

マルチセレクトおよびチェックボックスのフィールドでは、複数の値を設定する必要がある場合があります。このため、URL内で値はカンマで区切られている必要があります。例えば、Employee Formのフィールド「Roles」に値「Manager」および「Programmer」を設定する場合、URLは次のとおりです： https://creator.zoho.com/zchelp/employee-manager/#Form:Employee?Roles=Manager,Programmer

注：URLでクエリストリングとして渡される値は、ユーザーがフォームにアクセスするとき（つまり、フォームの読み込み時）に設定されます。

フォームをフィールドフォーカスなしでロードする

Zoho Creatorアプリケーションでフォームにアクセスする場合、フォームの最初のフィールドにフォーカスが設定され、カーソルが最初のフィールドに表示されます。

ウェブサイトやブログを想定して、埋め込みフォームを持っているとします。ウェブページにアクセスすると、このデフォルトのオートフォーカスの挙動により、フォームが配置されている場所までスクロールしてしまいます。これは、埋め込みフォームの上にあるコンテンツがスキップされてしまうため、ユーザーの体験を妨げる可能性があります。これを処理するために、Zoho Creatorはzc_Focusパラメーターを提供しています。

値：zc_Focus	意図された挙動
true	'true' は、このパラメータのデフォルト値です例：https://app.zohocreator.com/sampleapps/employees/#Form:Employee_Information このフォームのフィールドにカーソルが設定されることに注意してください。
偽	フォームのURLにzc_Focus=falseを付け加えることで、自動フォーカスの機能を無効にすることができます。例 - https://app.zohocreator.com/sampleapps/employees/#Form:Employee_Information?zc_Focus=false このフォームの最初のフィールドにフォーカスが設定されていないことに気づくかもしれません。

レコードIDをURLで渡して、個々のレコードを編集する

レコードIDを使用して個々のレコードを表示および編集するためのURLは以下に示されています。これにより、Zoho Creatorフォームが編集モードで表示されます。

https://<base_url>/<account_owner_name>/<app_link_name>/#Form:<form_link_name>?recLinkID=<record_ID>&viewLinkName=<view_link_name>

詳細な情報については、トピック「レコードIDを使用したレコードの編集」を参照してください。

レポートのための機能ベースのURL

レポートに表示されるデータをフィルタリングする

レポートの表示されるデータを、URL内のクエリ文字列にフィルター条件を設定することでフィルタリングすることができます。複数の条件でのフィルタリングもサポートされています。2つのフィールド値ペアを区切るにはアンパサンド文字（&）を使用します。以下は、Employee ManagerアプリケーションのEmployee Viewレポートをフィルタリングする例です。このレポートのURL：
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View

レポートをイコール演算子に基づいてフィルタリングするためのURL形式

https://<base_url>/<account_owner_name>/<app_link_name>/#Report:<report_link_name>?<FieldName1>=<value1>&<FieldName2>=<value2>

そこで、FieldName1 と FieldName2 はフォーム内のフィールドのリンク名です。

例:

このレポートを表示するためのURLは、従業員の名前がDanielであるレコードのみを表示するようになっています（Name=Daniel）：
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Name=Daniel
このレポートを表示するためのURLは、従業員IDが2466であるレコードのみを表示するようになっています（Employee_ID=2466）：
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Employee_ID=2466
このレポートを表示するためのURLは、従業員の入社日が13-May-2019であるレコードのみを表示するようになっています（Date_of_Joining=13-May-2019）：
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining=13-May-2019

注意：ここでは、この従業員マネージャーアプリケーションの設定で設定された日付フォーマットに従って13-May-2019となっています。レポートのURLに追加する日付の値は、アプリケーションで設定された日付フォーマットと一致する必要があります。

STARTS WITH 演算子に基づいてレポートをフィルタリングするURL形式

https://<base_url>/<account_owner_name>/<app_link_name>/#Report:<report_link_name>?<FieldName1>=<value1>&<FieldName1_op>=<constant>

そこで、

フィールド名1	フォーム内のフィールドのリンク名です。
Fieldname1_op	フィールドと演算子をリンクするパラメーターです。
constant	それぞれのフィールドに作用する演算子を参照する値です。すべての演算子とその定数のリストを参照するには、この表をご覧ください。

例:

ダンから始まる従業員レコードのみを表示するこのレポートのURLは次の通りです。このアプリケーションの Name フィールドは単行であり、 24 はSTARTS WITH演算子を識別する定数です。
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Name=Dan&Name_op=24
246から始まる従業員IDのレコードのみを表示するこのレポートのURLは次の通りです。このアプリケーションでは、 Employee ID は数値フィールドです。
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Employee_ID=246&Employee_ID_op=24

CONTAINS演算子に基づいてレポートをフィルタリングするURL形式

https://<base_url>/<account_owner_name>/<app_link_name>/#Report:<report_link_name>?<FieldName1>=<value1>&<FieldName1_op>=<constant>

例えば、このレポートによって、従業員レコードが管理職にいるものだけを表示するURLは以下の通りです。このアプリケーションでは、役割はチェックボックスフィールドであり、 26 はCONTAINSオペレータを識別する定数です。
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Roles=Admin&Roles_op=26

例えば、このレポートで従業員レコードが管理職にいるものだけを表示するURLは以下の通りです。このアプリケーションでは、役割はチェックボックスフィールドであり、 26 はCONTAINSオペレータを識別する定数です。
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Roles=Admin&Roles_op=26

例えば、このレポートで従業員レコードが管理職にいるものだけを表示するURLは以下の通りです。このアプリケーションでは、役割は BETWEEN 演算子に基づいてレポートをフィルタリングするURL形式

https://<base_url>/<account_owner_name>/<app_link_name>/#Report:<report_link_name>?<FieldName1>=<StartingValue>;<EndingValue>&<FieldName1_op>=<constant>

そこで、StartingValue と EndingValue は、数値、小数値、または日付となることができます。

例：このレポートに表示されるのは、入社日が2019年9月10日から2020年3月30日の間のみの従業員レコードのみのURLは次の通りです。このアプリケーションの 入社日 フィールドは日付型であり、BETWEEN演算子を識別する定数は 58 です。
https://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining=10-Sep-2019;30-Mar-2020&Date_of_Joining_op=58

レポートを他の日付/日時特定の演算子に基づいてフィルタリングするためのURL形式

注：演算子の一覧については、次の表を参照してください。

URL この報告書を表示するには、入社日が去年のものだけを表示するようにするには、次のとおりです。ここでは、去年の演算子を識別する定数として、51が使用されています。この形式は、来年、今年、先月、今月、先週、今週、昨日、明日などの演算子にも適用されます。
https://app.zohocreator.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://app.zohocreator.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://app.zohocreator.com/zchelp/employee-manager/#Report:Employee_View?Date_of_Joining_op=56

演算子とその定数のリスト

演算子

定数

イコール

不等しい

小於

＞

LESS_EQUAL（以下）

以上

STARTS_WITH

ENDS_WITH

END_WITH

含まれています

NOT_CONTAINS

NOT_CONTAINS（非含む）

空

空でない

昨日

今日

明日

最後の7日間

過去30日間

最後の60日間

過去90日間

最後の120日間

次の7日間

次の30日間

次の60日間

次の90日間

次の120日間

先月

今月

来月

前月の現在

来月

本当

偽

去年

今年

来年

前2年

次の2年間

今年前年

CURRENT_NEXT_YEAR

来年の現在

間

今週

先週

来週

今週の前週

今週の次週

最後のN日間

次のN日間

先週

来週

最後のNか月

来月

最後の＿年

次のN年

レポートの印刷

https://<base_url>/<account_owner_name>/<app_link_name>/print/<report_link_name>

例: https://app.zohocreator.com/zchelp/employee-manager/print/Employee_View

レポートを基準で印刷する

URLフォーマットを使用して、'='（イコール）演算子を使用してレポートを印刷する：

https://<base_url>/<account_owner_name>/<app_link_name>/print/<report_link_name>?<FieldName1>=<FieldName1 Value>&<FieldName2>=<FieldName2 Value>

例：「Engineering」部門の従業員レコードを印刷するURLは次の通りです。
https://app.zohocreator.com/zchelp/employee-manager/print/Employee_View?Department=Engineering

レポートを印刷するURL形式（「=」（イコール）以外の条件）：

https://<基本URL>/<アカウント所有者名>/<アプリリンク名>/print/<レポートリンク名>?<フィールド名1>=<フィールド名1の値>&<フィールド名2>=<フィールド名2の値>&<フィールド名1_op>=<定数>&<フィールド名2_op>=<定数>

そこで、

FieldName1 & FieldName2	フォーム内のフィールドのDelugeスクリプト名です
FieldName1_op & FieldName2_op	オペレーターのパラメーター名（'FieldName'に'_op'を付けたもの）です
constant	各オペレーターに割り当てられる値です。すべてのオペレーターとその定数の一覧を見るには、こちらを参照してください表

例: 「従業員IDが1235より大きい」レコードを印刷するURLは、
https://app.zohocreator.com/zchelp/employee-manager/print/Employee_View?Employee_ID=1235&Employee_ID_op=21 です。

レポートを印刷するためのURLフォーマット（「between」演算子を使用） -

https://<base_url>/<account_owner_name>/<app_link_name>/print/<report_link_name>?<FieldName1>=<StartingValue>;<EndingValue>&<FieldName1_op>=<constant>

そこで、<StartingValue> および <EndingValue>は、任意の数値、小数または日付です。

例：任意の二つの日付の間にある入社日のレコードを印刷するためのURLは、以下の通りです。ここで、入社日は日付フィールドです。
https://app.zohocreator.com/zchelp/employee-manager/print/Employee_View?Date_of_Joining=18-Jan-2006;30-Apr-2007&Date_of_Joining_op=58

レポートにデータをインポートする

アプリケーションのコンポーネント（ページ、フォーム、ワークフローなど）にこのURLを追加することで、ユーザーがアクセスした際に、指定されたレポートへのデータのインポートを可能にすることができます。例えば、ユーザーの好みに応じて、ページパネルにこのURLを含めるか、ワークフロー内のopenURLタスクに含めることができます。

注意：ユーザーは、インポート権限がアプリケーションに付与されている場合にのみデータをインポートすることができます。

レポートへのデータのインポート用のURL形式は次の通りです：

https://<base_url>/<account_owner_name>/<application_name>/report/<report_link_name>/import

https://<base_url>/<account_owner_name>/<application_name>/report/<report_link_name>/インポート

例：売上管理アプリケーションを考えると、ユーザーが請求書データを持っており、そのデータを請求書レポートにインポートしたいと考えています。ユーザーは従来の方法で行うことができますが、またはアプリケーションページにURLをボタンパネルとして添付して、1クリックでデータをインポートできるようにすることもできます。ユーザーがボタンをクリックすると、インポートインターフェースに誘導され、請求書ファイルを選択すると、指定されたレポートにデータがインポートされます。
https://creatorapp.zoho.com/zchelp/sales-management/report/invoices/import

ページの機能に基づくURL

ページには、URL パラメーターも受け入れることができます。以下の URL を例として参照してください（パラメーター emp に値が渡されています）。

https://app.zohocreator.com/sampleapps/employees/#Page:Complete_Employee_details?emp=support@zohocreator.com

パラメーター付きのページを印刷する

パラメータを持つページを印刷するURLフォーマットは以下の通りです。

https://<base_url>/<account_owner_name>/<app_link_name>/print/<page name>?<paramName>=<paramValue>

そこで、

paramName	ページで定義されたパラメータの名前です
paramValue	ページで定義されたパラメータに渡される値です

例：ページ「TestHTML」を印刷するためのURLは、paramNameが「dept」、paramValueが「Engineering」となっています。ここで、paramName「dept」は、指定されたparamValueでレコードを取得するためにページで定義されているパラメータの名前です。
https://app.zohocreator.com/zchelp/employee-manager/print/TestHTML?dept=Engineering

ページをPDFに変換する

https://<base_url>/export/<account_owner_name>/<app_link_name>/pdf/<page_link_name>?<param1>=<value>&<param2>=<value>

注意：Creator 5アカウントは、このURLにisc5page=trueをクエリストリングとして含める必要があります。

例えば https://app.zohocreator.com/export/sampleapps/customer-support/pdf/More_Details_Html_View?ticketID=104
ここで ticketID というのは、ページで定義されたパラメーターの名前です。

PDFの出力の一部をカスタマイズするために、次のパラメータを追加することができます：

パラメーター	値	デフォルト値	目的
zc_FileName	(必要に応じて)	ページの表示名	出力PDFファイルの名前を設定します。例： https://app.zohocreator.com/export/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_FileName=DownloadReport
zc_PdfOrientation	portrait、landscape	portrait	ページのコンテンツをエクスポートする方向を設定します。例： https://app.zohocreator.com/export/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_PdfOrientation=landscape
zc_PdfSize	レター、A4、レガル、エグゼクティブ	レター	出力PDFファイルのページサイズを設定します。例えば： https://app.zohocreator.com/export/sampleapps/customer-support/pdf/Most_Recent_Solution?zc_PdfSize=A4を参照してください。

制限

ページ内に埋め込まれたフォーム/レポートは、こちらのフォーラムで議論されたようにサポートされていません。（これは、Delugeでサーバーサイドのインクルードディレクティブを提供することで行われます。ユーザーは、PDF出力を有効にするために新しい実装に変更する必要があります）。詳細については、当社の制限ページを参照してください。
PDFに変換するページ内のリンク/埋め込みでは、現在の資格情報が必要な画像/CSSなどの認証済みコンテンツはサポートされません。（公開コンテンツである必要があります）。

CSS/画像やその他のリンクを正しく表示するには、フルパスで指定する必要があります。例えば、/images/xyz.jpgは正しく表示されません。

注：ページのPDFエクスポートオプションの可視性を制御する方法については、こちらのページを参照してください：こちら。