HubSpotカスタムワークフロー：データ型変換アクションの実装ガイド

HubSpot運用において、外部連携などで生じる「データの型の不一致」を解消するためのツールです。ワークフロー内で値を動的に適切な型（数値、日付、真偽値など）へ変換し、データの整合性を自動で保ちます。

1. 目的

本アクションの目的は、「HubSpot内でのスムーズなデータ共有と自動化の精度向上」です。

• 不一致の解消: 文字列を数値に変換し、計算やスコアリングで利用可能にします。
• 形式の標準化: 不揃いな日付データをHubSpot標準のタイムスタンプへ変換します。
• 精度の向上: 正しい型への変換により、レポートやリスト抽出のミスを防ぎます。

2. ユースケース

• 数値計算: フォームから届いた文字列の数値を「数値型」に変え、自動算出に利用。
• 日付修正: 外部ツールからインポートされた不揃いな日付を、HubSpotの日付型に統一。
• 分岐の自動化: 文字列の「true/false」を真偽値に変え、ワークフローの条件分岐に活用。

3. 実装ステップ

動画のデモンストレーションに基づく、具体的な設定手順です。

ステップ1：アクションの選択

ワークフロー編集画面で「＋」をクリックし、連携済みアクションから「データ型変換」を選択します。

ステップ2：コードの適用

デザインマネージャーで新規ファイルを作成し、公開されているソースコードを各該当箇所へそのままコピー＆ペーストして公開します。

ステップ3：エディターでの設定

ワークフローの設定パネルで、変換したい「入力値」を選び、プルダウンから「変換後の型（整数、日付など）」を指定します。

4. 実装後の活用イメージ

設定完了後、システムは以下の処理を自動で行います。

1. 自動変換: ワークフロー起動時に、指定したデータが即座に目的の型へ変換されます。
2. 変数への格納: 変換後の値は、型に応じた専用の出力用変数（integerValue等）に保持されます。
3. 後続への連携: 運用者はその値を使い、数値プロパティへのコピーや、正確な日付ベースの通知設定など、次の方策に直接活用できます。

‍