Zoho DataPrep向けClickUpコネクタ [BETA]
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Zoho DataPrepでは、チームがタスク、プロジェクト、目標、ワークフローを1つのワークスペースで管理できるオールインワンの生産性向上プラットフォーム、ClickUpからデータを取り込めます。このコネクターを使用すると、ETLワークフローを効率化し、データをスムーズに移行して、ClickUpとZoho DataPrep間のデータ連携を簡素化できます。
ClickUpからデータをインポートするには
1.既存のパイプラインを開くか、パイプラインを作成します。パイプラインは、［ホーム］ページ、［パイプライン］タブ、または［ワークスペース］タブから作成できます。その後、［データを追加］をクリックします。
情報：パイプラインの作成画面上部にある［データのインポート］
2. 左ペインで［プロジェクト管理］カテゴリーを選択し、［ClickUp］をクリックします。検索ボックスでClickUpを検索することもできます。
メモ：すでにデータ連携を追加している場合は、使用するデータ連携をクリックしてインポートを続けます。保存済みのデータ連携は、左ペインの［保存済みのデータ連携］カテゴリーからも確認できます。保存済みのデータ連携についての詳細は、こちらをクリックしてください。
3. 保存済みのデータ連携からアカウントを選択するか、［新規追加］を使用して新しいアカウントを連携します。
ClickUpアカウントを認証するには
4. 各項目に、重複しない［データ連携名］、［クライアントID］、［クライアントシークレット］を入力します。
クライアントIDとクライアントシークレットを取得するには
a. ClickUpアカウントに移動します。右上のプロフィールアイコンをクリックし、［設定］を選択します。
b. 左ペインで［アプリ］を選択し、［新しいアプリを作成］ボタンをクリックして、次の詳細を入力します。
［アプリ名］：アプリの名前を入力します（例：「My CRM Integration」）。
［リダイレクトURL］：アプリで使用するリダイレクトURLを入力します。Zoho DataPrepからコピーできます。
［アプリの説明］：アプリの機能を簡潔に説明します。
c. クライアントIDとクライアントシークレットが生成されます。これらをDataPrepのインポート画面にコピーして貼り付け、［認証する］をクリックします。
5. 組織、プロジェクト、必要なデータセットを選択します。対応する列が表示されます。インポートするデータセットと列を選択します。
対応しているモジュールは次のとおりです。
- タスク
- リスト
- タスクの担当者
- タスクのウォッチャー
- 独自項目
6. ClickUpアカウントからデータをインポートする方法を、いずれかの設定から選択します。
［すべてのデータ］- この設定では、アカウントからすべてのデータをインポートします。
［開始日］- この設定では、指定した日付から現在の日付までのデータをインポートします。
メモ：開始日の設定は、タスクモジュールでのみ使用できます。この設定に対応していないモジュールでは、すべてのデータがインポートされます。
7. データのインポートが完了すると、パイプラインの作成画面が開き、ETLパイプラインへの加工処理の適用を開始できます。また、ステージを右クリックして［データの準備］を選択すると、DataPrep Studioページでデータの準備を行えます。加工処理の詳細については、こちらをご参照ください。
メモ：ClickUpアカウントから複数のデータセットをインポートすると、上記のように各データセットがDataPrep内のステージとして作成されます。
8. データフローを作成し、各ステージに必要な加工処理を適用したら、ステージを右クリックして［エクスポート先を追加］し、データフローを完成させます。
スケジュール
［スケジュール］設定を使用して、パイプラインの実行スケジュールを設定できます。
スケジュールの設定
1. パイプラインの作成画面で、［スケジュール］設定を選択します。
2. ［繰り返し］（毎時間、毎日、毎週、毎月）を選択し、［実行間隔］ドロップダウンで頻度を設定します。［実行間隔］ドロップダウンの設定は、選択した繰り返し方法に応じて変わります。詳細については、こちらをご参照ください。
3. 元データで検出された新しいデータをインポートする時刻の基準となるGMTを選択します。初期値では、ローカルタイムゾーンが選択されます。
4.［指定回数の失敗後にスケジュールを一時停止］：この設定では、失敗回数がn回に達した後にスケジュールを一時停止するよう設定できます。
情報：2～100の範囲で指定できます。初期値は2です。インポート設定
インポート設定を使用して、ClickUpアカウントからデータをインポートおよび取得する方法を設定できます。各モジュールと対応する実行の種類で利用可能なインポート設定については、次のシートを参照してください。
メモ：パイプライン内のすべてのデータソースに対して、インポート設定を必ず行う必要があります。インポート設定を行わないと、予約を保存できません。
5. インポート設定を指定するには、［こちらをクリック］のリンクを選択します。
6. ［データソースからデータをインポートするには？］ドロップダウンから必要な設定を選択します。インポートしたモジュールに応じて、［すべてのデータをインポートする］、［更新されたデータと新しいデータのみ］、または［データをインポートしない］を選択できます。
すべてのデータをインポートする
すべてのデータをインポートする場合は、［開始］項目でデータのインポート開始日を選択します。選択した日付以降に利用可能なすべてのデータがインポートされます。
差分データ取得
更新されたデータと新しいデータのみ
最終インポート日時以降に更新されたデータと新しいデータのみを差分でインポートするには、［更新されたデータと新しいデータのみ］を
ドロップダウンから選択します。
［新しいデータがない場合は既存のデータを使用する］：
差分インポート時：
- チェックボックスがオンの場合：データソースに新しいデータがないと、最後に取得したデータが再度インポートされます。
- チェックボックスがオフの場合：データソースに新しいデータがないと、インポートが失敗し、ファイルはインポートされません。その結果、パイプライン処理全体が失敗します。
データをインポートしない
データがインポートされるのは初回のみです。2回目は、同じデータにルールが適用され、エクスポートされます。
7. ［保存］をクリックして、データのインポートを予約します。
メモ：ClickUpからの予約をすでに設定している場合、インポート設定セクションの以前の設定に基づいてデータが再読み込みされます。この動作は、［予約を編集］をクリックして新しい予約を設定した場合に適用されます。
予約の設定
［データに無効な値がある場合はエクスポートを停止する］：有効にすると、準備済みのデータに無効な値が残っている場合、エクスポートが停止します。
エクスポートの順番
複数のエクスポート先を設定済みで、各エクスポート先にデータをエクスポートする順番を指定する場合に、この設定を使用できます。
有効にしない場合、エクスポートは標準の順番で実行されます。
有効にしない場合、エクスポートは標準の順番で実行されます。
メモ：この設定は、パイプラインに複数のエクスポート先を追加した場合にのみ表示されます。
エクスポート先の順番を並べ替えるには
1）［エクスポートの順番］の切り替えボタンをクリックします。
2）ドラッグ＆ドロップでエクスポート先の順番を変更し、［保存する］をクリックします。
メモ：順番をもう一度並べ替えるには、［順番を編集する］のリンクをクリックします。
8. 予約の設定が完了したら、［保存する］をクリックして予約を実行します。これにより、パイプラインが開始されます。
予約済みの各実行は、処理として保存されます。パイプラインを予約すると、データソースからデータが取得され、各ステージで適用済みの一連の加工処理を使用して準備されます。その後、データ連携を通じて、一定の間隔でエクスポート先にデータがエクスポートされます。この一連の処理は、処理の履歴に記録されます。
9. 特定のパイプラインの処理リストに移動するには、パイプラインの作成画面で
省略記号アイコンをクリックし、［処理の履歴］メニューをクリックして、パイプラインの処理ステータスを確認します。
10. 特定の処理の処理の概要に移動するには、［処理の履歴］ページで対象の処理IDをクリックします。
処理の概要には、パイプラインフローで実行された処理の履歴が表示されます。詳細はこちらをクリックしてください。
10. 特定の処理の処理の概要に移動するには、［処理の履歴］ページで対象の処理IDをクリックします。
処理の概要には、パイプラインフローで実行された処理の履歴が表示されます。詳細はこちらをクリックしてください。
11. 予約が完了すると、パイプラインで準備されたデータが、設定済みのエクスポート先にエクスポートされます。
情報：予約のステータスは、後から［処理］ページでも確認できます。
メモ：パイプラインにさらに変更を加えると、その変更は下書き版として保存されます。変更を予約に反映するには、［下書き］を選択し、パイプラインを準備完了として設定します。
予約を設定した後は、パイプラインの作成画面にある［予約有効］から、［予約を一時停止する］、［予約の再開］、［予約を編集する］、［予約を削除する］を選択できます。
予約を編集して保存すると、次の処理では、最終予約実行日時から次回の予約済みデータ範囲までのデータが処理されます。
重要：ClickUpをエクスポート先として追加し、DataPrepからClickUpにデータを送信する機能は、現在サポートされていません。
制限事項
再読み込み、バックフィル、手動での実行では、［開始日］項目で指定した日付から現在の日時までのデータがインポートされます。終了日時の設定には対応していません。
関連情報