AACFlow

Microsoft Dataverse

Datensätze in Microsoft Dataverse-Tabellen verwalten

Microsoft Dataverse is a powerful cloud data platform for securely storing, managing, and interacting with structured business data. The Microsoft Dataverse integration enables you to programmatically create, read, update, delete, and link records in Dataverse tables as part of your workflow and automation needs.

With Microsoft Dataverse integration, you can:

  • List and query records: Access lists of records or query with advanced filters to find the data you need from any Dataverse table.
  • Create and update records: Add new records or update existing ones in any table for use across Power Platform, Dynamics 365, and custom apps.
  • Delete and manage records: Remove records as part of data lifecycle management directly from your automation flows.
  • Associate and disassociate records: Link related items together or remove associations using entity relationships and navigation properties—essential for reflecting complex business processes.
  • Work with any Dataverse environment: Connect to your organization’s environments, including production, sandbox, or Dynamics 365 tenants, for maximum flexibility.
  • Integrate with Power Platform and Dynamics 365: Automate tasks ranging from sales and marketing data updates to custom app workflows—all powered by Dataverse's security and governance.

The Dataverse integration empowers solution builders and business users to automate business processes, maintain accurate and up-to-date information, create system integrations, trigger actions, and drive insights—all with robust security and governance.

Connect Microsoft Dataverse to your automations to unlock sophisticated data management, orchestration, and business logic across your apps, teams, and cloud services.

Nutzungsanleitung

Integrate Microsoft Dataverse into your workflow. Create, read, update, delete, upsert, associate, query, search, and execute actions and functions against Dataverse tables using the Web API. Supports bulk operations, FetchXML, file uploads, and relevance search. Works with Dynamics 365, Power Platform, and custom Dataverse environments.

Tools

microsoft_dataverse_associate

Associate two records in Microsoft Dataverse via a navigation property. Creates a relationship between a source record and a target record. Supports both collection-valued (POST) and single-valued (PUT) navigation properties.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaSource entity set name (e.g., accounts)
recordIdstringJaSource record GUID
navigationPropertystringJaNavigation property name (e.g., contact_customer_accounts for collection-valued, or parentcustomerid_account for single-valued)
targetEntitySetNamestringJaTarget entity set name (e.g., contacts)
targetRecordIdstringJaTarget record GUID to associate
navigationTypestringNeinType of navigation property: "collection" (default, uses POST) or "single" (uses PUT for lookup fields)

Ausgabe

ParameterTypBeschreibung
successbooleanWhether the association was created successfully
entitySetNamestringSource entity set name used in the association
recordIdstringSource record GUID that was associated
navigationPropertystringNavigation property used for the association
targetEntitySetNamestringTarget entity set name used in the association
targetRecordIdstringTarget record GUID that was associated

microsoft_dataverse_create_multiple

Create multiple records of the same table type in a single request. Each record in the Targets array must include an @odata.type annotation. Recommended batch size: 100-1000 records for standard tables.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
entityLogicalNamestringJaTable logical name for @odata.type annotation (e.g., account, contact). Used to set Microsoft.Dynamics.CRM.{entityLogicalName} on each record.
recordsobjectJaArray of record objects to create. Each record should contain column logical names as keys. The @odata.type annotation is added automatically.

Ausgabe

ParameterTypBeschreibung
idsarrayArray of GUIDs for the created records
countnumberNumber of records created
successbooleanWhether all records were created successfully

microsoft_dataverse_create_record

Create a new record in a Microsoft Dataverse table. Requires the entity set name (plural table name) and record data as a JSON object.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
dataobjectJaRecord data as a JSON object with column names as keys

Ausgabe

ParameterTypBeschreibung
recordIdstringThe ID of the created record
recordobjectDataverse record object. Contains dynamic columns based on the queried table, plus OData metadata fields.
successbooleanWhether the record was created successfully

microsoft_dataverse_delete_record

Delete a record from a Microsoft Dataverse table by its ID.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
recordIdstringJaThe unique identifier (GUID) of the record to delete

Ausgabe

ParameterTypBeschreibung
recordIdstringThe ID of the deleted record
successbooleanOperation success status

microsoft_dataverse_disassociate

Remove an association between two records in Microsoft Dataverse. For collection-valued navigation properties, provide the target record ID. For single-valued navigation properties, only the navigation property name is needed.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaSource entity set name (e.g., accounts)
recordIdstringJaSource record GUID
navigationPropertystringJaNavigation property name (e.g., contact_customer_accounts for collection-valued, or parentcustomerid_account for single-valued)
targetRecordIdstringNeinTarget record GUID (required for collection-valued navigation properties, omit for single-valued)

Ausgabe

ParameterTypBeschreibung
successbooleanWhether the disassociation was completed successfully
entitySetNamestringSource entity set name used in the disassociation
recordIdstringSource record GUID that was disassociated
navigationPropertystringNavigation property used for the disassociation
targetRecordIdstringTarget record GUID that was disassociated

