【Dynamics】javascriptで業務プロセスを進める

javascriptで業務プロセスを進めたり、戻したりするメソッドがあったので使い方のメモ

var ProcessScriptSample = (function () {
    return {
        // 進める
        Next: function () {
            parent.Xrm.Page.data.process.moveNext(function (result) {
                Xrm.Utility.alertDialog(result);
            });
        },
        // 戻す
        Prev: function () {
            parent.Xrm.Page.data.process.movePrevious(function (result) {
                Xrm.Utility.alertDialog(result);
            });
        }
    };
})();

イメージは以下。
プロセス移動前

Nextボタン押下でプロセス移動後

今回はボタン押下をトリガーにプロセスのステージを移動させましたが、
フォームの保存時に特定の項目に値が入力させたらプロセスを自動的に次のステージに移動することなどが実装可能です。

【C#】xmlを読み込んでオブジェクトへ変換する －デシリアライズ－

Dynamics365のビュー定義が格納されているSavedQueryエンティティ。
このエンティティからビューの定義をExcelに出力したいと思い、その中でビューの定義情報を格納するfetchxmlとlayoutxmlをオブジェクト化する方法を調べたのでメモ。

今回はXmlSerializerクラスのDeserializeメソッドを使用しました。
https://msdn.microsoft.com/ja-jp/library/tz8csy73%28v=vs.110%29.aspx?f=255&MSPPError=-2147217396

読み込んだXMLを格納するオブジェクト

    [System.Xml.Serialization.XmlRoot("grid")]
    public class ViewLayoutXmlInfo
    {
        [System.Xml.Serialization.XmlArray("row")]
        [System.Xml.Serialization.XmlArrayItem("cell")]
        public List<ViewLayoutXmlCell> Cells { get; set; }

        public class ViewLayoutXmlCell
        {
            [System.Xml.Serialization.XmlAttribute("name")]
            public string Name { get; set; }

            [System.Xml.Serialization.XmlAttribute("width")]
            public string Width { get; set; }

            [System.Xml.Serialization.XmlAttribute("imageproviderwebresource")]
            public string ImageProviderWebresource { get; set; }

            [System.Xml.Serialization.XmlAttribute("imageproviderfunctionname")]
            public string ImageProviderFunctionname { get; set; }
        }
    }

読み込むXMLのサンプル(実際はSavedQueryエンティティを検索して取得します)

<grid name="resultset" object="1" jump="name" select="1" icon="1" preview="1">
    <row name="result" id="accountid">
        <cell name="name" width="300" />
        <cell name="primarycontactid" width="150" />
        <cell name="telephone1" width="100" />
    </row>
</grid>

 // LayoutXmlの読み込み
var xmlReader = XmlUtil.CreateXmlReader(layoutXml);

XmlSerializer serializer = new XmlSerializer(typeof(ViewLayoutXmlInfo));

ViewLayoutXmlInfo layoutXmlRowInfo = (ViewLayoutXmlInfo)serializer.Deserialize(xmlReader);

【C#】C#プログラムでExcelを出力する

C#プログラムからExcelを出力する方法について少し調べたのでメモ

Microsoft.Office.Interop.Excelライブラリを使用する方法
→Excelをインストールしていないと使用できないのとオブジェクトの解放を意識する必要がある。

ClosdeXmlを使用する方法
→Microsoft Open XMLを使用したオープンソース。Excelのインストールは不要

今回はClosedXmlを使用してDynamicsのエンティティのリストをExcelを出力してみました。

public void ExportEntityList()
{
    // エンティティメタデータ取得
    var entityMetadatas = _crmsrv.GetAllEntityMetadata();

    XLWorkbook workbook = new XLWorkbook();

    IXLWorksheet ws = workbook.AddWorksheet("sample");

    // エンティティの表示名と論理名をオブジェクトとして設定
    ws.Cell(1, 1).Value = entityMetadatas
        .OrderBy(entity => entity.LogicalName)
        .Select(entityMetadata => new
        {
            DisplayName = (entityMetadata.DisplayName != null && entityMetadata.DisplayName.UserLocalizedLabel != null)
                            ? entityMetadata.DisplayName.UserLocalizedLabel.Label + "(" + entityMetadata.LogicalName + ")" : entityMetadata.LogicalName,
            LogicalName =  entityMetadata.LogicalName
        }).ToList();

    workbook.SaveAs("sample.xlsx");
}

