移行を目的とした変数のマッピング

移行では、以前のプロダクト バージョンから Automation 360 に直接マッピングされる変数もありますが、変数は動作が異なる変数や設定が変更されている変数もあります。

注: Enterprise 11 で、Bot が、スペースと、ドル記号文字 ($) で始まり、括弧、角括弧、または中括弧で囲まれた文字列が続く変数を使用していた場合は、移行後に、変数フィールドでエラーが発生します。Automation 360では、ドル記号を表示するために、文字列に 2 つのドル記号 ($) が必要となるため、このエラーが発生します。このエラーを修正するには、文字列にもう 1 つドル記号を追加します。たとえば、文字列に続けて $5 [$Prompt-Assignment$ ($5)] を表示するために [prompt-assignment] 変数を使用している場合は、移行後に、変数フィールドにエラーが表示されます。エラーを修正するには、以下のように変数フィールドを編集してドル記号をもう 1 つ追加します。[$Prompt-Assignment$ ($5)]。

ユーザー定義変数

Automation 360 では、親 Bot と子 Bot の間で値をやり取りするために、Bot で定義されているすべての変数が、移行時に「入力として使用」および「出力として使用」の型として作成されます。

Enterprise 11 で変数が親 Bot と子 Bot の間でマップされ、マップされた変数の一部が親 Bot または子 Bot のどちらでも使用できない場合、そのような変数は移行プロセスにより削除されます。移行プロセスでは、親 Bot と一緒に移行される子 Bot、およびすでに移行されている子 Bot について、このような変数が削除されます。

サポートされている変数の一覧については、「Automation 360 の機能比較表」を参照してください。

次のユーザー定義変数がどのように移行されるかを確認してください。

配列

このセクションでは、[配列] 変数がどのように Automation 360 に移行されるかについて説明します。場合によっては、移行の前後に何らかのアクションを実行したり、いくつかのことを確認したりする必要があります。

サブタイプ「値」
このサブタイプを持つ変数は、すべての列値が [文字列] として [テーブル] に移行されます。
サブタイプ「テキスト ファイルから読み取る」
このサブタイプを持つ変数は、すべての列値が [文字列] として [テーブル] に移行されます。

次のアクションは、変数内のデータを構成するために、移行の一部として追加されます。

Automation 360 のアクション 関数
[CSV/TXT] > [開く] 読み取り用にファイルを開きます。
[CSV/TXT] > [読み取り] テーブル変数の値を返します。
[CSV/TXT] > [閉じる] ファイルを閉じます。
サブタイプ「データベースから読み取る」
このサブタイプを持つ変数は、すべての列値が [文字列] として [テーブル] パッケージに移行されます。

次のアクションは、変数内のデータを構成するために、移行の一部として追加されます。

Automation 360 のアクション 関数
[データベース] > [接続] [接続] アクションが、それぞれの接続文字列とともに追加されます。
[データベース] > [データテーブルにエクスポート] 結果をデータテーブル変数に戻すために、[データテーブルにエクスポート] アクションが追加されます。
[データベース] > [接続解除] データベースを切断するために、[接続解除] アクションが追加されます。

次のページも参照してください: データベース パッケージ

サブタイプ「Excel/CSV ファイルから読み取る」
このサブタイプを持つ変数は、すべての列値が [文字列] として [テーブル] に移行されます。

次のアクションは、変数内のデータを構成するために、移行の一部として追加されます。

Automation 360 のアクション 関数
[Advance Excel] > [開く] 読み取り用にファイルを開きます。
[Advance Excel] > [複数のセルを取得] 変数宣言で [すべてのセル] または [範囲] オプションが選択されている場合に、[テーブル] 変数値を返します。
[Advance Excel] > [行を読み取る] 変数宣言で [行全体] オプションが選択されている場合に、[テーブル] 変数値を返します。
[Advance Excel] > [列を読み取る] 変数宣言で [列全体] オプションが選択されている場合に、[テーブル] 変数を返します。

また、[リストのデータテーブルにリストを割り当て] パッケージは、変数に返された値の格納に使用されます。

