変数の作成と管理

変数の作成と管理

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

1. このページの内容

Creator アプリケーション全体で参照および更新できる値を保持する変数の作成方法については、こちらを参照してください。

先に進む前に、変数とその重要性についても参照してください。

2. 提供状況

  1. 変数は、Creator のすべてのプランで利用できます。
  2. スーパー管理者、管理者、開発者のみが変数を作成および管理でき、その他のユーザーは参照のみ可能です。
  3. この機能は、すべてのデータセンターで利用できます。

3. 変数の作成

一度作成した変数は、Creator アプリケーション内のどこからでも値を参照および更新できます。これにより、変数とその値を一元的に管理し、一貫性を保つことができます。変数を作成する前に、変数に関する関連事項をすべて理解しておいてください。
メモ:変数はスーパー管理者、管理者、開発者がアクセスできるため、機密データを変数に保存することは推奨されません。さらに、変数に保存された値は、スクリプトの実行を通じて有効なアプリケーションユーザーからアクセス可能になる場合があります。フォームに保存されたデータとは異なり、変数に対してはユーザー権限を設定できません。

3。1. 変数作成の流れ


3。2. 変数の作成方法を見る


3。3. 変数を作成する手順

変数を作成するには:
  1. 変数を作成するアプリケーションの編集モードに移動し、設定をクリックします。
  2. Developer toolsの下にあるVariablesをクリックします。

  3. 最初の変数を作成するには、変数を追加ボタンをクリックします。

    右側にペインが開くので、グループ名変数名などの詳細を入力します。

  4. 変数フィールドに、変数の名前を入力します。
  5. メモ:
    1. 1 つのアプリケーションにつき、最大 20 個の変数を作成できます。
    2. 変数名には英数字とアンダースコアを使用できますが、数字またはアンダースコアで開始することはできません。使用可能な変数名の例: interestRate、Branch24、email_id
    3. 変数名は 50 文字未満である必要があります。
  6. 変数を分類するグループを作成するには、+ グループを追加をクリックし、グループ名を入力します。すでにグループを作成している場合は、ドロップダウンからグループを選択できます。グループによる分類が不要な場合は、このフィールドを空のままにして続行できます。
  7. メモ:
    1. 同じグループ内で、同じ名前の変数を 2 つ以上作成することはできません。
    2. 1 つのアプリケーションにつき、最大 10 個のグループを作成でき、グループ名は一意である必要があります。
    3. グループ名は 50 文字未満である必要があります。
    4. グループ名には英数字とアンダースコアを使用できますが、数字またはアンダースコアで開始することはできません。使用可能なグループ名の例: interestRate、ZykerBranch、organization_info
  8. 定義済みの値フィールドに、変数の値を入力します。変数のデータ型は、入力した値の形式に基づいて自動的に割り当てられます。
  9. メモ:
    1. コレクションのサイズは 2kB 未満である必要があります。
    2. 1 つのアプリケーションにつき、作成できるコレクションは最大 4 つまでです。

    1. 以下の表で、データの種類ごとに分類されたサンプル値を確認できます。

    2. データの種類


      サンプル値


      番号

      1
      メモ: 番号データ型でサポートされる値の範囲は、-9,223,372,036,854,775,808 ~ 9,223,372,036,854,775,807 です。


      小数


      1。0

      メモ: 小数データ型の整数部は 19 桁以内、小数部は 6 桁以内である必要があります。


      Boolean



      Text


      Hello World
      メモ: TEXT 型変数の最大文字数は 255 文字です。


      コレクション (List)


      ['Creator',6]

      メモ:

      - コレクション内では、日付および日付-時間データ型の値はサポートされません。

      - コレクションのサイズは 2 KB を超えることはできません。


      コレクション (キー-値)


      {'商品' : 'Creator', 'バージョン' : 6}


      メモ:

      - コレクションで指定するキーは TEXT のみ使用できます。

      - コレクション内では、日付および日付-時間データ型の値はサポートされません。

      - コレクションのサイズは 2 KB を超えることはできません。


      日付


      '15-Aug-1947'

      サポートされるその他の日付形式については、この ヘルプ ドキュメントを参照してください。

      メモ: 入力される日付値は、サポートされている任意の日付形式で指定できます。ただし、返される日付値の形式は、アプリケーションの日付形式設定に基づきます。

    3. メモ: 変数に設定された値が、いずれのデータ型の形式とも一致しない場合、その変数はTEXTデータ型として扱われます。
  10. [作成] をクリックします。
    1. 追加が完了すると、定義済みの値と現在値が次のように表示されます。変数名で検索するには[検索]タブを、目的の変数グループを絞り込むには[フィルター]タブを使用できます。

