ここでは、Sequenceを2つに分割しています。まず、テキストファイルがどうなるかを考えてみましょう。
テキストファイルで実行される最初のアクティビティは、その内容を読み取ることです。ここでも、ユーザーはAssignActivityを「Then」フィールドにドラッグし、Variableを使用します。この例では、Variableの名前は「content」、タイプは「string」です。
ファイルを読み込むための式はSystem.IO.File.ReadAllText(file_name) を使用します。内容は、割り当てられたVariableに格納されます。
備考
この例では、.txtでないものを削除します。このチュートリアルでさらに説明します。
次に、ファイルの作成日を取得します。この手順は、前の手順（Read File）とよく似ています。つまり、ユーザーはAssignActivityを使って、VB式の内容を保存することになります。
この場合、式はSystem.IO.File.GetCreationTime(file_name).ToShortTimeString となります。
備考
ここでは、他の可能性もある。ユーザーは、時間、日、月、あるいは、ファイルの作成に関するその他の情報を取得することができます。これを行うには、ユーザーは式の最後の部分を必要な情報の種類に変更する必要があります（例えば、System.IO.File.GetCreationTime(file_name).Month）。
この例では、ファイルを移動する前に、テキストファイルから情報を抽出してログファイルに追加するためのアクションがいくつか追加されています。Matchesアクティビティが採用され、ユーザーはその3つのプロパティに注目する必要があります。「入力」、「パターン」、「結果」です。
最初の “Input “は、”Pattern “の検索対象となる文字列または文字列を格納するVariableである。この場合、値はファイルの内容に対応する “content “変数である必要がある。
“パターン “は、”入力 “内の文字列から検索されるRegEx式です（引用符で囲まれている必要があることに注意してください）。
最後に、”Results “は結果が格納されるVariableまたはArgumentです（この場合、Variableでなければなりません）。
この Variable の型はSystem.Text.RegularExpressions.Match でなければならないことにユーザーは注意しなければならない。これは、結果のリストになります。この例では、マッチごとに1つの結果のみが存在することになります。この結果を得るために、ユーザーは次の構文を使用する必要があります： variablename.First.ToString, つまり、リストの最初のアイテムは文字列に変換されます。
これらの手順が完了すると、ロボットはファイルを内容に応じて分類する。この例では、製品情報があるかどうかが基準になっています。
ユーザーは、このSequenceに別のIfActivityをドラッグします（前のIf文のBody）。ここでは、ファイルの内容を格納する変数「content」が使用されます。メソッドは.Contains("string")で、構文は次のとおりです。content.Contains("product").
備考
なお、検索される語句は文字列であるため、引用符で囲まなければならない。
もし、そのような用語があれば、ロボットは「Then」フィールドに進み、そうでなければ、「Else」フィールドに進みます。つまり、このActivityは、ファイルを2つのカテゴリに分類しているのです。これは簡単な例ですが、より複雑な用語を検索することもできます。
最初の可能性（ファイルに製品情報がある）を考慮すると、ロボットはそのファイルを「製品情報」ディレクトリに移動します。これを行うには、別のアクティビティをシーケンスにドラッグして、Invoke Codeを作成する必要があります。このアクションは引数や変数に格納する値を生成しないので、Assignでファイルを移動することはできません。
ユーザーは、「エディターを開く」をクリックして、呼び出すコードを編集します。ユーザーは、好きなプログラミング言語を自由に選択することができます。この例では、VBを使用しています。式の構文は次のとおりです。System.IO.File.Move (移動 元の フルパス 、移動先の フル パス )。ここで重要なのは、フルパスが必須であること、つまり、ファイル名を含むことです。
そして、オリジンのフルパスは、ファイルのフルパスを格納する変数（この例では、反復処理の「項目」）を介してアクセスされる。もう一つの方法は、ルートディレクトリのパス（この例では「path」という名前）を格納するArgumentを使い、サブディレクトリとファイル名を含む別の文字列と連結させる方法です。
備考
2つ以上の文字列を連結する方法は、”&”を使うことである。
移動時にファイル名を変更する場合、ユーザーが行うべきことは、移動先のフルパスに新しい名前を割り当てることのみです。
この例では、ファイル名の先頭に新しい単語を追加することでファイル名を変更しましたが、任意の名前を設定することができます。ファイルを移動する式を書くとき、ユーザーは新しい名前が式に書かれ、ディレクトリのパスに連結されていることを確認する必要があります。
次に、ワークフローの最初に作成された DataTable に、ファイルについて収集した情報を追加します。ユーザーは、AddDataRowを各サブワークフローの最後（つまり、製品情報を持つテキストファイル、製品情報を持たないテキストファイル、またその他のファイル）にドラッグして、各ファイルを処理した記録を保持します。
新しい行を正しいDataTableに参照させるために、DataTableの名前は以前に作成されたものでなければなりません。RowData には、ユーザが追加したい変数名を、辞書の構文に従って追加します（{variable, variable, variable}）。
詳細は、Add this iteration’s invoice to DataTableに記載されています。なお、これは別の例ですので、変数名はこの例に従って変更する必要があります。
この例では、Windows Powershellを使って SOAPサービス「VIES VAT Validation<https://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl> _」に接続し、WSDLを使ってデータを収集するワークフローを作成し、入力データを取得して、収集したデータを出力バー内に展示します。
SOAPサービスがどのように定義されているかを可視化する
入出力変数の定義
SOAP Serviceに接続し、Invoke Code内でデータをマッピングする
収集したデータを展示する
ワークフロー終了 – 出力
ここでは、接続先となるSOAPサービスのWSDL定義にアクセスし、入出力変数を定義することになります。
まず、VIES VAT Validation(https://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl) ウェブサービスページにアクセスし、どのクラスでデータを収集するのかを確認することができます。
.wsdlファイルに定義されたスキーマから分かるように、定義されたtargetNamespaceはurn:ec.europa.eu:taxud:vies:services:checkVat:typesです。つまり、テンプレートの残りの部分で定義される要素は、checkVatクラスから継承された型です。これは、データを収集するために使用されるクラスです。
このクラス内のメイン関数はcheckVat関数で、この関数は2つの入力パラメータ、countryCodeと vatNumberを受け取ります。この関数が呼ばれると、checkVatResponse関数の内容、つまり、countryCode,vatNumber,requestDate,valid,name,addressが返されます。つまり、checkVat の入力パラメータ(countryCode,vatNumber) とcheckVat関数の呼び出しの出力パラメータ(requestDate,valid,name,address) を返すのです。ユーザはvalid、name、addressだけを使って、返されたデータを展示することになります。
ここでは、SOAPサービスに渡す入力変数と、SOAPサービス呼び出しの内容を格納するための出力変数を定義します。
まず、メインシーケンスにAssignアクティビティをドラッグします。To入力フィールドに変数countryCodeを、Enter a VB expressionフィールドに"DK "を入力します。
さて、メインシーケンスにAssignアクティビティをドラッグします。To入力フィールドに変数vatNumberを、Enter a VB expressionフィールドに"40400230 "を入力します。
備考
Ctrl+Kを押すと、入力フィールドに入力する際に自動的に変数が作成されますが、画面下部の変数ボックスをクリックして手動で作成することもできます。右側には、変数に代入する値を入力します。
ここで、返される他の出力変数、つまりvalid、name、address を手動で定義しなければなりません。nameとaddressはString変数で、validはBoolean変数です。これは、WSDLファイル内のcheckVatResponse関数の定義で簡単に見ることができます。valid変数の定義では、<xsd:element>の typeパラメータはxsd:booleanとみなされ、他の2つの変数については、そのtypeはxsd:stringとみなされる。
あとは、Variables, Imports & Argumentsボックスの Variables セクションで、これらの出力変数を作成するだけです。
ここでは、Invoke Codeアクティビティにデータをマッピングする方法と、Powershell言語を用いてSOAP Serviceの呼び出しを実行する方法について学習します。
まず、Invoke Codeアクティビティをメインシーケンスにドラッグします。エディタを開く]ボタンをクリックしてエディタを開き、その言語をPowerShellに設定します。
ここで、以下のコードをエディタに挿入してください。
$Client = New-WebServiceProxy -Uri "http://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl" -Class "checkVat"$DateChecked = $Client.checkVat([ref]$countryCode, [ref]$vatNumber, [ref]$valid, [ref]$name, [ref]$address)
Client行はVIES VAT Validationウェブサービスに接続し、データを収集するために使用されるクラスを定義します：checkVat.Toは、VIES VAT Validationウェブサービスに接続し、データを収集するために使用されるクラスを定義します。
DateCheckedの行は、前のセクションで見たように、定義されたcheckVatを実行し、参照変数（https://ss64.com/ps/syntax-ref.html）を使って、返される変数 –countryCode,vatNumber,valid,name,address– をマッピングしています。
このセクションでは、ユーザーはWrite Lineアクティビティを使用して、Outputバーで収集したデータを表示します。
まず、WriteLineアクティビティをメインシーケンスにドラッグして、Text入力フィールドにvalid.ToStringを入力します。
さて、WriteLineアクティビティをメインシーケンスにドラッグして、Text入力フィールドにnameを入力します。
最後に、WriteLineアクティビティをメインシーケンスにドラッグして、Text入力フィールドにAddressを入力します。
このワークフローの例の出力内容の一部を紹介します。
この例では、Chuck Norris Jokes API(https://api.chucknorris.io/) に接続し、ジョークをキャプチャするワークフローを作成することになります。
また、ユーザーはForge.FormsのダイナミックWPFフォーム（https://github.com/WPF-Forge/Forge.Forms）を使って、ジョークのカテゴリーを選択できるダイアログボックスを作成します。
また、メッセージがChuck Norrisのジョークかどうかを確認するために、簡単な検証方法が用いられています。
その手順は以下の通りです。
Node-REDでTo/Fromに渡す変数を設定する
NodeREDにおけるメッセージの操作について
OpenRPAフォーム
openrpaでワークフローを呼び出す
冗談で失敗したワークフローを作成する
チャック・ノリス・ジョークを評価する
ジョーク失敗のワークフローを呼び出す
Node-REDにおける評価失敗ケースの設定
出力ロジック
ワークフロー終了
ロボットからデータを受け取り、Chuck Norris APIに問い合わせ、その値をロボットに返すというロジックがここにある。
ワークフローロジック
Workflow Inノードをワークスペースにドラッグします。
Workflow In のプロパティで、OpenFlow ワークフローが割り当てるキューを定義するために、キュー 名を設定します。キュー名は完全に任意であり、ユーザが好きな名前を選択できます。この例では、chuckapi と設定しています。
備考
Node-RED ワークスペース内のノードのプロパティにアクセスするには、指定されたノードをダブルクリックします。ノードのプロパティボックスが表示され、それ自体に必要な各入力フィールドが表示されます。
RPAチェックボックスをオンにすると、このフローのワークフローがOpenRPAエージェントから呼び出されるようになります。
Name入力フィールドにワークフローの名前を設定します。ここでは、ChuckAPIと設定しています。
HTTP Requestノードをワークスペースにドラッグします。
Workflow In」ノードと「HTTP Request」ノードを接続します。
備考
ノードの接続は、Ctrlキーを押しながら、各ノードの外側にあるポートという灰色の長方形をクリックするだけで簡単にできます。クリックしたままでも接続できますが、筆者はCtrlキーを使う方が使いやすいと感じています。
リクエストのMethodを GETに設定します。
リクエストの送信先となるAPIのURLを設定します。この例では、https://api.chucknorris.io/jokes/random?category={{category}}です。
Mustache(https://mustache.github.io/mustache.5.html) の中の変数、すなわちcategoryも同様に任意の名前になっています。
この変数は、OpenRPAがユーザーから取得した選択肢の値を渡すために使用されます。ユーザーは自分の好きなように名前をつけることができます。
返送するタイプを設定します。この例では、パースされた JSON オブジェクトが返されます。
Workflow Outノードをワークスペースにドラッグします。
HTTP RequestノードとWorkflow Outノードを接続します。
備考
ノードの接続は、Ctrlキーを押しながら、各ノードの外側にあるポートという灰色の長方形をクリックするだけで簡単にできます。クリックしたままでも接続できますが、筆者はCtrlキーを使う方が使いやすいと思います。
画面左上の赤い「Deploy」ボタンをクリックして、フローをデプロイします。
ここで、OpenRPAからNode-REDにパラメータを送信して、ワークフローがそれほど静的でないようにしたいと思います。
このパラメータには、Chuck Norris APIのジョークが関連するカテゴリを指定します。
Node-REDのワークフローで集めた変数からパラメータを変更するには、Functionノードとそのプロパティで簡単に行うことができます。
RobotsIn/Out の引数は常にmsg.payload属性に渡され（Node-RED では）、Functionノードで簡単に操作することができます。
ワークフローのChuckAPI Workflow InノードとHTTP Requestノードの間にFunctionノードをドラッグするだけで、ワークフローに追加できます。
備考
ノードを自動的に追加してシーケンスにバインドするには、Shiftキーを押しながらノードをドラッグします。こうすると、ノードがドラッグされる前にすでに確立されていたシーケンスの間に自動的に入ります。
この例では、必要なパラメータはmsg.categoryで、これは OpenRPA ワークフローから渡されるcategory引数からmsg.payload.categoryとして収集されます。
Functionノードのプロパティでmsg.category = msg.payload.category を設定します。
これは、ユーザーが次に構築するOpenRPAワークフローから取得したHTTP Requestノードに、categoryパラメータを設定するために使用されます。
備考
この例では、ユーザーはChangeノードを使用してmsg.category属性をmsg.payload.categoryに設定することもできますし、単にmsg.payload.categoryを HTTP リクエストに直接渡すこともできます（これについては後述します）。
ここで、ユーザーは動的なWPFフォームを作成し、クライアントからカテゴリ値を収集します。
まず、Invoke Formulaスニペットをメインシーケンスにドラッグします。
ここで、「 デザイナーを開く」をクリックして、フォーム デザイナーを開きます。
備考
フォーム デザイナーは、クライアントからの入力を収集するために、ユーザーが希望するWPFフォームを作成する場所です。その右側には、入力フォームのプレビューが表示される。その左側には、入力フォームを設計するために使用するコードを入力します。フォーム デザイナーにコードを追加した後、常にビルドフォームボタンを押して変更を保存し、プレビューを可視化することができます。
サンプルコードをすべて消去し、下記のコードスニペットをデザイナーのコードエディタに追加します。そして、Build formボタンを押してフォームを更新してください。
<form-designer> <title>Choose Chuck Norris API Category</title> <heading>Please enter the desired category number inside the input field. The returned joke will be related to the selected category.</heading><select name="category" label="Choose the desired category"> <option name="animal" /> <option name="career" /> <option name="celebrity" /> <option name="dev" /> <option name="explicit" /> <option name="fashion" /> <option name="food" /> <option name="history" /> <option name="money" /> <option name="movie" /> <option name="music" /> <option name="political" /> <option name="region" /> <option name="science" /> <option name="sport" /> <option name="travel" /></select><action name="submit" content='SUBMIT' icon='check' validates='true' ClosesDialog='true' ></action></form-designer>
備考
コードスニペットを追加した後、Create variablesボタンを押すと、WPFフォームで使用するすべての変数を自動的に作成することができます。
この場合、ワークフローはVariableを使用することができない。Node-REDで消費される値なので、必ずDirectionが In/OutまたはOutで、タイプがStringの Argumentとして設定しなければならない。
さて、WPFフォームから収集した値が正しい型であることを保証するために、ユーザーはAssignアクティビティを使用して値をStringにキャストします。
さて、いよいよOpenRPAでワークフローを起動し、処理ロジックを工夫していきます。
フローはすでにデプロイされているので、ユーザーはワークフローをOpenFlowリポジトリと同期させる必要があります。
前述の作業を行うには、OpenRPAのリボン内にある「Reload」ボタンをクリックします。OpenFlowリポジトリ内にある全てのワークフローがOpenRPAにリフレッシュされます。
OpenRPAのデザイナーで、Invoke OpenFlowアクティビティをメインシーケンスにドラッグします。
呼び出したいRPAワークフローを選択します。ここでは、ChuckAPIを選択します。
備考
注意：Node-REDがフローの実行を終了すると、msg.payloadに設定されたものがロボットに戻ってきます。NodeREDにmsg.payload.personが存在すれば、そこに戻ってきたものは自動的にOpenRPAのpersonという変数に格納されます。
ChuckAPIのプロセスが設定されたので、ユーザーは通常のプロセス実行時に何らかの障害が発生した場合に実行されるワークフローの設定に進むことができます。
新しいワークフローを作成します。この例では、REST Workflow Example - Joke Failedという名前で、ワークフローを指定します。
WriteLineアクティビティをメインシーケンスにドラッグします。
ここで、Chuck Norris API のジョークの内容を含むエントリを返すデフォルトの変数を作成する必要があります (「変数、引数、およびインポート」ボックス内)。この変数のエイリアスは、Chuck Norris API Random Joke(https://api.chucknorris.io/jokes/random)に示すように、valueです。
テキスト入力フィールドまたはプロパティボックスで、出力値をエイリアス値の新しい変数に設定します。
備考
Ctrl+Kを押すと、入力フィールドに入力する際に自動的に変数が作成されますが、画面下部の変数ボックスをクリックして手動で作成することもできます。右側には、変数に代入する値を入力します。
このワークフローは、OpenRPAの無限の可能性を示す一例として使用されているに過ぎない。ChuckAPIのジョークを.csvや .xslxファイルに読み込んで、そのデータを扱うワークフローを起動したり、MongoDB Entityに渡したり、前述したように自動化には限界がないのです。
ここでは、Chuck Norris APIから取得したジョークがジョークであるかどうかを確認するための評価処理を設定します。
ここで使われている検証基準は、返されたJSON 辞書の 値の項目の内容が、”Chuck Norris “という文字列を含んでいるかどうかというものである。
まず、Chuck Norris API のジョークの内容を含むエントリを返すデフォルト変数を、「変数、引数、およびインポート」ボックス内に作成する必要があります。この変数のエイリアスは、Chuck Norris API Random Joke(https://api.chucknorris.io/jokes/random) で見ることができるように、valueです。
REST ワークフロー 例のワークフローで、Ifアクティビティをデザイナへドラッグします。
アクティビティ本体またはプロパティボックスの「条件」入力フィールドにvalue.Contains("Chuck Norris")を入力します。
ChuckAPIプロセスの評価に失敗した場合に、さらに実行される適切なフローをユーザーが設定する必要があります。
ワークフローロジック
Workflow Inノードをワークスペースにドラッグします。
Workflow In のプロパティで、OpenFlow ワークフローが割り当てられるキューを定義するQueue nameを設定します。
キュー名は完全に任意であり、ユーザは好きな名前を選ぶことができる。この例では、jokefailed と設定されています。
備考
Node-RED ワークスペース内のノードのプロパティにアクセスするには、指定されたノードをダブルクリックします。ノードのプロパティボックスが表示され、それ自体に必要な各入力フィールドが表示されます。
RPAチェックボックスをオンにすると、このフローのワークフローがOpenRPAエージェントから呼び出されるようになります。
Name」入力フィールドにワークフローの名称を設定します。ここでも、名前は任意に設定します。この例では、「Joke Failed」と設定されています。
RPA WorkflowまたはRobotノードをワークスペースにドラッグします。このノードにより、評価失敗時にREST Workflow - Joke Failedワークフローを呼び出すことができます。
ワークフローを呼び出すロボットと呼び出されるワークフローを、ロボットノードのプロパティに設定します。また、ノードのLocal queue nameと Nameを設定します。
ローカル キュー 名は任意で、ロボットインスタンスのキューイングに使用されるキューを設定するために使用されます。
Nameパラメータは、Node-RED内部での表示のみに使用されます。
この例では、Local queue nameを jokefailed、Nameを Invoke Joke Failed Workflowに設定しています。
Workflow InノードとRobotノードを接続します。
備考
ノードの接続は、Ctrlキーを押しながら、各ノードの外側にあるポートという灰色の長方形をクリックするだけで簡単にできます。クリックしたままでも接続できますが、筆者はCtrlキーを使う方が使いやすいと感じています。
Email Outノード（アクティビティの右端にある文字アイコンのノード）をワークスペースにドラッグします。このノードは、評価時にエラーが発生した場合、選択したメールにmsg.payloadオブジェクトの JSON 文字列を送信する役割を担います。
Invoke Joke Failed Workflowノードの一番上のポートを、emailノードの外側のポートに接続します。
備考
ノードの接続は、Ctrlキーを押しながら、各ノードの外側にあるポートという灰色の長方形をクリックするだけで簡単にできます。クリックしたままでも接続できますが、筆者はCtrlキーを使う方が使いやすいと思います。
Eメールノードのプロパティを設定します。
Toは、受信者からの電子メールアドレスを指します。
Useridは、メールを送信するアカウントのUserIdです。(例: ドメインなしの電子メール – 電子メールがadmin@openiap.io の場合、UserId はadmin になります)
パスワード– 送信者からのメールアカウントのパスワード。
この例では、ダミーの電子メール（admin@gmail.com）を設定し、メッセージの送受信に使用する。ここで注意すべきは、ユーザーがEメールを変更しなければ、ワークフローは明らかに機能しないということです。
備考
ユーザーが Gmail の SMTP サーバを使用している場合、Less secure アプリのアクセスを許可する設定が正しいことが必要です。さもなければ、ワークフローの実行時にエラーメッセージが表示されます。そのためには、Less secure app access(https://myaccount.google.com/lesssecureapps) を参照し、Allow less secure appssettings がON になっていることを確認します。
Workflow Outノードをワークスペースにドラッグします。
Workflow Out」ノードを「Eメール」（現在は「admin@gmail.com」）ノードに接続します。
備考
ノードの接続は、Ctrlキーを押しながら、各ノードの外側にあるポートという灰色の長方形をクリックするだけで簡単にできます。クリックしたままでも接続できますが、筆者はCtrlキーを使う方が使いやすいと感じています。
画面左上の赤い「Deploy」ボタンをクリックして、フローをデプロイします。
備考
Node-REDのフローに変更があった場合、ユーザーはそのフローをデプロイする必要があり、その変更は現在そのフローを使用しているロボット全体に伝搬されます。