Freigeben über

Externe Bewertungen

  • Artikel

Bei der externen Bewertung handelt es sich um einen Mechanismus, um eine Bewertung aus einer anderen Bewertung heraus abzurufen. Eine externe Bewertung ist selbst keine Bewertung. Stattdessen fungiert es wie eine Datenquelle, die es Ihnen ermöglicht, Daten zu senden und eine Antwort von einer Zielbewertung zu erhalten. Eine Bewertung kann eine von zwei möglichen Freigabeeinstellungen haben:

  • Privat: Nur in der Stammumgebung der Bewertung zugänglich.
  • Freigegeben: Zugriff auf alle Umgebungen im Mandanten.

Externe Bewertungen können auf jede private Bewertung verweisen, die in derselben Stammumgebung verfügbar ist, oder auf eine freigegebene Bewertung, die in einer beliebigen Stammumgebung des Mandanten verfügbar ist.

Hinweis

Weitere Informationen zum Ändern der Freigabeeinstellung einer Bewertung von "Privat" in "Privat" oder "Freigegeben" in "Privat" finden Sie in der Übersicht über die Bewertungskonfiguration.

Nachdem Sie eine externe Bewertung eingerichtet haben, kann sie über eine Regel aus jeder Bewertung in dieser Umgebung aufgerufen werden.

Flow für externe Bewertung

Für private Bewertung: Umgebung Y = Umgebung X

Für freigegebene Bewertung: Umgebung Y = Jede Stammumgebung innerhalb desselben Mandanten

Eine Anrufbewertung bezieht sich auf jede Bewertung, die eine private oder freigegebene Bewertung über eine externe Bewertung aufruft. Die aufrufende Bewertung muss über eine externe Bewertungsregel verfügen. Wenn die Regelbedingung erfüllt ist, ruft die Regel die externe Bewertung auf und führt die konfigurierten Aktionen aus. Ähnlich wie externe Anrufe werden externe Bewertungen nicht von untergeordneten Elementen geerbt. Um eine externe Bewertung in einer Regel zu verwenden, müssen Sie die externe Bewertung in der Umgebung einrichten, aus der Sie sie aufrufen möchten.

Erstellen einer externen Bewertung

Um eine externe Bewertung zu erstellen, stellen Sie zunächst sicher, dass Sie über die richtige Berechtigung zum Ausführen dieses Vorgangs verfügen. Weitere Informationen zu Benutzerrollen und Berechtigungen finden Sie unter Benutzerrollen und Zugriff

  1. Wählen Sie im Fraud Protection-Portal in der linken Navigation Externe Bewertungen und dann + Neue externe Bewertung.
  2. Auf der Seite Neue externe Bewertung legen Sie die folgenden Felder fest:
  • Zielbewertung, die aufgerufen werden soll – In der Dropdownliste können Sie alle privaten Bewertungen, die in derselben Stammumgebung eingerichtet sind, sowie alle verfügbaren freigegebenen Bewertungen in jeder Stammumgebung desselben Mandanten einrichten. Wählen Sie die Zielbewertung aus.

Schein

Wenn die freigegebene Bewertung, auf die Sie ihre externe Bewertung verweisen möchten, nicht in der Dropdownliste angezeigt wird, überprüfen Sie die Freigabeeinstellung der Bewertung, und stellen Sie sicher, dass sie auf "Freigegeben" festgelegt ist. Weitere Informationen zum Konfigurieren der Freigabeeinstellung finden Sie in der Übersicht über die Bewertungskonfiguration.

  • Name – Geben Sie den Namen ein, mit dem Sie aus Ihren Regeln auf die externe Bewertung verweisen. Der Name darf nur Zahlen, Buchstaben und Unterstriche enthalten. Es darf nicht mit einer Zahl beginnen.

Schein

