Microsoft Dataverse¶

import "github.com/jhonsferg/traverse/ext/dataverse"

client, err := dataverse.New(dataverse.Config{
    OrgURL: "https://myorg.api.crm.dynamics.com",
    BearerToken: func() (string, error) {
        return getTokenFromAAD() // your token acquisition logic
    },
})
if err != nil {
    log.Fatal(err)
}

// Build the entity URL and issue a request.
req, _ := http.NewRequestWithContext(ctx, http.MethodGet,
    client.ServiceURL()+"accounts?$select=name,accountid", nil)

resp, err := client.Do(req)

type Config struct {
    // OrgURL is the Dataverse organisation URL, e.g. https://myorg.api.crm.dynamics.com
    OrgURL string

    // APIVersion is the Dataverse Web API version. Defaults to "9.2".
    APIVersion string

    // BearerToken is called before each request to supply an OAuth2 access token.
    // If nil, requests are sent without an Authorization header.
    BearerToken func() (string, error)

    // CallerID optionally impersonates a user by their system user GUID.
    // Sets the MSCRMCallerID request header.
    CallerID string

    // MaxPageSize sets the Prefer: odata.maxpagesize header. Defaults to 100.
    MaxPageSize int
}

type Client struct { /* unexported */ }

func New(cfg Config) (*Client, error)

func (c *Client) ServiceURL() string

func (c *Client) Do(req *http.Request) (*http.Response, error)

func Select(fields ...string) QueryOption
func Filter(expr string) QueryOption
func OrderBy(field string, desc bool) QueryOption
func Top(n int) QueryOption
func Skip(n int) QueryOption
func Expand(nav string) QueryOption

params := url.Values{}
dataverse.Select("name", "accountid")(params)
dataverse.Filter("statecode eq 0")(params)
url := client.ServiceURL() + "accounts?" + params.Encode()