Zoho DataPrep用Expensifyコネクタ [ベータ]

Zoho DataPrep用Expensifyコネクタ [ベータ]

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Zoho DataPrepは、経費や取引の管理プラットフォームであるExpensifyからデータを取り込むことができます。この連携により、定期的なインポートのスケジュール設定、データの準備、経費ワークフローの効率化、さらには貴重な財務インサイトの取得が可能です。本コネクターは、ETLワークフローの効率化、スムーズなデータ移動、ExpensifyとZoho DataPrep間のデータ統合を簡素化します。

Expensifyからデータをインポートするには

1.既存のパイプラインを開くか、パイプラインを作成します。「ホーム」ページ、Pipelinesタブ、またはWorkspacesタブから操作し、「データを追加」オプションをクリックします。

Info情報: パイプラインビルダーの上部にあるデータをインポートアイコンをクリックして、複数のソースからパイプラインにデータを取り込むこともできます。


2. 左側のペインでFinanceカテゴリを選択し、Expensifyをクリックします。Expensifyは検索ボックスから検索することもできます。



Notesメモ: 以前に外部連携を追加済みの場合は、該当する連携をクリックしてインポートを続行してください。また、保存済み外部連携は左側のペインにあるSaved 外部連携カテゴリからも確認できます。保存済み外部連携について詳しくは、こちらをご参照ください。

3. 保存済み外部連携からアカウントを選択するか、新規追加オプションを使って新しいアカウントを接続します。




Expensify アカウントを認証する方法

4. Expensify アカウントのそれぞれの項目に、固有のConnection 名前、パートナー ユーザー ID、パートナー ユーザー シークレットを入力してください。


パートナー ユーザー ID とパートナー ユーザー シークレットの取得方法

1. https://www.expensify.com/tools/integrations/ にアクセスします。
2. partnerUserID と partnerUserSecret の認証情報が自動的に作成され、ページ上に表示されます。



メモ: 提供された partnerUserID と partnerUserSecret のペアは、再表示されないため安全な場所に必ず保管してください。

5. 必要なタブを選択すると、対応する項目が表示されます。インポートしたいタブおよび項目を選択してください。

サポートされているすべてのタブの一覧は以下の通りです。

  1. 規定

  2. レポート

  3. 経費

  4. 経費 Attendees

  5. レポート承認者
    メモ: インポート可能なのは承認済みタブのみです。

  6. レポート履歴およびコメント

  7. Categories

  8. People

  9. 税金

  10. Tags




6. 設定のいずれかを選択して、Expensifyアカウントからデータをインポートします。

すべてのデータ - このオプションを選択すると、アカウント内のすべてのデータがインポートされます。
日付指定 - 指定した日付から現在の日付までのデータがインポートされます。
メモ: 日付指定オプションは、以下のタブで利用可能です。サポートされていないタブの場合は、すべてのデータがインポートされます。

  1. レポート

  2. 経費

  3. 経費 Attendees

  4. レポート承認者

  5. レポート履歴・コメント
7. データのインポートが完了すると、Pipeline builderページが開き、ETLパイプラインへの変換の適用を開始できます。ステージを右クリックし、データの準備オプションを選択して、DataPrep Studioページでデータの準備を行うことも可能です。変換についての詳細はこちらをクリックしてください。



メモ: Expensifyアカウントから複数のタブをインポートする場合、各データセットは上記のようにDataPrep内でステージとして作成されます。
8. データフローの作成と、各ステージで必要な変換の適用が完了したら、ステージを右クリックして出力先を追加し、データフローを完了できます。
Notesメモ: ETLパイプラインに出力先を追加した後、まず手動実行でパイプラインを実行してみてください。手動実行が正常に動作することを確認した後で、スケジュールを設定してパイプラインおよびデータ転送の自動化が可能です。さまざまな実行タイプの詳細はこちらをご参照ください。

スケジュール

スケジュールオプションを使用してETLパイプラインのスケジューリングが可能です。

スケジュール設定

1. パイプラインビルダーでScheduleオプションを選択します。

2. 繰り返し方法（毎時間、毎日、weekly、月間）を選択し、Perform 頻度 ドロップダウンで頻度を設定します。 Perform 頻度ドロップダウンの設定は、選択した繰り返し方法によって変わります。こちらをクリックして詳細をご覧ください。




3. インポートしたい新規データがデータ元に見つかったときに使用するGMTを選択します。初期設定では、ローカルのタイムゾーンが選択されています。


4.一時停止するスケジュールが次の後: このオプションでは、選択した回数分失敗した後にスケジュールを一時停止することができます。
Info情報: 設定可能な範囲は2〜100です。初期設定値は2です。

インポート設定