Sie können den Namen einer externen Bewertung nicht ändern, nachdem Sie sie in einer Regel verwendet haben.

  • Beschreibung – Fügen Sie eine Beschreibung hinzu, damit Ihr Team die externe Bewertung schnell identifizieren kann.
  • API für die Vorschau – Wählen Sie die API aus, für die Sie eine Vorschau des Beispielcodes anzeigen möchten. Der Beispielcode ist die FQL, die Sie in einer Regel verwenden können, um diese freigegebene Bewertung aufzurufen

Hinweis

Sie können die externe Bewertung verwenden, um die Auswertungs-, Beobachtungs- oder Bezeichnungs-API der freigegebenen oder privaten Bewertung aufzurufen, auf die sie verweist.

  • Beispielantwort – Dieser Abschnitt enthält die Beispielantwort, die von der Zielbewertung erwartet wird. Die angezeigten Informationen werden vom Zielbewertungsadministrator manuell bereitgestellt und verwendet, um Beschreibungen (QuickInfos) und Vorschläge für autoVervollständigen zu aktivieren, wenn auf die Bewertung in einer Regel verwiesen wird.
  1. Wenn Sie mit dem Festlegen der erforderlichen Felder fertig sind, wählen Sie "Erstellen" aus.

Aufrufen einer externen Bewertung

Um Ihre externen Bewertungen zu verwenden, verweisen Sie auf diese aus Ihren Regeln. Zum Beispiel, um auf eine externe Bewertung zu verweisen, die in Ihrer Regel myAssessment heißt, verwenden Sie die folgende Syntax:

Assessments.myAssessment.Evaluate($baseInput = @@)

Im obigen Beispiel ordnet $baseInput = @@alle Felder zu, die von der freigegebenen/externen Bewertung aus der Nutzlast der aufrufenden Bewertung benötigt werden. Sie können auch nur bestimmte Felder zuordnen. Sie können auch definieren, welche Aktivitäten die Regel basierend auf den Informationen ausführen soll, die sie vom Aufruf der externen Bewertung erhält.

Beispiel:

LET $card = {
  number: 12345,
  expy: "2023-03-10".ToDateTime()
}
LET $response = Assessments.MicroTx.evaluate(card = $card, user = @@"user")
OBSERVE Output(decision = $response.decisionDetails.merchantRuleDecision)

Sie können eine Regel zum Aufrufen der externen Bewertung einrichten, indem Sie entweder die Regelvorlage Externe Bewertung verwenden verwenden oder die Beispiel-FQL von der Seite für die externe Bewertung kopieren/einfügen. Achten Sie darauf, den Beispielcode für die API zu verwenden (auswerten, beobachten, bezeichnen), die Sie aufrufen möchten. Der Beispielcode zeigt alle Felder an, die an die freigegebene Bewertung gesendet werden können. Die erforderlichen Felder sind im Code als solche gekennzeichnet.

Hier ist eine weitere Beispiel-FQL zum Aufrufen der Auswertungs-API der externen Bewertung mit dem Namen ExtAssessment1:

LET $customUser = {
    id: "userId123456",
    username: "johnsmith2",
    firstName: "John",
    lastName: "Smith",
    email: "johnsmith2@gmail.com",
    address: {
        street1: "0123 Bechtelar Loop",
        city: "Kubtown",
        state: "SC",
        zipCode: "44329",
        countryRegion: "US"
    }
}

LET $result = Assessments.ExtAssessment1.Evaluate(
    user = $customUser,
    specialConsideration = true)
OBSERVE Output(Result = $result)

Sie können auch auf das Diagnoseobjekt in Regeln zugreifen, sodass Sie wichtige Diagnose- und Debuginformationen aus der Antwort einer externen Bewertung ermitteln können. Das Diagnoseobjekt enthält die Anforderungsnutzlast, den HttpStatus-Code, die Fehlermeldung und die Latenz. Das Diagnoseobjekt muss zuerst mithilfe der entsprechenden Erweiterungsmethode "erstellt werden. GetDiagnostics()", bevor die Felder des Objekts in den Regeln verwendet werden können.

