Benutzerdefinierte Dataverse-Logik umgehen

Es gibt Zeiten, in denen Sie in der Lage sein wollen, Datenoperationen durchzuführen, ohne dass eine benutzerdefinierte Geschäftslogik in Dataverse angewendet wird. Diese Szenarien umfassen normalerweise Massendatenvorgänge, bei denen eine große Anzahl von Datensätzen erstellt, aktualisiert oder gelöscht wird.

Da es keine Möglichkeit gibt, Dataverse anzuweisen, die Geschäftslogik nicht aufzurufen, müssen Sie die einzelnen benutzerdefinierten Plug-Ins und Workflows, die die Geschäftslogik enthalten, suchen und deaktivieren. Das Deaktivieren von Plug-Ins und Workflows bedeutet, dass die Logik für alle Benutzer deaktiviert wird, während diese Plug-Ins und Workflows deaktiviert werden. Es bedeutet auch, dass Sie darauf achten müssen, nur die richtigen Plug-Ins und Workflows zu deaktivieren, und daran denken müssen, sie wieder zu aktivieren, wenn Sie fertig sind.

Anstelle dieses manuellen Prozesses können Sie als Entwickler einer Clientanwendung oder eines Plug-Ins spezielle optionale Parameter mit Ihren Anforderungen übergeben, um zwei Arten benutzerdefinierter Geschäftslogik zu steuern, wie in der folgenden Tabelle beschrieben:

Optionale Parameter

Verwenden Sie diese optionalen Parameter, um die Geschäftslogik zu steuern, die in Dataverse ausgeführt wird:

BypassBusinessLogicExecution

Der optionale BypassBusinessLogicExecution-Parameter funktioniert ähnlich wie der optionale Parameter BypassCustomPluginExecution, außer dass Sie wählen können, ob die synchrone Logik, die asynchrone Logik oder beides umgangen werden soll.

Dieser optionale Parameter zielt auf die benutzerdefinierte Geschäftslogik, die für Ihr Unternehmen angewendet wurde. Wenn Sie Anforderungen senden, die die benutzerdefinierte Geschäftslogik umgehen, werden alle benutzerdefinierten Plug-Ins und Workflows deaktiviert, außer:

• Plug-Ins, die Teil des Microsoft Dataverse-Kernsystems oder Teil einer Lösung sind, bei der Microsoft der Herausgeber ist.
• Workflows, die in einer Lösung enthalten sind, bei der Microsoft der Herausgeber ist.

System-Plug-ins definieren die Kernverhaltensweisen für bestimmte Entitäten. Ohne diese Plug-Ins würden Sie auf Dateninkonsistenzen stoßen, die möglicherweise nicht leicht zu beheben sind.

Von Microsoft ausgelieferte Lösungen, die Dataverse verwenden, wie z. B. Microsoft Dynamics 365 Customer Service oder Dynamics 365 Sales enthalten auch kritische Geschäftslogik, die mit dieser Option nicht umgangen werden kann.

In der folgenden Tabelle wird beschrieben, wann die Parameterwerte mit BypassBusinessLogicExecution verwendet werden sollen.

Voraussetzungen für die Verwendung des optionalen BypassBusinessLogicExecution-Parameters

• Sie müssen die Anforderungen mit dem optionalen Parameter BypassBusinessLogicExecution senden.
• Der Benutzer, der die Anfragen sendet, muss die Berechtigung prvBypassCustomBusinessLogic haben. Standardmäßig haben nur Benutzer mit der Sicherheitsrolle "Systemadministrator" diese Berechtigung. Erfahren Sie, wie Sie die prvBypassCustomBusinessLogic-Berechtigung einer anderen Rolle hinzufügen

Wie nutze ich den optionalen BypassBusinessLogicExecution-Parameter?

Sie können diese Option entweder mit dem SDK für .NET oder der Web-API verwenden.

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);
}