メモ:定義値とは、変数が作成された時点で担当者によって設定された値を指します。一方、現在値は、その後アプリケーション内でスクリプトが実行されるたびに更新される、変数の最新のリアルタイム値を表します。

4. コードビューで変数を作成・更新する

コードビューは、作成済みのすべての変数を整形されたコード形式で表示するページです。これにより、そのアプリケーションで作成した変数へ簡単にアクセスし、管理できます。
メモ:コードビューでは、変数や変数グループの名前変更や削除はできません。
コードビューで変数を作成するには:
  1. アプリケーションの設定で、Developer Tools 配下の Variables に移動します。ここに、作成済みのすべての変数が一覧表示されます。

  2. 右上に表示されている コードビュー をクリックします。
    1. 作成済みの変数がコード形式で表示されます。まだ変数を作成していない場合は、空の Deluge エディターが表示されます。
    2. コード内の値を直接編集することも、以下の構文に従って新しい変数を作成することもできます。

      グループありの変数を作成する場合:
    3. thisapp。variables.<group_name>.<variable_name> = <値>;

    4. グループなしの変数を作成する場合:
    5. thisapp。variables.<variable_name> = <値>;
  3. 保存 をクリックします。行われる変更内容の概要を確認するポップアップが表示されます。
  4. ポップアップで 続ける をクリックし、コードビュー で行った変更を保存します。

5. Deluge を使用して変数にアクセス・変更する

アプリケーション内の変数は、Deluge を使用してアクセスおよび更新の両方が可能です。Deluge スクリプトを通じて変数の値を変更すると、その値は変数の現在値として保存されます。この現在値は、アプリケーション内でスクリプトが実行されるたびにリアルタイムで動的に更新され、その更新された値がアプリケーション全体に反映されます。

メモ:
  1. 同時に変数へアクセスおよび変更を行うと、期待した結果が得られない場合があります。
  2. Deluge スクリプトで更新された変数の値は、スクリプトの実行中は更新後の値で処理されますが、現在値に反映されるのはスクリプト実行の終了時点のみです。
アプリケーションで変数にアクセスして利用するには、以下の構文に従います。

グループ内の変数の場合:
  1. // 変数にアクセスする
  2. thisapp。variables.<group_name>.<variable_name>;
  3. // 変数を変更する
  4. thisapp。variables.<group_name>.<variable_name> = <値>;

グループに属さない変数の場合:
  1. // 変数にアクセスする
  2. thisapp。variables.<variable_name>;
  3. // 変数を変更する
  4. thisapp。variables.<variable_name> = <値>;
ここで:
  1. <group_name> は、その変数が属するグループ名を表すテキストです。
  2. <variable_name> は、指定したグループ内で値にアクセスする対象の変数名を表すテキストです。
たとえば、Organization_Details というグループ内に、値が Zylker TechnologiesOrganization_Name という変数がある場合、その値には次のスクリプトでアクセスできます:
  1. info thisapp.variables.Organization_Details.Organization_Name; // Zylker Technologies を返します

6. 異なる環境における変数