[Advance Excel] > [閉じる] ファイルを閉じます。
重要: Automation 360 では、空のテーブル変数はランタイム エラーを返します。移行した Bot に空のテーブル変数が含まれている場合は、Automation 360 で問題を解決する必要があります。
配列変数: DLL 関数で受け入れられる入力タイプ
システムが Enterprise 11 Bot から別のタイプの DLL 関数に配列変数を渡す場合、DLL ファンクションは入力タイプとして次の値を受け入れます。
  • UInt16[]、Int16[]、Int32[]、Int64[]、Int[]、Char[]、Single[]、Decimal[]、Float[]、Double[]、Boolean[]、bool[]、Byte[]、String[]、Datetime[]
  • UInt16、Int16、Int32、Int64、Int、Char、Single、Decimal、Float、Double、Boolean、bool、Byte、String、Datetime
  • List<UInt16>、List<Int16>、List<Int32>、List<Int64>、List<Int>、List<Char>、List<Single>、List<Decimal>、List<Float>、List<Double>List<Boolean>、List<bool>、List<Byte>、List<String>、List<Date-Time>
  • UInt16[,]、[,], Int16[,], Int32[,], Int64[,], Char[,], Single[,], Decimal[,], Float[,], Double[,], Boolean[,], bool[,], Byte[,], String[,], and Datetime[,]
詳細についてはこちら
配列変数を含む Enterprise 10 または Enterprise 11 Bot を移行できます。

以下のような主な動作の違いがあります。

  • インデックスの位置は、Enterprise 10Enterprise 11 では 1 で始まりますが、Automation 360 では 0 で始まります。たとえば、$arrayVariable(1,1)$$arrayVariable[0][0]$ になります。
  • 配列に 10 行 / 列があり、ループが 10 回以上実行されている場合、Enterprise 10/Enterprise 11 はインデックス位置を持つ配列変数の名前を返します。
  • Enterprise 11 では、コマンドで定数の文字列値を配列インデックスに渡した場合 (たとえば、$array(field1)) で、field1 が変数ではない場合)、値はそのまま (たとえば、$array(field1) のまま) 使用されます。ただし、BotAutomation 360 に移行された後、コマンドに変数でない値がある場合、コンパイル時エラーが発生します。
  • Enterprise 11 では、インデックスなしで配列変数を渡した場合 (例: "$array
    quot;
    "$array()
    quot;
    のように、インデックスがない場合)、その値がそのまま使われます (例: "$array
    quot;, "$array()
    quot;
    )。ただし、Bot を Automation 360 に移行した後、コンパイル タイム エラーが発生します。
重要: 無効なインデックスを使用して Enterprise 11 の任意の配列にアクセスしている場合は、移行前または移行後に Bot エラーを解決してください。
ディクショナリ

このセクションでは、[ディクショナリ] 変数がどのように Automation 360 に移行されるかについて説明します。場合によっては、移行の前後に何らかのアクションを実行したり、いくつかのことを確認したりする必要があります。

ロジックを実行
Enterprise 11 で [ロジックを実行] 操作を実行すると、特定のキーを ディクショナリ 変数から選択し、必要な値変数にマッピングすることができます。

Automation 360 では、直接マッピングできるのは変数のみで、ディクショナリ (キー) 変数を文字列にマッピングすることはできません。

サブタイプ「値」
これらの変数は、Automation 360 では [文字列] のサブタイプを持つ [ディクショナリ] タイプに移行されます。
サブタイプ「CSV ファイルから読み取る」
移行処理では、CSV/Text パッケージを使用して CSV ファイルを読み取るアクションが追加され、データがテーブル変数に格納されます。また、[テーブル] 変数に対してループを実行するアクションが追加され、[ディクショナリ] パッケージの [書き込み] アクションを使用して、[ディクショナリ] 変数にキーと値が追加されます。
ディクショナリ変数: DLL 関数で受け入れられる入力タイプ
システムが Enterprise 11 Bot から別のタイプの DLL 関数にディクショナリ変数を渡す場合、DLL ファンクションは入力タイプとして次の値を受け入れます。UInt16、Int16、Int32、Int64、Int、Char、Single、Decimal、Float、Double、Boolean、bool、Byte、String、および Datetime。
詳細についてはこちら
ディクショナリ変数を含む Enterprise 10 または Enterprise 11 Bot を移行できます。

次の表に、主な動作の違いと、それらが Automation 360 でどのように機能するかを示します。

Enterprise 10 または Enterprise 11 の動作 Automation 360 の動作
Enterprise 10 または Enterprise 11 では、ディクショナリ キーの大文字と小文字が区別されません。 Automation 360 では、ディクショナリ キーの大文字と小文字が区別されます。

