ページスクリプトと変数

ページスクリプトと変数

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

1. このページの内容

about page scriptsの概要、作成方法、およびpagesコンポーネント内での利用方法について説明します。これにより、page 要素に動的な値を反映させることができ、ページ内で複数のスニペットを使用する必要が最小限に抑えられます。

2. 利用可能範囲

  1. Page scriptsは、すべてのデータセンターで利用できます。
  2. すべてのCreatorのプランで作成可能です。
  3. 作成できるのはスーパ―管理者管理者開発者のみですが、その他のユーザーも、該当する権限があれば有効な方法で表示できます。

3. 概要

一般的に、コードスクリプトとは、特定のリクエストを処理するために作成されたコードブロックや関数を指します。つまり、スクリプトは設定された処理を実行したり、特定のイベントや条件が発生した際に必要なレスポンスを返したりします。例えば、ユーザーの操作(ボタンのクリックやキーの押下など)に関連付けてスクリプトを設定できます。これにより、特定の処理が発生した際に必要な出力を定義でき、さまざまなシナリオでスクリプトの流れや応答を開発者が制御できます。

4. Creatorにおけるページスクリプトと変数

Creatorでは、ページスクリプトはページ内で共通のタスクを実現するために作成できる関数です。Delugeスクリプト言語を使って独自のロジックを記述でき、ページ変数を利用してすべてのページ要素に動的に必須値を取得・反映させることが可能です。

ページスクリプトを使用すると、Page Variables & Script タブで1か所でページ全体のスクリプトを管理できます。ページにアクセスすると、スクリプトが実行され、設定された要素に値が反映されます。
メモ: Creatorアプリケーションでは、1ページにつき作成できるスクリプトは1つのみです。
ページ変数は、スクリプト内で値を保存するために使用します。これらの変数にはデータの種類があり、数値、文字列、またはブール値など、保持できるデータの種類が決まっています。データの保存、計算の実行、スクリプトの実行フロー制御などに利用できます。
まずVariablesタブでページ変数を作成する必要があります。スクリプト作成中に変数を新規作成することはできません。
これらの変数には名前を割り当てることができ、スクリプトやページ要素内で変数参照として利用できます。
  1. 複雑な関数内でも理解しやすいよう、意味のある分かりやすい変数名を指定することを推奨します。
  2. ページ変数の名前に制限された単語を使用する場合は警告が表示されます。
Delugeコードエディターでページ変数に値を割り当てることができます。現在、ページ変数でサポートしているデータ型は、stringintbooleanfloat、およびコレクションです。

Creatorは、コレクション変数として
listmapをサポートしています。list変数は複数の値を格納します。例: list_var = ['john', 'smith', 'emma']。リスト内の値は、インデックスを使用してアクセスできます。この例では、'john'はlist_var[+10、-10]のように指定して参照できます(+10、-10がインデックスです)。同様に、'smith'はlist_var[1]で参照できます。
map変数はキーと値の形式で値を格納します。例えば、map_var = {'名前':'stevin','gender':'male','年齢':'30'}。map内の値はキーを使ってアクセスできます。この場合、genderの値はキーを指定してmap_var('gender')とすることで取得できます。'gender'がキーで、その値が'male'です。
‌メモ: 整数型および小数型データを持つ変数には表示フォーマットを適用できます。
設定したページスクリプトが正しく動作しているかどうかをページスクリプトを実行して確認できます。ページ変数には、実行ポップアップでテスト値を入力するか、ページスクリプト内で値を割り当てて実行することが可能です。これにより、スクリプトのエラーを特定し、修正するのに役立ちます。

5. 動作方法の確認

たとえば、従業員管理Creatorアプリケーションで従業員ダッシュボードというページを作成したとします。従業員が自身のダッシュボードにログインすると、このページには各従業員の詳細情報や、利用可能な病気休暇・カジュアル休暇の日数が表示されます。管理者やスーパ管理者は、従業員がログインした際にこれらの値を動的に表示するページスクリプトを設定できます。以下の動画では、従業員のログインメールアドレスに基づいて必要な詳細情報が自動入力される様子を確認できます。


