RPAでWebデータを取得・CSVファイルへ自動出力|JobAuto

RPA × WEB DATA EXTRACTION × CSV EXPORT

Webシステムの受注一覧から必要な項目を取得し、CSVファイルへ保存する方法を紹介します。国産RPAツール「JobAuto」では、ブラウザ操作で一覧の値を取得し、「変数の値を加工」でカンマ区切りの文字列を作成、「ファイル書き込み」でCSVファイルを出力できます。

ブラウザの起動・ログイン、一覧の繰り返し処理、データ取得からCSV保存まで、操作画像21点で順番に説明します。複数行を確実に出力するためのデータ蓄積や追記、CSVの文字列加工時の注意点も紹介します。

Webシステムからデータを取得してCSVファイルへ出力する流れ

受注一覧などのWebページからデータを取得し、CSVファイルとして別のシステムへ渡したい場合を考えます。JobAutoでは、次の操作を組み合わせて自動化できます。

  1. 「ブラウザを起動」でChromeを起動し、「ページを開く」でWebシステムを表示する
  2. 「値入力」でユーザー名・パスワードを入力し、「マウス操作」でログインする
  3. 受注一覧を開き、「要素の繰り返し処理」で明細行を順番に処理する
  4. 各行の必要な項目を「値取得」で変数へ格納する
  5. 「変数の値を加工」で項目をカンマ区切りに結合し、CSVの1行分を作る
  6. 全行分の文字列を蓄積するか、行ごとに追記する方法で複数行をまとめる
  7. 「ファイル書き込み」でCSVファイルへ保存し、内容を確認する

複数行を保存するときの重要な注意点:1行分の文字列を毎回同じ変数へ上書きし、繰り返し終了後に1回だけ書き込むと、最後の1行しか残りません。受注一覧の全件をCSVへ出力する場合は、全行分を変数へ蓄積して一括書き込みするか、ループの中で1行ずつ追記する処理を別途設けてください。

手順1|ブラウザを起動してWebシステムを開く

STEP 01 / OPEN WEB SYSTEM

「ブラウザを起動」アクションを作成する

ロボデザインで「ブラウザを起動」アクションを追加します。JobAutoからWebシステムを操作するためのブラウザを起動するアクションです。

JobAutoのロボデザインでブラウザを起動アクションを作成する画面
ブラウザ起動アクションを作成

ブラウザの選択でChromeを指定する

「ブラウザの選択」でChromeを選択します。使用するブラウザは操作先Webシステムの動作環境に合わせて選択してください。

ブラウザ起動アクションのブラウザ選択でChromeを指定する画面
Chromeで作成する

「ページを開く」アクションを作成する

ブラウザが起動したら「ページを開く」アクションを追加します。

JobAutoでページを開くアクションを作成する画面
ページを開くアクションを作成

「URL」欄へ、操作するWebシステムのログインページなどのアドレスを指定します。

ページを開くアクションのURL欄へWebシステムのアドレスを設定する画面
URLへシステムのURLを設定

ページが表示されたことを確認してから、ログイン処理へ進みます。読み込みが遅い場合は、画面の表示や目的の要素が見つかるまでの待機設定を確認してください。

手順2|ユーザー名とパスワードを入力してログインする

STEP 02 / SIGN IN

ユーザー名欄を選択して「値入力」を作成する

ログイン画面のユーザー名欄をクリックして選択し、右クリックメニューから「値入力」を選びます。

Webシステムのログイン画面でユーザー名入力欄を選択し値入力アクションを作成する画面
入力する箇所を選択して右クリックし、値入力をクリックする

値入力アクションの「入力する値」に、ログインに使用するユーザー名を設定します。

値入力アクションでユーザー名の文字列を設定する画面
入力する値へユーザー名を設定する

パスワード欄にも「値入力」を設定する

パスワード欄も同様に選択し、「値入力」アクションを作成します。

Webシステムのパスワード欄へ値入力を設定する画面
パスワードも同じことを行う

