変数の変換

変数の変換を使用すると、Workshop のビルダーは変数に一般的な操作を適用できるほか、前の操作を参照して操作を連鎖させることもできます。

実行コンテキスト

変数の変換は、Foundry のバックエンドではなくブラウザーで実行されます。文字列、数値、日付、ブール値などのプリミティブ型に対する変換では、Foundry サービスとの往復通信は必要ありません。

変換の種類

一般的な操作

String の連結： 指定された固定テキストや変数の値を連結した文字列を返します。配列変数を入力した場合、この操作は配列内の要素を文字列にキャストして連結します。ビルダーは、要素間に追加する別の入力を任意で指定できます。
If/else 文： 条件文を実行し、事前定義された出力値または変数を返します。
キャスト操作： 異なるプリミティブ型の間で変数をキャストします。次の型キャストがサポートされています。
- 文字列 → 数値：数値文字のみを含む文字列型の値を渡して、数値型にキャストします。
- 文字列 → 日付：有効な形式の日付値を含む文字列型の値を渡し、パーサーフィールドで対応する日付形式を選択します。たとえば、値が 06/26/24 の文字列変数を渡す場合は、対応するパーサー形式として M/dd/yyyy を選択して、日付型にキャストします。
- 文字列 → タイムスタンプ：有効な形式のタイムスタンプ値を含む文字列型の値を渡し、パーサーフィールドで対応するタイムスタンプ形式を選択します。出力されるタイムスタンプ値のキャストに使用するタイムゾーンは、ユーザーのローカルタイムゾーンを使用するか、ドロップダウンの選択肢から固定で設定するか、文字列の参照または変数を使用して動的に設定できます。たとえば、値が 2024 06 26 12:50 AM の文字列変数を渡す場合は、対応するパーサー形式として yyyy M dd hh:mm aa を選択して、タイムスタンプ型にキャストします。
- 文字列 → Geopoint：[latitude], [longitude] のペア形式の文字列型の値を渡して、Geopoint 型にキャストします。例: 40.782142,-73.96596。
- 文字列 → Geoshape：図形の種類と座標の配列を含む JSON 形式の文字列型の値を渡して、Geoshape 型にキャストします。例: {"type":"Polygon","coordinates":[[[-73.9580917968885,40.80044406792189],[-73.98186087075722,40.76811683550534],[-73.97304465743831,40.76434392565562],[-73.94930767833077,40.79687062648023],[-73.9580917968885,40.80044406792189]]]}。
- タイムスタンプ → 日付：タイムスタンプ型の値を渡して、日付型にキャストします。出力される日付値のキャストに使用するタイムゾーンは、ユーザーのローカルタイムゾーンを使用するか、ドロップダウンの選択肢から固定で設定するか、文字列の参照または変数を使用して動的に設定できます。入力されたタイムスタンプは、指定したタイムゾーンでの絶対タイムスタンプを使用して日付に変換されます。
- 日付 → タイムスタンプ：日付型の値を渡して、タイムスタンプ型にキャストします。出力される日付値のキャストに使用するタイムゾーンは、ユーザーのローカルタイムゾーンを使用するか、ドロップダウンの選択肢から固定で設定するか、文字列の参照または変数を使用して動的に設定できます。入力された日付は、指定したタイムゾーンでその日の開始時刻を表すタイムスタンプに変換されます。
- 任意の型 -> 文字列：String の連結操作を使用して、任意のプリミティブ型を文字列にキャストできます。

オブジェクトセットの変換

空である： 指定されたオブジェクトセットにオブジェクトが存在しないかどうかをブール値でチェックします。
空でない： 指定されたオブジェクトセットにオブジェクトが存在するかどうかをブール値でチェックします。
オブジェクトプロパティ： 単一のオブジェクトと、そのオブジェクトタイプの指定されたプロパティに基づいて、プロパティ値を返します。
オブジェクトセットの集計： 指定されたオブジェクトセットの指定されたプロパティを集計します。サポートされている集計には、最小値、最大値、合計、平均、カーディナリティがあります。
オブジェクト RID： 指定されたオブジェクトのオブジェクト RID を返します。

数学演算

加算： 指定された数値または変数の合計を返します。
減算： 指定された数値または変数の差を返します。
乗算： 指定された数値または変数の積を返します。
除算： 指定された数値または変数の商を返します。
絶対値： 指定された数値または変数の絶対値を返します。
否定： 指定された数値または変数の符号を反転した値を返します。
切り上げ： 指定された数値または変数を、指定された精度で切り上げた値を返します。
切り捨て： 指定された数値または変数を、指定された精度で切り捨てた値を返します。
四捨五入： 指定された数値または変数を、指定された精度で丸めた値を返します。
最大： 数値、日付、タイムスタンプの値または変数の集まりから、最大値を返します。
最小： 数値、日付、タイムスタンプの値または変数の集まりから、最小値を返します。

日付/時刻の演算