Bot 実行の回復力を維持するため、移行処理ではすべてのディクショナリ キーが小文字の値に変換されます。変数がディクショナリ キーとして使用されている場合、小文字のキー名を取得するために、文字列表現 [小文字] が使用されます。

リスト

このセクションでは、[リスト] がどのように Automation 360 に移行されるかについて説明します。場合によっては、移行の前後に何らかのアクションを実行したり、いくつかのことを確認したりする必要があります。

サブタイプ「値」
これらの変数は、サブタイプが [文字列] の [リスト] に移行されます。
サブタイプ「配列」
これらの変数は、サブタイプが [文字列] の [リスト] に移行されます。
サブタイプ「テキスト ファイルから読み取る」
ファイルを読み取ることによって宣言された変数が呼び出されると、[レガシー オートメーション] パッケージの [テキスト ファイルからのインポート リスト] アクションが、移行されるアクションの上に追加されます。
「ランダムにする」宣言
[リスト] 変数は、リストからランダムな項目を返すために、Enterprise 10 または Enterprise 11 で「ランダムにする」と宣言できます。移行処理では、リスト サイズを取得するために [リスト] パッケージに新しい [サイズ] アクションを追加し、[乱数の割り当て] アクションを [数値] パッケージに追加して、ランダムな位置を見つけ、それをランダムなリスト項目の取得に使用します。
重要: Automation 360 では、ループ外で使用される空のリスト変数はランタイム エラーを返します。移行した Bot がこの条件を満たしている場合は、Automation 360 環境で問題を解決する必要があります。
詳細についてはこちら
  • Enterprise 10Enterprise 11 では、インデックスを指定せずに [リスト] にアクセスできます。Automation 360 では、リストから特定の値を取得するように、それぞれのインデックスを指定する必要があります。

    例: 次の方法で、インデックスから [リスト] 変数にアクセスできます。

    $listVariable[0]$

    0 はリスト内の最初の値を表します。

  • インデックスの位置は、Enterprise 10 または Enterprise 11 では 1 で始まりますが、Automation 360 では 0 で始まります。
  • Enterprise 11 の動作: Enterprise 11 では、固定インデックスがあるリストが使用されると、システムはそのリストの最初のインデックス位置の有効な値を返します。

    例: たとえば、値 1、2、3、4 を持つリストがあるとします。$IntList(3)$ を使用してリストの 3 番目のインデックス位置の値を取得する必要があるとします。システムは、指定されたインデックス位置の (3) ではなく、リスト (1) の最初のインデックス位置の有効な値を返します。

    Automation 360 の動作: Automation 360 では、システムは指定されたインデックス位置の有効な値を返します (上記の例の場合、3 を返します)。

    移行した Bot の動作: リスト内の固定インデックスを使ったこのような式を使用する Enterprise 11 BotAutomation 360 に移行すると、指定されたインデックス位置の有効な値が返されます。

  • リストに 10 個の項目があり、ループが 10 回以上実行される場合、Enterprise 10 または Enterprise 11 は、10 回目の反復後にリストの最初の値を返します。
リスト変数: DLL 関数で受け入れられる入力タイプ
システムが Enterprise 11 Bot から別のタイプの DLL 関数にリスト変数を渡す場合、DLL 関数は入力タイプとして次の値を受け付けます。
  • UInt16[]、Int16[]、Int32[]、Int64[]、Int[]、Char[]、Single[]、Decimal[]、Float[]、Double[]、Boolean[]、bool[]、Byte[]、String[]、Datetime[]
  • UInt16、Int16、Int32、Int64、Int、Char、Single、Decimal、Float、Double、Boolean、bool、Byte、String、Datetime
  • List<UInt16>、List<Int16>、List<Int32>、List<Int64>、List<Int>、List<Char>、List<Single>、List<Decimal>、List<Float>、List<Double>List<Boolean>、List<bool>、List<Byte>、List<String>、List<Date-Time>
  • UInt16[,]、[,], Int16[,], Int32[,], Int64[,], Char[,], Single[,], Decimal[,], Float[,], Double[,], Boolean[,], bool[,], Byte[,], String[,], and Datetime[,]

    次のページも参照してください: リスト パッケージ

ランダム

このセクションでは、[ランダム] 変数がどのように Automation 360 に移行されるかについて説明します。場合によっては、移行の前後に何らかのアクションを実行したり、いくつかのことを確認したりする必要があります。