実運用では、認証情報がロボットの設定・ログ・画面などに不要に表示されないよう、取り扱い方法を確認してください。

「ログイン」ボタンをマウス操作する

ログインボタンを選択して右クリックし、画面例では「『ログイン』を見つけてマウス操作」を選択します。必要な項目を入力した後、ログイン操作を実行します。

ログインボタンを文字指定で見つけてマウス操作する設定メニュー
ログインボタンを右クリックして、「ログイン」を見つけてマウス操作をクリックする

ログインに失敗した場合や追加認証が表示された場合は、そのまま後続のデータ取得へ進まず、ログイン状態を確認できる処理を設けてください。

「受注一覧」へ移動する

ログイン後、操作対象の受注一覧のリンクやメニューを選択します。画面例では「『受注一覧』を見つけてマウス操作」を使用しています。

受注一覧リンクを文字指定で見つけてマウス操作する設定メニュー
受注一覧を右クリックして、「受注一覧」を見つけてマウス操作をクリックする

目的の一覧が表示されたことを確認してから、行ごとの繰り返し処理を設定します。

手順3|受注一覧を繰り返し処理する

STEP 03 / LOOP THROUGH ORDERS

「要素の繰り返し処理」を作成する

受注一覧のデータ行を選択して右クリックし、「要素の繰り返し処理」アクションを作成します。これにより、一覧の対象行を1件ずつ処理できます。

受注一覧の行を選択して要素の繰り返し処理を作成する画面
受注一覧の行を選択して右クリック、要素の繰り返し処理をクリックする

見出し行を除外するため「開始行」を設定する

「繰り返しの対象リスト」に列名などの見出し行が含まれている場合は、データ行から処理が始まるように開始位置を指定します。画像の例では「開始行」を「2」にしています。

要素の繰り返し処理で一覧のヘッダーを除くため開始行を2に設定する画面
一覧の項目名は繰り返しの対象外なので開始行を2にした

開始行を固定する前に確認:「2」にすればすべてのWebシステムで見出しを除外できるわけではありません。実際に「繰り返しの対象リスト」で先頭が見出し、2番目が最初のデータになっているか確認してください。設定後は「再読込」で繰り返し対象を確認し、不要な行があればフィルターの使用も検討します。

手順4|各行から必要な項目を「値取得」する

STEP 04 / EXTRACT ROW VALUES

取得したいセルを選択して「値取得」を作成する

一覧の行にある取得対象の値を選択し、右クリックメニューから「値取得」アクションを作成します。

受注一覧の行の値を取得するため値取得アクションを作成する画面
取得する値を右クリックして、値取得をクリック

値の格納先変数を指定する

取得した項目を後続の処理で使うため、値取得アクションで取得結果を格納する変数を設定します。

値取得アクションで受注項目の取得値を格納する変数を選択する画面
取得した値の格納先の変数を設定する

ほかの項目にも値取得を設定する

商品名、数量など、CSVへ出力したいほかの項目についても同様に「値取得」を設定します。操作画面の例に合わせ、受注一覧から必要な値を取得します。

受注一覧のほかの列にも値取得アクションを設定する画面
ほかの項目も同様の設定を行う

行の取り違えを防ぐ:「要素の繰り返し処理」の内部で値取得する際は、「高度な設定」の「rangename」を適切な繰り返し範囲に設定し、現在処理中の行から値を取得することを確認してください。別の行を繰り返し取得しないよう、複数行を使ってテストします。

手順5|取得した項目をカンマ区切りに加工する

STEP 05 / BUILD ONE CSV RECORD

「変数の値を加工」アクションを作成する

各行から取得した値をCSVの1行分にするため、「変数の値を加工」アクションを作成します。

受注データをカンマ区切りに加工する変数の値を加工アクション作成画面
変数の値を加工アクションを作成

「文字操作」から「値セット」を開く

加工画面で「文字操作」→「値セット」を選択し、取得した変数の値を組み合わせる設定を行います。

