add apps 7

全角半角コンバータご利用ガイド

HubSpot のフォームに入力された文字を、項目ごとに決めた規則で自動でそろえます。全角の英数字を半角に、半角カタカナを全角に、続いた空白を 1 つに、といった表記のゆれを入力の時点でそろえるため、コンタクトのプロパティの表記がそろい、検索や重複の確認、リストの絞り込みがしやすくなります。会社名、住所、電話番号、ふりがなの項目など、表記がばらつきやすい項目に向いています。設定ページで作ったコードを、フォームを置いたページに貼り付けるだけで使えます。

提供: 株式会社ハレフル（add apps）
料金: 無償
版: 1.1.0

設定ページを開く

できること

項目ごとに、次の変換のオン・オフを選べます

変換	例
英数字・記号を半角に	ＡＢＣ１２３＠ → ABC123@（全角スペースも半角にします）
半角カタカナを全角に	ｶﾞｲﾄﾞ → ガイド（濁点・半濁点は 1 文字にまとめます）
カタカナをひらがなに	ヤマダ → やまだ（半角カタカナも対象です。「ヵ」「ヶ」は変えません）
続く空白を半角の空白ひとつにそろえる	株式会社　　ハレフル → 株式会社ハレフル
空白をすべて消す	03 1234 5678 → 0312345678
ハイフン・長音のゆれを「-」にそろえる	03ー1234－5678 → 03-1234-5678（「コーヒー」のようなかなの長音は残します）
前後の空白を消す	「　山田　」→「山田」

入力欄から離れたときに変換し、入力欄の値を書き換えます。「次へ」「送信」を押したときにも、変換が済んでいない項目があれば変換します
変換する項目は、30 項目まで設定できます

送信は HubSpot フォームの標準のボタンで行います。送信後の動き（お礼の表示、通知、ワークフローなど）は今までどおりです。

使える条件

対象	使えるか
「フォームエディター」で作ったフォーム	使えます
「旧フォームエディター」で作ったフォーム	使えません
HubSpot のランディングページ・ウェブサイトページに置いたフォーム	使えます
HubSpot 以外のサイトに埋め込んだフォーム	使えません
フォームの共有リンク（フォームだけを開く URL）	使えません

ご注意

変換できるのは、文字を入力する項目（1 行テキスト、複数行テキスト、メールアドレス、電話番号など）です。チェックボックス、ラジオボタン、ドロップダウンなどの選んで入力する項目は変換しません
変換の順番は決まっていて、設定で選んだ順には左右されません。半角カタカナを全角にする変換と、カタカナをひらがなにする変換を先に行い、空白の変換をその後に行います。同じ値を何度変換しても、結果は変わりません
「空白をすべて消す」と「続く空白を半角の空白ひとつにそろえる」の両方をオンにしたときは、「空白をすべて消す」を優先します
空白の変換では、複数行テキストの改行はそのまま残します。ただし「前後の空白を消す」では、先頭と末尾の改行も消します
「ハイフン・長音のゆれを「-」にそろえる」では、－ − ‐ – — ― などは、いつでも「-」にします。長音「ー」は、英数字の間（例：０３ー１２３４、ＡーＢ）のときだけ「-」にし、かなの長音（コーヒー、らーめん）や、漢字の間（東京ー大阪）の長音は残します
「カタカナをひらがなに」では、「ヶ月」などで使う「ヵ」「ヶ」と、ひらがなにない「ヷ」「ヸ」「ヹ」「ヺ」は変えません
送信が終わったあとは、変換しません
入力内容を外部に送ることはありません。変換は、ご覧になっているブラウザの中だけで行います
「フォームの確認画面」（add apps 1）などほかの add apps と一緒に使えます
お使いのテーマ・テンプレートはそのまま使えます。ただし、テーマが独自の JavaScript でフォームの見た目や動きを大きく作り変えている場合は、正しく動かないことがあります
同じフォームに、同じ add apps を 2 つ以上入れないでください（コードを 2 回貼り付ける、HubSpot のテンプレートマーケットプレイス版のモジュールと一緒に使うなど）。二重に動きます

導入の手順

STEP 1

フォームを準備する

HubSpot でフォームの編集画面を開き、変換したい項目がフォームに置かれていることを確認します
フォームを公開します

STEP 2

設定ページでコードを作る

設定ページを開きます
HubSpot でフォームを開いたときの、ブラウザのアドレス欄の URL（https://app.hubspot.com/forms/… または https://app.hubspot.com/submissions/… で始まるもの）を貼り付け、「読み取る」を押します
「フォームの確認」を確かめます。「要対応」が出た場合は、表示された案内に沿ってフォームや設定を直してください。フォームを読み取れない場合も、項目を入力すればコードを作れます（項目がフォームにあるかは確認できません）

変換する項目を 1 つずつ追加し、項目ごとに変換のオン・オフを選びます。項目は、フォームに表示される項目名か、プロパティの内部名のどちらかを書きます。フォームを読み取ると、入力欄でフォームの項目から選べます

設定欄	内容
項目	変換する項目です（例：`company`）。30 項目まで追加できます
英数字・記号を半角に	初期の設定はオンです
半角カタカナを全角に	初期の設定はオンです
カタカナをひらがなに	ふりがなの項目向けです。初期の設定はオフです
続く空白を半角の空白ひとつにそろえる	初期の設定はオンです
空白をすべて消す	電話番号・郵便番号などの項目向けです。初期の設定はオフです
ハイフン・長音のゆれを「-」にそろえる	電話番号などの項目向けです。初期の設定はオフです
前後の空白を消す	初期の設定はオンです
動作の記録	ブラウザの開発者ツールに出す記録の詳しさです（警告だけ／主な動作／くわしく）

「コードをコピー」を押します

STEP 3

ページに貼り付ける

HubSpot で、フォームを置いたページの編集画面を開きます
「設定」→「詳細」→「HeadのHTML」に、コピーしたコードを貼り付けます。コードは長くなりますが、途中で切らずに全部を貼り付けてください。ほかの add apps と一緒に使う場合は、それぞれのコードを貼り付けます
ページを更新（公開）します
公開したページで、次のことを確かめます
- 項目に全角の英数字などを入力し、入力欄から離れると、設定どおりに変換されること
- 送信すると、変換した値がコンタクトのプロパティに保存されること

設定を変えた、項目を変えた場合は

変換する項目や規則を変えるとき、フォームの項目を変えたときは、設定ページでコードを作り直し、「HeadのHTML」のコードを貼り替えてください。add apps の新しい版も、作り直したコードに含まれます。

困ったとき

変換されない

変換する項目がフォームに置かれているか、文字を入力する項目か、フォームが「フォームエディター」（「旧フォームエディター」ではない方）で作られているかを確認してください
設定ページで、項目と変換の規則が正しく設定されているかを確認してください。変換を 1 つもオンにしていない行や、同じ項目を入れた行が 2 つ以上あるときは、設定ページはコードを作らずに直し方を表示します
変換は、入力欄から離れたとき、または「次へ」「送信」を押したときに行います。入力している間は変換しません
コードが途中で切れずに全部貼り付けられているか、ページを更新（公開）したかを確認してください
フォームの項目を差し替えた場合は、設定ページでコードを作り直してください

動作の記録を見る

ページの URL の末尾に ?kp_debug=1 を付けて開くと（すでに ? がある場合は &kp_debug=1）、ページの下部に動作の記録が表示されます。お問い合わせの際は、この記録を添えてください。

ご利用にあたって

無償・無保証で提供しています
HubSpot の仕様変更により、動かなくなる場合があります
本ツールの利用により生じた損害について、当社は責任を負いません