microsoft_dataverse_download_file

Download a file from a file or image column on a Dataverse record. Returns the file content as a base64-encoded string along with file metadata from response headers.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
recordIdstringJaRecord GUID to download the file from
fileColumnstringJaFile or image column logical name (e.g., entityimage, cr_document)

Ausgabe

ParameterTypBeschreibung
fileContentstringBase64-encoded file content
fileNamestringName of the downloaded file
fileSizenumberFile size in bytes
mimeTypestringMIME type of the file
successbooleanWhether the file was downloaded successfully

microsoft_dataverse_execute_action

Execute a bound or unbound Dataverse action. Actions perform operations with side effects (e.g., Merge, GrantAccess, SendEmail, QualifyLead). For bound actions, provide the entity set name and record ID.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
actionNamestringJaAction name (e.g., Merge, GrantAccess, SendEmail). Do not include the Microsoft.Dynamics.CRM. namespace prefix for unbound actions.
entitySetNamestringNeinEntity set name for bound actions (e.g., accounts). Leave empty for unbound actions.
recordIdstringNeinRecord GUID for bound actions. Leave empty for unbound or collection-bound actions.
parametersobjectNeinAction parameters as a JSON object. For entity references, include @odata.type annotation (e.g., {"Target": {"@odata.type": "Microsoft.Dynamics.CRM.account", "accountid": "..."}})

Ausgabe

ParameterTypBeschreibung
resultobjectAction response data. Structure varies by action. Null for actions that return 204 No Content.
successbooleanWhether the action executed successfully

microsoft_dataverse_execute_function

