Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

Version 1 Next »

 

Yellowfinには、そのまま利用できる数多くのパラメーター実装があります。これらは、列挙型InputTypeで定義されます。以下に、利用可能なすべてのタイプとそのオプションを、コードサンプルとともに示します。

 

タイプ説明オプションコードサンプル
TEXTBOX

テキスト入力ボックスです。

  • textClassName：HTML入力要素に追加するclassを指定します。
  • style：HTML入力要素に追加されたCSSスタイルです。
  • numericOnly：テキストボックスに数字のみを許可する場合は「true」に設定します。
  • numericType：小数値を許可しない場合は「INTEGER」に設定します。numericOnlyは、trueにしなくてはいけません。
  • unsignedOnly：負の値を許可しない場合は「true」に設定します。numericOnlyがtrueに設定されている時のみ機能します。
  • thousandSeparatorOn：numericOnlyがtrueに設定されている時に、千単位区切り文字を表示する場合に「true」に設定します。
  • decimalPlaces：numericOnlyがtrue、numericTypeがINTEGERではない時の小数点以下桁数です。
  • minValue/maxValue：入力可能な最小値と最大値です。
  • maxStringLength：numericOnlyがfalseに設定されている時の最大入力長です。
  • readonly：HTML入力要素の「readOnly」プロパティを設定します。
  • disabled：trueに設定することで、HTML入力要素の「disabled」プロパティを設定します。
  • name：HTML入力要素の「name」プロパティを設定します。
  • tooltip：HTML入力要素の「title」プロパティを設定します。
  • disableBrowserAutoComplete：そのフィールドのブラウザのオートコンプリートを無効にします。
  • placeholder：値が入力されるまで表示されるプレースホルダーテキストです。
  • placeholderCss：プレースホルダーのスタイルです。
  • placeholderAccountForScroll：プレースホルダーからスクロール位置を差し引く場合は「true」に設定します。
  • suffix：実際の値の最後に追加されて表示されるべき接尾辞の表示です。
  • width：カスタマイズした幅でこちらの入力値の幅の値を上書きます。注意：これはcssプロパティのため、好きな表示単位を定義することができます。単位のデフォルトはpxではありません。
ParameterImpl parameter = new ParameterImpl();
parameter.setProperty("DECIMALS");
parameter.setInputType(InputType.TEXTBOX);
parameter.setName("Decimal Places");
parameter.setMinAllowed(0);
parameter.addViewOption("numericOnly", true);
parameter.addViewOption("numericType", "INTEGER");
SELECT

ドロップダウンリストです。値と説明は、こちらのパラメーターに追加された可能な値から取得されます。

  • width：カスタマイズした幅でこちらの入力値の幅の値を上書きます。注意：これはcssプロパティのため、好きな表示単位を定義することができます。単位のデフォルトはpxではありません。

  • style：HTML入力要素に追加されたCSSスタイルです。

  • size：ドロップダウンリストのサイズ属性を設定します。デフォルトは「1」です。これを高い数値に設定することで、スクロール可能な一覧になります。

  • multiSelect：スクロール可能な複数選択一覧にする場合は「truen」に設定します。

  • selectAllAvailable：すべての選択肢を選択、および選択解除する制御を追加します。こちらを使用するには、multiSelectをtrueに設定します。

  • multiJoinString：こちらを「|」に設定した場合、複数選択で選択されたすべての値は、間にひとつの文字として「|」を挟み結合されます。

  • disabled：入力を無効にする場合は「true」に設定します。

  • showOptionTitle：選択肢のツールチップを表示する場合は「true」に設定します。

ParameterImpl p = new ParameterImpl();
p.setProperty("DATE_FORMAT");
p.setName("Format");
p.setInputType(InputType.SELECT);
  