POST [Organization URI]/api/data/v9.2/accounts HTTP/1.1
If-None-Match: null
OData-Version: 4.0
OData-MaxVersion: 4.0
Content-Type: application/json
Accept: application/json
MSCRM.BypassBusinessLogicExecution: CustomSync,CustomAsync

{
  "name":"Sample Account"
}

BypassBusinessLogicExecutionStepIds

Verwenden Sie den optionalen BypassBusinessLogicExecutionStepIds-Parameter, um angegebene registrierte Plug-In-Schritte anstelle der gesamten synchronen und asynchronen benutzerdefinierten Logik zu umgehen. Übergeben Sie mit diesem Parameter die GUID-Werte der registrierten Plug-In-Schrittregistrierungen. Wenn die übergebene Schritt-ID in der angegebenen Anforderung nicht ausgeführt wird, wird sie ignoriert.

Wie verwende ich die Option „BypassBusinessLogicExecutionStepIds“?

Sie können diese Option entweder mit dem SDK für .NET oder der Web-API verwenden.

static void DemonstrateBypassBusinessLogicExecutionStepIds(IOrganizationService service)
{
   Entity account = new("account");
   account["name"] = "Sample Account";

   CreateRequest request = new()
   {
         Target = account
   };
   request.Parameters.Add("BypassBusinessLogicExecutionStepIds", "45e0c603-0d0b-466e-a286-d7fc1cda8361,d5370603-e4b9-4b92-b765-5966492a4fd7");
   service.Execute(request);
}

POST [Organization URI]/api/data/v9.2/accounts HTTP/1.1
If-None-Match: null
OData-Version: 4.0
OData-MaxVersion: 4.0
Content-Type: application/json
Accept: application/json
MSCRM.BypassBusinessLogicExecutionStepIds: "45e0c603-0d0b-466e-a286-d7fc1cda8361, d5370603-e4b9-4b92-b765-5966492a4fd7"
{
  "name":"Sample Account"
}

Identifizieren Sie die Schritte, die Sie umgehen möchten

Es gibt mehrere Möglichkeiten, die GUID-Werte der Plug-In-Schrittregistrierung zu finden.

Das Plug-in-Registrierungstool verwenden

1. Wählen Sie im Menü Ansicht die Option Nach Entität anzeigen aus.

2. Wählen Sie die Entität und Nachricht aus

3. Wählen Sie den Schritt.

   Im Detailbereich wird auf der Registerkarte Eigenschaften die StepId angezeigt. Kopieren Sie den Wert von dort.

   

Weitere Informationen zum Plug-In-Registrierungstool

Ihre Umgebung mit Web-Api abfragen

Verwenden Sie eine Abfrage wie die folgende, um die festgelegten Plug-In-Schrittregistrierungen für eine bestimmte Tabelle und Nachricht abzurufen. Das folgende Beispiel gibt die account-Tabelle unter Verwendung des logischen Tabellennamens an. Create ist der Name der Nachricht. Ersetzen Sie diese Werte durch die Tabelle und Nachricht, die Sie benötigen.

Anfordern

GET [Organization URI]/api/data/v9.2/sdkmessagefilters?$select=sdkmessagefilterid
&$filter=primaryobjecttypecode eq 'account' 
and sdkmessageid/name eq 'Create'
&$expand=sdkmessagefilterid_sdkmessageprocessingstep($select=name;
$filter=statecode eq 0 
and customizationlevel eq 1 
and iscustomizable/Value eq true)
Accept: application/json   
OData-MaxVersion: 4.0   
OData-Version: 4.0 

Response

Suchen Sie in der Antwort nach den sdkmessageprocessingstepid-Werten. Verwenden Sie den Wert name, um das Plug-In zu identifizieren, das Sie umgehen möchten.

In diesem Fall gibt es nur eines: 4ab978b0-1d77-ec11-8d21-000d3a554d57