インポート設定オプションを利用して、Expensifyアカウントからデータをインポートし取得する方法を設定できます。下記の表で、各タブごとに利用可能なインポート設定と対応する実行タイプをご確認ください。
メモ: パイプライン内のすべてのソースに対してインポート設定が必要です。インポート設定を行わないと、スケジュールを保存できません。


5. ここをクリックリンクを選択し、インポート設定を行います。

6. データ元からデータをインポートする方法ドロップダウンから、必要なオプションを選択します。すべてのデータをインポート、更新済みおよび新規データ、またはインポートしないのいずれかをインポートするタブに応じて選択できます。

すべてのデータをインポート  

すべてのデータをインポートしたい場合は、差出人項目でデータをインポートする必要がある日付を選択してください。このオプションを選ぶと、選択した日付以降に利用可能なすべてのデータがインポートされます。



メモ: 差出人オプションは、選択済みタブ（上記の表を参照）で利用可能です。このオプションに対応していないタブでは、すべてのデータがインポートされます。

増分データ取得

更新済みおよび新規データのみ

更新済みおよび新規データを増分でインポートするには、最終インポート日時以降のデータを 差出人、 更新済みおよび新規データのみオプション を選択します。
ドロップダウンから選択してください。



利用可能な場合、新規 data が次の値と等しくない場合は既存 data を使用します: 

増分インポートする時に、

  1. チェックボックスがオンの場合：データ元に新規 data がない場合、最後に取得済みの data が再度インポートされます。
  2. チェックボックスがオフの場合：データ元に新規 data がない場合、インポートするは失敗し、ファイルはインポートされません。その結果、パイプラインジョブ全体も失敗します。

dataをインポートしない 

データは一度だけインポートされます。2回目以降は、同じデータに対してルールが適用され、エクスポート済みデータが取得されます。



7. 保存をクリックして、データのインポートするをスケジュールします。
Notesメモ：すでにExpensifyからのスケジュールを設定済みの場合、インポートする設定セクションで以前の設定内容に基づきデータが再読み込みされます。編集スケジュールオプションをクリックし、新しいスケジュールを設定してください。

Schedule 設定

停止する エクスポートする if data has 無効な値: これを有効にすると、準備されたデータに無効な値が含まれている場合、エクスポートが停止されます。



順番 exports

複数の送信先を設定している場合、データをどの順番で送信先にエクスポートするかを指定する際にこのオプションを使用できます。

有効にしない場合は、エクスポートは初期設定の順番で実行されます。
メモ: このオプションは、パイプラインに2つ以上の送信先を追加している場合のみ表示されます。

エクスポート先の順番を並べ替えるには

1) 順番 exportsトグルをクリックします。

2) drag and drop で宛先の順番を変更し、保存をクリックします。


メモ: 順番を再度並べ替えたい場合は、編集 順番リンクをクリックしてください。


8. スケジュール設定が完了した後、保存をクリックしてスケジュールを実行します。これにより、ETLパイプラインが開始されます。



スケジュール実行ごとにジョブとして保存されます。パイプラインがスケジュールされると、データはデータソースから取得済みとなり、各ステージで適用した変換処理によって整備され、その後、シームレスなデータ統合により、データはエクスポート済みとして指定の宛先に送信されます。この処理は通常の間隔で実施されます。この完了した処理はジョブ履歴に記録されます。

9. 特定のパイプラインのジョブ一覧に移動するには、パイプラインビルダー内の三点リーダーアイコンをクリックし、Job 履歴メニューを選択して、パイプラインのジョブステータスを確認します。

10. Jobs 履歴 ページで、必要なジョブIDをクリックすると、Job 概要へ移動し、そのジョブの詳細を確認できます。

Job 概要では、パイプラインフローで実行されたジョブの履歴を確認できます。こちらをクリックして詳細をご覧ください。

11. スケジュールが完了すると、パイプラインで準備されたデータは設定済みの出力先にエクスポートされます。
情報: できることは、Jobsページでスケジュールのステータスを後から表示することも可能です。
Notesメモ: パイプラインにさらに変更を加えた場合、その変更は下書きバージョンとして保存されます。下書きオプションを選択し、パイプラインを変更反映可能として設定してください。これによりスケジュールに反映されます。




スケジュール設定後は、スケジュールの一時停止や再開、編集、削除をパイプラインビルダーのSchedule 有効オプションから選択できます。

スケジュールを編集して保存した場合、次回のジョブは、前回のスケジュール実行時刻から次のスケジュールデータ間隔までの間で実行されます。

重要: Expensify を宛先として追加し、DataPrep から Expensify へデータをプッシュする機能は、現時点ではサポートされていません。

制限事項

  1. インクリメンタルフェッチは日付単位のみサポートされています。特定の1日の時間単位でのデータ取得はサポートされていません。

関連情報