変数は、アプリケーションの開発環境にあるアプリケーション設定からのみ作成および管理できます。ただし、アプリケーションを開発環境から後続の環境へ公開した場合、変数の現在値は引き継がれません。その代わり、公開時点の定義値に置き換えられます。現在値は、各環境で実行されるスクリプトに応じて環境ごとに異なる場合があります。
メモ:環境設定では、その環境に固有の変数の定義値と現在値のみを表示できます。変数を作成または管理するには、開発環境のアプリケーション設定にアクセスする必要があります。
例:
開発環境で、'Interest' という変数の定義値が '7。5'、現在値が '8。0' であるとします。アプリケーションをステージ環境に公開すると、変数の定義値のみが引き継がれ、現在値は初期設定で定義値の '7。5' に設定されます。この時点で、ステージ環境では 'Interest' 変数の定義値と現在値の両方が '7。5' になります。以下の表は、これをわかりやすく示したものです。

 

Variable

Development Environment

Stage Environment

Interest

Defined 値

現在 値

Defined 値

現在 値

7。5

8。0

7。5

7。5


ステージ環境でのスクリプト実行によっては、その環境の現在値がさらに変更される場合があります。たとえば、ステージ環境の現在値がスクリプト実行により「10。0」に更新されたとします。このとき、開発環境で変数の定義値を「8。5」に更新し、再度ステージ環境に公開すると、現在値「10。0」は更新された定義値「8。5」に置き換えられます。以下の表は、これをわかりやすく示したものです。

変数

開発環境
(値を編集)

ステージ環境
(既存の値)

ステージ環境
(アプリケーションを再公開)

Interest

定義値

現在値

定義値

現在値

定義値

現在

8。5

8。5

7。5

10。0

8。5

8。5


同じシナリオが、変数をステージ環境から本番環境へ公開する場合にも当てはまります。
環境ごとの変数とその値を表示するには、環境の設定で[Variables]セクションに移動します。詳細はこちら

7. 変数を管理する

変数を管理すると、次の操作を行えます:
  1. 変数の参照を表示
  2. 変数を編集
  3. 変数を削除
  4. グループ名を変更
  5. グループを削除

7。1. 変数の参照を表示

参照には、対象の変数がアプリケーション内で使用されているすべての場所の一覧が含まれます。参照を表示するには、次の手順を実行します:
  1. アプリケーションの設定で、Developer Tools内のVariablesに移動します。ここに、作成したすべての変数が一覧表示されます。
  2. 参照を確認したい変数名をクリックします。

  3. Variable項目の下にある変数の参照を表示ハイパーリンクをクリックします。
アプリケーション内でその変数が使用されているすべての場所の一覧が、ポップアップで表示されます。

7。2. 変数を編集

変数の値を編集すると、定義値と現在値の両方が自動的に更新されます。変数を編集するには、次の手順を実行します:
  1. アプリケーションの設定で、Developer Tools内のVariablesに移動します。ここに、作成したすべての変数が一覧表示されます。
  2. 編集したい変数名をクリックします。

  3. 次のページで、変数の詳細が表示されます。変数名を変更するにはVariable項目を、変数の値を更新するには項目をクリックします。
  4. メモ:
    1. 変数を別のグループに移動することはできません。
    2. 変数に、異なるデータ型の値を割り当てることはできません。言い換えると、変数のデータ型は更新できません。

  5. 更新するをクリックします。
    1. 確認ポップアップで変更するをクリックすると、変更内容がすぐに保存されます。
    2. リストからキー値構造への変更、またはその逆など、コレクション変数タイプの変更を行う場合は、そのコレクション変数が使用されているすべての場所の参照を表示するポップアップウィンドウが表示されます。これらの参照を確認し、変更するをクリックして変更を保存できます。
メモ:キー値コレクションからキーを削除する場合は、参照を適切な値に置き換えてください。同様に、リスト型コレクションにキーを追加する場合は、参照をキー値ペアに置き換えてください。この予防的な手順は、アプリケーションで発生しうるエラーを防ぎ、その機能性を維持するために重要です。

7。3. 変数を削除

