【UiPath】GenericValue型と暗黙の型変換

GenericValue型の変数をご存じだろうか。
UiPath固有の変数で、公式ドキュメントでは以下のように説明されている。

GenericValue 変数は、テキスト、数値、日付、または配列といった種類のデータを格納することができる変数型であり、Studio 特有のものです。

GenericValue 変数は、特定のアクションを実行できるように自動的に他の型に変換されます。ただし、これらの変数の型はプロジェクトに対して常に正しく変換されるとは限らないため、使用には十分な注意が必要です。

UiPath Studio には GenericValue 変数の自動変換メカニズムがあり、式を正しく定義することで、目的の結果を得ることができます。式の最初の要素は、Studio から操作するガイドラインとして使用されることを考慮してください。たとえば、2 つの GenericValue 変数を追加し、式の最初の変数が String として定義されてた場合、最初に代入された値を元に 2 つの値を結合し、文字列となります。 Integer として定義した場合の結果は、合計の値となります。

当記事では、このGenericValue型とそれ以外の型を加算演算子で繋いだ場合の動作について確認していく。

前準備

検証用に以下のワークフローを作成する。
動作としてはシンプルで、A・B・Cの3つの変数を作り、AとBを足した（+で繋いだ）結果をCに代入し、型と値をログに出力するというもの。また、確認のためA・Bの型と値も同様にログに出力している。

以降、このワークフローを元に変数A・B・Cの型と規定値を変更しながら実行ログを確認する。以下の例はABC全てInt32型とし、A = 1、B = 2とした際のログである。

文字列とGenericValue型

【ケース 1】 String + GenericValue

	変数A	変数B	変数C
型	String	GenericValue	GenericValue
値	"123"	456	?

たとえば、2 つの GenericValue 変数を追加し、式の最初の変数が String として定義されてた場合、最初に代入された値を元に 2 つの値を結合し、文字列となります。

公式ドキュメント記載のケース。
結果は123と456が連結され123456。
なお、変数Aの規定値123はダブルクォーテーションで囲わず数値として設定している。
VB.netの加算演算子では、両方の式の型がStringである場合は文字列を連結するという仕様になっており、変数BがStringに変換され連結されたと考えられる。

【ケース 2】GenericValue (整数) + String

	変数A	変数B	変数C
型	GenericValue	String	GenericValue
値	123	"456"	?

ケース1とは逆に変数AをGenericValue型に、変数BをString型にしている。変数Aは数値123を既定値にしているのは先ほどと同じ。
結果は123と456が加算され579。
先頭のGenericValue型に格納されている値が数値のためか、数値同士として演算されている。

片方の変数が数値型であり、もう片方は文字列型である場合の加算演算子の仕様は以下の通り。

Option Strict が On である場合は、コンパイラ エラーが発生します。
Option Strict が Off である場合は、String を Double に暗黙的に変換して、加算します。

【ケース 3】 String + GenericValue（文字列）

	変数A	変数B	変数C
型	GenericValue	String	GenericValue
値	"123"	"456"	?

ケース2と同様の型と値だが、変数Aの規定値をダブルクォーテーションで囲み、"123"としている。
結果はケース1と同様に123456。

【ケース 4】 String + GenericValue → Int32

	変数A	変数B	変数C
型	String	GenericValue	Int32
値	"123"	456	?

変数ABはケース1と同じで、変数Cの型を数字型（Int32）に変更。
結果はケース1と同様に123456で、特に問題なく代入できている。

ちなみに、変数ABを両方String型、変数CをInt32型に変えると検証エラーになる。

小数点とGenericValue型

【ケース 5】 Int32 + Double → Double

	変数A	変数B	変数C
型	Int32	Double	Double
値	10	5.5	?

まずはGenericValue型無しでの確認。
Int32型とDouble型を加算してDouble型に代入している。
結果は10と5.5が加算され15.5。

また、この逆の場合（Double型をInt32型を代入）は検証エラーになる。

【ケース 6】 Int32 + GenericValue → Int32

	変数A	変数B	変数C
型	Int32	GenericValue	Int32
値	10	5.5	?

ケース5から変数Bの型をGenericValue、変数Cの型をInt32に変更。
前述の通りDouble型をInt32型を代入しようとするとエラーとなるが、GenericValue型であれば少数を含む数値であってもエラーにならない。
結果は10と5.5を加算し小数点を繰り上げたのか16となっている。

まとめ

ケース2やケース6あたりは直感に反した動きになるのではないだろうか。
GenericValue型は一見便利ではあるが、公式ドキュメントにも記載されているように、使用する際には十分に注意したい。

余談だが、過去のバージョンでは変数の型の初期選択肢にGenericValue型が含まれていたが、現在は除外されている。

参考

動作環境

UiPath.System.Activities 24.10.3