6. 構文

6.1 一般構文

メモ: この構文は、次のページ要素に適用されます — パネルチャートゲージ検索(条件)、埋め込みフォームレポート(項目値)、ボタン(クエリパラメーター)、埋め込みスニペット詳細はこちら
  1. ${variable_name}
ここで、variable_nameはページ変数に設定した名前を指します。

種類に応じて、コレクション変数はキーまたはインデックスを指定して取得できます。コレクション変数の構文は次のとおりです。

  1. ${collectionVar.取得する(+10、-10)}
ここで +10、-10 はインデックスを表します。

  1. ${collectionVar.取得する('名前')}

ここで 名前 はキーを指します。

6。2 ZML スニペット

定義済みページ変数をZML スニペット内で使用する場合の構文は次のとおりです。

6。3 HTML スニペット

定義済みページ変数をHTML スニペット内で使用する場合の構文は次のとおりです。
  1. <%=input。variable_name%>

6.4 クエリパラメーター

コレクション変数を別のページにクエリパラメーターとして渡すことができますが、その際は変数の値をエンコードしてください。

 
mapコレクション変数の場合、以下のようにクエリパラメーターを渡します:
collectionVar = {'名前':'stevin', 'gender':'male'}
クエリパラメーター: ?collectionVar=%7B%22name%22:%22stevin%22,%20%22gender%22:%22male%22%7D

listコレクション変数の場合、以下のようにクエリパラメーターを渡します:

