理解するnavigateParentURL()メソッド

理解するnavigateParentURL()メソッド

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

この方法は、ウィジェットに適用されます。
Zoho Creatorアプリケーションの機能を拡張するためにウィジェットが使用されます。これにより、ビルトイン機能では実現できないタスクを実行したり、アプリのフロントエンド機能を強化することができます。ウィジェットとして機能を作成し、ページに追加することで、求めるユーザビリティを得ることができます。

ウィジェットを含めて、Creatorアプリの要件を満たすサードパーティアプリをページに組み込むこともできます。これらのウィジェットでは、ボタンのいずれかをクリックすると、一定のナビゲーションアクションが実行されるように設定したい場合があります。たとえば、「前へ」ボタンをクリックすると、ユーザーが前のURLにリダイレクトされるようになります。「キャンセル」ボタンをクリックすると、ウィジェットポップアップが閉じられますが、ユーザーは親ページのままになります。これらのアクションは、親ウィンドウと子ウィンドウのドメインが同じ場合に実行されます。現在、親ウィンドウと子ウィンドウが異なるドメインで動作している場合、クロスドメイン制限のため、それぞれのアクションは実行されません。 

このnavigateParentURL()メソッドを使用すると、子ウィンドウから親ウィンドウへアクションを実行することができます。言い換えれば、このメソッドは親コンテナを制御するためにのみ使用され、親URLに対して実行されるアクションにのみ使用されます。 

親ウィンドウと子ウィンドウを識別するにはどうすればよいですか?
親ウィンドウとは、現在ユーザーが到達し、操作を行う主なウィンドウです。 例えば、アプリケーション内のダッシュボードページは親ウィンドウです。 メインウィンドウの内側に開かれるすべてのウィンドウは子ウィンドウです。 例えば、ダッシュボードページ内で開かれるメールサブスクリプションポップアップは子ウィンドウです。
注意: 親ウィンドウには複数の子ウィンドウがある可能性があります。
あなたが「Food Delivery Management」というアプリケーションを作成したとします。その中で「User Details」というフォームを構築しました。ユーザーは自分の詳細を入力し、「Verify Details」フィールド(決定ボックス)をチェックすると、「Verify Phone Number」というポップアップが開きます。これは実際にはウィジェットとして組み込まれたサードパーティーサービスです。ユーザーは電話番号を入力して「Verify」をクリックするか、ポップアップを閉じることができます。 



「ポップアップウィンドウを閉じた後、明示的に親ウィンドウ(ここではフォーム)に切り替える必要があります。 この場合、異なるドメインの所有するサードパーティーサービスを使用したため、閉じるアクションは実行されません。 これは、親ウィンドウと子ウィンドウが異なるドメインで動作する場合、ウィジェットがURLアクションを実行できないためです。 これが、navigateParentURL()メソッドが登場する場面です。」

構文

  1. ‌var パラメーター = {
  2. アクション:${ACTIONVALUE} 
  3. URL: ${URL} 
  4. ウィンドウ: ${WINDOWTYPE}
  5. }
  6. ZOHO.CREATOR.UTIL.navigateParentURL(パラメーター) 
注意: この方法は大文字と小文字を区別します。値が2つ以上の単語の場合、キャメルケースが受け入れられます。

例えば、上記の構文は以下のように使用することができます。

URLを開く
  1. ZOHO.CREATOR.init().then(function (data) {
  2.  var param = {
  3. action: '開く',url: 'https://www.zoho.com/widgets.html', window: '新しい'   };
  4. ZOHO.CREATOR.UTIL.navigateParentURL(param); 
  5. });
URLを閉じる方法
  1. ZOHO.CREATOR.init().then(function (データ) {
  2. var param = {action: '閉じる' };
  3. ZOHO.CREATOR.UTIL.navigateParentURL(param);   
  4. });

ラベル
アクション
  1. open - 新しい/親ウィンドウに指定されたURLを開きます。 'url'または'window'パラメーターに値が渡されない場合、指定されたアクションは実行されません。
  2. reload - 以前に訪れたページをロードします。
  3. back - 親ウィンドウを再読み込みします。
  4. close - 最後に開かれた親コンテナを閉じます。
  5. close all - 親ウィンドウ内のすべてのオープンダイアログ親コンテナを閉じます。
URL
ここに任意のURLリンクを指定できます。また、ハッシュ(#)にCreatorコンポーネントURLを含めることもできます。
例:#Report:Report_Name
ウィンドウタイプ
‌'new' , 'same'

あなたがZylker Tutorialsというクイズ管理アプリを作成したと仮定しましょう。このアプリでは、ユーザーが自分の選択したトピックのクイズに参加できます。 

ユーザーがクイズを完了し、次へ ボタンをクリックすると、ウィジェットを含む Captcha の確認 ページに移動します。このサードパーティーのウィジェットは、ユーザーがクイズの答えが自動入力(ロボットによる入力)されていないことを証明するために関連するオプションをチェックする必要がある画像を表示するように構成されています。間違ったオプションをチェックすると、同じページにエラーが表示されます。正しいオプションをチェックしたら、ウィジェットから ユーザー詳細 フォームにリダイレクトされます。このリダイレクトは、フォームを開くオープンアクションを実行するように構成された navigateParentURL() メソッドを使用して実行されます。必要な詳細を入力した後、ユーザーはフォームを送信できます。 



日本語:
情報:さらに、Captcha Verified という名前の決定ボックスフィールドを追加し、ユーザーにのみ表示可能にできます。ワークフローを設定して、入力されたメールアドレスがログインしているユーザーのメールアドレスと一致するかどうかを確認するチェックを実行できます。検証後、Captcha Verifiedフィールドの値をtrueに設定できます。 

上記の使用例を設定する方法を学ぶには、ここをクリックしてください。

制限

現在、ウィンドウタイプを指定する際、ポップアップウィンドウはサポートされていません。 

関連トピック

  1. navigateparentURL()を設定する
  2. ウィジェットを理解する
  3. JS API ドキュメンテーション

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

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

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

    Zoho CRM Training



              Zoho Desk Resources

              • Desk Community Learning Series


              • Digest


              • Functions


              • Meetups


              • Kbase


              • Resources


              • Glossary


              • Desk Marketplace


              • MVP Corner


              • Word of the Day









                                • Related Articles

                                • レポート関連メソッド

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho CreatorのAndroid SDKのZCUISDKUtilを使用すると、Zoho Creatorアプリケーションのコンポーネントのインターフェイスを管理できます。 注意: Zoho ...
                                • 「navigateParentURL() メソッドの設定」

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 navigateParentURL() メソッドの詳細については、こちらをクリックしてください こちら。 このメソッドは、ウィジェットなどのページ要素に設定できます。 このメソッドは、Creator の C5 および C6 ...
                                • 「ページ関連のメソッド」

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho CreatorのAndroid SDKのZCUISDKUtilを使用すると、Zoho Creatorアプリケーションのコンポーネントのインターフェイスを管理できます。 注意:Zoho ...
                                • 「関連するフォームのメソッド」

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho CreatorのAndroid SDKのZCUISDKUtilを使用すると、Zoho Creatorアプリケーションのコンポーネントのインターフェースを管理できます。 ...
                                • クラス定義(Java)

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 注:Zoho CreatorのモバイルSDKは現在ベータ版の機能です。本番ステージのアプリにはご使用いただけません。 Zoho CreatorのAndroid SDKのZCUISDKUtilを使用すると、Zoho ...

                                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.