{
   "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#sdkmessagefilters(sdkmessagefilterid,sdkmessagefilterid_sdkmessageprocessingstep(name))",
   "value": [
      {
         "@odata.etag": "W/\"31434372\"",
         "sdkmessagefilterid": "c2c5bb1b-ea3e-db11-86a7-000a3a5473e8",
         "sdkmessagefilterid_sdkmessageprocessingstep": [
            {
               "@odata.etag": "W/\"115803276\"",
               "name": "BasicPlugin.FollowupPlugin: Create of account",
               "_sdkmessagefilterid_value": "c2c5bb1b-ea3e-db11-86a7-000a3a5473e8",
               "sdkmessageprocessingstepid": "4ab978b0-1d77-ec11-8d21-000d3a554d57"
            }
         ],
         "sdkmessagefilterid_sdkmessageprocessingstep@odata.nextLink": "[Organization URI]/api/data/v9.2/sdkmessagefilters(c2c5bb1b-ea3e-db11-86a7-000a3a5473e8)/sdkmessagefilterid_sdkmessageprocessingstep?$select=name&$filter=statecode%20eq%200%20and%20customizationlevel%20eq%201%20and%20iscustomizable/Value%20eq%20true"
      }
   ]
}

Erfahren Sie mehr über die Datenabfrage mit der Web-API

Ihre Umgebung mit FetchXml abfragen

Verwenden Sie eine Abfrage wie die folgende, um die festgelegten Plug-In-Schrittregistrierungen für eine bestimmte Tabelle und Nachricht abzurufen. Das folgende Beispiel gibt 1 an, um die account-Tabelle darzustellen, unter Verwendung des Tabellenobjekttypcodes.

Create ist der Name der Nachricht. Ersetzen Sie diese Werte durch die Tabelle und Nachricht, die Sie benötigen.

Verwenden Sie diese FetchXml-Abfrage, um step.sdkmessageprocessingstepid-Werte zurückzugeben, die Sie mit dem optionalen Parameter BypassBusinessLogicExecutionStepIds verwenden können.

<fetch>
  <entity name='sdkmessagefilter'>
    <filter>
      <condition attribute='primaryobjecttypecode'
        operator='eq'
        value='1' />
    </filter>
    <link-entity name='sdkmessage'
      from='sdkmessageid'
      to='sdkmessageid'
      link-type='inner'
      alias='message'>
      <filter>
        <condition attribute='name'
          operator='eq'
          value='Create' />
      </filter>
    </link-entity>
    <link-entity name='sdkmessageprocessingstep'
      from='sdkmessagefilterid'
      to='sdkmessagefilterid'
      link-type='inner'
      alias='step'>
      <attribute name='name' />
      <filter>
        <condition attribute='statecode'
          operator='eq'
          value='0' />
        <condition attribute='customizationlevel'
          operator='eq'
          value='1' />
        <condition attribute='iscustomizable'
          operator='eq'
          value='1' />
      </filter>
    </link-entity>
  </entity>
</fetch>

Weitere Informationen zum Abfragen von Daten mit FetchXml

Beschränken auf die Anzahl von Schritten

Um sicherzustellen, dass die Parametergröße nicht zu groß wird, beträgt die Standardbegrenzung für die Anzahl der Schritte, die Sie übergeben können, drei. Die Begrenzung wird mithilfe von Daten in der Spalte „OrgDbOrgSettings“ der Organisationstabelle gesteuert. Verwenden Sie das OrgDBOrgSettings-Tool für Microsoft Dynamics CRM oder die OrgDbOrgSettings-App, um den BypassBusinessLogicExecutionStepIdsLimit-Wert zu ändern.

Die maximal empfohlene Größe für diese Begrenzung beträgt 10 Schritte.

BypassCustomPluginExecution

Verwenden Sie den optionalen Parameter BypassCustomPluginExecution, um benutzerdefinierte synchrone Logik zu umgehen.

Verwenden Sie diesen optionalen Parameter auf die gleiche Weise wie BypassBusinessLogicExecution, mit dem Unterschied, dass er eine andere Berechtigung erfordert: prvBypassCustomPlugins