変数の値を加工で文字操作の値セットを開いて取得値を設定する画面
文字操作~値セットで変数を値セット画面を開く

各項目をカンマ区切りで結合する

値セットに、取得した項目をCSVの列順に並べてカンマ(,)で結合します。

取得した複数項目の変数をカンマ区切りで結合する設定画面
カンマ区切りで結合する

例えば、受注番号・商品名・数量の3項目を取得した場合、CSVの1行は次のような形になります。

1001,商品A,2

この段階で完成するのは1レコード(1行)分の文字列です。受注一覧に複数行がある場合は、全行のデータを保存する処理が必要です。

加工した値をCSV出力用の変数へ格納する

「加工した値の格納先」に、結合後の文字列を保存する変数を指定します。

CSV出力用に加工した文字列を保存する変数を指定する画面
加工した値の格納先を設定する

この変数の内容が、次の「ファイル書き込み」で書き込む値になります。全行分を一括書き込みする構成では、行ごとの値を別の蓄積用変数へ追加する必要があります。

CSVにカンマ・ダブルクォーテーション・改行が含まれる場合:単純に項目をカンマで結合するだけでは、CSVの列数がずれたりデータが壊れたりすることがあります。必要に応じてフィールドをダブルクォーテーションで囲み、値に含まれる " を "" にエスケープしてください。入力データの内容に合わせたCSVの整形が別途必要です。

複数行を出力する場合|データを蓄積するか追記する

受注一覧の全件をCSVへ保存したい場合は、1行分の文字列を作った後、次のどちらかの構成にします。これはこの操作例に加えて必要となる運用上の設計ポイントです。

方法A|全行の文字列を変数に蓄積し、最後に一括書き込みする

  1. 繰り返し処理の開始前に、CSV全体を蓄積する変数を空文字で初期化する
  2. 繰り返し処理の中で、現在の行の項目をカンマ区切りの1行に加工する
  3. その1行を、適切なレコード間改行とともに蓄積用変数へ追加する
  4. すべての行の処理が終わった後で、蓄積したCSV全体を「ファイル書き込み」で保存する

文字の追加には「変数の値を加工」の「文字追加」などを使用する方法を検討できます。変数の初期化・改行位置・追加先の指定を実際のロボットで確認してください。

方法B|1行作るたびにファイルへ追記する

  1. 繰り返し処理の開始前に、出力先CSVを新規作成するか、既存内容を初期化する
  2. 繰り返し処理の中で、1行のCSV文字列を作成する
  3. 「ファイル書き込み」の「追記する」を有効にし、行をファイルへ追加する
  4. 各レコードの間に改行が入り、行が連結されないことを確認する

追記する方法では、前回実行時のファイルに新しい行を追加してしまわないよう、実行開始前の出力ファイル初期化が重要です。初回の保存と2回目以降の追記、改行コードを正しく設計します。

受注番号,商品名,数量
1001,商品A,2
1002,商品B,5
1003,商品C,1

上のように複数レコードが正しく出力されていることを、テキストエディターや取込先システムで確認してください。ヘッダーの有無は取込先の仕様に合わせます。

手順6|「ファイル書き込み」でCSVファイルを出力する

STEP 06 / WRITE CSV FILE

「ファイル書き込み」アクションを作成する

CSVとして保存する文字列を用意したら、「ファイル書き込み」アクションを作成します。

CSVデータの保存に使うファイル書き込みアクションを作成する画面
ファイル書き込みアクションを作成

「書き込み値」にCSVデータの変数を指定する

「書き込み値」に、作成したCSVデータが格納された変数を指定します。一括書き込みの場合は全行を蓄積した変数、追記の場合は現在の1行を表す変数を指定してください。

ファイル書き込みでCSVへ出力する値を格納した変数を指定する画面
CSVファイルへ出力する変数を設定

「ファイル」に保存先のフルパスを指定する