Im Folgenden sehen Sie ein Beispiel für eine Regel, die das Diagnoseobjekt für die Antwort einer externen Bewertung namens ExtAssessment2 verwendet:

LET $result = Assessments.ExtAssessment2.evaluate($baseInput =@@)
LET $diagnostics = $result.GetDiagnostics()
RETURN Approve(), Output (Diagnostics = $diagnostics)
WHEN $diagnostics.httpStatusCode==200

Externe Aufrufe und externe Bewertungen erfordern möglicherweise komplexe strukturierte Objekte als Teil ihres Anforderungsschemas. Weitere Informationen zur Verwendung von JSON-Arrays und -Objekten finden Sie im Handbuch zur Sprachreferenz.

Hinweis

Externe Bewertungen können auch innerhalb von Funktionen referenziert werden. Weitere Informationen finden Sie unter Funktionen.

Überwachen externer Bewertungen im Betrugsschutzportal

Fraud Protection zeigt eine Kachel mit drei Metriken für jede von Ihnen definierte externe Bewertung an:

  • Anforderungen pro Sekunde – Die Gesamtzahl der Anforderungen geteilt durch die Gesamtzahl der Minuten im ausgewählten Zeitrahmen.
  • Durchschnittliche Wartezeit – Die Gesamtzahl der Anforderungen geteilt durch die Gesamtzahl der Minuten im ausgewählten Zeitrahmen.
  • Erfolgsquote – Die Gesamtzahl der erfolgreichen Anforderungen dividiert durch die Gesamtanzahl der durchgeführten Anforderungen.

Die Zahlen und Diagramme, die auf dieser Kachel angezeigt werden, enthalten nur Daten für den Zeitrahmen, den Sie in der Dropdownliste in der oberen rechten Ecke der Seite ausgewählt haben.

Schein

Metriken werden nur angezeigt, wenn Ihre externe Bewertung in einer aktiven Regel verwendet wird.

  • Um tiefer in die Daten Ihrer externen Bewertung einzutauchen, wählen Sie „Leistung“ in der rechten Ecke der Kachel aus. Fraud Protection zeigt eine neue Seite mit einer detaillierteren Ansicht der Metriken.
  • Um Metriken für einen beliebigen Zeitrahmen in den letzten drei Monaten anzuzeigen, passen Sie die Einstellung Datumsbereich oben auf der Seite an.

Neben den drei zuvor beschriebenen Metriken wird auch ein Fehler-Diagramm angezeigt. Dieses Diagramm zeigt die Anzahl der Fehler nach Fehlertyp und Code an. Um die Anzahl der Fehler im Zeitverlauf oder die Verteilung der Fehler anzuzeigen, wählen Sie Kreisdiagramm aus.

Neben den HTTP-Client-Fehlern (400, 401 und 403) werden möglicherweise die folgenden Fehler angezeigt:

  • Ungültige Anwendungs-ID – Die angegebene Anwendungs-ID ist in Ihrem Mandanten nicht vorhanden oder nicht gültig.
  • Microsoft Entra-Fehler – Das Microsoft Entra-Token konnte nicht abgerufen werden.
  • Definition nicht gefunden – Der externe Aufruf wurde gelöscht, aber es wird weiterhin in einer Regel referenziert.
  • Zeitlimit – Die Anforderung an das Ziel hat das angegebene Zeitlimit überschritten.
  • Kommunikationsfehler – Aufgrund eines Netzwerkproblems oder weil das Ziel nicht verfügbar ist, konnte keine Verbindung zum Ziel hergestellt werden.
  • Schaltkreisschalter – Wenn der externe Anruf kontinuierlich fehlgeschlagen ist und einen bestimmten Schwellenwert überschritten hat, werden alle weiteren Anrufe für ein kurzes Intervall angehalten.
  • Unbekannter Fehler – Ein interner Dynamics 365-Fehler ist aufgetreten.