Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dataverse stellt eine Reihe optionaler Parameter und Anforderungsheaderwerte bereit, mit denen Sie das Verhalten einzelner Anforderungen ändern können. In diesem Artikel werden die Parameterwerte und Anforderungsheader beschrieben, die Sie verwenden können, um die gewünschten Verhaltensweisen zu erhalten.
Anmerkung
In diesem Artikel werden diese Parameter vorgestellt, aber nicht im Detail erläutert. Um die Szenarien für die Verwendung dieser Parameter vollständig zu verstehen, folgen Sie den Links für weitere Informationen.
Verwenden
Wie Sie diese optionalen Parameter verwenden, hängt davon ab, ob Sie das SDK für .NET oder die Web-API von Dataverse verwenden.
In der Regel fügen Sie den Parameter zur OrganizationRequest.Parameters-Auflistung der benannten Request-Klasse hinzu.
Anmerkung
Sie können diese Parameter nicht angeben, indem Sie die sieben Shortcutmethoden verwenden, die von IOrganizationService bereitgestellt werden. Sie müssen den benannten Anforderungstyp mit der IOrganizationService.Execute-Methode verwenden.
Eine Ausnahme besteht beim Festlegen von partitionid. Legen Sie partitionid als Attribut der Entitätsinstanz fest. Weitere Informationen finden Sie unter: Ausführen eines Datenvorgangs mit der angegebenen Partition
Weitere Informationen:
- Nachrichten mit dem SDK für .NET verwenden
- Siehe die folgenden Beispiele
Eine Lösungskomponente einer Lösung zuordnen
Wenn Sie Datenvorgänge für eine Lösungskomponente ausführen, können Sie sie einer Lösung zuordnen, indem Sie den eindeutigen Namen der Lösung im Parameter SolutionUniqueName angeben.
Sie können diesen Parameter mit diesen Nachrichten verwenden:
AddPrivilegesRoleCopySystemForm-
Create(POST) -
Delete(LÖSCHEN) MakeAvailableToOrganizationTemplateRemovePrivilegeRoleReplacePrivilegesRole-
Update(PATCH) Upsert
Der Vorgang gibt einen Fehler zurück, wenn der Wert SolutionUniqueName ist:
- Enthält ungültige Zeichen. Es sind nur Buchstaben, Ziffern und Unterstriche zulässig.
- Ist eine leere Zeichenfolge oder verwendet einen namen einer eingeschränkten Lösung.
- Stimmt mit keinem Lösungswert
UniqueNameüberein.
Wichtig
Es wird kein Fehler zurückgegeben, wenn der SolutionUniqueName Parameterwert einer verwalteten Lösung entspricht. Der -Wert wird ignoriert. Sie können einer verwalteten Lösung keine Lösungskomponente hinzufügen.
Die folgenden Beispiele erstellen eine Webressourcen-Lösungskomponente und fügen sie der Lösung mit dem eindeutigen Namen ExampleSolution hinzu.
static void CreateWebResourceInSolution(IOrganizationService service)
{
Entity webResource = new("webresource");
webResource["displayname"] = "Simple HTML web resource";
webResource["content"] = "PCFET0NUWVBFIGh0bWw+CjxodG1sPgogIDxib2R5PgogICAgPGgxPkhlbGxvIFdvcmxkPC9oMT4KICA8L2JvZHk+CjwvaHRtbD4=";
webResource["webresourcetype"] = new OptionSetValue(1);
webResource["name"] = "sample_SimpleHTMLWebResource.htm";
webResource["description"] = "An example HTML web resource";
CreateRequest request = new();
request.Target = webResource;
request["SolutionUniqueName"] = "ExampleSolution";
service.Execute(request);
}
Weitere Informationen:
Weitere Informationen:
- Erstellen Sie eine benutzerdefinierte Tabelle mit Code
- Tabellendefinitionen über die Web-API erstellen und aktualisieren
Duplikaterkennung unterdrücken
Wenn Dataverse einen Fehler zurückgeben soll, wenn ein neuer Datensatz, den Sie erstellen, oder ein Datensatz, den Sie aktualisieren, mit den duplizierten Erkennungsregeln für einen anderen Datensatz übereinstimmt, müssen Sie die Zeile mithilfe des Parameters mit einem SuppressDuplicateDetection Wert von false.
In den folgenden Beispielen wird ein Fehler zurückgegeben, wenn die folgenden Bedingungen erfüllt sind:
- Die Duplikaterkennung ist für die Umgebung aktiviert, wenn Sie einen Datensatz erstellen oder aktualisieren.
- Die
accountTabelle hat die Duplikaterkennung aktiviert. - Es wird eine Duplikaterkennungsregel veröffentlicht, die überprüft, ob der Wert des Kontos
namegenau mit einer vorhandenen Zeile übereinstimmt. - Es gibt ein vorhandenes Konto mit dem Namen
Sample Account.
static void DemonstrateSuppressDuplicateDetection(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("SuppressDuplicateDetection", false);
try
{
service.Execute(request);
}
catch (FaultException<OrganizationServiceFault> ex)
{
throw ex.Detail.ErrorCode switch
{
-2147220685 => new InvalidOperationException(ex.Detail.Message),
_ => ex,
};
}
}
Weitere Informationen:
Eine gemeinsam genutzte Variable zum Plug-In-Ausführungskontext hinzufügen
Verwenden Sie den tag-Parameter, um einen freigegebenen Variablenwert einzuschließen, der innerhalb eines Plug-Ins zugänglich ist. Diese zusätzlichen Informationen ermöglichen es einem Plug-In, Logik anzuwenden, die von der Clientanwendung abhängt.
Anmerkung
Dieser Parameter ist dafür vorgesehen, von Clientanwendungen auf einen beliebigen Wert gesetzt zu werden. Keine Microsoft-Funktion sollte erfordern, dass Sie einen bestimmten Wert in Ihrem Clientanwendungscode festlegen, um unterschiedliche Verhaltensweisen zu ermöglichen.
Verwenden Sie die IExecutionContext.SharedVariables-Auflistung, um auf den Wert in einem Plug-In zuzugreifen.
if (context.SharedVariables.ContainsKey("tag")){
string tagValue = context.SharedVariables["tag"];
}
Die folgenden Beispiele erfüllen diese Bedingung: A string value beim Erstellen eines Kontodatensatzes.
static void DemonstrateTag(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("tag", "A string value");
service.Execute(request);
}
Weitere Informationen: Freigegebene Variablen
Einen Datenvorgang mit der angegebenen Partition durchführen
Wenn Sie flexible Tabellen mit einer Partitionierungsstrategie verwenden, übergeben Sie einen eindeutigen Zeichenfolgenwert mit dem partitionid Parameter, um auf nichtrelationale Tabellendaten in einer Speicherpartition zuzugreifen.
Die folgenden Beispiele verwenden den partitionid-Wert von deviceId, wenn ein contoso_sensordata-Datensatz abgerufen wird.
private static Entity RetrieveRecord(
IOrganizationService service,
Guid contosoSensorDataId,
string deviceId,
string sessionToken)
{
EntityReference entityReference = new("contoso_sensordata", contosoSensorDataId);
RetrieveRequest request = new()
{
ColumnSet = new ColumnSet("contoso_value"),
Target = entityReference,
["partitionId"] = deviceId, //To identify the record
["SessionToken"] = sessionToken //Pass the session token for strong consistency
};
var response = (RetrieveResponse)service.Execute(request);
return response.Entity;
}
Alternativ können Sie den Wert partitionid mit dem alternativen Schlüsselformatstil verwenden.
- Erfahren Sie mehr über die Verwendung der alternativen Schlüssel mit elastischen Tabellen.
- Erfahren Sie, wie Sie eine Partitionid angeben.
Benutzerdefinierte Dataverse-Logik umgehen
Synchrone Logik gilt während der Transaktion und kann sich erheblich auf die Leistung einzelner Vorgänge auswirken. Bei Massenvorgängen kann die zusätzliche Zeit für diese einzelnen Vorgänge den Zeitaufwand erhöhen. Verwenden Sie den BypassBusinessLogicExecution-Parameter, wenn Sie die Leistung beim Ausführen von Massendatenvorgängen verbessern möchten.
Wichtig
Der aufrufende Benutzer muss die prvBypassCustomBusinessLogic-Berechtigung haben.
Im folgenden Beispiel wird der BypassBusinessLogicExecutionoptionale Parameter für synchrone und asynchrone benutzerdefinierte Logik beim Erstellen eines neuen Kontodatensatzes mithilfe der SDK für .NET CreateRequest-Klasse festgelegt.
static void DemonstrateBypassBusinessLogicExecution(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("BypassBusinessLogicExecution", "CustomSync,CustomAsync");
service.Execute(request);
}
Erfahren Sie mehr über Möglichkeiten zum Umgehen benutzerdefinierter Dataverse Logik
Umgehen von Power Automate Flüssen
Wenn Massendatenvorgänge auftreten, die Flows auslösen, erstellt Dataverse Systemaufträge zum Ausführen der Flows. Wenn die Anzahl der Systemaufträge groß ist, kann dies zu Leistungsproblemen für das System führen. Wenn Leistungsprobleme auftreten, können Sie die Auslösung der Flows mithilfe des SuppressCallbackRegistrationExpanderJob optionalen Parameters umgehen.
Die CallbackRegistration-Tabelle verwaltet Flow-Trigger, und es gibt einen internen Vorgang namens expander, der die registrierten Flow-Trigger aufruft.
Anmerkung
Wenn Sie diese Option verwenden, erhalten die Ablaufbesitzer keine Benachrichtigung, dass ihre Flusslogik umgangen wurde.
static void DemonstrateSuppressCallbackRegistrationExpanderJob(IOrganizationService service)
{
Entity account = new("account");
account["name"] = "Sample Account";
CreateRequest request = new()
{
Target = account
};
request.Parameters.Add("SuppressCallbackRegistrationExpanderJob", true);
service.Execute(request);
}
Weitere Informationen: Umgehung von Power Automate-Flows
Unmaskierte Daten anzeigen
Wenn Sie eine Spalte für die Verwendung des Vorschaufeatures für Maskierungsregeln konfigurieren, verwenden Sie den UnMaskedData optionalen Parameter, um den nicht maskierten Wert anzufordern.
RetrieveMultipleRequest request = new()
{
Query = query,
["UnMaskedData"] = true
};
var response = (RetrieveMultipleResponse)service.Execute(request);
Weitere Informationen zum Abrufen nicht maskierter Daten.
Siehe auch
Nachrichten mit dem SDK für .NET verwenden
Web-API: HTTP-Anforderungen erstellen und Fehler behandeln: Weitere Header
Benutzerdefinierte Geschäftslogik umgehen