Dynamics 365 for Sales取引先企業エンティティに郵便番号から住所検索を実装する

2020年4月25日

Dynamics 365 for Sales取引先企業エンティティに郵便番号から住所検索を実装する

グローバル製品なので、郵便番号から住所検索は実装されていません。
なので、今回取引先企業エンティティにて、郵便番号を入力したら自動的に住所を表示させる機能を追加してみます
Dynamics365を初めてまだ2週間もたっていないので間違っているところがあってら指摘してもらえると嬉しいです！

この記事ではzipcloudさんを利用させてもらい実装しています

メインフォームのフィールドを変更する

Dynamics365のアプリを何か開きます（営業ハブとか）
歯車アイコン→【詳細設定】をクリックします
（次の画面に遷移するまでちょっと時間かかります・・・）
「設定」→【カスタマイズ】をクリックします
【システムのカスタマイズ】をクリックします
この画面が表示されますが、まだ遷移できない画面がある（？）ようなので【キャンセル】をクリックして、
クラシック表示のまま利用します。
「エンティティ」を展開し、【取引先企業】を選択します
「フォーム」→【取引先企業】をクリックします
フィールドエクスプローラーから「住所１：郵便番号」を住所欄にドラッグ＆ドロップします
これを複数回繰り返し、下記の状態にします
【保存】をクリックしたあと、【公開】をクリックします
取引先企業フォームを開き、変更したフィールドが反映されているかを確認します

スクリプトファイルを用意する

下記のようなスクリプトを用意します。
エラー処理が何もないのと、複数結果があったとしても最初の1件を表示させますが、そのあたりはお好みで修正してください
（というより誰かもっといいもの作ってファイルください（笑））
Xrm.Pageは廃止予定とのことなので、executionContextを利用しています

function onChangeZipcode(executionContext) {
    var formContext = executionContext.getFormContext();
    var zipcode = formContext.getAttribute("address1_postalcode").getValue();

    $.ajax({
        url:"https://zipcloud.ibsnet.co.jp/api/search?&callback=?",
        type:"GET",
        data:{zipcode : zipcode},
        dataType:"json",
        async:false,
        crossDomain:true,
        success:function(data){
            pref = data.results[0].address1;
            city = data.results[0].address2;
            line1 = data.results[0].address3;
            formContext.getAttribute("address1_stateorprovince").setValue(pref);
　　　　formContext.getAttribute("address1_city").setValue(city);
　　　　formContext.getAttribute("address1_line1").setValue(line1);
        }
    })

}

スクリプトファイルをフォームに追加する

jQueryをダウンロードしてきます
上記と同じように「システムカのスタマイズ」から取引先企業エンティティを開き、取引先企業フォームを開きます
【フォームのプロパティ】をクリックします
「フォームライブラリ」の【追加】をクリックします
【新規】をクリックします

下記のように設定し、【上書き保存】をクリックします

名前	わかりやすい名前(jQuery等）
コンテンツ
種類	スクリプト(JScript)
言語	日本語
ファイルのアップロード	ダウンロードしたJQueryファイルを選択