Wie verwende ich die Option BypassCustomPluginExecution?

Sie können diese Option entweder mit dem SDK für .NET oder der Web-API verwenden.

static void DemonstrateBypassCustomPluginExecution(IOrganizationService service)
{
    Entity account = new("account");
    account["name"] = "Sample Account";

    CreateRequest request = new()
    {
        Target = account
    };
    request.Parameters.Add("BypassCustomPluginExecution", true);
    service.Execute(request);
}

var service = new CrmServiceClient(connectionString);  

service.BypassPluginExecution = true;

var account = new Entity("account");
account["name"] = "Sample Account";

service.Create(account);

POST [Organization URI]/api/data/v9.2/accounts HTTP/1.1
If-None-Match: null
OData-Version: 4.0
OData-MaxVersion: 4.0
Content-Type: application/json
Accept: application/json
MSCRM.BypassCustomPluginExecution: true

{
  "name":"Sample Account"
}

Einer anderen Rolle die erforderlichen Berechtigungen hinzufügen

Die in diesem Artikel beschriebenen optionalen Parameter erfordern Berechtigungen, die nur zur Systemadministrierenden-Sicherheitsrolle hinzugefügt werden. Diese Berechtigungen sind im Sicherheitsrollen-Designer nicht zum Hinzufügen zu anderen Sicherheitsrollen verfügbar. Wenn Sie dieses Recht einer anderen Sicherheitsrolle erteilen müssen, müssen Sie die API verwenden. Sie könnten dieses Recht z. B. einem Benutzer mit der Sicherheitsrolle „Systemanpasser“ gewähren.

Um das Recht einer anderen Sicherheitsrolle hinzuzufügen, benötigen Sie die ID des Rechts.

Diese ID-Werte sind für alle Dataverse-Umgebungen gleich.

static void AddprvBypassCustomPluginsToRole(IOrganizationService service, Guid roleId)
{
    var request = new AddPrivilegesRoleRequest
    {
        RoleId = roleId,
        Privileges = new[]{
            new RolePrivilege{
                PrivilegeId = new Guid("0ea552b0-a491-4470-9a1b-82068deccf66"),
                Depth = PrivilegeDepth.Global
            }
        }
    };
    service.Execute(request);
}

POST [Organization URI]/api/data/v9.2/roles(<id of role>)/Microsoft.Dynamics.CRM.AddPrivilegesRole HTTP/1.1
Content-Type: application/json   
Accept: application/json   
OData-MaxVersion: 4.0   
OData-Version: 4.0 

{
  "Privileges": [
    {
      "PrivilegeId": "0ea552b0-a491-4470-9a1b-82068deccf66",
      "Depth": "3"
    }
  ]
}

HTTP/1.1 204 No Content  
OData-Version: 4.0  

Häufig gestellte Fragen zum Umgehen von Geschäftslogik (FAQ)

Nachfolgend finden Sie häufig gestellte Fragen zur Verwendung optionaler Parameter zum Umgehen synchroner Geschäftslogik.

Umgehen diese optionalen Parameter Plug-Ins für Datenoperationen durch Microsoft-Plug-Ins?

Nein. Wenn ein Plug-In oder Workflow in einer Microsoft-Lösung Operationen auf anderen Datensätzen durchführt, wird die Logik für diese Operationen nicht umgangen. Es werden nur die Plug-Ins oder Workflows umgangen, die für den spezifischen Vorgang gelten.

Kann ich diese optionalen Parameter für Datenoperationen verwenden, die ich innerhalb eines Plug-Ins durchführe?

Ja, aber nur, wenn das Plug-In im Kontext von Benutzenden läuft, welche die erforderliche Berechtigung haben. Für Plug-Ins setzen Sie den optionalen Parameter auf die von der OrganizationRequest-Klasse abgeleitete Klasse. Sie können die Klassen CrmServiceClient oder ServiceClient nicht in einem Plug-In verwenden.

Siehe auch

Power Automate-Flows umgehen
Optionale Parameter verwenden