変数を削除するには、次の手順を実行します。
  1. アプリケーションの設定で、Developer Tools 配下の Variables に移動します。作成したすべての変数がここに一覧表示されます。
  2. 削除したい変数にカーソルを合わせ、表示される削除アイコン()をクリックします。
    1. その変数がアプリケーション内で使用されていない場合は、表示される確認ポップアップで 削除 をクリックすると、すぐに削除されます。
    2. 使用されている場合は、その変数を使用しているすべての場所の一覧を示すポップアップが表示されます。
    3. 変数を削除し続けるには、表示されたすべての参照を削除する必要があります。

7。4. グループ名を変更する

グループ名を変更すると、アプリケーション全体で、そのグループ内の変数および参照に新しいグループ名が適用されます。変数グループ名を変更するには、次の手順を実行します。
  1. アプリケーションの設定で、Developer Tools 配下の Variables に移動します。作成したすべての変数がここに一覧表示されます。
  2. 変更したいグループ名にカーソルを合わせ、編集アイコン()をクリックします。

  3. ポップアップで新しいグループ名を入力し、名前を変更する をクリックします。

7。5. グループを削除する

変数グループを削除するには、次の手順を実行します。
  1. アプリケーションの設定で、Developer Tools 配下の Variables に移動します。作成したすべての変数がここに一覧表示されます。
  2. 削除したいグループ名にカーソルを合わせ、削除アイコン()をクリックします。

    1. そのグループ内の変数がアプリケーションで使用されていない場合は、表示される確認ポップアップで 削除 をクリックすると、すぐに削除されます。
    2. 使用されている場合は、参照を持つすべての変数の一覧を示すポップアップが表示されます。
    3. 変数グループを削除し続けるには、表示されたすべての変数とその参照を個別に削除する必要があります。

8. 注意点

  1. 同一グループ内の変数名は一意である必要があります。
  2. 変数のデータ型は作成後は固定され、変更できません。コレクション データ型の場合、値はリスト形式からキー値形式、またはその逆に変更できます。
  3. キー値型のコレクションをリスト型コレクションに変更する場合は、参照を適切な値に置き換えてください。同様に、リスト型コレクションをキー値型コレクションに変更する場合は、参照をキーと値のペアに置き換えてください。この予防的な手順により、アプリケーションで発生しうるエラーを防ぎ、機能性を維持できます。

9. 制限事項

  1. 変数を含む C5 アプリケーションでは、テスト環境を作成することはできません。
  2. C5 テスト環境および Developer Zone 内のアプリケーションでは、変数は利用できません。
  3. 1 つのアプリケーションにつき、作成できるグループは最大 10 個です。
  4. 1 つのアプリケーションにつき、グループ数に関係なく、作成できる変数は最大 20 個です。そのうちコレクション データ型の変数は最大 4 個までです。
  5. 各コレクション変数のサイズは 2 KB を超えてはなりません。
  6. 変数をあるグループから別のグループへ移動することはできません。
  7. システム変数は、Deluge スクリプトを介してのみ変数に割り当てることができます。
  8. コードビューでは、変数または変数グループの名前変更や削除は現在サポートされていません。
  9. 1 日あたり、Deluge スクリプト経由で実行できる変数の代入は最大 500 回です。
  10. スクリプトから同時に変数へアクセスおよび変更を行うと、期待どおりの結果が得られない場合があります。
  11. 次のワークフロー処理では、スクリプトから変数の値を更新することはできません。
    1. フォームの読み込み時
    2. フォームの検証時
    3. 項目のユーザー入力時
    4. サブフォーム - 行の追加時
    5. サブフォーム - 行の削除時
    6. サブフォーム - 項目のユーザー入力時
    7. ステートレスフォーム - ボタン処理
    8. ページスクリプト
  12. メモ:これらの処理内で、変数の変更を伴う関数が呼び出された場合、その関数は実行されません。
  1. 変数について


    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

                                  • 変数の理解

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 このページの内容 Creator アプリケーション全体で参照および更新できる値を保持する変数について説明します。 提供状況 変数は、Creator のすべてのプランで利用できます。 スーパー管理者、管理者、開発者のみが変数を作成および管理でき、その他のユーザーは参照のみ可能です。 ...

                                  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.