TIBCO Spotfireのヒント:TIBCO Spotfireで構成ブロック(Block)を作成します
Tibco Spotfire Tips Create Configuration Block Tibco Spotfire
元の: https://community.tibco.com/wiki/create-configuration-block-tibco-spotfire
前書き
パラメトリック分析パラメーターの挿入とは、ファイルを開くプロセス、およびオプションで、構成分析とユーザー操作を変更する前にさらに分析することを意味します。これらの操作は両方とも構成ブロックで定義されます。
構成スクリプトのテキストブロックは類似しており、構成パラメーターの割り当てステートメントで構成されています。
データソース、パラメータ情報、または変換リンクのパラメータの分析を含む、ドキュメントプロパティ割り当て、パラメトリック分析のパラメータ設定。
パラメータ範囲にデータをロードする前。 APIを介していつでも取得できます。
構成ステートメントの後にメソッドパラメーターリストの名前が続きます。ただし、データのロード後にコマンド履歴をアクティブ化する前の構成ステートメントの説明。それらを破棄するための構成ステートメントの説明の後。
構成ステートメントは常にオプションです。分析では、構成ステートメントを定義する必要はありません。
次の例では、最初の2行はパラメーターの割り当てであり、次の行はアレンジされたステートメントです。
Region = 'West' Acme.Limits = { 10, 100, 1000 } SetPage(pageTitle = 'Overview') ApplyBookmark(bookmarkName = 'UserRegionOnly') SetFilter(tableName = 'Table 1', columnName = 'Column 1', values = { 'A', 'B' }) SetMarking(tableName = 'Table 2', whereClause = 'Gender = 'Male' AND GeekFactor = 'High'')
構成の前にブロック構成構文パラメーター割り当てステートメントを配置します。
APIでは、構成ブロック DocumentOpenSettings と DocumentSaveSettings それぞれ、テキストプロパティクラス表現。 AnalysisApplication.Open と AnalysisApplication.Save 方法。
その他の用途
ブロック開口部の外側で構成ファイルを使用することに加えて、分析ブロックの埋め込み構成を保存するために使用することもできます。一般的な状況は、さまざまな領域を担当する営業マネージャーなど、ユーザーが一連の同様のドキュメントを自動的に生成する必要があるため、わずかに異なります。埋め込まれたブロックを使用したオープン構成の分析。ブロックは、オープン効果を呼び出すパラメーターと同じ効果を発揮します。
インサートは、パラメータとして渡される外部ブロックと組み合わせることもできます。埋め込みブロックは、外部ブロックの前に解釈されます。このようにして、ブロックを使用して、外側の挿入ブロックで定義された設定をカバーできます。通常、外部アプリケーション構成ブロック分析の開始を使用します。割り当てられたパラメーターの値は、このアプリケーションで自動的に導出されます。この場合、COMオートメーションインターフェイスを使用して呼び出しを開き、完了します。
構成ブロックを使用する場所
構成ブロックは、次の位置で使用できます。
-
現在使用中 TIBCOSpotfire®JavaScriptAPI ページ。
-
に カスタムC#拡張子 。
-
に のSpotfireAnalyst API 、テキスト属性構成ブロックで表されます
-
-
ブラウザでSpotfire分析を行うときにURLを開きます。例えば:
https://spotfire-next.cloud.tibco.com/spotfire/wp/analysis?file=/Samples/Introduction%20to%20Spotfire&configurationBlock=SetPage(pageTitle=%22Filtering%22)SetFilter(tableName=%22World%20Bank%20Data%22,columnName=%22Region%22,values=%7B%22North%20America%22,%22Europe%20%26%20Central%20Asia%22%7D)
注意 :URLを使用する場合、URLは構成ブロックコーディング(エンコードパーセンテージ)である必要があります。さまざまなブラウザがさまざまな方法でコード化を処理できます。
特に、次の文字をコーディングする必要があります。
space | %20 |
“ | %22 |
{ | %7B |
} | %7D |
例えば:{'北アメリカ'、 'ヨーロッパおよび中央アジア'}は次のようにコード化されます。
%7B%22North%20America%22,%22Europe%20%26%20Central%20Asia%22%7D
-
URLエンコードの詳細 ここに 。無料のオンライン変換ツールも提供しています。
-
構成ブロックで使用されるURLには、任意の数の構成パラメーターと割り当てステートメントを含めることができ、それぞれがセミコロンで終了します。
-
Spotfire Library Browserまたはサービスのコンシューマー/クライアントから、パラメーター化されたURLの展開を構成ブロックで簡単に取得できます。 ここにあります もっと理解する。
-
たとえば、コマンドラインパラメータとしてのクライアントSpotfire Analyst
-
ライブラリdxpでドキュメントプロパティのファイルを開くと 'testParam'割り当て 'パラメータ値':
-
Spotfire.Dxp.exe /server:http://myserver/ /uri:analysis:/MyFolder/MyTestFile:configurationBlock:testParam=%22param%20value%22
-
-
構成ブロックはURLエンコードする必要があることに注意してください。上記の「Spotfire分析を開いたときにURLの詳細を参照してください」
-
- 「自動化サービス」ミッションの「ライブラリからのオープン分析」。
パラメータの割り当て
オープンパラメトリック分析。すべての分析に必要なパラメーターは、APIを介して値に割り当てる必要があります。必須パラメーターが欠落していると、エラーが発生します。パラメータもParameterManagerクラスによって管理され、APIを使用して取得できます。引数マネージャーの一部はドキュメントではありませんが、アプリケーションサービスレベルの取得として常駐できます。
構成パラメーター割り当てステートメントを配置する前の文法構成。
多くのコンピューター言語識別子に類似したパラメーター名。大文字と小文字は重要ですが、パラメータ名で定義された意味で格納される方法でのみです。メソッドの検索パラメーターマネージャーは、混乱のリスクを減らすために、すべてのパラメーター名が一意である必要があるという意味でも、大文字と小文字を区別せず、大文字と小文字を区別しません。
パラメータ値は、文字列または文字列/配列のリストです。すべてのリストはフラットであり、他のリストが含まれていない場合があります。文字列にスペースや特殊文字が含まれていない場合は、引用符なしで書き込むことができます。
パラメータの単一値の例:
Parameter1=Value Parameter2='Value 1'
例示的なリスト/配列パラメータ:
Parameter3={'Value 1', 'Value 2', 'Value 3'}
パラメータとドキュメントのプロパティ
データ分析でドキュメント属性が同じ名前とタイプで定義されている場合、構成はブロックパラメータのドキュメントプロパティに自動的に割り当てられます。それは多くの便利な方法でさまざまなプロジェクトの分析パラメータにあります。一般的な使用法は、プロパティ値を引数IronPythonスクリプトとして文書化することです。
パラメトリック情報リンク
パラメータの割り当ては通常、Spotfire InformationDesignerツールで簡単に作成できるパラメータ化された情報リンクと組み合わせて使用されます。これらには、サーバーによって定義されたいくつかのパラメーターへの情報リンクが含まれる場合があります。設計者の名前とタイプによって定義されるこのようなパラメータ情報。タイプは、単一の値またはリストタイプの場合があります。次の構文を使用してパラメーターをリンクすると、構成ブロックの名前が参照されます。 param_name。
パラメータ情報リンクからデータがロードされると、ParameterManagerから取得されたパラメータの値。次の表に、プロパティ内の要素をリンクする情報が含まれる可能性のあるさまざまなパラメータを示します。
要素タイプ | パラメータ化されたプロパティ |
カラム | 列計算式 集計列の計算式 フィルタリングされた条件式 |
フィルタ | 条件式をフィルタリングする |
情報リンク | 静的フィルター SQLの編集(更新、クエリ、更新の前) |
プログラム | 入力パラメータ値 |
情報源 | セッションを開くコマンド セッションを閉じるコマンド |
パラメトリックリンク情報を作成する方法の詳細については、TIBCO®Spotfire-パラメトリック情報リンクサブジェクトユーザーマニュアルを参照してください。
構成ステートメント
2つのステップで実行されるステートメントの構成。まず、分析メソッド名とパラメータリストが配置された後続のステートメントを構成し、それぞれのクラス構成のインスタンスを作成するために使用されます。次に、構成プログラムを確認して実行します。
次のリストは、使用可能な構成ステートメントのセットを定義しています。
- SetPage:初期ページ分析を指定します
- ApplyBookmark:アプリケーションブックマーク
- SetFilter:指定された任意のタイプのフィルターの初期設定
- SetMarking:初期化マーク
SetPage
SetPageステートメントは、分析を指定するための初期ページを構成するために使用されます。これは1つのパラメーターを取ります。これは、ページのゼロベースのインデックス、またはページタイトルページのGUIDです。
SetPage(pageIndex = 2) SetPage(pageId = '5462f26a-8e02-11dc-8314-0800200c9a66') SetPage(pageTitle = 'The Intro Page')
PageCollectionドキュメントを使用して一致するページを見つけるSetPage構成プログラム。検索一致の順にリストされます。最初にページインデックス(提供されている場合)を使用し、次にページID、最後にページタイトルを使用します。
問題リストにコメントを追加するための構成プログラムに一致するページが見つからないが、中断されない場合。
ApplyBookmark
指定された分析の初期状態のApplyBookmark構成ステートメント。ブックマークには、名前またはIDを表示して識別します。
ApplyBookmark(bookmarkId = '5462f26a-8e02-11dc-8314-0800200c9a66') ApplyBookmark(bookmarkName = 'Streamlined')
BookingCollectionドキュメントを使用したApplyBookmark構成プログラム一致するブックマークを検索します。リストされている順序で、最初にID、次に名前の順に一致するものが検索されます。
一致するブックマークがない場合は、問題リストにコメントを追加するようにプログラムを構成しますが、中断されることはありません。
setfilterを使用する
SetFilter構成ステートメントは、任意のタイプのフィルターの初期設定を指定します。次のパラメータは、さまざまな組み合わせで使用できます。
パラメータ | の種類 | デフォルト | 説明 |
FilteringName | ストリング | イベントページから | フィルタプログラムを指定します |
テーブル名 | ストリング | ポジティブプロットについて | 指定されたテーブル |
TABLEID | ストリング | ポジティブプロットについて | 指定されたテーブル |
COLUMNNAME | ストリング | - | 識別フィルター |
searchPatternです | ストリング | - | TextFilterおよびListBoxFilterの場合 |
値 | StringList | - | 値のリストを指定します |
道 | StringList | - | フィルタ階層の親 |
低い価値 | ストリング | 変更なし | 低域フィルター |
高い価値 | ストリング | 変更なし | ハイレンジフィルター |
INCLUDEEMPTY | ブール値 | 変更なし | 空の(無効な)値が含まれています |
手術 | 記載されています | 交換 | 置換、追加、追加、削除、すべてのリセットの削除 |
フィルタボックスまたはリストボックスフィルタ
CheckBoxFilterまたはListBoxFilterは次のように提供されます。
// Check A and B, uncheck all other values: SetFilter(columnName = 'C', values = { 'A', 'B' }) // Uncheck A, leave other check boxes as is: SetFilter(columnName = 'C', values = { 'A' }, operation = Remove) // Uncheck all boxes and exclude empty values: SetFilter(columnName = 'C', operation = RemoveAll, includeEmpty = false) // Reset the filter: SetFilter(columnName = 'C', operation = Reset) // The following applies only to the ListBoxFilter. // Select A and BA, hide all items not ending with 'A': SetFilter(columnName = 'C', values = { 'A', 'B' }, searchPattern = '*A')
プロジェクトフィルターまたはフィルターラジオボタン
ItemFilterまたはRadioButtonFilterは次のように提供されます。
// Select a specified value: SetFilter(columnName = 'C', values = { 'A' }) // Select all values, leave includeEmpty as is: SetFilter(columnName = 'C', operation = AddAll) // Select no values, leave includeEmpty as is: SetFilter(columnName = 'C', operation = RemoveAll)
レンジフィルター
RangeFilterは次のように設定されます。
SetFilter(columnName = 'C', lowValue = '100', highValue = '1000') // Set the upper limit, leave the lower limit as is: SetFilter(columnName = 'C', highValue = '1000') // Select the full range of values: SetFilter(columnName = 'C', operation = AddAll)
階層フィルター
CheckBoxHierarchyFilterは次のように設定されます。
// Select the May 1988 subtree only: SetFilter(columnName = 'C', path = { '1988' }, values = { 'May' }) // Add the May 1988 subtree to the included values: SetFilter(columnName = 'C', path = { '1988' }, values = { 'May' }, operation = Add) // Remove two days in May from the selection: SetFilter(columnName = 'C', path = { '1988', 'May' }, values = { '1', '2' }, operation = Remove)
テキストフィルター
TextFilterは次のように設定されます。
// Select all items ending with 'A': SetFilter(columnName = 'C', searchPattern = '*A') // Reset the filter: SetFilter(columnName = 'C', operation = Reset)
SetMarking
マークを初期化するために使用されるSetMarking構成ステートメント。次のパラメータが必要です。
パラメータ | の種類 | デフォルト | 説明 |
マーキング名 | ストリング | イベントページから | タグを指定してください |
テーブル名 | ストリング | ポジティブプロットについて | 指定されたテーブル |
TABLEID | ストリング | ポジティブプロットについて | 指定されたテーブル |
whereClause | ストリング | - | 制限された行のセットを選択するためのSQLステートメント。構文は、詳細情報に使用される式と同じです。「式の言語」セクションの「TIBCO®Spotfire-ユーザーガイド」を参照してください。 |
手術 | 記載されています | 交換 | または、交差点の加算、減算、切り替え |
SetMarking構成ステートメントは次のように使用されます。
// Replace the current marking by the one specified: SetMarking(tableName = 'T1', whereClause = 'Region = 'West' and Broker = 'John'') // Add a set of rows to the current marking: SetMarking(tableName = 'T1', whereClause = 'Region = 'East'', operation = Add)
TIBCO Spotfireの最初の購入に連絡する必要がある場合は、次のリンクにアクセスできます。
https://www.tibco.com/company/locations
中国北京本社電話