「ファイル」に、CSVファイルの保存先となるフルパスを指定します。例:C:\Work\Output\受注一覧.csv。実際の出力先に合わせ、フォルダの存在や書き込み権限を確認します。

ファイル書き込みで出力先となるCSVファイルのパスを設定する画面
CSVファイルのパスを設定

書き込み設定:「追記する」のチェックが外れている場合は、ファイルを作り直して書き込みます。チェックを入れると既存内容へ追記します。「文字コード」は取り込み先の仕様に合わせ、「改行の扱い」でCRLF・LFなどを確認してください。文字コード変換の失敗を見逃さない設定も検討します。

CSVを正しく作成するための注意点

値にカンマなどの特殊文字が含まれる場合

商品名や備考欄にカンマ、ダブルクォーテーション、改行が含まれるときは、CSVとしての引用符処理が必要です。例えば以下のように出力します。

元の値CSVに書き出す例
商品A商品A
商品A,特別仕様"商品A,特別仕様"
商品”特別仕様”"商品""特別仕様"""

カンマで結合するだけでは、こうしたデータを安全に表現できない場合があります。CSVの仕様に合わせて整形し、取込先で列数が変わらないことを確認してください。

取得できなかった列の扱いを決める

Web画面の値取得が失敗して空欄になった場合に、その行の出力を中止するのか、空欄として記録するのかを決めます。JobAutoでは繰り返し処理中の値取得失敗時、格納先変数が初期化される場合があるため、必須項目の欠落を確認してください。

先頭のゼロ・文字コード・改行を確認する

得意先コードや商品コードのような 00123 は文字列として保持する必要があります。また、CSVの文字コードや改行コードは取り込み先の仕様と一致させてください。Excelで開いたときの見た目だけでなく、CSVファイルの実際の内容も確認することをおすすめします。

一括書き込みと追記を混在させない

全行のデータを蓄積して最後に出力する場合は、原則としてその出力ファイルを新しく作る構成を検討します。一方、繰り返しの各回で書き込む場合は追記が必要です。ループ内で毎回上書きすると、最後に処理した行しか残らないため注意してください。

CSV出力の確認チェックリスト

  1. ChromeでWebシステムを開き、正常にログインできているか
  2. 受注一覧に必要な明細行が表示されているか
  3. 「要素の繰り返し処理」の対象リスト・開始行が正しいか
  4. 値取得でrangenameなどの検索範囲を正しく設定しているか
  5. 行ごとの項目がCSVの列順どおりに格納されているか
  6. カンマやダブルクォーテーションを含むデータがあっても列がずれないか
  7. 全行の蓄積か、行ごとの追記かを明確に設定しているか
  8. 追記する場合、前回実行のデータが残って重複しないか
  9. 文字コード・改行コードが取り込み先の仕様に合っているか
  10. 出力したCSVの行数・列数・内容を検証できているか

まとめ|Webシステムのデータ取得からCSV保存までを自動化する

JobAutoでは、「ブラウザを起動」「ページを開く」「値入力」「マウス操作」でWebシステムを操作し、「要素の繰り返し処理」「値取得」で受注一覧のデータを取得できます。さらに、「変数の値を加工」「ファイル書き込み」を組み合わせて、CSVファイルの作成・保存まで自動化できます。

複数行のCSVを出力する場合は、各行の値をカンマ区切りにするだけでなく、全行を蓄積するか追記する処理が必要です。文字コード・改行・特殊文字の扱いも確認し、受け渡し先のシステムで問題なく読み込める形式に整えましょう。

Webシステムからのデータ取得・CSV出力をJobAutoで自動化

受注一覧や商品情報などをWebシステムから取得し、CSVファイルで別システムへ連携する定型業務にJobAutoを活用できます。実際の画面構成やCSVの取込仕様に合わせたロボット作成についてもご相談いただけます。

“RPAでWebデータを取得・CSVファイルへ自動出力|JobAuto” への1件のフィードバック

  1. […] 取得したデータをCSVファイルへ出力する例 […]

コメントを残す