Execute a bound or unbound Dataverse function. Functions are read-only operations (e.g., RetrievePrincipalAccess, RetrieveTotalRecordCount, InitializeFrom). For bound functions, provide the entity set name and record ID.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
functionNamestringJaFunction name (e.g., RetrievePrincipalAccess, RetrieveTotalRecordCount). Do not include the Microsoft.Dynamics.CRM. namespace prefix for unbound functions.
entitySetNamestringNeinEntity set name for bound functions (e.g., systemusers). Leave empty for unbound functions.
recordIdstringNeinRecord GUID for bound functions. Leave empty for unbound functions.
parametersstringNeinFunction parameters as a comma-separated list of name=value pairs for the URL (e.g., "LocalizedStandardName='Pacific Standard Time\

Ausgabe

ParameterTypBeschreibung
resultobjectFunction response data. Structure varies by function.
successbooleanWhether the function executed successfully

microsoft_dataverse_fetchxml_query

Execute a FetchXML query against a Microsoft Dataverse table. FetchXML supports aggregation, grouping, linked-entity joins, and complex filtering beyond OData capabilities.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
fetchXmlstringJaFetchXML query string. Must include <fetch> root element and <entity> child element matching the table logical name.

Ausgabe

ParameterTypBeschreibung
recordsarrayArray of Dataverse records. Each record has dynamic columns based on the table schema.
countnumberNumber of records returned in the current page
fetchXmlPagingCookiestringPaging cookie for retrieving the next page of results
moreRecordsbooleanWhether more records are available beyond the current page
successbooleanOperation success status

microsoft_dataverse_get_record

Retrieve a single record from a Microsoft Dataverse table by its ID. Supports $select and $expand OData query options.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
recordIdstringJaThe unique identifier (GUID) of the record to retrieve
selectstringNeinComma-separated list of columns to return (OData $select)
expandstringNeinNavigation properties to expand (OData $expand)

Ausgabe

ParameterTypBeschreibung
recordobjectDataverse record object. Contains dynamic columns based on the queried table, plus OData metadata fields.
recordIdstringThe record primary key ID (auto-detected from response)
successbooleanWhether the record was retrieved successfully

microsoft_dataverse_list_records

Query and list records from a Microsoft Dataverse table. Supports OData query options for filtering, selecting columns, ordering, and pagination.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
selectstringNeinComma-separated list of columns to return (OData $select)
filterstringNeinOData $filter expression (e.g., statecode eq 0)
orderBystringNeinOData $orderby expression (e.g., name asc, createdon desc)
topnumberNeinMaximum number of records to return (OData $top)
expandstringNeinNavigation properties to expand (OData $expand)
countstringNeinSet to "true" to include total record count in response (OData $count)

Ausgabe

ParameterTypBeschreibung
recordsarrayArray of Dataverse records. Each record has dynamic columns based on the table schema.
countnumberNumber of records returned in the current page
totalCountnumberTotal number of matching records server-side (requires $count=true)
nextLinkstringURL for the next page of results
successbooleanOperation success status

Perform a full-text relevance search across Microsoft Dataverse tables. Requires Dataverse Search to be enabled on the environment. Supports simple and Lucene query syntax.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
searchTermstringJaSearch text (1-100 chars). Supports simple syntax: + (AND), | (OR), - (NOT), * (wildcard), "exact phrase"
entitiesstringNeinJSON array of search entity configs. Each object: {"Name":"account","SelectColumns":["name"],"SearchColumns":["name"],"Filter":"statecode eq 0"}
filterstringNeinGlobal OData filter applied across all entities (e.g., "createdon gt 2024-01-01")
facetsstringNeinJSON array of facet specifications (e.g., ["entityname,count:100","ownerid,count:100"])
topnumberNeinMaximum number of results (default: 50, max: 100)
skipnumberNeinNumber of results to skip for pagination
orderBystringNeinJSON array of sort expressions (e.g., ["createdon desc"])
searchModestringNeinSearch mode: "any" (default, match any term) or "all" (match all terms)
searchTypestringNeinQuery type: "simple" (default) or "lucene" (enables regex, fuzzy, proximity, boosting)

Ausgabe

ParameterTypBeschreibung
resultsarrayArray of search result objects
IdstringRecord GUID
EntityNamestringTable logical name (e.g., account, contact)
ObjectTypeCodenumberEntity type code
AttributesobjectRecord attributes matching the search. Keys are column logical names.
HighlightsobjectHighlighted search matches. Keys are column names, values are arrays of strings with {crmhit}/{/crmhit} markers.
ScorenumberRelevance score for this result
totalCountnumberTotal number of matching records across all tables
countnumberNumber of results returned in this page
facetsobjectFacet results when facets were requested. Keys are facet names, values are arrays of facet value objects with count and value properties.
successbooleanOperation success status

microsoft_dataverse_update_multiple

Update multiple records of the same table type in a single request. Each record must include its primary key. Only include columns that need to be changed. Recommended batch size: 100-1000 records.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
entityLogicalNamestringJaTable logical name for @odata.type annotation (e.g., account, contact). Used to set Microsoft.Dynamics.CRM.{entityLogicalName} on each record.
recordsobjectJaArray of record objects to update. Each record must include its primary key (e.g., accountid) and only the columns being changed. The @odata.type annotation is added automatically.

Ausgabe

ParameterTypBeschreibung
successbooleanWhether all records were updated successfully

microsoft_dataverse_update_record

Update an existing record in a Microsoft Dataverse table. Only send the columns you want to change.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
recordIdstringJaThe unique identifier (GUID) of the record to update
dataobjectJaRecord data to update as a JSON object with column names as keys

Ausgabe

ParameterTypBeschreibung
recordIdstringThe ID of the updated record
successbooleanOperation success status

microsoft_dataverse_upload_file

Upload a file to a file or image column on a Dataverse record. Supports single-request upload for files up to 128 MB. The file content must be provided as a base64-encoded string.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
recordIdstringJaRecord GUID to upload the file to
fileColumnstringJaFile or image column logical name (e.g., entityimage, cr_document)
fileNamestringJaName of the file being uploaded (e.g., document.pdf)
filefileNeinFile to upload (UserFile object)
fileContentstringNeinBase64-encoded file content (legacy)

Ausgabe

ParameterTypBeschreibung
recordIdstringRecord GUID the file was uploaded to
fileColumnstringFile column the file was uploaded to
fileNamestringName of the uploaded file
successbooleanWhether the file was uploaded successfully

microsoft_dataverse_upsert_record

Create or update a record in a Microsoft Dataverse table. If a record with the given ID exists, it is updated; otherwise, a new record is created.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)
entitySetNamestringJaEntity set name (plural table name, e.g., accounts, contacts)
recordIdstringJaThe unique identifier (GUID) of the record to upsert
dataobjectJaRecord data as a JSON object with column names as keys

Ausgabe

ParameterTypBeschreibung
recordIdstringThe ID of the upserted record
createdbooleanTrue if the record was created, false if updated
recordobjectDataverse record object. Contains dynamic columns based on the queried table, plus OData metadata fields.
successbooleanOperation success status

microsoft_dataverse_whoami

Retrieve the current authenticated user information from Microsoft Dataverse. Useful for testing connectivity and getting the user ID, business unit ID, and organization ID.

Eingabe

ParameterTypErforderlichBeschreibung
environmentUrlstringJaDataverse environment URL (e.g., https://myorg.crm.dynamics.com\)

Ausgabe

ParameterTypBeschreibung
userIdstringThe authenticated user ID
businessUnitIdstringThe business unit ID
organizationIdstringThe organization ID
successbooleanOperation success status

On this page

Heute mit dem Aufbau beginnen
Über 100 000 Entwickler vertrauen uns.
Die SaaS-Plattform zum Aufbau von KI-Agenten und für Ihre agentische Belegschaft.
Loslegen