メインコンテンツまでスキップ
バージョン:23.3

SenseTalkのローカルおよびグローバルプロパティ

SenseTalkでは、ローカルおよびグローバルプロパティは、ランタイム環境の動作を決定するシステム全体の値です。本質的に、これらの特殊なプロパティは、プロパティの利用可能なオプションを設定するために特定の値を受け入れることができるコンテナです。

たとえば、the strictFilesのような単純なグローバルプロパティは、真または偽の値を取るだけで、機能が有効化または無効化されるかを決定するかもしれません。他のプロパティ、たとえばthe timeFormatは、そのデータ型の形式を設定できる形式の受け入れ可能な値のリストが大きいかもしれません。

SenseTalkには、ローカルハンドラーの環境のみに影響を及ぼすローカルプロパティと、ランタイム環境全体に影響を及ぼすグローバルプロパティの両方が含まれています。さらに、Eggplant Functionalで動作するように特別に定義されたグローバルプロパティがあります:Eggplant Functionalグローバルプロパティ、および実行オプショングローバルプロパティ

以下のページで利用可能なローカルおよびグローバルプロパティのリストを見つけることができます:

SenseTalkコマンドでのグローバルプロパティの使用

SenseTalkスクリプト内で、グローバルプロパティの値を設定または変更することができます。実際、スクリプトごと、または1つのスクリプト内で複数回それらを変更することができます。

SenseTalkコマンドのSetまたはPutでグローバルプロパティの値を設定できます。

ノート

これらのプロパティを参照するときは、普通の変数と区別md するためにプロパティ名の前にtheを使用しなければなりません。

例:

set the searchrectangle to (1,2,2,3)
put 2 into the remoteworkinterval

詳細な情報については、Container Propertiesを参照してください。

SetOptionおよびSetOptionsを使用したグローバルプロパティの使用

通常、上記で説明したようにsetまたはputコマンドを使用してグローバルプロパティの値を設定することが最も簡単です。ただし、setOptionおよびsetOptionsコマンドも利用可能で、一度に複数のプロパティを更新できます。

これらのコマンドを使用してグローバルプロパティの値を設定するとき、グローバルプロパティの名前の前にtheを挿入しないでください。(SetOptionsetOptionsは、パラメータ値としてonlyグローバルプロパティを取るコマンドなので、theでグローバルプロパティを区別する必要はありません。)

一度に複数のグローバルプロパティを設定するには、setOptionsコマンドを使用し、常にリストを渡すように、括弧内にグローバルプロパティのリストを渡します。

例:

setoption searchrectangle, (1,2,2,3)
setoptions (searchrectangle: (1,2,2,3), scriptlogging: yes)
ノート

デフォルト設定を保存するには、スクリプトの実行の始めに以下のSenseTalkコードを追加します。このコードはデフォルト設定をグローバル変数に格納します:

put GetOptions ( "RunOptions" ) into global defaultRunOptions

次に、以下のSenseTalkコードを使用してデフォルト設定を復元できます:

SetOptions

global defaultRunOptions

これらのコマンドについての完全な情報については、SetOption, SetOptions Commandsを参照してください。

GetOptionおよびGetOptions関数

getOptiongetOptions関数は、グローバルプロパティ(getOption)の値、またはグローバルプロパティのリスト(getOptions)を返します。どの関数でもそうであるように、単一のグローバルプロパティとグローバルプロパティのリストを括弧で囲みます。

例:

put getOption (searchrectangle)
put getOptions (searchrectangle, scriptlogging)

これらの関数に関する完全な情報については、GetOption、GetOptions関数を参照してください。