List<CustomValue<?>> optValues = new ArrayList<>();
optValues.add(new CustomValue(""," - - Select - - ");
optValues.add(new CustomValue("YEAR","Year"));
optValues.add(new CustomValue("YEAR_START","Year Start Date"));
optValues.add(new CustomValue("YEAR_END","Year End Date"));
  
p.setPossibleValues(optValues);
RADIO

ラジオボタンのグループです。各選択肢にラジオボタンを持ちます。

  • alignment：「right」に設定すると、ラベルの右側にラジオボタンが表示します。デフォルトは「left」です。
  • fullDescription：各選択肢に説明を表示する場合は「true」に設定します。

  • descriptions：これは形式のオブジェクトである必要があります：{value: ‘description’ }

    例：

    {
"LEFT": "Align Left",
"RIGHT": "Align Right",
"MIDDLE": "Centre Align"
}

    これは、fullDescriptionがtrueに設定されている場合にのみ機能します。

     

  • textAlign：text-align CSSプロパティを設定します。これはalignmentプロパティが設定されている場合にのみ適用されます。
  • valign：この要素のvalign CSSプロパティを指定します。
  • radioColour：赤いラジオボタンを表示する場合は、こちらを「red」に設定します。これはラベルには反映されません。
  • disabled：入力を無効にする場合は「true」に設定します。
  • tooltip：選択肢にツールチップを表示する場合「true」に設定します。
  • maxRows：利用可能な選択肢は、この複数ロウ（行）に表示されます。
ParameterImpl parameter = new ParameterImpl();
parameter.setProperty("STARTING_POINT");
parameter.setInputType(InputType.RADIO);
parameter.addPossibleValue("LEFT", "Left");
parameter.addPossibleValue("RIGHT", "Right");
parameter.addPossibleValue("MIDDLE", "Middle");
DATE, TIMESTAMP

日付/タイムスタンプ入力要素です。これらはほぼ同様で、同一のビューオプションを持ちます。

キーは入力値を保存するsetPropertyを使用して設定します。

形式：

静的日付は「yyyy-MM-dd」として保存されます。

静的タイムスタンプは「yyyy-MM-dd hh:mm:ss」として保存されます。

 

動的日付：

動的日付の場合、単位はビューオプション「unitCodeProperty」で指定されたキーに対して保存されます。

動的日付値は、「STSDATE+」として保存されます。例えば、「property=STARTDATE」、「unitCodeProperty=STARTUNIT」の場合、

Today -1 Yearは、以下のように保存されます。

STARTDATE: SYSDATE-1

STARTUNIT: YEAR

  • useCurrentDate：動的日付を使用する場合は「true」に設定します。これは、特定の日付/タイムスタンプ使用するように切り替えることのできるトグルを表示します。
  • unitCodeProperty：動的日付の場合、選択された日付単位を識別するために使用します。
  • width：テキストボックスのデフォルト幅を上書きます。
  • disabled：入力を無効にする場合は「true」に設定します。
ParameterImpl p = new ParameterImpl();
p.setProperty("STARTDATE");
p.addViewOption("useCurrentDate", "true");
p.addViewOption("unitCodeProperty", "STARTUNIT");
p.setInputType(InputType.DATE);
TIME

時間データ入力を検証するテキスト入力要素です。

有効な時間入力は、hh:mm:ss形式（24時間）の指定されたプロパティに対して保存されます。

このウィジェットにはスタイリングオプションがありません。

  • showSeconds：秒を入力するテキストボックスを表示する場合は「true」に設定します。これはデフォルトで「false」です。
  • disabled：無効にするためには「true」に設定します。
ParameterImpl p = new ParameterImpl();
p.setProperty("RUN_TIME");
p.setInputType(InputType.TIME);
CHECKBOX

ひとつ以上のYellowfinチェックボックスを表示します。

  • alignment：「right」に設定すると、ラベルの右側にチェックボックスを表示します。デフォルトは「left」です。
  • checkboxColour：赤いチェックボックスを表示する場合は、こちらを「red」に設定します。これはラベルには反映されません。
  • tooltip：選択肢にツールチップを表示する場合「true」に設定します。
ParameterImpl p = new ParameterImpl();
p.setInputType(InputType.CHECKBOX);
p.setProperty("INCLUDED_FIELDS");
p.setParameterClassName("included-fields");
p.addViewOption("tooltip", true);
 
p.addPossibleValue("field001", "PERSONID");
p.addPossibleValue("field002", "CAMPID");
p.addPossibleValue("field003", "INVOICEDAMOUNT");
BUTTON

標準的なYellowfinのボタンを表示します。

  • text：ボタンに表示するテキストラベルです。
  • img：ボタンに表示するイメージです。「img」と「text」の両者を指定した場合、イメージのみが表示され、「テキスト」の値はボタンのツールチップとして使用されることに注意してください。イメージはURL、またはイメージタイプのBase64文字列になります。

data:<MIME Type>;base64, <base64 String>

  • activeImg：マウスオーバーした時にボタンに表示するイメージです。
  • imgCss：ボタンのイメージに適用するスタイルです（有効、または無効）。
  • style：ボタンの色です。「red」、「blue」、「redhover」、「grey」、「medgrey」、「darkgrey」のいずれかひとつになります。
  • flat：3D効果無しにボタンを表示する場合は「true」に設定します。
  • tooltip：ボタンにマウスオーバーした時のHTMLツールチップです。
  • css：ボタンに適用するスタイルです。
  • cssClass：ボタンに追加されるclassです。
  • width：ボタンの幅です。
  • height：ボタンの高さです。
ParameterImpl p = new ParameterImpl();
p.setProperty("apply");
p.setInputType(InputType.BUTTON);
p.addViewOption("text", "Apply");
p.addViewOption("flat", true);
p.addViewOption("style", "blue");
p.addViewOption("width", "50px");
p.addViewOption("height", "40px");
STATIC

静的テキストのブロックを表示します。

text：表示されるコンテンツです。
ParameterImpl p = new ParameterImpl();
p.addViewOption("text", "This is some text");
p.setInputType(InputType.STATIC);
COLOURPICKER

標準的なYellowfinのカラーピッカーです。

なし
ParameterImpl p = new ParameterImpl();
p.setInputType(
InputType.COLOURPICKER);
SLIDERANDTEXT

どちら方法でも入力が可能なリンクテキストボックス付きのスライダー入力です。

  • maxValue：パラメーターのプロパティに対して保存されるスライダーの最大値です。デフォルトは「100」です。
  • textMaxValue：テキストボックスに入力可能な最大値です。
  • minValue：パラメーターのプロパティに対して保存されるスライダーの最小値です。デフォルトは「0」です。
  • textMinValue；テキストボックスに入力可能な最小値です。
  • sliderWidth：スライダー要素のデフォルト幅を上書きます。
ParameterImpl p = new ParameterImpl();
p.setName("Group Size");
p.setProperty("size");
p.setInputType(InputType.SLIDERANDTEXT);
p.addViewOption("textMaxValue", "20");
p.addViewOption("maxValue", "20");
p.setDefaultValue(5);
TOGGLE

On/Offトグルスライダーを表示します。

  • onValue：トグルスライダーが有効の場合に保存する値です。デフォルトは「true」です。
  • offValue：トグルスライダーが無効の場合に保存する値です。デフォルトは「false」です。
  • disabled：無効にする場合は「true」に設定します。
ParameterImpl p = new ParameterImpl();
p.setProperty("FIRST_ROW_HEADER");
p.setName("First row contains unique titles");
p.setDefaultValue(true);
p.setInputType(InputType.TOGGLE);
FIELDMATCHDROPDOWN

お互いに一致するFieldObject（詳細は、ヘルパーオブジェクト項目を参照）の2つの一覧を受け付けます。ひとつ以上の一致を含めることができます。結果の関係は、以下のような配列で返されます。

{
  'from': fieldA.id,
  'to': fieldB.id
}

  • fieldListA：フィールドの最初の一覧です。
  • fieldListB：フィールドの二番目の一覧です。
  • titleA：フィールド一覧Aのタイトルです。
  • titleB：フィールド一覧Bのタイトルです。
  • titleClassA：フィールド一覧Aのタイトルに形式を設定するオプションCSS classです。
  • titleClassB：上記と同様ですが、フィールド一覧Bのタイトルに適用されます。
  • viewOptionsA：ドロップダウンリストAに渡されるオプションです。
  • viewOptionsB：ドロップダウンリストBに渡されるオプションです。
ParameterImpl p = new ParameterImpl();
p.setProperty("fieldMatchProperty");
p.setList(true); //List of matches
ListOptions lo = new ListOptions();
lo.setAddButtonText("Match More");
p.setListOptions(lo);
  
FieldObjectDataType textType = FieldObjectDataType.TEXT;
FieldObjectDataType numericType = FieldObjectDataType.NUMERIC;
 
// LIST A
List<FieldObject> fieldListA = new LinkedList<>();
FieldObject field1 = new FieldObject("1", "", "Field 1", textType);
FieldObject field2 = new FieldObject("2", "", "Field 2", numericType);
fieldListA.add(field1);
fieldListA.add(field2);
 
// LIST B
List<FieldObject> fieldListB = new LinkedList<>();
FieldObject field3 = new FieldObject("3", "", "Field 3", textType);
FieldObject field4 = new FieldObject("4", "", "Field 4", numericType);
FieldObject field5 = new FieldObject("5", "", "Field 5", textType);
FieldObject field6 = new FieldObject("6", "", "Field 6", numericType);
fieldListB.add(field3);
fieldListB.add(field4);
fieldListB.add(field5);
fieldListB.add(field6);
 
// Add the lists to the Match widget
p.addViewOption("fieldListA", fieldListA);
p.addViewOption("fieldListB", fieldListB);
  
p.addViewOption("titleA", "Left Field");
p.addViewOption("titleB", "Right Field");
  
p.setInputType(InputType.FIELDMATCHDROPDOWN);
FIELDMATCH

これは、FIELDMATCHDROPDOWNと同様の機能を提供します。ドラッグをすることでフィールドを一致させます。フィールドはデータ型により一致し、色でコーディングされています。一致しないフィールドはフラグ付けされます。

一方のフィールドは、「除外」ゾーンにドラッグすることで除外することができます。結果の関係は、FIELDMATCHDROPDOWNと同様の形式で返されます。

 

ひとつのカラム（列）からフィールドが除外された場合、そのロウ（行）に一致するオブジェクトは、対応する「from」や「to」属性を持たないことになります。例えば、以下の画像のADDRESSIDのオブジェクトは、下記のようになります。

{ 
  'to': ADDRESSID.id
}

  • fieldListA：フィールドの最初の一覧です。
  • fieldListB：フィールドの二番目の一覧です。
  • titleA：フィールド一覧Aのタイトルです。
  • titleB：フィールド一覧Bのタイトルです。
  • titleClassA：フィールド一覧Aのタイトルに形式を設定するオプションCSS classです。
  • titleClassB：上記と同様ですが、フィールド一覧Bのタイトルに適用されます。
  • viewOptionsA：ドロップダウンリストAに渡されるオプションです。
  • viewOptionsB：ドロップダウンリストBに渡されるオプションです。
  • includeUnmatched：一方の一覧からのフィールドが、他方の一覧からのフィールドと一致しない場合に、エラーを表示しません。デフォルトは「false」です。
  • roughMatch：日付とテキストフィールドの一致を許可します。デフォルトは「false」です。
  • imageMap：マップ内の様々なイメージを指定します。利用可能なキーは、以下の通りです。
  • primary：プライマリーキー形式のフィールド用です。
  • dragHandle：フィールドをドラッグするためのハンドルです。
  • error：フィールド一致エラーイメージです。
  • forceAllConnections：接続が返されている時にtrueに設定すると、警告がある場合、部分的に接続された一覧の代わりに空の一覧が返されます。デフォルトは「false」です。
ParameterImpl p = new ParameterImpl();
p.setInputType(InputType.FIELDMATCH);
p.setProperty("UNION_FIELD_MATCH");
p.addViewOption("includeUnmatched", true);
  
//Match exact types
p.addViewOption("roughMatch", false);
  
List<FieldObject> foListA = new ArrayList<>();
List<FieldObject> foListB = new ArrayList<>();
  
FieldObjectDataType textDataType = FieldObjectDataType.TEXT;
FieldObjectDataType numericDataType = FieldObjectDataType.NUMERIC;
  
// LIST A
FieldObject field1 = new FieldObject("1", "primary", "Field 1", textDataType); //Primary Key
FieldObject field2 = new FieldObject("2", "", "Field 2", numericDataType);//This is a metric
  
foListA.add(field1);
foListA.add(field2);
 
// LIST A
FieldObject field3 = new FieldObject("3", "", "Field 3", textDataType);
FieldObject field4 = new FieldObject("4", "", "Field 4", numericDataType);//This is a metric
FieldObject field5 = new FieldObject("5", "", "Field 5", textDataType);
FieldObject field6 = new FieldObject("6", "", "Field 6", numericDataType);//This is a metric
 
foListB.add(field3);
foListB.add(field4);
foListB.add(field5);
foListB.add(field6);
  
p.addViewOption("fieldListA", foListA);
p.addViewOption("fieldListB", foListB);
  
//Input 1
p.addViewOption("titleA", "Input 1");
  
//Input 2
p.addViewOption("titleB", "Input 2");

 

上記のコードは、以下を生成します。

AUTOCOMPLETEBOX

検索可能なドロップダウンリストを表示します。

検索可能なアイテムは、パラメーターの「possibleValues」として追加されたCustomValueオブジェクトでなくてはいけません。

  • initialValue：入力の初期値です。これは、CustomValueオブジェクトでなくてはならず、設定は以下のようになります。
    value = search string
    description = search string
  • width：ビューの幅を設定します。
  • maxDisplayItems：一覧の下に表示される最大アイテム数です。デフォルトは「4」です。
  • isDataGrouped：データはグループを持つことができます。
  • resultListStyle：結果一覧を含むHTML要素を指定されたclassに追加します。
ParameterImpl p = new ParameterImpl();
p.setProperty("TABLETEXTBOX");
p.setName("New Table Name");
p.setInputType(InputType.AUTOCOMPLETETEXTBOX);
p.addViewOption("width", 200);
  
CustomValue<String> initialValue = new CustomValue<String>("all_objects", "all_objects");
p.addViewOption("initialValue", initialValue);
  
List<CustomValue<?>> possibleValues = new ArrayList<>();
possibleValues.add(new CustomValue<String>("all_columns", "all_columns"));
possibleValues.add(new CustomValue<String>("all_parameters", "all_parameters"));
possibleValues.add(new CustomValue<String>("all_sql_modules", "all_sql_modules"));
possibleValues.add(new CustomValue<String>("all_tables", "all_tables"));
  
p.setPossibleValues(possibleValues);
  
p.addViewOption("width", 200);
p.addViewOption("resultListStyle", "outputStepAutoCompleteList");
SHOWADVANCED

他のユーザーインターフェイス要素を表示/非表示する展開可能なウィジェットです。これは、ParameterDisplayRulesとともに使用しなくてはいけません。

  • showText：設定を展開するリンクのテキストです。
  • hideText：展開を元に戻すリンクのテキストです。
Boolean value = true;
Boolean negative = false;
  
// SHOW_ADVANCED_SETTINGS == true
ParameterDisplayRule advancedSettingsDisplayRule = new ParameterDisplayRule("AND", "SHOW_ADVANCED_SETTINGS", value, negative);
  
ParameterImpl p = new ParameterImpl();
p.setProperty("ALL_ROWS");
p.setName("All Rows");
p.setDefaultValue(true);
p.setInputType(InputType.TOGGLE);
p.addDisplayRule(advancedSettingsDisplayRule);
paramList.add(p);
 
p = new ParameterImpl();
p.setProperty("SEPARATOR");
p.setName("Separator");
p.setInputType(InputType.TEXTBOX);
p.addViewOption("width", "40px");
p.addDisplayRule(advancedSettingsDisplayRule);
paramList.add(p);
p = new ParameterImpl();
p.setProperty("SHOW_ADVANCED_SETTINGS");
p.setInputType(InputType.SHOWADVANCED);
  
p.setDefaultValue(false);
p.addViewOption("showText", "Advanced Settings &darr;");
p.addViewOption("hideText", "Less &uarr;");
p.addViewOption("width", "150px");
paramList.add(p);
PAIRCOLUMNS   
    
    

 

 

 

 

 

  • No labels