サブタイプ「ランダム文字列」
サブタイプが [文字列] のランダム変数がある場合、移行処理では、[If] 条件の上にランダム文字列を生成するために [文字列] パッケージの [ランダム文字列の生成] アクションが追加され、Automation 360 のそれぞれの移行された変数に値が代入されます。
サブタイプ「乱数」
サブタイプが [数値] のランダム変数がある場合、移行処理では、[If] 条件の上にランダム文字列を生成するために [数値] パッケージの [乱数の割り当て] アクションが追加され、Automation 360 のそれぞれの移行された変数に値が代入されます。

このセクションでは、[] がどのように Automation 360 に移行されるかについて説明します。場合によっては、移行の前後に何らかのアクションを実行したり、いくつかのことを確認したりする必要があります。

サブタイプ「値」
これらの変数は、数値、Boolean 値、または日時値がある場合でも、Automation 360 では常に文字列として移行されます。式は、必要に応じて Automation 360 で文字列を他のタイプに変換するために使用されます。
サブタイプ「テキスト ファイルから読み取る」
移行時の Bot の実行の完全性を維持するため、ファイルを読み取ることによって宣言された変数が呼び出されると、[文字列] パッケージの [テキスト ファイルから文字列をインポート] アクションが、移行されるアクションのすぐ上に追加されます。
Enterprise 11 Bot がテキスト ファイルから値を読み取る変数を含んでいる場合、これらの Bot は [変数を読み取り] アクションを使用して移行されます。

特定の変数がテキスト ファイルに存在しない場合、または特定の変数が存在しないファイルから値を読み取っている場合、Automation 360 は例外エラーを生成します。

移行後、[ファイルから読み取り] 変数を含む Bot を実行すると、Bot 実行プロセスの開始時に [変数を読み取り] アクションで 1 回だけ読み取りが行われます。Bot の実行中に変数で読み取ろうとしているファイルが更新された場合、[ファイルを読み取り] 変数は更新されません。

詳細についてはこちら
変数内で値型変数を使用する Bot は、Automation 360 に移行できます。キーストロークの挿入 コマンドで変数を使用する Enterprise 11 Bot の場合、文字列 パッケージの [評価値] アクションが移行した Bot に追加されます

次のページも参照してください: 文字列 パッケージ | 数字 パッケージ | [Boolean] パッケージ | [日時] パッケージ

システム変数

Automation 360 では、場合によっては、エラーの行番号、エラーの説明、OS 名などのシステム変数が異なる値を返します。これらの変数を意思決定または文字列操作で使用する Bot は、移行後に確認する必要があります。

また、ループ内で使用されているシステム変数の一部は、移行後にループ内のユーザー定義変数になります。場合によっては、移行した Bot でユーザー定義変数が何らかの構成を必要とする可能性があります。

一部のシステム変数は、Automation 360 ではアクションとして移行されます。このようなアクションは、これらの変数を使用するアクションのすぐ上に追加されます。

以下のシステム変数のインデックス位置で変数が定義されている場合、移行処理では変数の内容 (インデックスまたは列名) を判断できないので、移行した Bot を解決する必要がある場合があります。これを解決しない場合、Bot は「キーがレコードに見つかりません」というランタイム エラーを返す可能性があります。移行処理では変数の値を名前として扱います。変数の値がインデックスである場合は、適切な変更を行う必要があります。
  • $Filedata Column$
  • $Dataset Column$
  • $XML Data Node$
  • $Excel Column$
下記の表は、さまざまなシステム変数と、それらの Automation 360 への移行方法に関する情報を示しています。アクションの一部となったり、アクションとなったりする変数もありますが、システム変数となるものもあります。ただし、構文が変更されています。
注: 移行済み Bot は、以下のシステム変数に対してデータをループ外に保存しません。
  • $FolderName$
  • $FileName$
  • $Extenstion$