相対日付： 加算または減算する日数、週数、月数、年数を指定する数値または変数と、日付の値または変数に基づいて、計算された日付を返します。
相対時間： 加算または減算する秒数、分数、時間数、日数、週数、月数、年数を指定する数値と、時刻の値または変数に基づいて、計算された時刻を返します。
日付の間隔： 指定された2つの日付の値または変数の差を数値で返します。返される差は、日数、週数、月数、年数で計算できます。
時間間隔： 指定された2つの時刻の値または変数の差を数値で返します。返される差は、秒数、分数、時間数、日数、週数、月数、年数で計算できます。
現在の日付： 現在の日付を返します。

日付の比較

以降： 指定された1つ目の日付の値または変数が、指定された2つ目の日付の値または変数以降であるかどうかをブール値でチェックします。
より後： 指定された1つ目の日付の値または変数が、指定された2つ目の日付の値または変数より後であるかどうかをブール値でチェックします。
以前： 指定された1つ目の日付の値または変数が、指定された2つ目の日付の値または変数以前であるかどうかをブール値でチェックします。
より前： 指定された1つ目の日付の値または変数が、指定された2つ目の日付の値または変数より前であるかどうかをブール値でチェックします。
等しい： 指定された2つの日付の値または変数が等しいかどうかをブール値でチェックします。

時刻の比較

以降： 指定された1つ目の時刻の値または変数が、指定された2つ目の時刻の値または変数以降であるかどうかをブール値でチェックします。
より後： 指定された1つ目の時刻の値または変数が、指定された2つ目の時刻の値または変数より後であるかどうかをブール値でチェックします。
以前： 指定された1つ目の時刻の値または変数が、指定された2つ目の時刻の値または変数以前であるかどうかをブール値でチェックします。
より前： 指定された1つ目の時刻の値または変数が、指定された2つ目の時刻の値または変数より前であるかどうかをブール値でチェックします。
等しい： 指定された2つの時刻の値または変数が等しいかどうかをブール値でチェックします。

数値の比較

と等しい： 指定された数値または変数が等しいかどうかをブール値でチェックします。
等しくない： 指定された数値または変数が等しくないかどうかをブール値でチェックします。
より小さい： 指定された1つ目の数値または変数が、指定された2つ目の数値または変数より小さいかどうかをブール値でチェックします。
以下： 指定された1つ目の数値または変数が、指定された2つ目の数値または変数以下であるかどうかをブール値でチェックします。
より大きい： 指定された1つ目の数値または変数が、指定された2つ目の数値または変数より大きいかどうかをブール値でチェックします。
以上： 指定された1つ目の数値または変数が、指定された2つ目の数値または変数以上であるかどうかをブール値でチェックします。

文字列の比較

である： 指定された文字列値または変数が等しいかどうかをブール値でチェックします。
ではない： 指定された文字列値または変数が等しくないかどうかをブール値でチェックします。
含む： 2番目に指定された文字列値または変数が、最初に指定された文字列値または変数の部分文字列であるかどうかをブール値でチェックします。
含まない： 2番目に指定された文字列値または変数が、最初に指定された文字列値または変数の部分文字列であるかどうかをブール値でチェックします。
で始まる： 2番目に指定された文字列値または変数が、最初に指定された文字列値または変数の接頭辞であるかどうかをブール値でチェックします。
で終わる： 2番目に指定された文字列値または変数が、最初に指定された文字列値または変数の接尾辞であるかどうかをブール値でチェックします。

ブール値の比較

真である： 指定されたブール変数が true であるかどうかをブール値でチェックします。
偽である (NOT)： 指定されたブール変数が false であるかどうかをブール値でチェックします。
nullである： 指定された変数が null であるかどうかをブール値でチェックします。
nullでない： 指定された変数が null ではないかどうかをブール値でチェックします。

地理空間

Geopoint からの Geohash： 指定された Geopoint を文字列の Geohash 値に変換します。
Geopoint からの緯度： 指定された Geopoint から緯度の数値を返します。
Geopoint からの経度： 指定された Geopoint から経度の数値を返します。
Geopoint からの MGRS： 指定された Geopoint を文字列の MGRS 値に変換します。

配列の操作

作成： 指定された配列のすべての値を含む配列を返します。
共通部分： 指定された配列間で共通する値のみを含む配列を返します。
指定位置の要素を更新： 指定された配列内の特定の要素を更新した配列を返します。ビルダーは、配列内での要素の位置を表すインデックスを指定することで、更新する要素を指定できます。
指定位置の要素を取得： 指定された配列内の指定インデックスにある要素に対応し、配列のデータ型に一致する値を返します。
長さ： 指定された配列内の要素数を表す数値を返します。

配列のチェック

含む： 指定された配列内に指定された値が存在するかどうかをブール値でチェックします。
含まない： 指定された配列内に指定された値が存在しないかどうかをブール値でチェックします。
のサブセットである： 指定された配列が、別の指定された配列のサブセットであるかどうかをブール値でチェックします。
nullである： 指定された配列が null であるかどうかをブール値でチェックします。
- 注：値として配列変数への参照が選択されている場合、この変換は「空である」として評価され、表示されます。
nullでない： 指定された配列が null ではないかどうかをブール値でチェックします。
- 注：値として配列変数への参照が選択されている場合、この変換は「空ではない」として評価され、表示されます。

構造体の変換

構造体のフィールドを抽出： 指定された構造体とフィールドIDに基づいて、構造体のフィールド値を返します。詳細は、構造体からフィールドを抽出するを参照してください。