ClickUpコネクタ for Zoho DataPrep [BETA]

ClickUpコネクタ for Zoho DataPrep [BETA]

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

Zoho DataPrepは、ClickUpからデータを取り込むことができます。ClickUpは、タスク、プロジェクト、目標、ワークフローを1つの統合ワークスペースで管理できるオールインワンの生産性向上プラットフォームです。このコネクタを使用することで、ETLワークフローを効率化し、スムーズなデータ移動を実現し、ClickUpとZoho DataPrep間のデータ統合を簡素化できます。

ClickUpからデータをインポートする方法

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

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


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


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

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



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

4. それぞれの項目に一意のConnection 名前クライアントIDClient シークレットを入力してください。




クライアントIDとClient シークレットの取得方法

a. ClickUpアカウントに移動し、右上の権限アイコンをクリックして設定を選択します。
b. 左側のペインからAppsオプションを選択し、作成 新規 appボタンをクリックして、以下の詳細を入力してください。


アプリ名: アプリ用の名前を入力してください(例:「My CRM Integration」)。
移動先URL: アプリケーションで使用する移動先URLを入力してください。Zoho DataPrepからコピーすることも可能です。
App 説明: アプリの機能について簡単に説明します。
c. クライアントIDおよびclientシークレットは作成済みです。DataPrepのインポート画面でコピー&ペーストし、「Authenticate」をクリックしてください。



5. 組織、プロジェクト、および必須のデータセットを選択します。該当するカラムが表示されます。インポートしたいデータセットカラムを選択してください。

サポートされているタブの一覧は以下の通りです:
  1. タスク
  2. リスト
  3. タスク担当者
  4. タスクウォッチャー
  5. カスタム商品



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

すべてのデータ - このオプションを選択すると、アカウント内のすべてのデータがインポートされます。
日付指定 - このオプションを選択すると、指定した日付から現在の日付までのデータがインポートされます。
Notes
メモ: 日付指定オプションはタスクタブでのみ利用可能です。対応していないタブの場合は、すべてのデータがインポートされます。
7. データのインポートが完了すると、Pipeline builderページが開き、ETLパイプラインへの変換の適用を開始できます。ステージを右クリックし、データの準備オプションを選択して、DataPrep Studioページでデータを準備することも可能です。変換についての詳細はこちらをご覧ください。



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

スケジュール

スケジュールオプションを使用してパイプラインの実行をスケジュールできます。

スケジュール設定

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

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




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


4.一時停止する schedule が次の後: このオプションを使用すると、選択する スケジュールを、n回の失敗後に一時停止するように設定できます。
Info情報: 範囲は2~100の間で設定できます。初期設定値は2です。

インポートする configuration

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



5. クリック hereリンクを選択し、インポートする configurationを設定します。

6. How to インポートする data 差出人 the データ元?ドロップダウンから必須のオプションを選択します。タブに応じて、インポートする すべて data更新済みおよび新規 data、またはdo not インポートするのいずれかを選択できます。

インポートする すべて data  

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




増分データ取得

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

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



既存のdataを使用する(新規dataが次の値と等しくない場合に利用可能): 

インクリメンタルインポート時に、

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

dataをインポートしない 

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



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

Schedule 設定

無効な値が存在する場合にエクスポートを停止: このオプションを有効にすると、準備されたデータに無効な値が含まれている場合、エクスポート処理が停止します。



順番エクスポート

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

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

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

1) 順番エクスポートトグルをクリックします。


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



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


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



スケジュールされた各実行はジョブとして保存されます。パイプラインがスケジュールされると、データはデータソースから取得済みとなり、一連の変換プロセスを通じて申請済みの処理が行われます。各ステージで処理された後、データはデータ統合によって通常の間隔で宛先にエクスポート済みとなります。この完了プロセスはジョブ履歴に記録されます。

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

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

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

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




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

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

重要: ClickUpを送信先として追加し、DataPrepからClickUpへのデータ転送はまだサポートされていません。

制限事項

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



関連情報