実行結果イメージは以下。オブジェクトのリストを渡すだけで簡単に一覧の出力が可能でした。

以上です。

【Dynamics】【XrmTooling】XrmToolingを使用してEntityMetadataをすべて取得

XrmToolingを使用してEntityMetadataを取得する方法のメモ。

エンティティのメタデータを取得するには以下１行で取得可能(全エンティティ分取得)

// _crmsrvはCrmServiceClientオブジェクト
_crmsrv.GetAllEntityMetadata();

その他のメソッドについてはMSDNを参考に
CrmServiceClient のメソッド (Microsoft.Xrm.Tooling.Connector)

【Dynamics】フォームでのグラフ表示

Dynamicsではダッシュボードやビューでグラフを表示することができますが、フォームでもグラフを表示することができます。

以下、取引先企業毎の営業案件についての情報をフォームダッシュボードとして表示した際のイメージになります。

設定方法

フォームのサブグリッドを設定する際にグラフを表示するチェックボックスがあるのでそれにチェックをつけるとグラフを表示することができます。

レコード毎の情報を視覚化したい場合に使える機能だと思います。

【Dynamics】WebAPIの機能拡張 作成または更新プログラム上のリターン エンティティ データ

WebAPIでエンティティレコードを作成、更新した際に以前までは作成したレコードのGUIDのみがリターンされていました。今回のアップデートでエンティティのフィールドをリターンすることができるようになりました。

以下、MSDNのサンプルの抜粋です。
Web API を使用してエンティティを作成する

リクエストのサンプル

POST [Organization URI]/api/data/v8.2/accounts?$select=name,creditonhold,address1_latitude,description,revenue,accountcategorycode,createdon HTTP/1.1
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json
Content-Type: application/json; charset=utf-8
Prefer: return=representation

{
    "name": "Sample Account",
    "creditonhold": false,
    "address1_latitude": 47.639583,
    "description": "This is the description of the sample account",
    "revenue": 5000000,
    "accountcategorycode": 1
}

レスポンスのサンプル

{
  "@odata.context":"https://orgname.api.crm7.dynamics.com/api/data/v8.2/$metadata#accounts(name,creditonhold,address1_latitude,description,revenue,accountcategorycode,createdon)","value":[
    {
      "@odata.etag":"W/\"635745\"","name":"001","creditonhold":false,"address1_latitude":null,"description":null,"revenue":null,"accountcategorycode":null,"createdon":"2017-01-07T12:07:42Z","_transactioncurrencyid_value":"eee7fb82-6fc8-e611-80fc-c4346bc52044","accountid":"7ccb8ce3-d1d4-e611-80fd-c4346bad16b0"
    }
}

この機能を使うことでCREATEやUPDATE後に何か処理を行う場合に、取得処理を省くことができるようになりました。

追記：リターンエンティティデータを試した際のサンプルコード（備忘）

function CreateRecord(entitySetName, data) {
    return new Promise(function (resolve, reject) {
        var req = new XMLHttpRequest();
        req.open("POST","api/data/v8.2/accounts?$select=name,creditonhold,address1_latitude,description,revenue,accountcategorycode,createdon", true);
        req.setRequestHeader("Accept", "application/json");
        req.setRequestHeader("Content-Type", "application/json; charset=utf-8");
        req.setRequestHeader("OData-MaxVersion", "4.0");
        req.setRequestHeader("OData-Version", "4.0");
        req.setRequestHeader("Prefer", "return=representation");
        req.onreadystatechange = function () {
            if (this.readyState == 4 /* complete */) {
                req.onreadystatechange = null;
                if (this.status == 201) {
                    console.log("JSON.parse:", JSON.parse(this.responseText));
                    resolve(JSON.parse(this.responseText));
                }
                else {
                    reject(Common.WebAPI.ErrorHandler(req.response));
                }
            }
        };
        req.send(JSON.stringify(data));
});

【Dynamics】新機能 ネイティブのデバイス機能 (Dynamics 365 モバイル クライアント)

新機能でネイティブのデバイス機能を利用することができるようになっていたので使ってみました。ネイティブのデバイス機能と言われてもピンときませんが、内容としてはバーコードの読み取りと位置情報の取得が可能になっているとのことです。

以下、参考のMSDNです。
Xrm.Utility (クライアント側の参照)

バーコードのイメージ。getBarcodeValueを実行するとカメラが自動で起動します。