変数

Zoho People拡張機能の変数の詳細

1. 表示／編集：ユーザーの組織で変数を表示するための権限です。ユーザーは値の確認と変更が可能です。ただし、開発者向けコンソールで値を変更した場合、アップグレードの際に変更内容が送信されることはありません。また、ユーザーの組織に反映されることもありません。このような変更は、新規のサインアップに対してのみ適用されます。今後、拡張機能がアップグレードされる際に、変数の情報を変更できます（値を除く）。
   
   
2. 表示のみ：［表示のみ］の変数は、ユーザーの組織で閲覧は可能ですが、変更はできません。また、アップグレード時に開発者向けコンソールから値を変更することもできません。ただし、他の変数の値を除き、拡張機能の次のバージョンに対するアップグレード時に、データを変更することは可能です。 
   
   
3. 非表示：［非表示］の変数は、開発者が開発者向けコンソールで管理することはできますが、ユーザーの組織内のエンドユーザーには表示されません。開発者向けコンソールで変数の値を変更しても、ユーザーアカウントに対して更新は反映されません。ただし、新規サインアップ時には変更が反映されます。また、変数の値以外のデータは、拡張機能の次のバージョンに対するアップグレード時に変更できます。 
   
   
4. システム：［システム］の変数は、開発者が開発者向けコンソールで管理することはできますが、ユーザーの組織内のエンドユーザーには表示されません。この権限では、ユーザーの組織における変数の値を変更することはできません。開発者向けコンソールで変数の値を変更した場合、アップグレードの際にユーザーアカウントに反映されます。 
   

1. ユーザーの組織では、［システム］権限の変数を除くすべてのカテゴリーで、APIによる変数の値の変更が可能です。
   
2. ［非表示］および［システム］権限の変数は、他のコンポーネントで差し込み項目として使用することはできません。
3. すべての権限の変数（［システム］権限の変数を除く）は、onChangeスクリプト関数に対応しています。
   

以下の場合に変数を使用可能

1. 独自の関数：コードのロジックや計算の際に、値に動的にアクセスします。
2. メールテンプレート：定義済みの変数の値でメッセージをカスタマイズします。
3. データのテンプレート：データの作成／表示の際に、データを動的に挿入します。
4. 差し込み文書テンプレート：文書の作成時に変数を使用することで、データをかんたんに入力できます。
5. API連携：外部のシステムやサービス連携向けに、APIを使用して変数の値にアクセスします。
6. onChangeスクリプト関数：独自の関数に個別に対応します。各変数はonChangeスクリプト関数に対応しています。この機能は、変数の値が更新された際に実行されます。

変数のプロパティのパッケージ化

onChangeスクリプト関数

Zoho People拡張機能の開発者向けコンソールでは、変更スクリプトを定義することで、ユーザーの組織で共通変数の値が変更された場合に実行されるロジックを操作できます。

機能の概要

スクリプトの設定

1. 変数の設定画面で、［項目の値］→［onChange］タブに移動します。
2. ［スクリプトを作成する］をクリックします。
3. 編集画面でvariableMapオブジェクトを使用して、過去および現在の値を確認します。

構文の例

1. oldValue：変更前の変数の値です。
2. newValue：変更後の変数の値です。
   

これらの値を使って、独自のロジックを作成できます。

例：

if (oldVal != newVal)

{

   // Run custom logic here

   info "Variable updated from " + oldVal + " to " + newVal;

}

1. 設定済みの変数が変更された場合に、該当の項目を再計算する。
2. 重要な設定に変更があった場合に、ユーザー／管理者に通知する。
3. しきい値が変更された場合に、値やワークフローをリセットする。
4. グローバル設定が依存するAPI呼び出しや機能連携を変更する。

インストール時の設定

1. ユーザーがインストールした拡張機能に変数が含まれる場合、インストール画面に［変数を認証する］タブが表示されます。
   
   
   
   
2. このタブに表示されるのは、［表示／編集］および［表示のみ］の権限を持つ変数です。［表示のみ］の変数は編集できませんが、［表示／編集］の変数は、インストール画面で直接設定が可能です。
3. インストール時にこの手順を実行しない場合、拡張機能の設定スライダーや、［開発者向け情報］の［変数］タブから変数の値を別途編集できます。
   

変更による影響

新しい変数の追加

1. アップグレード時に新たに共通変数を追加しても、ユーザーの組織における既存の設定には影響しません。
2. 新しいワークフロー、スクリプト、項目設定で変数を使えるようになります。
3. 既存の機能やユーザーが定義したプロセスは、導入前と変わらず機能します。
4. 現在の設定には干渉せず、遡及的な影響を及ぼすこともありません。
   

既存の変数の変更 

1. 説明や変数名を変更しても、既存の参照関係や機能に影響はありません。
2. これらは形式上のみの変更です。
   

1. ［非表示］／［システム］権限の変数が設定のUIに表示されなくなる場合があります。
   
2. エンドユーザーが値を編集できなくなる場合があります。
   

1. 従来の値に依存するスクリプト、ワークフロー、プロセスの挙動が変化する場合があります。
2. 開発者は変更スクリプトを使って、このような移行をプログラムとして処理できます。
3. ただし、エンドユーザーが新しい値に適合するには、カスタムロジックを手作業で更新する必要があります。
   

値をわずかに変更するだけでも、従来の設定に依存するしきい値、条件、計算に影響が生じることがあります。

変数の削除

変数を削除すると、大きな影響が生じます。ユーザーのデータや設定に、長期的な影響が及ぶこともあります。変数を削除する前にどのような影響があるか慎重に検討し、どうしても必要な場合にのみ削除します。

1. 削除された変数を参照するプロセス、項目、スクリプト、ワークフローが機能しなくなります。
2. 拡張機能全体で、ランタイムのエラー、値の欠落、ロジックの不具合が生じることがあります。
3. 明示的にコーディングしない限り、自動的なフォールバックや置換が行われることはありません。
   

変数を削除すると、使用中のユーザー環境が使用できなくなることがあります。削除しようとする変数が使用されていないこと、下流のプロセスに依存関係がないことを確認します。また、できる限りリリースノートが提供される主要なバージョンアップグレード時に削除します。