データを送信する#
送信は、モデルの行を書き込み可能な送信先オブジェクトに対応付けます。Supernova は最初の書き込み前に差分をプレビューし、確認済みの行の値をハッシュで記憶します。以降は変更した行だけを送信します。
送信を設定する#
HubSpot または Intercom のソースを開き、データを送信を選択します。
モデル、送信先オブジェクト、照合用プロパティを選択します。
モデルの列を、書き込み可能な送信先プロパティに対応付けます。
プレビューを実行し、更新、新規作成、スキップ、曖昧な一致、検証エラーを確認します。
マッピングを確認してから、すぐに実行するかスケジュールを設定します。
null と空の値は省略します。送信先のプロパティを消去することはありません。送信先の型で表現できない値は、送信先へのリクエスト前に検証エラーになります。
照合と新規作成#
照合列は送信先のレコードを識別します。1 つの値が複数のレコードに一致した場合は、設定した曖昧な一致のポリシーに従います。一致しない行は、新規作成を有効にしていなければスキップします。
新規作成が 1 件でもあれば確認が必要です。スケジュール実行も、差分が 500 件の書き込みを超えると一時停止します。これらのゲートにより、以前は小規模だったマッピングが、無人のまま大規模な変更になることを防ぎます。
差分の状態#
基準状態には、モデルの値そのものではなく rowValueHash と sendCfgHash を保存します。マッピングを変更すると、以前の確認は無効になります。全件実行では基準状態を消去し、ソースのすべての行を再評価します。
ドライランは書き込みも基準状態の更新も行いません。プレビューのサンプルは一時的で、サイズに上限があります。
テナントの固定とエラー#
送信の作成時に送信先のアカウントまたはワークスペースを記録し、実行のたびに再検証します。ソースの認証情報を変更しても、送信先が黙って切り替わることはありません。
行ごとのログにはカテゴリ、コード、トレース ID だけを保存します。送信先のメッセージには顧客の値が含まれる可能性があるため、そのままのメッセージは保存しません。一部の書き込みで成功を確認できた分は基準状態を更新し、再試行で無条件に再送しません。