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

概要

トピックZoho Creator URL Patternsでは、Zoho Creator アプリケーションおよびそのフォーム、レポート、ページにアクセスするための基本 URL について説明しました。このトピックでは、フォーム項目の初期値を設定したり、URL にデータ ID を渡してレコードを編集したり、条件を設定したり、レポートやページを印刷したりするための、機能別 URL について説明します。

すべての URL 形式で、次の要素を使用します。

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

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

アプリの各コンポーネントのパーマリンク形式は、次のとおりです。

フォーム向けの機能別 URL

フォーム項目の初期値を設定する

フォーム項目の初期値は、フォームの URL に追加パラメーターを渡すことで設定できます。たとえば、従業員マネージャーアプリケーションの項目 従業員 ID に値を自動的に読み込むには、フォームの URL にクエリ文字列（Employee_ID=1234）として初期値を渡します。ここで Employee_ID は、従業員フォーム内のその項目の Deluge スクリプト名です。

クエリ文字列付きフォーム URL の形式は、次のとおりです。

1. アプリケーション内からアクセスする場合:
   https://creatorapp.zoho.com/zchelp/employee-manager/#Form:Employee?Employee_ID=1234
2. パーマリンク経由でアクセスする場合:
   https://creatorapp.zoho.com/zchelp/employee-manager/form-perma/Employee?Employee_ID=1234
3. 別の Web ページに埋め込まれたフォームにアクセスする場合:
   https://creatorapp.zoho.com/zchelp/employee-manager/form-embed/Employee?Employee_ID=1234

複数選択項目やチェックボックス項目では、複数の値を設定する必要がある場合があります。その場合、URL 内では値をカンマ区切りで指定します。たとえば、従業員フォームの項目 Roles に「Manager」と「Programmer」という値を設定する場合、URL は次のようになります。 https://creatorapp.zoho.com/zchelp/employee-manager/#Form:Employee?Roles=Manager,Programmer

項目にフォーカスを当てずにフォームを読み込む

Zoho Creator アプリケーションでフォームにアクセスすると、フォームの最初の項目にフォーカスが自動的に設定され、カーソルがその項目上に表示されることに気づくでしょう。

Webサイトやブログにフォームを埋め込んでいるとします。ページが表示されると、初期設定のオートフォーカス動作により、ページはフォームが配置されている位置までスクロールされます。これにより、埋め込みフォームより上にあるコンテンツが飛ばされてしまい、ユーザー体験を損なう可能性があります。これを回避するために、Zoho Creator では zc_Focus パラメーターを提供しています。

URL にレコード ID を指定して個別レコードを編集する

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

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

レポートの機能別 URL

レコードを詳細ビューで表示する

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

レポートの URL にフィルター条件をクエリ文字列として設定することで、レポートに表示されるデータをフィルターできます。複数条件でのフィルタリングもサポートされており、2 つの項目と値のペアはアンパサンド文字 (&) で区切ります。以下は、従業員 Manager アプリケーションの 従業員ビュー レポートをフィルターする例です。このレポートの 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 は、この 従業員 Manager アプリケーションの 設定 で指定されている日付形式に従っています。レポートの URL にクエリ文字列として追加する日付値は、アプリケーションで設定されている日付形式と一致している必要があります。

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

ここで、

例:

• このレポートで、従業員名が 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 は次のとおりです。このアプリケーションの日付 of Joining項目は日付型であり、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 形式

• このレポートで、日付 of Joiningが直近 n 年に含まれる従業員データのみを表示するための URL は次のとおりです。ここで、70は「LAST N YEAR」演算子を表す定数です。この形式は、NEXT N YEAR、LAST N MONTH、LAST N WEEK、LAST N DAY などの演算子にも適用されます。
  https://creatorapp.zoho.com/zchelp/employee-manager/#Report: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/employee-manager/#Report:Employee_View?Date_of_Joining_op=56

演算子とその定数の一覧

