Greenhouseをデータパイプラインソースとして設定 ​

Greenhouseをデータパイプラインソースとして設定し、応募、候補者、ジョブ、オファー、スコアカードなどの採用データをGreenhouse Harvest APIから抽出して、宛先に同期します。

このガイドを使用して、前提条件を確認し、Greenhouseをデータパイプラインソースとして接続し、パイプラインを設定して、サポートされているオブジェクト、同期モード、スキーマ処理、および制限事項について理解します。

サポートされている機能 ​

Greenhouseをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続: https経由でGreenhouse Harvest APIに接続します。 オンプレミスエージェントは不要です。
• カスタムドメイン: デフォルトのhttps://harvest.greenhouse.ioに加えて、https://acme.greenhouse.ioなどのGreenhouseカスタムサブドメインをサポートします。
• オブジェクトレベルの選択: 宛先に同期するGreenhouseオブジェクトを選択します。
• 同期モード: オブジェクトごとに設定されるフル同期と増分同期をサポートします。
• カスタムフィールド: テナントのGreenhouseカスタムフィールドを検出し、それらをサポートするオブジェクト上の列として同期します。
• スキーマドリフト処理: ソーススキーマが変更されたときに、新しいフィールドを自動同期するか、新しいフィールドをブロックするかを選択します。
• フィールドレベルのデータ保護: 機密フィールドが宛先に到達する前にハッシュ化します。
• 設定可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。

前提条件 ​

Greenhouseをデータパイプラインソースとして接続する前に、次の要件を満たしてください。

• Harvest APIへのアクセス権を持つGreenhouseアカウント。

推奨スコープ ​

特定のスコープを選択すると、harvest:users:listスコープは常に含まれます。

サポートされているGreenhouseオブジェクトを同期するには、Harvest OAuthスコープフィールドで次のHarvest API読み取りスコープを選択します。

サポートされるコネクションタイプ ​

Greenhouseデータパイプラインは、Greenhouse Harvest v3 APIに対して認証を行うOAuth 2.0認可コードグラントをサポートしています。

Greenhouseデータパイプラインでは、APIキー認証はサポートされていません。

Greenhouseに接続 ​

Greenhouseをデータパイプラインソースとして接続するには、次の手順を実行します。

パイプラインの設定 ​

Greenhouseをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Greenhouseデータパイプラインは、Greenhouse Harvest v3 APIリソースからデータを同期します。 次の表は、サポートされているオブジェクトをカテゴリ別に示しています。 各オブジェクトは、宛先内の個別のテーブルとして同期されます。

採用データ ​

ユーザーと組織 ​

設定データと参照データ ​

人口統計およびEEOCデータ ​

EEOCオブジェクトとDemographic Answersオブジェクトには、保護対象クラスのデータが含まれています。 これらのオブジェクトはデフォルトで同期から除外され、新しいオブジェクトを追加パネルには表示されません。

同期モード ​

Greenhouseデータパイプラインは、フル同期と増分同期をサポートしています。 同期モードは、オブジェクトをパイプラインに追加するときにオブジェクトごとに設定されます。

フル同期 ​

フル同期では、同期のたびにGreenhouseから使用可能なすべてのレコードを読み取り、宛先テーブルを上書きします。 宛先テーブルはソースの現在の完全な状態を反映するため、Greenhouseで削除されたレコードは次回の同期時に宛先から削除されます。

増分同期 ​

増分同期では、前回の同期後に作成または更新されたレコードのみを読み取ります。 パイプラインは各レコードのupdated_atタイムスタンプを追跡し、前回の実行時の最新タイムスタンプより後に更新されたレコードのみをリクエストします。 updated_atタイムスタンプを提供しないオブジェクトは、フル同期で同期されます。

増分同期では、Greenhouseで削除されたレコードはキャプチャされません。 削除されたレコードは宛先テーブルに残ります。

削除追跡 ​

Greenhouse Harvest v3 APIは削除フィードを提供しないため、Greenhouseデータパイプラインは削除を追跡しません。 宛先から削除済みレコードを削除するには、オブジェクトをフル同期で同期します。

スキーマとデータ型の処理 ​

カスタムフィールド ​

Greenhouseデータパイプラインは、テナントのカスタムフィールドを検出し、カスタムフィールドをサポートするオブジェクト（Jobs、Applications、Candidates、Offers、Openings）に列として追加します。 カスタムフィールド列には、フィールドのGreenhouse name_key値に基づいて名前が付けられます。

Greenhouseは、短いテキスト、長いテキスト、はい/いいえ、単一選択、複数選択、日付、URL、通貨、数値、ユーザーのカスタムフィールドタイプをサポートしています。

ネストされたオブジェクトと配列 ​

ネストされたオブジェクトまたは配列を含むフィールドは、JSON文字列として宛先に同期されます。

タイムスタンプ ​

Greenhouseのタイムスタンプは、2024-01-15T10:30:00.000ZなどのISO 8601 UTC文字列です。 一部のフィールドは、Offersオブジェクトのsent_onフィールドなど、YYYY-MM-DD形式の日付のみの値を返します。 パイプラインは元の値を保持します。

機密データの処理 ​

Greenhouseオブジェクトには大量の個人を特定できる情報（PII）が含まれており、一部のオブジェクトには保護対象クラスのデータまたは報酬データが含まれています。 次のオブジェクトには、一般的に機密フィールドが含まれます:

PIIが送信先に到達する前に保護するには、パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用します。 詳細については、パイプラインを構成手順を参照してください。 報酬データが保護されていない状態で宛先に到達しないように、WorkatoではOffersオブジェクトのcustom_fieldsフィールドをハッシュ化することをお勧めします。

候補者の匿名化 ​

候補者が匿名化されると（たとえば、GDPRまたはCCPAの消去リクエスト後）、Greenhouseは候補者のanonymized_atタイムスタンプを設定し、候補者のPIIフィールドをクリアします。 パイプラインは、宛先でanonymized_at値を保持します。 匿名化された候補者レコードはnullのPIIフィールドで同期されます。これは想定される動作です。

制限事項 ​

Greenhouseをデータパイプラインソースとして使用する場合、次の制限事項が適用されます。

非公開候補者 ​

Greenhouseは、表示する権限のないAPIユーザーに非公開候補者を返しません。 パイプラインは、同期から欠落している非公開候補者を検出したり警告したりすることはできません。 宛先に非公開候補者がない場合は、コネクションを認可したGreenhouseアカウントの権限を確認してください。

機密ジョブ ​

Greenhouseで機密としてマークされたジョブは、コネクションを認可したアカウントの権限によっては、nameやrequisition_idなどのフィールドにnull値を返す場合があります。 パイプラインは、これらのレコードをnull値で同期し、confidentialフィールドを保持します。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。 これより高い頻度で同期をトリガーすることはできません。