システム変数 Automation 360 への移行方法
$Day$ Automation 360 では $System:Day.Number:toString$ となります
$FileName 移行後、Automation 360 命名規則に従って、この変数が自動的に作成されるため、移行された Bot は正常に実行されます。
$Error Description 移行後、Automation 360 命名規則に従って、この変数が自動的に作成されるため、移行された Bot は正常に実行されます。
$Error Line Number$ 移行後、Automation 360 命名規則に従って、この変数が自動的に作成されるため、移行された Bot は正常に実行されます。
$Extension$ 移行後、Automation 360 命名規則に従って、この変数が自動的に作成されるため、移行された Bot は正常に実行されます。
$Folder Name$ 移行後、Automation 360 命名規則に従って、この変数が自動的に作成されるため、移行された Bot は正常に実行されます。
$Month$ Automation 360 では $System:Month.Number:toString$ となります
$Year$ Automation 360 では $System:Year.Number:toString$ となります
$Date$ Automation 360 では $System:Date$ となります

Enterprise 11 または Enterprise 10Bot の変数に設定された日付形式は、AADefaultDateFormat グローバル値に保存されます。

$Hour$ Automation 360 では $System:Hour.Number:toString$ となります
$Minute$ Automation 360 では $System:Minute.Number:toString$ となります
$Clipboard$ Automation 360 では $System:Clipboard$ となります
$Machine$ Automation 360 では $System:Machine$ となります
$MiliSecond$ Automation 360 では $System:MiliSecond.Number:toString$ となります
$ArrayColumns($arrayVariable$)$ Automation 360 では、$arrayVariable.DataTable:columnCount$ となります
$ArrayRows($arrayVariable$)$ Automation 360 では、$arrayVariable.DataTable:rowCount$ となります
$AAControlRoom$ Automation 360 では $System:AAControlRoom$ となります
$RAMUsage$ Automation 360 では $System:RAMUsage$ となります
$TotalRAM$ Automation 360 では $System:TotalRAM$ となります
$OSName$ Enterprise 10 または Enterprise 11 は [Microsoft Windows 10 Pro 64-bit] 値を返します。Automation 360 では、この変数は $System:OSName$ になり、[Windows 10 64-bit] を返します。
$CPUUsage$ Automation 360 では $System:CPUUSage$ となります
$Counter$ このシステム変数は Automation 360 で廃止されています。移行処理によってユーザー定義変数型の数字が作成され、11.x Bot と同じ出力になるように Bot が変更されます。

ループで $Counter$ 変数が使用されている場合は、移行処理によって、移行された Bot では変数は $Condition-Counter$ 変数に置き換え、値 1 に設定されます。

$Dataset Column$ このシステム変数は、[ループ] の [SQL クエリ データセットの各行] 反復子の一部になりました。ループ内に新しい変数が作成され、ループ内の $Dataset Column$ が存在する場所で使用されます。

変数がループ外で使用された場合、変数は記録タイプのユーザー定義変数に変換され、[記録] アクションに割り当てられます。これにより、変更元の記録変数の値を変更先の記録変数に割り当てることができます。したがって、この変数を含む移行した Bot を実行すると、最後の行のデータが表示されます。

$Excel Column$ このシステム変数は、[ループ] の [ワークシート内の各行] 反復子の一部になりました。ループ内に新しい変数が作成され、ループ内の $Excel Column$ が存在する場所で使用されます。

変数がループ外で使用された場合、変数は記録タイプのユーザー定義変数に変換され、[記録] アクションに割り当てられます。これにより、変更元の記録変数の値を変更先の記録変数に割り当てることができます。したがって、この変数を含む移行した Bot を実行すると、最後の行のデータが表示されます。

$Extension$ and $FileName$ これらのシステム変数は、これまで [ループ] の [フォルダーの各ファイルに対して] 反復子で使用されていました。Automation 360 では、ディクショナリ型変数を使用して、拡張子とファイル名をキャプチャします。この拡張子とファイル名は、それぞれ「extension」キー名と「name」キー名で取得できます。

ループ パッケージ

$Email$

$Email From$

$Email Message$

$Email Received Date$

$Email Received Time$

$Email Subject$

$Email To$

$Email Sent date$

$Email Sent time$

これらのシステム変数は、これまで [ループ] の [メールボックス内の各 E メールに対して] 反復子で使用されていました。Automation 360 では、ディクショナリ型変数を使用して、それぞれのキーで取得できるすべての E メール値をキャプチャします。

E メール プロパティでのディクショナリ変数の使用」を参照してください。

$Filedata Column$ このシステム変数は、[ループ] の [CSV/TXT の各行] 反復子の一部になりました。ループ内に新しい変数が作成され、ループ内の $Filedata Column$ が存在する場所で使用されます。

