変数の作成と管理

変数の作成と管理

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

1. このページの内容

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

変数とその重要性についての詳細を理解してから、先に進んでください。

2. 利用可能状況

  1. 変数は、Creatorのすべてのプランでご利用いただけます。
  2. スーパー管理者、管理者、開発者のみが変数の作成および管理を行えますが、他のユーザーは変数へアクセス可能です。
  3. この機能は、すべてのデータセンターでご利用いただけます。

3. 変数の作成

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

3。1. 変数作成フロー


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


3。3. 変数作成の手順

変数を作成するには:
  1. 目的のアプリケーションの編集方法に移動し、変数を作成して設定をクリックします。
  2. Developer tools内のVariablesをクリックします。

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

    画面右側にパネルが開きますので、グループ名Variable 名前などの詳細を入力してください。

  4. Variable項目に、変数の名前を入力してください。
  5. メモ:
    1. 1アプリケーションにつき最大20個の変数を作成できます。
    2. Variable名前には英数字およびアンダースコアが使用できますが、数字またはアンダースコアで始めることはできません。有効な変数名の例:interestRate、Branch24、email_id
    3. Variable名前は50文字未満でなければなりません。
  6. + 追加する グループをクリックしてグループを作成し、グループ名を入力してください。すでに作成済みのグループがある場合は、ドロップダウンからグループを選択できます。グループで分類せずにこの項目を空欄のまま進めることも可能です。
  7. メモ:
    1. 同じグループ内で同じ名前の変数を2つ作成することはできません。
    2. 1アプリケーションにつき最大10個のグループを作成でき、グループ名は一意でなければなりません。
    3. グループ名は50文字未満でなければなりません。
    4. グループ名には英数字およびアンダースコアが使用できますが、数字またはアンダースコアで始めることはできません。有効なグループ名の例:interestRate、ZykerBranch、organization_info
  8. Defined 値項目に変数の値を入力します。入力した値の形式に応じて、変数のデータ型が自動的に割り当てられます。
  9. メモ:
    1. コレクションのサイズは2kB未満でなければなりません。
    2. 1アプリケーションにつき最大4つのコレクションのみ作成できます。

    1. 下記の表は、データの種類ごとに分類済みのサンプル値です。

    2. データの種類


      サンプル値


      番号

      1
      メモ: 番号の値は-9,223,372,036,854,775,808から9,223,372,036,854,775,807までの範囲のみサポートされています。


      小数


      1。+10、-10

      メモ: 小数 データの種類の整数部は最大19桁まで、小数部は最大6桁まで入力できます。


      Boolean



      テキスト


      Hello World
      メモ: TEXT 種類の変数は最大255文字まで入力できます。


      コレクション(リスト)


      ['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. . = <値>;

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

5. Delugeによる変数の参照と変更

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

メモ:
  1. 変数への同時アクセスや同時変更を行った場合、期待通りの結果が得られないことがあります。
  2. Deluge スクリプトを通じて更新された変数の値は、スクリプトの実行終了時にのみ現在の値として反映されます。スクリプトの実行中は更新後の値が使用されますが、即座には現在の値には反映されません。
アプリケーションで変数にアクセスし利用するには、以下の構文に従ってください。

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

グループに属さない変数の場合
  1. //変数へアクセスする場合
  2. thisapp。variables. ;
  3. //変数を変更する場合
  4. thisapp。variables. = <値>;
各項目の説明:
  1. 変数が所属するグループの名前を表すテキストです。
  2. 指定されたグループ内の変数名を表すテキストで、その値にアクセスするために使用します。
たとえば、Organization_Detailsというグループ内にOrganization_Nameという変数があり、その値がZylker Technologiesの場合、以下のスクリプトで値にアクセスできます。
  1. info thisapp。variables。Organization_Details。Organization_Name; // Zylker Technologies を返します

6. 異なる環境での変数

変数はアプリケーションの開発環境にあるアプリケーション設定から作成および管理できます。ただし、アプリケーションが開発環境から他の環境へ公開済みとなった場合、変数の現在の値は転送されません。代わりに、公開済みで定義された値に置き換えられます。現在の値は、環境ごとにその環境固有のスクリプト実行によって異なる場合があります。
メモ:環境設定では、その環境固有の変数の定義済み値と現在の値のみを表示できます。変数を作成または管理するには、開発環境のアプリケーション設定にアクセスする必要があります。
例:
開発環境で「Interest」という変数があり、定義済み値が「7.5」、現在の値が「8、+10、-10」とします。アプリケーションがステージ環境に公開された場合、変数の定義済み値のみが転送され、初期設定として現在の値は定義済み値「7.5」に設定されます。これにより、ステージ環境では「Interest」変数の定義済み値と現在の値の両方が「7.5」となります。以下の表は、その内容をわかりやすくまとめたものです。

 

変数

開発環境

ステージ環境

利息

定義済み値

現在値

定義済み値

現在値

7.5

8、+10、-10

7.5

7.5


ステージ環境でのスクリプト実行により、現在の値がさらに変更される場合があります。例えば、ステージ環境の現在の値がスクリプト実行によって『10。+10、-10』に更新されたとします。その後、開発環境で変数のdefined 値を『8。5』に変更し、再度ステージ環境へ公開すると、ステージ環境の現在の値『10。+10、-10』は、更新されたdefined 値『8。5』で上書きされます。理解を深めるために、下記の表で説明します。

変数

開発環境
(値の編集時)

ステージ環境
(既存値)

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

利息

定義済み値

現在の値

定義済み値

現在の値

定義済み値

現在

8。5

8。5

7。5

10。+10、-10

8。5

8。5


同じシナリオが、変数 差出人 をステージ環境から本番環境へ出版する場合にも当てはまります。
環境ごとの変数とその値を表示するには、環境設定の「Variables」セクションに移動してください。詳細はこちら

7. Variablesの管理

変数の管理では、以下の操作が可能です。
  1. 変数参照の表示
  2. 変数の編集
  3. 変数の削除
  4. グループ名の変更
  5. グループの削除

7。1. 変数参照の表示

参照には、アプリケーション内で特定の変数が使用されているすべての場所が一覧表示されます。参照を表示するには、以下の手順に従ってください。
  1. アプリケーションの設定内にあるDeveloper ToolsVariableに移動します。作成済みのvariablesがすべて一覧表示されます。
  2. 参照したいvariable名をクリックします。

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

7。2. Variableの編集

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

  3. 次のページで、variableの詳細が表示されます。variable名を変更する場合はVariable項目を、値を更新する場合は項目をクリックします。
  4. メモ:
    1. variableは、あるグループから別のグループへ移動できません。
    2. variableに異なるデータの種類の値を割り当てることはできません。つまり、variableのデータの種類は更新できません。

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

7。3. Variableの削除

Variableを削除するには:
  1. アプリケーション設定内のDeveloper ToolsVariablesに移動します。作成済みのvariablesがすべて一覧表示されます。
  2. 削除したいvariableにカーソルを合わせ、表示される削除アイコン()をクリックします。
    1. variableがアプリケーション内で使用中でない場合は、確認ポップアップで削除をクリックするとすぐに削除されます。
    2. 使用中の場合、そのvariableが利用されているすべての場所の一覧がポップアップで表示されます。
    3. 記載されている参照をすべて削除してから、variableの削除を続けることができます。

7.4. グループ名を変更する

グループ名を変更すると、新しいグループ名がそのグループ内のvariablesおよび参照全体に適用されます。variableグループの名前を変更するには:
  1. アプリケーション設定内のDeveloper ToolsVariablesに移動します。作成済みのvariablesがすべて一覧表示されます。
  2. 変更したいグループ名にカーソルを合わせ、編集アイコン()をクリックします。

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

7.5. グループを削除する

variableグループを削除するには:
  1. アプリケーションの設定でDeveloper ToolsVariablesに移動します。作成したすべてのvariablesがここに表示されます。
  2. 削除したいグループ名にカーソルを合わせ、削除アイコン()をクリックします。

    1. そのグループ内のvariablesがアプリケーションで使用中でない場合は、確認ポップアップで削除をクリックすると、すぐに削除されます。
    2. そうでない場合、参照があるすべてのvariablesのリストが表示されるポップアップが表示されます。
    3. 記載されたvariablesおよびその参照を個別にすべて削除しないと、variableグループの削除を続けることはできません。

8. 注意点

  1. グループ内のvariable名は一意である必要があります。
  2. variableのデータの種類は作成後は変更できません。コレクションデータの種類の場合、値はリストからキー-値形式、またはその逆に変更できます。
  3. リスト種類のコレクションをキー-値種類のコレクションに変換する場合は、参照もキー-値ペアに置き換えてください。アプリケーションの不具合を防ぎ、正常に動作させるために必要な注意事項です。

9. 制限事項

  1. C5アプリケーションに変数が含まれている場合、テスト環境を作成することはできません。
  2. C5テスト環境および開発者ゾーン内のアプリケーションでは変数は利用できません。
  3. 1つのアプリケーションにつき最大10個のグループを作成できます。
  4. 1つのアプリケーションにつき、グループ数に関係なく最大20個の変数を作成できます。このうちコレクションデータ型の変数は最大4つまでです。
  5. 各コレクション変数のサイズは2KBを超えてはなりません。
  6. 変数は、あるグループから別のグループへ移動できません。
  7. システム変数は、Delugeスクリプトを通じてのみ変数として利用できます。
  8. 変数または変数グループの名称変更や削除は、現在コード表示ではサポートされていません。
  9. 1日あたり最大500回の変数代入をDelugeスクリプトで実行できます。
  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.