レポートを印刷する

例: https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View

条件付きでレポートを印刷する

• 条件に'=' (Equal)演算子を使用してレポートを印刷するための URL 形式:
  
  https://<base_url>/<account_owner_name>/<app_link_name>/print/<report_link_name>?<FieldName1>=<FieldName1 値>&<FieldName2>=<FieldName2 値>

  例: 「Engineering」部署に所属する従業員データを印刷するための URL は次のとおりです。
  https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View?Department=Engineering

• 条件に'=' (Equal)以外の演算子を使用してレポートを印刷するための URL 形式:
  
  https://<base_url>/<account_owner_name>/<app_link_name>/print/<report_link_name>?<FieldName1>=<FieldName1 値>&<FieldName2>=<FieldName2 値>&<FieldName1_op>=<constant>&<FieldName2_op>=<constant>
  
  
  ここで、
  

  FieldName1& FieldName2	フォーム内の項目に対応する Deluge スクリプト名です。
  FieldName1_op& FieldName2_op	演算子用のパラメーター名です（'FieldName' に '_op' を付加したもの）。
  constant	各演算子に割り当てられる値です。すべての演算子とその定数の一覧は、この表を参照してください。

  例: 従業員 ID GREATER_THAN 1235 という条件でデータを印刷するための URL は次のとおりです。
  https://creatorapp.zoho.com/zchelp/employee-manager/print/Employee_View?Employee_ID=1235&Employee_ID_op=21

• 条件に'が次の間'演算子を使用してレポートを印刷するための URL 形式 -
  
  https://<base_url>/<account_owner_name>/<app_link_name>/print/<report_link_name>?<FieldName1>=<StartingValue>;<EndingValue>&<FieldName1_op>=<constant>

  ここで、<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

ページでも URL パラメーターを受け取ることができます。以下の URL は、例としてアクセスできます（パラメーター emp に値が渡されています）。

https://creatorapp.zoho.com/sampleapps/employees/#Page:Complete_Employee_details?emp=##PROTECTED_0##

パラメーター付きでページを印刷するには

ここで、

例: 'TestHTML' という名前の Page を印刷するための URL で、paramName が 'dept'、paramValue が 'Engineering' の場合は、次のようになります。ここで、paramName 'dept' は、指定した paramValue を使用してデータを取得するために Page で定義されているパラメーター名です。
https://creatorapp.zoho.com/zchelp/employee-manager/print/TestHTML?dept=Engineering

Page を PDF に変換するには

例: https://creatorapp.zoho.com/export/sampleapps/customer-support/pdf/More_Details_Html_View?ticketID=104
ここで、ticketID は Page で定義されているパラメーター名です

出力される PDF の内容をカスタマイズするために、次のパラメーターを追加できます。

埋め込みレポートで変更内容を保持するための URL 形式

レポートをページに埋め込んだ場合、検索、並べ替え、グループ化、フィルターなど、元のレポートに対して行った変更は、デフォルトでは保持されません。代わりに、zc_RetainChanges パラメーターを使用して埋め込みレポートがこれらの変更を保持するように設定できます。このパラメーターは、Web デバイスレイアウトでのみサポートされます。

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

これにより、（従業員名による）並べ替えが、埋め込みコンテキストにおいても元のレポートコンポーネントと同期されます。

制限事項

1. ページ内に div 埋め込みされたフォーム／レポートはサポートされません。この点については、すでに次のフォーラム投稿で説明しています。（これは、Deluge でサーバーサイドの include ディレクティブ、つまり #include サポートを提供した後にのみ対応されます。PDF 出力を有効にするには、完了後にユーザー側で新しい実装へ変更していただく必要があります）。詳細については、制限事項ページを参照してください。
2. 現在の認証情報を必要とする画像／CSS などの認証付きコンテンツはサポートされません。つまり、PDF に変換されるページ内のリンクや埋め込みは、公開コンテンツである必要があります。