変数がループ外で使用された場合、変数は記録タイプのユーザー定義変数に変換され、[記録] アクションに割り当てられます。これにより、変更元の記録変数の値を変更先の記録変数に割り当てることができます。したがって、この変数を含む移行した Bot を実行すると、最後の行のデータが表示されます。

$FolderName$ このシステム変数は、これまで [ループ] の [フォルダー内の各フォルダーに対して] 反復子で使用されていました。Automation 360 では、この値はループで指定された文字列変数に返されます。
$Excel Cell Row$ Automation 360 では、このシステム変数は [Excel] パッケージの [行番号を取得] アクションに移行され、これが使用されるアクションのすぐ上に追加されます。

Enterprise 11 では、最後に実行された Excel セッションは [Excel セル行] 変数で [セッション名] の値として使用されます。ただし、Automation 360 では、[Excel セル行] 変数は存在しません。このため、[Excel セル行] の前に使用され最後に実行された Excel セッションは、移行時に [行番号を取得] の値として使用されます。

回避策: 文字列変数を作成し、その変数に名前を割り当てて、移行した Bot の [Excel] コマンドの後に追加します。[行番号を取得] に新しく作成した文字列変数を使用します。

$Excel Cell Collumn$ Automation 360 では、このシステム変数は [Excel] パッケージの [列名を取得] アクションに移行され、これが使用されるアクションのすぐ上に追加されます。
Enterprise 10/Enterprise 11 は、アクティブなセルがループ内の A 列にない (F10 列にある) 場合でも、$Excel Cell Column$ の最初の列 (A 列など) を返します。Automation 360 では、同じ構成がアクティブなセルを返します (たとえば、F10 列)。上記の動作変更につながるユース ケースを以下に示します。
  • Excel は 10 行を含むファイルを開きます ([ヘッダーを含む] の選択状態は関係ありません)。
  • F10 がアクティブ セルとして設定されます。
  • ループは行の読み取りに使用されます。
  • [メッセージ ボックス] と $Excel Cell Column$ を入れます
  • Bot を実行します。
重要: 動作の違いを考慮し、いくつかの Bot を変更する必要がある場合があります。
$Excel Cell$ Automation 360 では、このシステム変数は [Excel] パッケージの [セル アドレスを取得] アクションに移行され、これが使用されるアクションのすぐ上に追加されます。
$AATaskExecutor$ Automation 360 では、このシステム変数は、[$AATaskExecutor$] および [$AATaskInvoker$] になります。
Enterprise 11 では、タスクの要求者と実行者に関するさまざまな値 (要求者と実行者の名、姓、E メール アドレス、ユーザー名など) が、この変数から返されます。Automation 360では、[$AATaskInvoker$] 変数は次の値を返します。
  • invvoker_Username
  • Invoker_Firstname
  • Invoker_Lastname
  • Invvoker_Email
[$AATaskExecutor$] 変数は、次の値を返します。
  • Executor_Username
  • Executor_Firstname
  • Executor_Lastname
  • Executor_Email
  • Executor_Type
$AATaskName$ このシステム変数は、Automation 360 では [$System.AATaskName$] になります。

Enterprise 10/Enterprise 11 では、この変数はコンピューター パス ディレクトリの値 (Automation Anywhere\My Tasks\My Folder\My Folder2\AATaskName.atmx など) を返します。Automation 360 では、この変数は Control Room に対する Bot の相対的なパスの値 (Bots/AATaskName など) を返します。

Action required: 返された値がバージョンごとに異なることを考慮し、いくつかの Bot を変更する必要がある場合があります。
$AAApplicationPath$ Enterprise 11 固有: この Enterprise 11 システム変数は、ユーザーが (「クライアント アプリケーション」の) [ツール] > [オプション] 設定で指定したパスを返します。Automation 360 では、変数はグローバル値になります。移行処理によってこの変更が自動的にマップされ、Enterprise 11 の各ユーザーの値セットがグローバル値変数 @AAApplicationPath にコピーされます。
注: Automation 360 をインストールする際に、復元された Enterprise 11 データベースを使用した場合、このシステム変数は移行中にグローバル値として自動的にマップされるので、Enterprise 11 ではユーザーによるアクションは必要ありません。

Enterprise 10 固有: この Enterprise 10 のシステム変数は、自動的にグローバル値として Automation 360 に移行しないため、移行後に何らかのアクションが必要になります。

