関数
対象: System Center 2012 SP1 - Orchestrator、System Center 2012 - Orchestrator、System Center 2012 R2 Orchestrator
System Center 2012 - Orchestrator を使用すると、テキスト ファイル、公開データなどのソースの文字列データを操作し、使用できるフォームに変換できます。 また、合計や差分の計算、除算、乗算など、単純な数学操作を実行できます。 たとえば、テキスト ファイルの管理活動を使用してテキスト ファイルからテキストを抽出し、テキストの先頭または末尾のスペースを削除し、テキストの特定部分を取得して、返されたデータの項目として他の活動に渡すことができます。
実行できる関数のすべての一覧については、次の関数表を参照してください。
データ操作関数
データ操作関数は、テキストを入力できる任意のボックスに挿入できます。 データ操作関数は角かっこ ("[" および "]") で囲む必要があります。 たとえば、
[Upper('this will be inserted in upper case')]
この活動を実行すると、例の 'this will be inserted in uppercase' というテキストは 'THIS WILL BE INSERTED IN UPPERCASE' に置き換えられます。
入れ子になった関数
別の関数内でデータ操作関数を使用する場合、入れ子になった関数を角かっこで囲む必要はありません。 たとえば、Field 関数を入れ子にするには、次のように入力します。
[Field(Field('username=jsmith@abcompany.com','=',2),'@',1)]
関数
関数は大文字と小文字が区別されます。 たとえば、Upper('Text') は処理されますが、upper('Text') は処理されません。
| 関数と定義 | 使用方法 | パラメーター | 例 |
|---|---|---|---|
| Upper - テキストを大文字に変換します。 | Upper('Text') | Text - 大文字に変換されるテキスト。 | Upper('this will be converted to uppercase') は 'THIS WILL BE CONVERTED TO UPPERCASE' を返します |
| Lower - テキストを小文字に変換します。 | Lower('Text') | Text - 小文字に変換されるテキスト。 | Lower('This Will Be Converted To Lowercase') は 'this will be converted to lowercase' を返します |
| Field - 特定の位置のテキストを返します。 | Field('Text', 'Delimiter', Field Number) | Text - 検索対象のテキスト。 Delimiter - フィールドの区切り文字。 Field Number - 返されるフィールドの位置 (開始値は 1)。 |
Field('John;Smith;9055552211', ';', 2) は 'Smith' を返します。 |
| Sum - 複数の数値の合計を返します。 | Sum(firstNumber, secondNumber, thirdNumber, ...) | Number - 加算される数値。 任意の数の数値をコンマ (,) で区切って指定できます。 | Sum(2,3,4,5) は '14' を返します |
| Diff - 2 つの数値の差を返します。 | Diff(Number1, Number2, <Precision>) | Number1 - 減算される数値。 Number2 - Number1 から減算する数値。 Precision <省略可能> - 結果を丸める小数点以下の桁数。 |
Diff(9, 7) は '2' を返します Diff(9.3, 2.1, 2) は '7.20' を返します |
| Mult - 複数の数値の積を返します。 | Mult(firstNumber, secondNumber, thirdNumber, ...) | Number - 乗算される数値。 任意の数の数値をコンマ (,) で区切って指定できます。 | Mult(2, 3, 4) は '24' を返します |
| Div - 2 つの数値の商を返します。 | Div(Number1, Number2, <Precision>) | Number1 - 除算される数値 Number2 - Number1 を除算する数値 Precision <省略可能> - 結果を丸める小数点以下の桁数。 |
Div(8, 4) は '2' を返します Div(9, 2, 2) は '4.50' を返します |
| Instr - テキスト内に特定のテキストが最初に出現する位置を返します。 | Instr ('SearchText', 'TextToFind') | SearchText - 検索対象のテキスト。 TextToFind - 検索するテキスト。 |
Instr('This is a string that is searched', 'string') は 11 を返します |
| Right - 全文の右側から、テキストの一部を返します。 | Right('Text', Length) | Text - 全文。 Length - 返される右側からの文字数。 |
Right('Take from the right', 9) は 'the right' を返します |
| Left - 全文の左側から、テキストの一部を返します。 | Left('Text', Length) | Text - 全文。 Length - 返される左側からの文字数。 |
Left('Take from the left', 4) は 'Take' を返します |
| Mid - 全文の中から、テキストの一部を返します。 | Mid('Text', Start, Length) | Text - 全文。 Start - 返される文字のテキスト内の開始位置。 Length - 開始位置から返される文字数。 |
Mid('Take from the middle', 5, 4) は 'from' を返します |
| LTrim - テキストから先頭のスペースを削除します。 | LTrim('Text') | Text - 先頭のスペースを削除する対象のテキスト。 | LTrim(' Remove the leading spaces only. ') は 'Remove the leading spaces only. ' を返します。 |
| RTrim - テキストから末尾のスペースを削除します。 | RTrim('Text') | Text - 末尾のスペースを削除する対象のテキスト。 | RTrim(' Remove the trailing spaces only. ') は ' Remove the trailing spaces only.' を返します。 |
| Trim - テキストから先頭と末尾のスペースを削除します。 | Trim('Text') | Text - 削除対象のテキスト。 | Trim(' Remove leading and trailing spaces. ') は 'Remove leading and trailing spaces.' を返します。 |
| Len - テキストの長さを返します。 | Len('Text') | Text - 測定対象のテキスト。 | Len('Measure this text') は 17 を返します |