クライアントスクリプト：Zoho CRMにおけるリード変換前のデータ検証を効果的に処理する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Requirement 概要
Zoho CRM 組織では、リードの変換前に、リードタブ内のすべての必須項目が認証されていることを求めています。法人は、リードデータが完了していることをより簡単かつ効果的に確認できる方法を必要としています。これは、初期設定の「受注データを［パッケージ］データに変換するだけで、」ボタンをリードデータ詳細ページで使用する前に行う必要があります。
これにより、変換後の連絡先は、必須データ（空欄なしの項目）をすべて含んだ状態で作成され、営業チームによる効果的なフォローアップや育成が可能となります。
権限 & 利用可否
-> 管理 Extensibility権限を持つユーザーはClient Scriptの設定・管理が可能です。
-> 管理 テスト環境権限を持つユーザーはテスト環境の管理が可能です。
-
Client Script の配置場所
例：
-> ページのOn_Load/On_Save/On_Edit、項目のOn_Type/On_Change、サブフォーム処理、Blueprint処理、リスト表示処理など。
-> コマンド／ショートカットキー（CRM内のどこからでも、いつでもスクリプトを実行可能）。
-> カスタムボタン（最近の強化）
詳細は以下のヘルプ参照をご確認ください（Client Script 処理 詳細）。-
Client Script を作成するには：
Client Scriptは2つの方法で追加できます：
1. 設定ページから：
Zoho CRM の設定 (⚙️) >> Developer Hub >> Client Script >> 新規 Script に移動します。
-> スクリプトに適した名前と説明を入力します。
-> カテゴリー 詳細-
- 要件に応じてカテゴリーを選択します。タブ - 処理をトリガーする場合、または Commands- Command Pallet/ショートカットキーでトリガーする場合があります。
- スクリプトを追加したいタブを選択します（例：Lead、連絡先など）。
- スクリプトを特定のページに適用する場合はPageを選択します（例：作成、編集、複製する、詳細、List など）。
- Layoutを選択します（例：スタンダードまたはカスタムレイアウト）。
-> Event 詳細-
処理の種類を選択します - 項目 Event、Page Event、または Subform Event
- 項目 Event-> 該当する項目とイベントを選択します（例：名 項目の onChange）。
- Page Event-> 対象のページとイベントを選択します（例：作成 Page の onLoad）。
- Subform Event-> 該当するサブフォームとイベントを選択します（例：onCellChange）。
2. 詳細／リスト／作成／編集／複製ページからタブ内データを操作する方法
-> Zoho CRMで目的のタブを選択し、リスト、作成、詳細、編集、または複製のいずれかのページでデータを開きます。例として、リード作成ページを考えます。
-> 作成／編集／複製ページの場合：ページの右上隅にある「Client Script」をクリックし、スクリプトを追加します。
-> カテゴリー詳細はシステムによって自動入力されます。クライアントスクリプトのその他の詳細（名前、説明、イベント詳細など）を入力してください。続けて「次へ」をクリックし、Client Script IDE のコードエディタにスクリプトを追加します。その後、「保存」し、「閉じる」をクリックします。
詳細ページからClient Scriptを追加する方法：
リスト／作成／編集／複製など各ページからClient Scriptを追加する方法：
使用例
初期段階では、リードが初めて取得された際（例：WebフォームやSNS経由）、すぐにすべての必須項目を入力することは現実的でない場合や必要がない場合があります。営業プロセスの中で一部の項目が後から収集されることもあります。営業プロセスが完了したら、リードは連絡先およびアカウントへ変換する必要があります。
高いデータ品質を維持し、信頼性のある顧客コミュニケーションを確保するため、法人では連絡先タブ内で一部の項目（例：メール、モバイル、住所）を必須に設定しています。これにより、連絡先データにはアウトリーチやセグメント、サービス提供に必要な情報が確実に揃います。
リードを連絡先へ変換する際、リードデータ内で連絡先の必須情報が入力されていないケースがあり、その結果、変換後のフォローや育成に必要な情報が不足することがあります。このような場合、連絡先タブにおいて未完了・不整合なデータが発生します。
最終成果 - 法人は、より簡単かつその他の効果的な方法で認証リードデータを次の前のリードコンバージョンに進める必要があります。初期設定の「受注データを［パッケージ］データに変換するだけで、」ボタンをリードデータ詳細ページで使用します。
重要性:
- データの整合性
- 高いコンバージョン率
- リードフロー効率の向上
- 営業エンゲージメントの迅速化
主な課題
入力規則 - 現時点では、リードコンバージョン時のバリデーションがないため、このような変換を防ぐことができません。初期設定の入力規則機能は作成・編集・複製・詳細ページで動作しますが、リードコンバージョンには実装されません。
「受注データを［パッケージ］データに変換するだけで、」ボタンのトリガーについて- 現在、初期設定ボタン（例：「受注データを［パッケージ］データに変換するだけで、」）のクリック時にバリデーションを設定し、エラー（インラインまたはポップアップエラー）を表示するトリガーはありません。
提案アプローチと最適解
このような未完了コンバージョンを回避するための代替手段はいくつかあります。以下で説明します。
ワークフアルール- ユーザーは、リード上（例：編集時のトリガー）で特定の条件に基づいてワークフアルールを設定し、操作（受注データを［パッケージ］データに変換するだけで、）を選択することでリードを連絡先やアカウント、必要に応じて商談へ変換できます。しかし、この方法は、ユーザーが頻繁にリード内の特定項目を更新してデータを変換しなければならず、また法人側で「受注データを［パッケージ］データに変換するだけで、」ボタンを不要に権限で無効化する必要が出てくるため、現実的ではありません。
カスタムボタン- ユーザーは、リードデータ詳細ページにカスタムボタンを設定し、カスタム関数を使ってリードデータ詳細を取得できます。その上で必須項目が空かどうかを確認し、スクリプトで適切に連絡先やアカウントへ変換します。ただし、この方法はコーディングに慣れていないユーザーにとっては難しい場合があります。また、初期設定の「受注データを［パッケージ］データに変換するだけで、」ボタンも頻度権限で無効化する必要があります。
上記2つの代替案は、現実的かつ簡単な方法とは言えません。しかし、他にClient Script を使用した最適な解決策があり、ユーザー側で設定可能です。
Client Script を用いたバリデーション実装のソリューション
ユーザーは、Lead 詳細ページの読み込み時に Client Script を設定し、バリデーションを行い、初期設定の「受注データを［パッケージ］データに変換するだけで、」ボタンを無効化/有効化できます。Client Script を利用して、各必須項目（値あり）を取得し、空であるかどうかをチェックします。いずれかの項目が入力されていない場合は、「受注データを［パッケージ］データに変換するだけで、」ボタンを無効化し、全ての項目が入力されている場合は有効化します。
この方法を利用すると、初期設定の「受注データを［パッケージ］データに変換するだけで、」ボタンへの直接的な操作が可能となり、ユーザーは直接的な Client Methods を使って項目値を取得し、ボタンの有効/無効を設定できます（コーディング経験がなくても設定可能です）。
設定
次に、詳細ページのLeadタブでOnLoad of Pageトリガー用の Client Script を作成します。例として、データ詳細ページが読み込まれるたびに client script が実行され、項目データのバリデーションに基づいて「受注データを［パッケージ］データに変換するだけで、」ボタンの操作が設定されます。
コード
- console.クリア();
- manadatoryNotFilled = 無効;
- //各連絡先必須項目データの取得
- var メール = ZDK.Page.getField('メール').getValue();
- var モバイル = ZDK.Page.getField('モバイル').getValue();
- var 市区町村 = ZDK.Page.getField('市区町村').getValue();
- var 状態 = ZDK.Page.getField('状態').getValue();
- var 国 = ZDK.Page.getField('国').getValue();
- var pin = ZDK.Page.getField('Zip_Code').getValue();
- var leadSource = ZDK.Page.getField('Lead_Source').getValue();
- // log(メール);
- // log(leadSource);
- //確認中 いずれかの項目が入力されていないかどうか
- if (メール == null || モバイル == null || 市区町村 == null || 状態 == null || 国 == null || pin == null || leadSource == null) {
- manadatoryNotFilled = 真;
- }
- log('manadatoryNotFilled --- '+manadatoryNotFilled);
- //受注データを［パッケージ］データに変換するだけのボタンを取得
- var convertButton = ZDK.Page.getButton('受注データを［パッケージ］データに変換するだけで、');
- //項目が入力されていない場合、ボタンを無効化します。すべて入力されていれば、「受注データを［パッケージ］データに変換するだけで」ボタンを有効化します。
- if (manadatoryNotFilled) {
- convertButton.無効にする();
- }
- else {
- convertButton.有効にする();
- }
動作デモ - Screencast
このアプローチは、項目が入力されていない場合のみ確認中に制限されるわけではありません。リード項目に対して、複雑なバリデーション（例えば、モバイル項目は10桁である必要がある、メール項目は有効なドメインを含む必要がある、など）をLead Conversionの前に設定することも可能です。
ご注意：現時点では、データ詳細ページで行った更新は直接反映されません。変更内容を表示するには、ページを更新する必要があります。詳細ページ上で変更を自動反映させる方法については、以下の記事をご参照ください。TIPS
-> スクリプトを作成する際は、各変数ごとに logs() または console.log()を追加して、出力結果を確認することを推奨します。たとえば、出力結果は 'Messages'タブ（Client Script IDE内）で logs() の出力として表示できます。console logs を表示するには、次の手順に従ってください - 'ブラウザページ上で右クリック >> 検証 >> コンソール'。
-> 期待される動作が実行されない場合は、各出力やループを確認しながらスクリプトを試し、サンプルのヘルプドキュメントで各ZDK Client/CRM API メソッドの構文を再度ご確認ください。
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho Campaigns Resources
Zoho WorkDrive Resources
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
Related Articles
クライアントスクリプト：Zoho CRMで重要データを削除する前の確認プロンプト
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 概要 Zoho CRM ユーザーは、機密性が高く重要な項目のデータを消去する前に、ダブル確認を行うための確認注意を求めています。 使用例 銀行が、Zoho ...Zoho CRMサブフォームでクライアントスクリプトを使用して商品リスト価格を自動入力する方法
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 概要 顧客は、同じタブに保存されている選択済み価格Book（Lookup項目）に基づき、カスタムタブ（例：Pre-注文）のサブフォーム内の商品リスト価格を自動的に更新・表示したいと考えています。この処理は、サブフォームで商品を選択した際に実行されます。 権限 ...クライアントスクリプト：Zoho CRMのブループリント遷移中にサブフォームのバリデーションを強制する
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 概要 Zoho CRM では、商談データがBlueprintに含まれている場合、ユーザーはサブフォームに追加されたエントリーを認証し、Blueprintの遷移で完了済みにする前に確認する必要があります。 権限 & 利用可能範囲 -> 管理 ...クライアントスクリプトを使用してZoho CRMでフライアウトモードのカスタムウィジェットを起動および同期する
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要: この記事では、Zoho CRMでClient Scriptを使用してフライアウトとしてカスタムウィジェットを起動し、CRM項目からウィジェットへデータを渡し、ウィジェットのレスポンスに基づいて同じ項目を更新する方法について説明します。 Requirement 概要: ...Zoho CRMでクライアントスクリプトを使用してウィジェットをバリデーションアラートとして呼び出す方法を探る
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 概要 Zoho CRM ユーザーは、任意のユーザーがデータに変更を加えた際に、カスタマイズされたバリデーションポップアップを表示したいと考えています。 使用する-case ...