重要:
  • Enterprise 10 ユーザーは、移行後に Automation 360AAApplicationPath グローバル値を作成し、Enterprise 10 パスで更新する必要があります。この更新を行うことで、Automation 360Bot を実行する際に、AAApplicationPath フォルダーの値が各ユーザーに対して一意に解決されます。

    例: AAApplicationPathEnterprise 10 のパス値が D:\John.Doe\My Documents\Automation Anywhere Files の場合、Automation 360AAApplicationPath グローバル値を作成し、このパスで更新する必要があります。

  • AAApplicationPath グローバル値を作成するときに、[変更可能] オプションが選択されていることを確認します。移行した BotBot Creator および Bot Runner で実行する前に、AAAplicationPath グローバル値の値を設定する必要があります。

グローバル値」を参照してください。

$AAInstallationPath$ このシステム変数は、Automation 360 では $System:AAInstallationPath$ になります。

Enterprise 10/Enterprise 11 の動作: Enterprise クライアント インストール パス (例: C:\Program Files (x86)\Automation Anywhere\Enterprise\Client) を返します。

Automation 360 の動作: Bot エージェント インストール パス (例: C:\Program Files\Automation Anywhere\Bot Agent) を返します。

Action required: 返された値がバージョンごとに異なることを考慮し、いくつかの Bot を変更する必要がある場合があります。
$Current Directory$ このシステム変数は Automation 360 では廃止され、移行時にユーザー定義変数に自動的に変換されます。変数の値は、[ループ] > [フォルダーの各ファイル] および [フォルダー内の各フォルダー] で定義されている値に従って設定されます。
$Date$ このシステム変数は、Automation 360 では [$System:Date$] になります。

Enterprise 10 および Enterprise 11 の動作: $Date$ 変数は、現在の日付と時刻を AA.Settings.XML ファイルで指定されている形式で返します。

Automation 360 の動作: $System:Date$ 変数は [日時] タイプの値を返します。ユーザーはアクションを使用して文字列に変更する必要があります。ユーザーの混乱を最小限に抑えるため、移行処理では、各 $Date$ インスタンスに対して以下の処理が行われます。

  • 文字列型の一時変数 [$SystemDateInString$] が作成されます。
  • [日時] パッケージの [ToString] アクションがカスタム フォーマット「MM/dd/yyyy HH:mm:ss」で追加され、[$System:Date$] が文字列に変換されて、出力が上記の文字列変数に格納されます。
  • [$Date$] が使用されるすべての場所に、この文字列変数が使用されます。
  • 各 [$Date$] に対して上記のステップが繰り返されます。

Bot の設定によっては、日付/時刻の設定を更新する必要があります。

Action required: 日付の形式が MM/dd/yyyy HH:mm:ss でない場合は、Bot を変更します。

$Error Line Number$

$Error Description$

Enterprise 10 または Enterprise 11 では、これらのシステム変数は [エラー処理] コマンドの後に使用されます。Automation 360 では、この値は [キャッチ] アクションで指定したユーザー定義変数に返されます。

$PDFFileName$

$PDFTitle$

$PDFAuthor$

$PDFSubject$

Enterprise 10 または Enterprise 11 では、これらのシステム変数は [PDF] コマンドの後に使用されていました。Automation 360 では、ディクショナリ型変数を使用して、それぞれのキーで取得できるすべての PDF 値をキャプチャします。すべての PDF アクションは、対応する PDF 値を持つディクショナリ変数を返します。

PDF プロパティでのディクショナリ変数の使用」を参照してください。

$System$ Enterprise 11 または Enterprise 10 では、このシステム変数は、デバイスの設定とそのパフォーマンスに関する情報の取得に使用されます。Automation 360 では、システム パッケージの [Get 環境変数] アクションが使用されます。

[環境変数を取得] アクション」を参照してください。

$WorkItem$
  • $WorkItem$ is String: そのまま移行されます。
  • $WorkItem$ is Number
    • 数値を表示またはログしている場合、数値は文字列に変更されます。
    • 数値として表示されている場合は、数値タイプとして移行します。
  • $WorkItem$ is DateTime: そのまま移行されますが、移行されたパッケージではエラーが発生するため、パッケージを移行できません。
