创建dynamics CRM client-side (十四) - Web API

Xrm.WebApi 是我们做前端开发不可不缺少的内容。

Xrm.WebApi 分为online和offline

online：

可以实现和服务器的CRUD交互

offline：

多用于mobile client

微软的Xrm.WebApi 官方资料：https://docs.microsoft.com/en-us/powerapps/developer/model-driven-apps/clientapi/reference/xrm-webapi

Create：

create来说其实很简单，我们可以把data pass进去之后直接创建。

var data =
            {
                "firstname": "Sample Account",
                "lastname": "Web API",
            }
            // create account record
            parent.Xrm.WebApi.createRecord("contact", data).then(
                function success(result) {
                    document.getElementById("text").innerHTML = result.id;

                    // perform operations on record creation
                },
                function (error) {
                    console.log(error.message);
                    document.getElementById("text").innerHTML = error.message;
                    // handle error conditions
                }
            );

Retrieve：

可以用retrieve来获取数据， 我们可以筛选不同的数据

parent.Xrm.WebApi.retrieveMultipleRecords("contacts", "?$select=fullname,emailaddress1$filter=firstname eq 'Chris')", 3).then(
                function success(result) {

                    for (var i = 0; i < result.entities.length; i++) {
                        console.log(result.entities[i]);
                    }
                    // perform additional operations on retrieved records
                },
                function (error) {
                    console.log(error.message);
                    // handle error conditions
                }
            );

获取多条数据

parent.Xrm.WebApi.retrieveMultipleRecords("contacts", "?$select=fullname,emailaddress1$filter=firstname eq 'Chris')", 3).then(
                function success(result) {

                    for (var i = 0; i < result.entities.length; i++) {
                        console.log(result.entities[i]);
                    }
                    // perform additional operations on retrieved records
                },
                function (error) {
                    console.log(error.message);
                    // handle error conditions
                }
            );

select 是指选择指定的数据

filter 是添加筛选条件。

Query Data using the Web API 的使用说明

https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/webapi/query-data-web-api

ps:里面包括select, filter等筛选使用说明.

我们也可以直接在browser里面查看数据信息。

https://xxx.crm5.dynamics.com/api/data/v9.0/contacts?$select=fullname,emailaddress1$filter=emailaddress1 eq 'usernamd@email.com'