JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 34
  • Score
    100M100P100Q64339F
  • License MIT

Javasript Software Development Kit for Microsoft Dynamics CRM Web API

Package Exports

  • crm-sdk

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (crm-sdk) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CRM-SDK

npm npm npm

Javascript Software Development Kit for Dynamics CRM Web API.

Why another library

There are several SDK's available, so why another one?

  • This library does paging for you (using @odata-nextLink to do multiple requests)
  • This library always finds correct entitySetName (which is not always: LogicalName + 's')
  • This library is promise based
  • This library supports modules
  • This library supports default WebAPI like other libraries, but also
  • This library supports extra Entity abstraction
  • This library supports annotations
  • This library supports getting OptionSet
  • This library supports Webresource uploading/publishing
  • This library supports Translation

Table of contents

Install

Install with Npm

$ npm install crm-sdk

Modules

//app.js
import {WebAPI} from "crm-sdk";

WebAPI.retrieveEntity("account", "475b158c-541c-e511-80d3-3863bb347ba8").then(function (data) {
    //todo logic here
});

Require

//app.js
var CRMSDK = require("crm-sdk"); //umd
var WebAPI = CRMSDK.WebAPI;

WebAPI.retrieveEntity("account", "475b158c-541c-e511-80d3-3863bb347ba8").then(function (data) {
    //todo logic here
});

Install via download

Download latest release and put reference to dist/CRMSDK.js in your index.html.

In example below, the app.js is your own application code. If you only need CRMSDK.WebAPI, you can include WebAPI.js in index.html instead of CRMSDK.js.

<html>
<body>
    <script type="text/javascript" src="CRMSDK.js"/>
    <script type="text/javascript" src="app.js"/>
</body>
</html>

In app.js, The WebAPI will be available on window.CRMSDK scope. Example for using WebAPI below:

//app.js
var WebAPI = window.CRMSDK.WebAPI;

WebAPI.retrieveEntity("account", "475b158c-541c-e511-80d3-3863bb347ba8").then(function (data) {
    //todo logic here 
});

WebAPI example

Index.html

<html>
<body>
    <script type="text/javascript" src="WebAPI.js"/>
    <script type="text/javascript" src="app.js"/>
</body>
</html>

app.js

    WebAPI.retrieveEntity("account", "475b158c-541c-e511-80d3-3863bb347ba8")
    .then(function (accountData) {
        WebAPI.updateEntity("account", accountData.accountid, {
            emailaddress1: "test2@company.com"
        }).then(function (data) {
            console.log("saved " + data.accountid);
        });
    });

Entity abstraction example

Index.html

<html>
<body>
    <script type="text/javascript" src="CRMSDK.js"/>
    <script type="text/javascript" src="app.js"/>
</body>
</html>

app.js

    var WebAPI = CRMSDK.WebAPI;
    var Entity = CRMSDK.Entity;

    Entity.get("account", "475b158c-541c-e511-80d3-3863bb347ba8")
    .then(function (account) {
        account.emailaddress1 = "test2@company.com";
        account.save().then(function () {
            console.log("saved! " + account.accountid);
        });
    });

Code and documentation copyright 2011-2017 Dynamics Software. Code released under the MIT License.