Zoho DataPrep用チームワークコネクタ [ベータ]

Zoho DataPrep用チームワークコネクタ [ベータ]

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

Zoho DataPrepを使うと、プロジェクトおよびタスク管理データをTeamworkから連携し、データ準備を行うことができます。Teamworkデータのインポートを定期的にスケジュールすることも可能です。このコネクターを利用することで、ETLワークフローを効率化し、円滑なデータ移動を実現し、TeamworkとZoho DataPrep間のデータ統合を簡素化できます。

Teamworkからデータをインポートする手順

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

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


2. 左側のペインでプロジェクト管理カテゴリーを選択し、Teamworkをクリックします。Teamworkは検索ボックスで検索することもできます。


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

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



Teamworkアカウントを認証するには

4. 各項目にTeamworkアカウントのConnection 名前、クライアントID、およびClient シークレットを一意に入力してください。



クライアントIDとClient シークレットを取得するには

a. TeamworkのDeveloperポータルにログインします。

b. 作成 Your First Appボタンをクリックします。
c. 名前、説明（任意）、商品を選択し、認証時にZoho DataPrepインポートウィザードからコピーしたCallback URLを貼り付けます。



d. 作成 Appボタンをクリックします。次に、作成したアプリを開き、Credentialsセクションに移動します。クライアントIDとClientシークレットを表示できます。



5. 必要なプロジェクト、Datasets、および対応する項目を選択します。インポートしたいDatasetsと項目を選択してください。

サポートされているタブの一覧は以下の通りです。
  1. 組織
  2. プロジェクト
  3. People
  4. Tags
  5. Milestones
  6. Milestone 担当者
  7. タスク List
  8. タスク
  9. タスク 担当者
  10. プロジェクト カテゴリー
  11. Risks
  12. 時間 Tracking
  13. ユーザー Rates
  14. 請求書
  15. 経費



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

すべてのデータ - このオプションを選択するとアカウント内のすべてのデータがインポートされます。
日付指定 - このオプションでは特定の日付から現在日付までのデータをインポートします。
Notes
メモ: 日付指定オプションは下記のタブで利用できます。その他のタブでは、すべてのデータがインポートされます。
  1. Milestones
  2. 時間 tracking
7. データのインポートが完了すると、Pipeline builderページが開き、ETLパイプラインへの変換を適用し始めることができます。また、ステージを右クリックしてPrepare dataオプションを選択し、DataPrep Studioページでデータの準備を行うことも可能です。変換の詳細についてはこちらをクリックしてください。



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

スケジュール

パイプラインはスケジュールオプションを使ってスケジューリングできます。

スケジュール設定

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

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




3. GMTを選び、データ元で検出された新しいデータをインポートする時間を指定します。初期設定では、ローカルのタイムゾーンが選択されています。


4.スケジュールを一時停止するタイミング: このオプションでは、一時停止する条件を特定の回数の失敗後に設定できます。
Info情報: 設定可能な範囲は2〜100です。初期設定値は2です。

インポート設定

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

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

6. データ元からどのようにデータをインポートしますか？のドロップダウンから必須のオプションを選択します。タブごとにすべてのデータをインポート、更新済みおよび新規データ、またはインポートしないを選択できます。

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

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



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

増分データ取得

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

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



既存の data を使用（新規 data が下記値と異なる場合に限り利用可能）: 


インクリメンタル インポート中、

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

data をインポートしない 

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



7. 保存をクリックして、データのインポートをスケジュールします。
Notesメモ: すでにスケジュール差出人Teamworkを設定している場合は、インポートする設定セクションで以前の設定に基づいてデータが再読み込みされます。編集スケジュールオプションをクリックして新規スケジュールを設定してください。

Schedule設定

無効な値がある場合、エクスポートするを停止する: この設定を有効にすると、準備されたデータに無効な値が含まれている場合、エクスポートが自動的に停止します。



順番エクスポート

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

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

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

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


2) ドラッグ＆ドロップで送信先の順番を変更し、保存をクリックします。


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


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



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

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

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

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

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




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

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

重要: Teamwork を送信先として追加し、DataPrep から Teamwork へデータをプッシュすることは、現在サポートされていません。

制限事項

更新、バックフィル、および手動実行時、データは「差出人」項目で指定された日付から現在の日付・時刻までインポートされます。終了時間の設定はサポートされていません。


関連情報