Struct DataverseClient 

pub struct DataverseClient { /* private fields */ }

HTTP client for the Dataverse OData Web API.

Provides methods for:

• Initial change tracking requests (equivalent to RetrieveEntityChangesRequest without DataVersion)
• Delta polling (equivalent to RetrieveEntityChangesRequest with DataVersion)
• Standard data retrieval for bootstrap

Implementations

impl DataverseClient

pub fn new( environment_url: &str, api_version: &str, identity_provider: Arc<dyn IdentityProvider>, ) -> Self

Create a new Dataverse client.

Arguments

• environment_url - Dataverse environment URL (e.g., https://myorg.crm.dynamics.com)
• api_version - Web API version (e.g., v9.2)
• identity_provider - Identity provider for authentication

pub async fn initial_change_tracking( &self, entity_set_name: &str, select: Option<&str>, ) -> Result<ODataDeltaResponse>

Perform an initial change tracking request for an entity.

This is the Web API equivalent of executing RetrieveEntityChangesRequest without a DataVersion – it returns all current records plus an initial delta token for subsequent change tracking.

Equivalent to the platform’s GetCurrentDeltaToken() method which pages through all initial data.

Arguments

• entity_set_name - The entity set name (plural, e.g., accounts)
• select - Optional $select clause for column filtering

pub async fn follow_delta_link( &self, delta_link: &str, ) -> Result<ODataDeltaResponse>

Follow a delta link to poll for changes.

This is the Web API equivalent of executing RetrieveEntityChangesRequest with DataVersion set to a previously obtained delta token.

Maps directly to the platform’s GetChanges(deltaToken) method.

Arguments

• delta_link - The delta link URL from a previous response

pub async fn follow_next_link( &self, next_link: &str, ) -> Result<ODataDeltaResponse>

Follow a next link for pagination within a response.

Equivalent to following the platform’s PagingCookie for additional pages.

Arguments

• next_link - The next link URL from the current page

pub async fn get_entity_data( &self, entity_set_name: &str, select: Option<&str>, ) -> Result<ODataDeltaResponse>

Retrieve all records from an entity (for bootstrap).

Sends a standard GET request without change tracking headers. Used by the bootstrap provider to load initial data.

Arguments

• entity_set_name - The entity set name (plural, e.g., accounts)
• select - Optional $select clause for column filtering

pub fn base_url(&self) -> &str

Get the base URL for this client.

pub fn api_version(&self) -> &str

Get the API version.