注: 日時タイプの場合、まだパッケージを移行できないため、関連する Bot を後で移行する必要があります。
$Trigger Value$ Automation 360 では $TriggerValue$ になります。この変数を使用する Enterprise 11 Bot の場合は、移行した Bot を正常に実行するために、次のタスクを実行します。
  • Enterprise 11 Bot で使用されたすべてのトリガーについて、Automation 360 で同等のトリガーを作成します。

    Automation 360 のトリガーの出力は、レコード タイプ変数に格納されます。

  • 適切なアクションを使用して、トリガーからの出力を含むレコード変数の値が $TriggerValue$ 変数に割り当てられるように、移行した Bot を更新します。

    たとえば、E メール トリガーのレコード変数から $TriggerValue$ 変数にホストとポートのキーを割り当てる場合は、$EmailTriggerData(host)$EmailTriggerData(port)$ 式を使用します。同様に、ファイルの場所を取得するには $FileTriggerData(file)$ 式を使用し、フォルダーの場所を取得するには $FolderTriggerData(fromFolder)$ 式を使用します。

$Table Column$ このシステム変数は、[ループ] の [テーブルの各行用] 反復子の一部になりました。ループ内に新しい変数が作成され、ループ内の $Table Column$ が存在する場所で使用されます。

変数がループ外で使用された場合、変数は記録タイプのユーザー定義変数に変換され、[記録] アクションに割り当てられます。これにより、変更元の記録変数の値を変更先の記録変数に割り当てることができます。したがって、この変数を含む移行した Bot を実行すると、最後の行のデータが表示されます。

$XML Data Node$ このシステム変数は、これまで [ループ] の [XML Dataset の各ノードに対して] 反復子で使用されていました。Automation 360 では、この値はループで指定された文字列変数に返されます。

変数がループ外で使用された場合、変数は文字列タイプのユーザー定義変数に変換され、[記録] アクションに割り当てられます。これにより、変更元の記録変数の値を変更先の記録変数に割り当てることができます。したがって、この変数を含む移行した Bot を実行すると、最後の行のデータが表示されます。

資格情報変数

Enterprise 10 および Enterprise 11 の [ユーザー名] および [パスワード] フィールドで使用される資格情報変数は、Automation 360 では [資格情報変数] として移行されます。

移行方法は、Enterprise 10Enterprise 11 で異なります。

Enterprise 10 の資格情報の移行方法については、Enterprise 10 のデータを Automation 360 にコピーする方法 の「資格情報」セクションを参照してください。

[ユーザー名] および [パスワード] フィールド以外のフィールドで使用される資格情報変数は、[グローバル値] として移行されます。これらのフィールドには、ホスト名、ポート番号などが含まれます。移行されたグローバル値には、<credentialname>_<attributename>。たとえば、hostname の属性を持つ FTPConnection の資格情報は、Enterprise 11 では FTPConnection_hostname として移行されます。

下表は、Enterprise 11 から Automation 360 への資格情報変数の移行をサポートする パッケージ および アクション に関する情報を示しています。

パッケージ アクション
Active Directory
  • ユーザーの作成と変更
  • グループの作成と変更
  • オブジェクトの作成と変更
  • 検索
  • プロパティを取得
データベース
  • 接続文字列で接続
  • ユーザー名
  • パスワード
E メール オートメーション
  • ホスト名
  • ユーザー名
  • パスワード
Excel スプレッドシートを開く
FTP/SFTP 接続
キーストロークの挿入 資格情報の使用を必要とするすべてのキーストローク
レガシー オートメーション [Web コントロールの管理] アクションでテキストを設定
Windows コントロールの管理
  • テキストを設定
  • テキストを追加
PDF
  • PDF を画像に変換
  • フォーム フィールドを抽出
  • テキストを抽出
  • ドキュメントの分割、暗号化、復号化
PGP
  • ファイルの暗号化と復号化
  • キーを作成
レコーダー
  • テキストを設定
  • テキストを追加
注: [キャプチャ] アクションとして オブジェクト クローニング コマンドから移行されました。
REST Web サービス
  • URI
  • ユーザー名
  • パスワード
  • ヘッダー
  • パラメーター (操作)
注: ドメイン名はグローバル値として移行されます。
SOAP Web サービス
  • ユーザー名
  • パスワード
  • ヘッダー
  • パラメーター (操作)
  • パラメーター (生データ)
ターミナル エミュレータ
  • ユーザーおよびキーファイル認証オプションを使用した SSH2 の接続コマンド
  • テキスト送信
  • フィールドを設定
Web レコーダー [テキストの設定] および [テキストの追加] 機能で Web コントロールを管理