Share via


Context

Description

Defines the properties that specify how to execute a web service request.

Properties

Property

Type

Length

Default

Description

WorkOnBehalfOf

string

N/A

Empty

Used when the web service call should be made using the security settings for a different user than the one executing the web method. The property should be set to the other user's logon name in the form: DOMAIN\USERNAME

or COMPUTERNAME\USERNAME

If the web service is not being called on behalf of another user, this property should be left empty.

OrganizationKey

OrganizationKey

N/A

Empty

Specifies the unique identifier of the company where the operation should be executed. The web service will determine the appropriate company database to use.

A null value for OrganizationKey will represent the system database. (In Microsoft Dynamics GP this is the DYNAMICS database.)

CultureName

string

N/A

Empty

The name of the culture. For a list of valid CultureNames, see the Web Services for Microsoft Dynamics GP Programmer's Guide.

CurrencyType

CurrencyType

N/A

Transactional

This property can be specified when documents are retrieved from the Dynamics GP service. It determines whether the MoneyAmount values in the document are returned in the Local currency or in the Transactional currency. This property should be specified only for documents that support multicurrency. A CurrencyType of Local will be used for all documents that do not support multicurrency.

RoleKey

RoleKey

N/A

Empty

If supplied, the role specified will be used used to choose the policy and appropriate behavior option for the web service call.

If you don't supply a role key, the Dynamics GP web service will attempt to find a role for the user and company specified in the context object. If only one role can be found, that role will be used. If more than one role is found, or no roles are found, the default role will be used.

TenantName

String

100

Empty

If supplied, specifies the tenant for which the Microsoft Dynamics GP web service will be accessed.

If you don't supply a tenant name, and the Dynamics GP web service is deployed in a multitenant configuration, the web service will attempt to determine the correct tenant to use. If the web service cannot resolve to a single tenant, an exception will be thrown.