更新日時 2025年9月22日
「データを書式設定」ワークフローアクションを使用して、CRMデータの修正、書式設定、メンテナンスを行います。例えば、コンタクトの名や会社名の先頭を大文字にしたり、プロパティーを基に値を計算したりすることができます。
また、データを 単行または複数行のテキストプロパティーに変換したり、 Googleスプレッドシートにデータを書式設定し、追加することもできます。
ワークフローによるデータの書式設定では、2段階で処理を行います。まず、［データを書式設定（データの形式設定）］アクションを設定して、データを準備します。次に、そのデータを利用するための別のワークフローアクションを設定します。
デフォルトの書式設定オプションを使ってデータを書式設定する
デフォルトの書式設定オプションを使ってデータを書式設定するには：
- HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
- 既存のワークフロー の名前 をクリックするか、 新しいワークフローを作成します。
- ワークフローエディターで、+プラスアイコンをクリックしてワークフローアクションを追加します。
- アクションパネルで、［データ処理］セクションの［データを書式設定］を選択します。
- 右側のパネルで、［カスタムモード］スイッチがオフになっていることを確認します。
- 左側のパネルで、書式設定するプロパティーまたは値を選択します：
- 登録されたレコードのプロパティー値を書式設定するには、［次の場所からのプロパティーまたはアクション出力を表示］ドロップダウンメニューをクリックし、［登録されたレコード］を選択します。次に、プロパティーを1つ選択します。
- 以前のアクションの結果を書式設定するには、［次の場所からのプロパティーまたはアクション出力を表示］ドロップダウンメニューをクリックし、［アクション出力］を選択します。次に、前のアクション名をクリックして展開し、アクション出力を1つ選択します。
- ［形式］ドロップダウンメニューをクリックし、書式設定オプションを1つ選択します。
- ［出力タイプ］ドロップダウンメニューをクリックして、出力タイプを1つ選択します。選択した書式設定オプションに応じて、データをテキスト、数値、日付、または日時の値として書式設定できます。
- 書式設定したデータを既存のプロパティーに自動的に保存するには、次の手順に従います。
- ［はい、値をプロパティーに保存します］チェックボックスをオンにします。
- 上部にある[ 保存して続行]をクリックします。これにより、新しい レコードを編集 アクションが自動的に作成されます。
- デフォルトの設定では、アクションのフィールドは自動入力され、同じレコードとプロパティーを更新するように設定されます。
- このアクションをさらにカスタマイズすることができます。「レコードを編集」アクションの使用方法について詳細をご確認ください。
- 次に［保存］をクリックします。
- アクションの設定が完了したら、［保存］をクリックします。
デフォルトの書式設定オプション
「データを書式設定」アクションを使用するときには、次のデフォルトの書式設定オプションを使用できます。
- ［数値を加算］：プロパティーまたは値に特定の数値を追加します。［加算する数値］フィールドに必要な値を入力してください。
- ［時間を加算］：日時の値に期間（時間、日数など）を追加します。［加算する数値］フィールドに時間の長さを入力し、［時間の単位］ドロップダウンメニューを使って時間の単位を選択してください。
- ［数値の平方根を計算］：数値の累乗根の値を計算します。［n乗根数］フィールドに、累乗根の数値を入力します。
- 先頭の文字を大文字にする：値の最初の文字を大文字にします。値に含まれる他の文字は全て小文字に変更されます。ラテンアルファベットの文字でのみ機能します。
- ［全ての文字を小文字に変更］：値の全ての文字を小文字に変更します。ラテンアルファベットの文字でのみ機能します。
- ［全ての文字を大文字に変更］：値の全ての文字を大文字に変更します。ラテンアルファベットの文字でのみ機能します。
- ［タイトルケースに変更］：値をタイトルケースに変更します。値の各単語の最初の文字は大文字に、その他の文字は全て小文字に変更されます。ラテンアルファベットの文字でのみ機能します。
- ［UNIXタイムスタンプに変換］：値をUNIXタイムスタンプに変換します。
- ［1文字以上を切り取る］：値から特定の文字を削除します。削除する文字を［切り取る文字］フィールドに入力します。例えば、郵便番号
02145の場合、フィールドに02と入力すると145という値になります。 - ［数値を除算］：特定の数値で値を除算します。除算に使用する数値を［除数］フィールドに入力します。
- エスケープとURLエンコード：URLエンコードされた形式で値を返します。例えば「hello world」から「hello%20world」に変換されます。
- [日時を書式設定]: 値の 日付の形式 を変更します。
- 日付形式：値を表す新しい日付形式。
- タイムゾーン：値はこのタイムゾーンで書式設定されます（IANA TZDB形式）。デフォルトでは、UTC時間を返します。
- ロケール：値に使用するロケール。例えばen-US、hi-INなど。
- ［数値の絶対値を求める］：数値の絶対値を返します。このオプションを使用すると、常に正の数値が得られます。
- ［数値を乗算］：特定の数値で値を掛けます。［乗数］フィールドに、掛ける数値を入力します。
- HTMLタグを削除：値から全てのHTMLタグを削除します。
- 文字を置換：値に含まれる特定の文字を検索して置換します。
- 置換する文字：値の中の置換される文字列。
- 置換文字：指定した［置換する文字］から置き換わる値。
- 置き換える該当件数：［置換する文字］の値が置換される回数。デフォルトでは、対象となる文字の全ての出現が置き換えられます。
- 数値を端数処理：指定された小数点以下桁数の近似値になるように値を増減します。
- 次の小数へ端数処理：丸めて整数にするか、選択した形式の小数に丸めます。
- 端数処理方法：［常に切り上げる］、［常に切り下げる］、または［四捨五入］から選択します。
- 時間を減算：日付プロパティーから時間を差し引くことを選択できます。［減算する数値］フィールドに値を入力し、［時間の単位］フィールドから時間の単位を選択します。
- 数値が割り切れるかを評価：指定した数値で値が割り切れるかどうかを検査します。［除数］フィールドに、検査に使用する数値を入力します。
- 先頭と末尾の空白を切り取る：値の先頭と末尾の空白を全て削除します。
カスタム式を使用してデータを書式設定する
カスタム式でデータを書式設定するには、次の手順に従います。
- HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
- 既存のワークフロー の名前 をクリックするか、 新しいワークフローを作成します。
- ワークフローエディターで、+プラスアイコンをクリックしてワークフローアクションを追加します。
- アクションパネルで、［データ処理］セクションの［データを書式設定］を選択します。
- 左のパネルで、［カスタムモード］をクリックしてオンに切り替えます。
- ［式］セクションに、カスタム数式を入力します。
- ［挿入］をクリックして、次の要素のいずれかを式に追加します。
- アクション出力：同じワークフロー内の以前のアクションからの出力値です。
- HubSpotプロパティー：登録されたレコードに属するプロパティーの値です。
- 関数：最初の文字を大文字にしたり、数値を追加するなど、式を設定するために使用される演算子です。
- プレビューに、結果の例が自動的に表示されます。
- 数式でプロパティー値などの変数が使用される場合、プレビューにはデフォルト値を使用した結果が表示されます。
- 他の例でプレビューを表示するには、［サンプルデータを編集］をクリックし、各フィールドに別のテスト値を入力します。
- 書式設定したデータを既存のプロパティーに自動的に保存するには、次の手順に従います。
- ［はい、値をプロパティーに保存します］チェックボックスをオンにします。
- 上部にある[ 保存して続行]をクリックします。これにより、新しいレコードを編集アクションが自動的に作成されます。
- デフォルトの設定では、アクションのフィールドは自動入力され、同じレコードとプロパティーを更新するように設定されます。
- このアクションをさらにカスタマイズすることができます。「レコードを編集」アクションの使用方法について詳細をご確認ください。
- アクションの設定が完了したら、［保存］をクリックします。
カスタム式の例
カスタム式を使用すると、出力に関する複雑な書式設定オプションをカスタマイズできます。カスタム式で使用できる関数についての詳細をご確認ください。例えば、次のように計算できます。
注: 関数をコピーして[式 ]セクションに貼り付けることは可能ですが、 アクションの出力や HubSpotプロパティーなど、使用するトークンは 手動で 挿入する必要があります。
| ユースケース | 式 |
| 電話番号から特殊文字を削除しています。 例えば、アカウント全体で電話番号の形式を標準化する場合などです。 |
cut(cut(cut([phone], "-"), "*"), "#") |
| 営業担当者のコミッション金額を計算する 例えば、取引レコードにココミッション率を記録する場合などです。 |
([Amount] * [commission_rate]) |
| 文字列や異なるプロパティー値の連結 | concat([company_name], [month_and_year]) |
| データの形式を変更して、アクションが発生する時刻にします。 例えば、特定のイベントが発生する時刻に基づいてレポートやセグメントを作成する場合などです。 |
cut( regex_replace(datetimeformat([hs_email_last_open_date], "full"), ".*\b(at\b)", "") ,"Coordinated Universal Time") |
| アクションが発生する曜日に合わせてデータの形式を変更します。 例えば、特定のイベントが発生する曜日に基づいてレポートやセグメントを作成する場合などです。 |
regex_replace(format_datetime([createdate], "full"), ",.*$", "" ) |
形式設定されたデータを使用する
「データを書式設定」アクションを追加した後、書式設定されたデータを使用するための追加のアクションをセットアップする必要があります。「データを書式設定」アクション内で、書式設定したデータを使って既存のプロパティーを自動的に更新できます。
また、Google Sheetsとの連携をインストールしている場合は、書式設定したデータをGoogleスプレッドシートに追加することもできます。
書式設定したデータを使って既存のプロパティーを更新する
「レコードを編集」アクションをセットアップし、新しく書式設定されたデータによってプロパティーを更新します。このアクションでは、前述の［データを書式設定（データの形式設定）］アクションで形式設定したデータを使用できます。
- HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
- 既存のワークフロー の名前 をクリックするか、 新しいワークフローを作成します。
- ワークフローエディターで、+プラスアイコンをクリックしてワークフローアクションを追加します。
- アクションパネルで、［レコードを編集］を選択します。
- 左側のパネルで［編集するプロパティー］ドロップダウンメニューをクリックし、プロパティーを1つ選択します。
- チェックボックスなどの選択タイプのプロパティーの場合：
- ［値を選択］ドロップダウンメニューをクリックし、［データ変数を選択］を選択します。
- ［データ変数を選択］パネルで、［登録済み［オブジェクト］］ドロップダウンメニューをクリックし、［アクション出力］を選択します。値を別のプロパティーにコピーする場合は、プロパティー間に互換性がなければなりません。詳しくは互換性のあるプロパティータイプをご確認ください。
- 前のアクション名をクリックして展開し、アクション出力を1つ選択します。
- テキスト入力プロパティーの場合：
- ［値を選択］テキストボックスをクリックします。
- ［データ変数を選択］パネルで、［登録済み［オブジェクト］］ドロップダウンメニューをクリックし、［アクション出力］を選択します。
- 前のアクション名をクリックして展開し、アクション出力を1つ選択します。
- ［保存］をクリックします。［レコードを編集］アクションの設定が完了すると、既に書式設定された値をワークフローで使用してCRMプロパティーを更新できるようになります。
書式設定したデータをGoogleスプレッドシートに追加する
Googleスプレッドシート連携をインストール済みの場合は、HubSpot内のプロパティーを更新することなく、書式設定したデータをスプレッドシートに直接追加できます。例えば、シート内のコンタクト名を小文字で書式設定する必要があるが、HubSpotではコンタクト名を大文字のままにしておきたい場合があります。
Google Sheetsアプリは、アプリマーケットプレイスから接続するか、ワークフロー内から接続することができます。
- HubSpotアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
- 既存のワークフロー の名前 をクリックするか、 新しいワークフローを作成します。
- ワークフローエディターで [+]プラスアイコンをクリックしてワークフローアクションを追加します。
- ［アクション］パネルで、［Googleスプレッドシートの行を作成］を選択します。
- ［スプレッドシート］ドロップダウンメニューをクリックします。次に、データの送信先となるスプレッドシートを選択します。Google スプレッドシートをHubSpotに接続したユーザーが所有している、またはそのユーザーと共有されているスプレッドシートから選択できます。
- ［シート］ドロップダウンメニューをクリックします。次に、データの送信先となるシートを選択します。［シート］フィールドは、スプレッドシートの最下部にあるタブを表します。
- 書式設定したデータを使用するようにGoogleスプレッドシートの行を次のように設定します。
- ［ヘッダー］ドロップダウンメニューをクリックします。次に、Googleスプレッドシート内の該当する列を選択します。
- ［プロパティー］フィールドをクリックします。
- データパネルで、［次の場所からのプロパティーまたはアクション出力を表示］ドロップダウンメニューをクリックし、［アクション出力］を選択します。
- 「データを書式設定」アクションをクリックして展開します。以前に書式設定された値を使用するには、［［出力タイプ］値］を選択します。このアクションでは、以前の任意の「データを書式設定」アクションで書式設定されたデータを使用できます。
- 新しい行が完成するまでこれを繰り返します。
- ［保存］をクリックします。
「Googleスプレッドシートの行を作成」アクションの設定が完了すると、既存のプロパティーに影響を与えることなく、以前に書式設定された値をワークフローで使用してGoogleスプレッドシートに新しい行を追加できます。ワークフローを使用してGoogleスプレッドシートにデータを追加する方法について詳しくご確認ください。
