データマッピング
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
データマッピングとは？
データマッピングとは、RPA フロー内でデータをどのように利用・変換するかを定義するプロセスです。これにより、あるアクションやトリガーの出力を別のアクションの入力に接続し、自動化プロセス全体で情報がスムーズかつ効率的に流れるようにできます。RPA ワークフローで一般的に扱う多様なデータ型を管理するうえで、非常に重要なプロセスです。
データマッピングが重要な理由
データマッピングは、RPA における次のような重要な側面で大きな役割を果たします。
動的なデータ処理：あるステップの出力データを利用して、直前のアクションに基づき情報を動的に処理できます。たとえば、抽出したタイムスタンプや日付を後続のアクションで使用できます。
例:メールから出発時刻を抽出し、カレンダーや ToDo リストの出張スケジュールを動的に更新する。
柔軟性:さまざまな形式や構造のデータを接続し、複数のアプリケーションやシステムをまたいだ自動化を実現します。
例:Excel ファイル、Web アプリケーション、クラウドアプリ連携から請求書情報を抽出し、レポートやデータ処理用に統一フォーマットへ変換する。
ワークフローの効率化:手作業でのデータ加工を不要にし、より高速で効率的な自動化プロセスを実現します。
例: 新入社員書類のデータから従業員プロファイルやシステムアクセス情報を自動入力し、手動でのデータ入力をなくす。
精度の向上:明確なデータのつながりにより、エラーや不整合を最小限に抑え、フロー全体でデータの整合性を確保します。
例: 商品コードを対応する商品説明にマッピングすることで、正確な価格設定と在庫管理を行えるようにする。
データと構文を理解する
Zoho RPA は、主に JSON などのさまざまなデータ形式を使って他のアプリケーションとやり取りします。JSON は、情報を整理してパッケージ化・共有するための分かりやすい形式です。この形式では、中かっこ ({}) と角かっこ ([]) を使って情報を整理します。以下のように動作します。
オブジェクト: 名前やメールアドレスなど、複数の情報をキーと値のペアとして保持する要素です。ラベル付きの仕切りがある箱のようなイメージで、それぞれの仕切りに特定の情報が入っています。仕切りのラベルが「キー」、中身が「値」です。
例:
- invoice: {
- 'company': 'ジルカー',
- 'amount': '$3000'
- }
配列（リスト）:特定の順序で並んだデータの集合で、複数のオブジェクトを保持します。各要素には 0（最初の要素）から始まる位置が割り当てられます。複数の商品が入ったショッピングカートのようなイメージです。
例:
- contacts': [
- { 'name': 'Angela', 'email': 'angela@zylker.com'},
- { 'name': 'Emma', 'model': 'emma@zylker.com'},
- ]
ヒント:
- 中かっこ ({}) はオブジェクトを囲みます。
- 角かっこ ([]) は配列を囲みます。
データをどのように抽出するか
オブジェクトからデータを抽出する:
${source.object.key} を使用して、オブジェクト内の特定の値にアクセスします。
ここで、
source: データを含むトリガーまたはアクションの名前。
object: データを抽出したいオブジェクトの名前。
key: 目的の値を保持しているキーの名前。
例:
アクション出力: getinvoicedetails
- {
- 'invoice': {
- 'company': 'ジルカー',
- 'amount': '$3000'
- }
- }
会社名を抽出する式: ${getinvoicedetails.invoice.company}
これにより、対象の項目に「ジルカー」が出力されます。
リストまたは配列からデータを抽出する:
${source.list[index].key} を使用して、リストまたは配列内の特定の要素と、その要素内のキーに対応する値にアクセスします。
ここで、
source: リストを含むトリガーまたはアクションの変数名。
list: データを抽出したいリストの名前。
index: リスト内の要素の位置（0 から開始）。
key:目的の値を保持しているキーの名前。
例:
- // リスト出力（例: トリガーから）:
- 'contacts':[
- {'name': 'Angela', 'email': 'angela@zylker.com' },
- {'name': 'Richard', 'email': 'richard@zylker.com' }
- ]
2 番目の要素のメールアドレスを抽出する式: ${trigger.contacts[1].email}
これにより、対象の項目に 'richard@zylker.com' が出力されます。
メモ:
- リストのインデックスは常に 0 から始まります。
- トリガーに割り当てられる変数名は、デフォルトで「trigger」です。
カスタム関数の出力からデータを抽出する:
-
変数ペインでカスタム関数を探します。
-
Execute ボタンをクリックします。
-
必要に応じてテストデータを入力します。
-
実行が完了すると、関数の出力が変数ペインに表示されます。
-
これらの出力を、そのまま他の項目や関数の入力として RPA フロー内で利用できます。
項目内の日付・時刻値のフォーマット:
Apps:日付項目に変数を割り当てる際、変数が使用する日付形式を選択できる「日付時刻のフォーマット」オプションがあります。選択した日付形式は、自動的にアプリ側で要求される形式に変換されます。
RPA:RPA アクションには、特定の形式が決まった日付項目はありません。ただし、Windows アプリや Web ブラウザーの項目に対して Set Text / Type into アクションで日付を入力する場合は、対象アプリケーションで要求される日付形式と一致している必要があります。
カスタム関数を使用して日付を必要な形式に変換し、その値を項目に割り当てることができます。
カスタム関数のサンプル
- String convertDate(input dateValue)
- {
- convertedDate=dateValue.toDate(dd-mm-yy);
- return convertedDate.toString();
- }
項目でシステム変数を使用する:
項目の設定で、あらかじめ定義された日付・時刻のシステム変数を使用できます。これらの日付・時刻の形式は固定で、変更することはできません。
現在の日付: タスク実行時の日付を提供し、マッピングされた項目に渡します。
形式: yyyy-MM-dd（例: 2024-01-23）
現在の日付と時刻: タスク実行時の日時を、マッピングされた項目に提供します。
形式: yyyy-MM-ddThh:mm:ssZ（例: 2024-01-19T23:30:30+05:30）
RPA フローでデータをマッピングする方法
1. 変数を確認する
アクションを設定する際、右側にある「変数を挿入」セクションを確認します。ここに利用可能な変数がすべて表示されます。
- システム変数: 現在の日付、現在の日時。
- 出力変数: 出力に対応しているトリガーおよびアクションから取得される変数。
- カスタム変数: 「変数を設定」タスクで作成した変数。
メモ: 変数名および項目名には、日本語の文字と数字のみ使用できます。他の言語はサポートされません。
アクション名をクリックすると、そのアクションで使用できる変数が表示されます。
2. 変数の種類を確認する
変数名の前には、その種類を示すアイコンが表示されます。
- Text: 文字列フィールド。
- Integer: 整数。
- Date: 日付。
- DateTime: 日付と時刻。
- Boolean: true または false の値。
- Email: メールアドレス。
- Decimal: 小数点を含む数値。
3. 変数をマッピングする
一覧から目的の変数をクリックし、対応する入力項目をクリックします。変数が自動的にその入力項目に挿入されます。
ヒント
必須項目でのデータの一貫性:
必須項目にマッピングした変数が、常に値を返すようにしてください。フロー実行時に必須項目が空になると、処理が失敗する可能性があります。
トリガーやアクション変更後のマッピングの見直し:
フロー設定後にトリガーやアクションを変更した場合は、マッピング済みの項目を再確認し、同期を保つようにマッピングを調整してください。
同名の変数がある場合の注意:
複数のステップで同じ名前（例: 「name」や「date」）の変数を使用している場合は注意してください。意図した値が使用されるよう、正しいステップの変数にマッピングされているか確認しないと、フロー実行時のエラーや失敗につながる可能性があります。
ドル記号のエスケープ:
ドル記号をエスケープするには、「$」を 2 回続けて入力します。たとえば、項目に $$40 と入力すると、出力は $40 になります。