コンセプト情報
Analytics ダイアログ ビルダーでは、1 つ以上のカスタム ダイアログボックスを作成し、スクリプトの実行中にユーザー入力を収集できます。
カスタム ダイアログボックスを使用して、次のようなさまざまな機能を実行します。
- ユーザーに対し、テーブル名、フィールド名、日付の範囲などを入力するように求める
- ユーザーが複数のオプションから選択できる
- 標準のメッセージ ボックスよりも多くの情報を表示する
- Analytics プロジェクト項目を動的に一覧表示する
メモ
カスタム ダイアログボックスを使用してパスワードを入力することは安全ではありません。代わりに PASSWORD コマンド を使用してください。
ダイアログ ボックス コントロール
ダイアログ ビルダーでは、ユーザー入力コントロールをダイアログボックスに追加して、カスタム ダイアログボックスを設計および作成できます。
コントロールは小さいインタラクティブなソフトウェア コンポーネントであり、スクリプトによって要求されるユーザー入力を収集するためのさまざまな方法を提供します。1 つ以上のコントロールをダイアログボックスに追加し、ニーズに合わせて設定します。
次のオプションを使用できます。
- テキスト ラベル
- テキストボックス
- チェック ボックス
- ラジオ ボタン
- フォロップダウン リスト
- プロジェクト項目一覧
以下のサンプル カスタム ダイアログボックスは各タイプのコントロールの例を提供します。
コマンドに自動的に変換されるダイアログボックス
新しく作成されたカスタム ダイアログボックスを保存するときには、Analytics は自動的に視覚的なダイアログボックスを一致する ACLスクリプト DIALOG コマンドに変換します。
コマンドは、カーソルが配置されるスクリプトの行に挿入されます。スクリプトを実行するときには、視覚的なダイアログボックスが表示されます。
以下の例は、1 つのテキスト ラベルと 1 つドロップダウン リストの他に、対応する DIALOG コマンドがある簡単なダイアログボックスが表示されます。
カスタム ダイアログ ボックス
対応する DIALOG コマンド
DIALOG (DIALOG TITLE "Select Branch" WIDTH 464 HEIGHT 116 ) (BUTTONSET TITLE "&OK;&Cancel" AT 336 12 DEFAULT 1 ) (TEXT TITLE "Select the branch:" AT 12 16 ) (DROPDOWN TITLE "Central Branch;East Branch;West Branch" TO "DROPDOWN1" AT 156 12 )
カスタム ダイアログボックスの作成 - 一般的な手順
- カスタム ダイアログ ボックスを追加する Analytics スクリプトを開きます。
- スクリプト内で、DIALOG コマンドを挿入したい行にカーソルを配置します。
メモ
空白の行にカーソルを配置します。必要に応じて、空白のスペースを作成します。
- ［新しいダイアログの作成
］ をクリックします。ダイアログ ビルダーが "ユーザー ダイアログ" というデフォルトのタイトルで表示されます。
- 次の手順を行って、カスタム ダイアログ ボックスを作成します。
- ダイアログ ビルダーをダブルクリックして、ダイアログ ボックスのタイトルやサイズを変更します。
ダイアログボックスの幅と高さをピクセルで指定します。また、ダイアログボックスのサイズを変更するには、ダイアログ ビルダーの作業領域の右下端をドラッグします（グリッドに合わせるをオンにする必要があります）。
- ［グリッドに合わせる］
をクリックして、ダイアログ ビルダーのグリッドの表示をオンまたはオフにします。グリッドを使用すると、レイアウト領域のコントロールの位置を調整できます。グリッドをオンにすると、各コントロールの左上隅を、最も近いグリッド ポイントに合わせて配置します。
- ダイアログ ビルダーの左側で、コントロール アイコンをクリックしてからレイアウト領域内をクリックすると、そのコントロールがフォーム上に追加されます。
メモ
特定のコントロールを追加および設計するための手順が以下に表示されます。
- ダイアログ ビルダーをダブルクリックして、ダイアログ ボックスのタイトルやサイズを変更します。
- 必要な数のコントロールを追加します。
- 追加した後にコントロールを修正する必要がある場合は、コントロールをダブルクリックします。
- ダイアログ ビルダーからコントロールを削除したい場合は、そのコントロールを選択して［削除］ をクリックします。
メモ
［OK］および［キャンセル］ボタンは削除できませんが、名前は変更できます（以下を参照）。
- ［閉じる］ボタンをクリックしてダイアログ ビルダーを終了します。
- 変更を保存する場合は確認ダイアログ ボックスで［OK］をクリックして、終了します。
スクリプト エディターに対応する DIALOG のコマンドが表示されます。右にスクロールすると、カスタム ダイアログ ボックスのすべてのコントロールに対応するスクリプト表現を見ることができます。
-
省略可能。スクリプトの DIALOG コマンドで、OK またはキャンセル ボタンのラベル テキストを編集します。
一般的に、OK およびキャンセル ラベルは編集しないでください。ラベルを変更する場合は、必ず肯定的な値（［はい］など）が否定的な値（［いいえ］など）の前に来るようにしてください。
ラベル テキストのみを編集します。例："&はい;&いいえ"
カスタム ダイアログ ボックスの修正
作成した後にカスタム ダイアログボックスを修正する必要がある場合は、対応する DIALOG コマンドにカーソルを置き、［コマンドの編集 
］をクリックします。
テキスト ラベルを追加する
テキスト コントロールを使用して、テキスト ラベルをカスタム ダイアログボックスに追加します。
テキストラベルは次のいずれかの目的で使用できます。
- 別のコントロールを特定する
- 通知を提供する
- ユーザーに確認または指示する
- カスタム ダイアログボックスで必要な他のテキスト情報を提供する
テキストラベルは表示専用であり、インタラクティブ機能に関連付けられていません。
手順
方法の説明
- ダイアログ ビルダー
で、［テキスト］をクリックしてから配置したいレイアウトでクリックします。配置される位置はコントロールの左上隅が基準となっています。
［テキスト］ダイアログ ボックスが開きます。
- ［ラベル］フィールドに、カスタム ダイアログボックスに表示するテキストを入力します。
スペースを含め 255 文字以内で入力します。
- 省略可能。コントロールの正確な位置を指定する場合は、ピクセルで指定された x（水平）および y（垂直）値を修正します。
ヒント
コントロールを配置するには、ダイアログ ビルダーをドラッグすることもできます。
- 省略可能。コントロールのサイズを指定する場合は、［幅］または［高さ］フィールドの横にある［自動］選択をオフにして、ピクセル単位で指定されている値を変更します。
- 自動選択テキスト コントロールは、コントロールに含まれるテキストのサイズに合わせて自動的に調整されます
- 自動選択テキスト コントロールは、コントロールに含まれるテキストのサイズに関係なく、指定されたサイズのままです
ヒント
ダイアログ ビルダーのサイズ変更ハンドルを使用して、コントロールのサイズを変更することもできます。
- ［左］、［右］または［中央］の選択によって、コントロール内におけるテキストの配置を指定できます。
- ［OK］をクリックして、コントロールをダイアログ ビルダーに追加します。
テキストボックスの追加
編集ボックス コントロールを使用して、テキストボックスをカスタム ダイアログボックスに追加します。
テキストボックスは、日付、業者または顧客 ID など、ユーザーが入力する必要がある情報を収集します。
編集ボックス変数
編集ボックス コントロールは、ユーザー入力を保存するための文字変数を作成します。
手順
方法の説明
- ダイアログ ビルダー
で、［編集ボックス］をクリックしてから配置したいレイアウトでクリックします。配置される位置はコントロールの左上隅が基準となっています。
［編集ボックス］ダイアログ ボックスが開きます。
- 省略可能。［変数］フィールドでは、カスタム ダイアログボックスでユーザーが入力した値を格納する変数の名前を入力します。
EDITn デフォルト変数名を保持することを選択できます。
- 省略可能。［デフォルト テキスト］フィールドで、テキスト ボックスのデフォルト入力値を指定します。
ユーザーが入力値を指定しない場合は、デフォルト値が使用されます。
- 省略可能。コントロールの正確な位置を指定する場合は、ピクセルで指定された x（水平）および y（垂直）値を修正します。
ヒント
コントロールを配置するには、ダイアログ ビルダーをドラッグすることもできます。
- 省略可能。コントロールのサイズを指定する場合は、［幅］または［高さ］フィールドの横にある［自動］選択をオフにして、ピクセル単位で指定されている値を変更します。
- 自動選択編集ボックス コントロールはコントロールに含まれるテキストのサイズに合わせて自動的に調整されます
- 自動選択編集ボックス コントロールは、コントロールに含まれるテキストのサイズに関係なく、指定されたサイズのままです
ヒント
ダイアログ ビルダーのサイズ変更ハンドルを使用して、コントロールのサイズを変更することもできます。
- ［OK］をクリックして、コントロールをダイアログ ビルダーに追加します。
チェック ボックスを追加する
チェックボックス コントロールを使用して、チェックボックスをカスタム ダイアログボックスに追加します。
チェックボックスはユーザーに表示されるバイナリ選択肢です。つまり、関連付けられたオプションはオンまたはオフにできます。たとえば、チェックボックスを使用すると、ユーザーが従業員テーブルから抽出されたデータに電子メール アドレス フィールドを含めるか除外できます。
オプションの組み合わせ
複数のチェックボックスを使用して、カスタム ダイアログボックスのオプションの組み合わせを選択できます。相互に排他的なオプションの場合は、ラジオ ボタンを使用するようにしてください。
チェックボックス変数
チェックボックス コントロールは、ユーザー入力を保存するための論理変数を作成します。チェックボックスがオンの場合は True、チェックボックスがオフの場合は False の値が変数に格納されます。
手順
方法の説明
- ダイアログ ビルダー
で、［チェックボックス］をクリックしてから配置したいレイアウトでクリックします。配置される位置はコントロールの左上隅が基準となっています。
［チェックボックス］ダイアログ ボックスが開きます。
- 省略可能。［変数］フィールドでは、カスタム ダイアログボックスでユーザーが入力した値を格納する変数の名前を入力します。
CHECKBOXn のデフォルト変数名を保持することを選択できます。
- ［ラベル］フィールドに、チェックボックスのテキストを入力します。
スペースを含め 255 文字以内で入力します。
- 省略可能。コントロールの正確な位置を指定する場合は、ピクセルで指定された x（水平）および y（垂直）値を修正します。
ヒント
コントロールを配置するには、ダイアログ ビルダーをドラッグすることもできます。
- 省略可能。コントロールのサイズを指定する場合は、［幅］または［高さ］フィールドの横にある［自動］選択をオフにして、ピクセル単位で指定されている値を変更します。
- 自動選択チェックボックス コントロールは、コントロールに含まれるテキストのサイズに合わせて自動的に調整されます
- 自動選択チェックボックス コントロールは、コントロールに含まれるテキストのサイズに関係なく、指定されたサイズのままです
ヒント
ダイアログ ビルダーのサイズ変更ハンドルを使用して、コントロールのサイズを変更することもできます。
- ［初期状態］の下で、カスタム ダイアログボックスが最初に開いたときに、チェックボックスがオフかオンかを指定します。
- ［OK］をクリックして、コントロールをダイアログ ビルダーに追加します。
ラジオ ボタンの追加
ラジオボタン コントロールを使用して、2 つ以上のラジオボタンをカスタム ダイアログボックスに追加します。
ラジオボタンは相互に排他的なオプションをユーザーに表示します。表示されたオプションのいずれかのみを 1 度に選択できます。たとえば、2 つのラジオボタンを使用して、ユーザーが次のいずれかを選択できるようにします。
- $5000 未満の金額
- $5000 以上の金額
相互に排他的なオプション
複数のラジオボタンを使用すると、ユーザーがカスタム ダイアログボックスでさまざまなオプションから 1 つのみを選択できます。相互に排他的なオプションでない場合は、チェックボックスを使用するようにしてください。
ラジオボタン変数
ラジオボタン コントロールは、ユーザー入力を保存するための数値変数を作成します。この変数の値は、最初のラジオ ボタンをクリックすると 1、2 番目のラジオ ボタンをクリックすると 2 という形になります。
手順
方法の説明
- ダイアログ ビルダー
で、［ラジオボタン］をクリックしてから配置したいレイアウトでクリックします。配置される位置はコントロールの左上隅が基準となっています。
［ラジオボタン］ダイアログボックスが開きます。
- 省略可能。［変数］フィールドでは、カスタム ダイアログボックスでユーザーが入力した値を格納する変数の名前を入力します。
RADIOn のデフォルト変数名を保持することを選択できます。
- ［ラベル］フィールドで、最初のラジオボタンのテキストを入力し、［追加］をクリックします。
スペースを含め 255 文字以内で入力します。
ラジオボタンはラベル リストに追加されます。
- 任意の各追加のラジオボタンのラベルを追加します。
各追加のラジオボタンはラベル リストの最後に追加されます。
メモ
ラジオボタン コントロールは相互に排他的なオプションを作成するため、2 つ以上のラジオボタンが必要です。
- 省略可能。ラベル リストの最後にラジオボタンを追加する代わりに、次の他のオプションを使用できます。
オプション 説明 挿入 ラベルリストの任意の場所にラジオボタンを挿入できます。
［挿入］をクリックする前に、新しいラジオボタンを挿入する場所の真下のリスト項目を選択します。
置換
（置換）
ラベル リストのラジオボタンを置換できます。置換は基本的にラジオボタン名を変更します。
［置換］をクリックする前に、新しいラジオボタンで置換するリスト項目を選択します。
削除 ラベル リストからラジオボタンを削除できます。
削除したいリスト項目を選択し、［削除］をクリックします。
デフォルトに設定 カスタム ダイアログボックスが最初に開くときにデフォルトで選択されるラジオボタンを指定します。
デフォルトに設定するリスト項目を選択し、［デフォルトに設定］をクリックします。
- 省略可能。コントロールの正確な位置を指定する場合は、ピクセルで指定された x（水平）および y（垂直）値を修正します。
ヒント
コントロールを配置するには、ダイアログ ビルダーをドラッグすることもできます。
- 省略可能。コントロールのサイズを指定する場合は、［幅］または［高さ］フィールドの横にある［自動］選択をオフにして、ピクセル単位で指定されている値を変更します。
- 自動選択ラジオボタン コントロールは、コントロールに含まれるテキストのサイズに合わせて自動的に調整されます
- 自動選択ラジオボタン コントロールは、コントロールに含まれるテキストのサイズに関係なく、指定されたサイズのままです
ヒント
ダイアログ ビルダーのサイズ変更ハンドルを使用して、コントロールのサイズを変更することもできます。
- ［整列］の下で、カスタム ダイアログボックスでラジオボタンに水平または垂直整列があるかどうかを指定します。
- ［OK］をクリックして、コントロールをダイアログ ビルダーに追加します。
ドロップダウン リストを追加する
ドロップダウンリスト コントロールを使用して、ドロップダウンリストをカスタム ダイアログボックスに追加します。
ドロップダウン リストは、選択可能なカスタム、テキストベース オプションの一覧をユーザーに提示します。ユーザーは 1 度に 1 つのオプションのみを選択できます。たとえば、ドロップダウン リストを使用して、ユーザーが次の項目を選択できるようにします。
- 年の月
- カテゴリ
- 会社の部署または支店
相互に排他的なオプション
ドロップダウン リストのオプションは相互に排他的です。ラジオボタンを使用して、類似した結果を実現できますが、項目数が多いリストの場合、ドロップダウンの方がよりコンパクトになり、使用しやすくなります。
ユーザーが 1 度に複数のオプションを選択できるようにする場合は、代わりにチェックボックスを使用します。
ドロップダウン リスト変数
ドロップダウン リスト コントロールは、ユーザー入力を保存するための文字変数を作成します。
手順
方法の説明
- ダイアログ ビルダー
で、［ドロップダウン リスト］をクリックしてから配置したいレイアウトでクリックします。配置される位置はコントロールの左上隅が基準となっています。
［ドロップダウン リスト］ダイアログボックスが開きます。
- 省略可能。［変数］フィールドでは、カスタム ダイアログボックスでユーザーが入力した値を格納する変数の名前を入力します。
DROPDOWNn のデフォルト変数名を保持することを選択できます。
- ［ラベル］フィールドで、最初のドロップダウン リスト項目のテキストを入力し、［追加］をクリックします。
スペースを含め 255 文字以内で入力します。
リスト項目はラベル リストに追加されます。
- 任意の各追加のリスト項目のラベルを追加します。
各追加のリスト項目はラベル リストの最後に追加されます。
メモ
ドロップダウン リスト コントロールは相互に排他的なおプッシュのを作成するため、2 つ以上のリスト項目が必要です。
- 省略可能。ラベル リストの最後にリスト項目を追加する代わりに、次の他のオプションを使用できます。
オプション 説明 挿入 ラベルリストの任意の場所にリスト項目を挿入できます。
［挿入］をクリックする前に、新しい項目を挿入する場所の真下でリスト項目を選択します。
置換
（名前の変更）
ラベルリストのリスト項目を置換できます。置換は基本的にリスト項目名を変更します。
［置換］をクリックする前に、新しい項目で置換するリスト項目を選択します。
削除 ラベル リストからリスト項目を削除できます。
削除したいリスト項目を選択し、［削除］をクリックします。
デフォルトに設定 カスタム ダイアログボックスが最初に開くときにデフォルトで選択されるリスト項目を指定します。
デフォルトに設定するリスト項目を選択し、［デフォルトに設定］をクリックします。
- 省略可能。コントロールの正確な位置を指定する場合は、ピクセルで指定された x（水平）および y（垂直）値を修正します。
ヒント
コントロールを配置するには、ダイアログ ビルダーをドラッグすることもできます。
- 省略可能。コントロールのサイズを指定する場合は、［幅］または［高さ］フィールドの横にある［自動］選択をオフにして、ピクセル単位で指定されている値を変更します。
- 自動選択ドロップダウン リスト コントロールは、コントロールに含まれるテキストのサイズに合わせて自動的に調整されます
- 自動選択ドロップダウン リスト コントロールは、コントロールに含まれるテキストのサイズに関係なく、指定されたサイズのままです
ヒント
ダイアログ ビルダーのサイズ変更ハンドルを使用して、コントロールのサイズを変更することもできます。
- ［OK］をクリックして、コントロールをダイアログ ビルダーに追加します。
プロジェクト項目一覧を追加する
プロジェクト項目一覧コントロールを使用して、プログラム項目一覧をカスタム ダイアログボックスに追加します。
プロジェクト項目リストには、テーブルなどの Analytics プロジェクト項目が一覧表示されます。項目の一覧は、スクリプトが実行される Analytics プロジェクトの内容に基づいて動的に入力されます。
ユーザーは 1 度に 1 つのオプションのみを選択できます。たとえば、プロジェクト項目一覧を使用して、ユーザーが次の項目を選択できるようにします。
- 年のすべてのテーブルから、特定の月のテーブル
- テーブルのすべての数値フィールドから、特定の数値フィールド
- 複数の可能なスクリプトから、特定のスクリプト
プロジェクト項目のカテゴリ
プロジェクト項目一覧を作成するときには、実際のプロジェクト項目を指定しません。プロジェクト項目のカテゴリを指定します。たとえば、スクリプトを実行するときに開いているテーブルですべての文字フィールドのリストをユーザーに表示する場合は、文字フィールド カテゴリを指定します。
指定するカテゴリに基づき、Analytics は動的にカスタム ダイアログボックスにプロジェクト項目一覧を入力します。
使用可能なカテゴリ
次のカテゴリを使用できます。
|
|
|
プロジェクト項目一覧変数
プロジェクト項目一覧コントロールは、ユーザー入力を保存するための文字変数を作成します。
手順
方法の説明
- ダイアログ ビルダー
で、［プロジェクト項目一覧］をクリックしてから配置したいレイアウトでクリックします。配置される位置はコントロールの左上隅が基準となっています。
［プロジェクト項目一覧］ダイアログ ボックスが開きます。
- 省略可能。［変数］フィールドでは、カスタム ダイアログボックスでユーザーが入力した値を格納する変数の名前を入力します。
ITEMn デフォルト変数名を保持することを選択できます。
- ［カテゴリ］ドロップダウン リストで、プロジェクト項目一覧に入れるプロジェクト項目のカテゴリを選択し、［追加］をクリックします。
たとえば、数値フィールドを選択する場合は、スクリプトを実行するときに、プロジェクト項目一覧に開いているテーブルのすべての数値フィールドが含まれます。
カテゴリはカテゴリ リストに追加されます。
- 省略可能。任意のその他のカテゴリを追加します。
各追加のカテゴリはカテゴリ リストの最後に追加されます。
注意
テーブルとフィールド、またはスクリプトと変数などの異なるカテゴリを追加すると、ユーザーが混乱する可能性があります。ベストプラクティスは、文字フィールドと数値フィールドなどの類似したカテゴリのみを追加することです。
- 省略可能。カテゴリ リストの最後にカテゴリを追加する代わりに、次の他のオプションを使用できます。
オプション 説明 挿入 カテゴリ リストの任意の場所にカテゴリを挿入できます。
［挿入］をクリックする前に、新しいカテゴリを挿入する場所の真下のカテゴリを選択します。
置換
カテゴリ リストでカテゴリを置換できます。
［置換］をクリックする前に、新しいカテゴリで置換するカテゴリを選択します。
削除 カテゴリ リストからカテゴリを削除できます。
削除したいカテゴリを選択し、［削除］をクリックします。
- 省略可能。［デフォルト］フィールドで、カスタム ダイアログボックスが最初に開くときにデフォルトで選択されるプロジェクト項目を指定します。
たとえば、特定のテーブル名またはフィールド名を指定できます。
メモ
カテゴリ名を指定しないでください。
アンダースコア（_）を含むプロジェクト項目のスペリングを正確に入力してください。
- 省略可能。コントロールの正確な位置を指定する場合は、ピクセルで指定された x（水平）および y（垂直）値を修正します。
ヒント
コントロールを配置するには、ダイアログ ビルダーをドラッグすることもできます。
- 省略可能。コントロールのサイズを指定する場合は、［幅］または［高さ］フィールドの横にある［自動］選択をオフにして、ピクセル単位で指定されている値を変更します。
- 自動選択プロジェクト項目一覧コントロールは、コントロールに含まれるテキストのサイズに合わせて自動的に調整されます
- 自動選択プロジェクト項目コントロールは、コントロールに含まれるテキストのサイズに関係なく、指定されたサイズのままです
ヒント
ダイアログ ビルダーのサイズ変更ハンドルを使用して、コントロールのサイズを変更することもできます。
- ［OK］をクリックして、コントロールをダイアログ ビルダーに追加します。
