Optionale Parameter verwenden

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:

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:

  • AddPrivilegesRole
  • CopySystemForm
  • Create (POST)
  • Delete (LÖSCHEN)
  • MakeAvailableToOrganizationTemplate
  • RemovePrivilegeRole
  • ReplacePrivilegesRole
  • 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:

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 account Tabelle hat die Duplikaterkennung aktiviert.
  • Es wird eine Duplikaterkennungsregel veröffentlicht, die überprüft, ob der Wert des Kontos name genau 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.

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