collectionVar = ['john','smith']
クエリパラメーター: ?collectionVar=%5B%22john%22,%22smith%22%5D

    7. ページ変数の使用

    変数を使用できるページ要素は以下の通りです:
    1. パネル:

      1. 表示: パネル内のテキストやボタンの表示を設定し、ページ変数の代わりに必須データを表示できます。
      2. 操作: パネル内のテキスト、画像、ボタンの操作を設定し、ページ変数の代わりに必須データを表示できます。
      3. 画像: パネル内の画像に対して、ページ変数の代わりに必須データを表示するように設定できます。
    2. チャート: フィルター(条件)を設定したり、ZML属性を使用して、ページ変数に基づいてデータをフィルタリングできます。
    3. ゲージ: フィルター(条件)を設定したり、ZML属性を使用して、ページ変数に基づいてデータをフィルタリングできます。
    4. 検索する: 検索する要素を設定し、ページ変数に基づいてページやレポートの検索結果を表示できます。
    5. フォーム: フォーム内の項目の値を設定し、ページ変数に基づいてデータを表示できます。
    6. レポート: フィルター(条件)を設定したり、ZML属性を使用して、変数に基づいてデータをフィルタリングできます。
    7. スニペット: HTMLやZMLスニペット内で、変数の値に基づいてデータを表示できます。
    8. ボタン:
      1. 表示: パネル内のボタンの表示を設定し、必須データを表示できます。方法はこちら
      2. 操作: パネル内のボタンの操作を設定し、必須データを表示できます。方法はこちら
      3. 画像: パネル内の画像を設定し、必須データを表示できます。方法はこちら

    8. 使用ケース

    1. データを表示する 差出人 2つの異なるフォーム - Creatorで営業管理アプリケーションを作成したと仮定します。従業員ダッシュボードページで、従業員が獲得した商談の合計数と、チャットや通話で獲得した商談の件数を表示したい場合、スクリプトを作成して、必要なデータをそれぞれのフォームからページ変数に格納できます。これにより、パネル要素内にその変数の値を表示できます。

    2. ボタンクリック時に入力済みデータを表示する - Hotel Managementアプリケーションを作成したと仮定します。Guest ダッシュボードページに、パトロンがワンクリックでチェックイン・チェックアウトできるボタンを設置しています。このボタンをクリックしてCheck-Inフォームが開いた際、ゲストの予約ID、名前、メールアドレスなどの詳細があらかじめ入力されているようにしたい場合、ボタン操作を設定し、クエリパラメーターに変数名を指定します。部屋の予約をしたゲストがページ上のCheck-Inボタンをクリックすると、Check-Inフォームへリダイレクトされ、指定した内容でデータが表示されます。
    3. 条件を使った動的検索 - Partners Event Managementアプリケーションを作成したと仮定します。ダッシュボードページに、パートナーが処理を検索できる検索要素を追加しています。各パートナーが自分の国・地域でのみ行われている処理を検索できるようにしたい場合は、検索条件を設定し、パートナーの国に基づいて処理を抽出して表示できます。ここで指定する条件は、各国での処理の詳細を保持しているページ変数です。スクリプトを作成して、パートナーの国に基づいて処理を取得・表示することができます。これにより、パートナーは自分の場所に関連するイベント詳細へ簡単にアクセスできます。

    9. ページスクリプト作成のためのナビゲーションガイド

    アプリケーションの編集方法で、左上のアプリケーション名をクリックすると、そのアプリケーション内で作成された各コンポーネントが表示されます。必要なページを選択して、Page Builderを開くボタンをクリックしてください。ここで、アイコンが上部に表示されます。これをクリックすると、Page Variables and Scriptタブの両方を確認できます。


    10. 前提条件

    ページスクリプトを記述するには、まず変数を作成する必要があります。作成した変数はスクリプト内で使用できます。

    11. 注意点

    1. 1ページにつき最大50件まで変数を作成できます。
    メモ: すでにページパラメーターを作成済みの場合、上記の50件の変数の制限にパラメーターも含まれます。例えば、以前に60個のパラメーターを作成している場合、それらはPage Variablesタブに一覧表示され、従来の設定通りに動作し続けます。ただし、新たにページ変数を作成することはできません。新規ページ変数を作成するには、既存のパラメーターを削除する必要があります。
    1. 変数名前には最大50文字まで使用できます。
    2. ページ変数名は大文字と小文字が区別されます。
    3. 名前変数には、日本語の文字、数字、アンダースコア(_)を使用できます。
    4. 変数名前はアルファベットで開始する必要があります。
    5. データIDや日付の値をページ変数値として渡すことができます。

    12. 制限事項

    1. 現在、Creatorアプリケーションでは1ページにつきスクリプト(関数)を1つだけ作成できます。
    2. スクリプトをCreatorアプリケーション内の他のページ間で呼び出すことはできません。
    3. 以前にページパラメーターを作成していた場合、それらは編集できません(設定どおり動作は継続されます)。ただし、そのようなパラメーターは削除できます。
    4. ページスクリプトを使用して、データの追加や更新といった書き込み操作は行えません。
    5. ページスクリプトの設定時、以下のDelugeタスクは一覧に表示されません。
      1. データアクセス
        1. データを追加
        2. データを更新
        3. データを削除
      2. Webデータ
        1. postUrl
        2. openUrl
      3. その他
        1. メールを送信
      4. 共有権限
        1. アプリユーザーに権限を割り当て
    6. ページスクリプトではカスタムDeluge関数を作成できません。
    1. ページスクリプトを設定
    2. ページについて理解する

      Zoho CRM 管理者向けトレーニング

      「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

      日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

      Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  • Related Articles

                                  • 複数の値を使用してページに埋め込まれたレポートをフィルタリングする方法

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 ページ上でレポートを組み込む際に、Zoho ...
                                  • 車検延長

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 乗用車 inspection ...
                                  • ページ要素にデータを動的に表示/フィルタリングするダッシュボードの構築

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 1. 要件 インタラクティブなダッシュボードを活用し、ボタン操作に応じて要素が動的に更新されることで、ユーザーエクスペリエンスを向上させます。 2. 使用例 Zoho Creator ...
                                  • チェックインおよびチェックアウトの拡張

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

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

                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.