Externa utvärderingar

Viktig

Från och med den 3 februari 2025 är Dynamics 365 Fraud Protection inte längre tillgängligt för köp. Stödet för bedrägeriskydd upphör den 3 februari 2026. Mer information finns i artikeln Slutet av support för Dynamics 365 Fraud Protection.

Extern utvärdering är en mekanism för att anropa en utvärdering från andra utvärderingar. En extern utvärdering är inte en utvärdering i sig. I stället fungerar den som en datakälla som gör att du kan skicka data och ta emot ett svar från en målutvärdering. En utvärdering kan ha någon av två möjliga delningsinställningar:

• Privat: Endast tillgängligt i utvärderingens rotmiljö.
• Delad: Tillgänglig i alla miljöer i klientorganisationen.

Externa utvärderingar kan peka på alla privata utvärderingar som är tillgängliga i samma rotmiljö, eller alla delade utvärderingar som är tillgängliga i alla rotmiljöer i klientorganisationen.

Not

Mer information om hur du ändrar inställningen Delning för en utvärdering från Privat till Delad eller Delad till Privatfinns i Översikt över utvärderingskonfigurationen.

När du har konfigurerat en extern utvärdering kan den anropas via en regel från valfri utvärdering i den miljön.

för privat utvärdering: Miljö Y = Miljö X

för delad utvärdering: Miljö Y = Alla rotmiljöer inom samma klientorganisation

En anropsbedömning avser alla utvärderingar som genom en extern utvärdering anropar en privat eller delad utvärdering. Den anropande utvärderingen måste ha en extern utvärderingsregel konfigurerad. När regelvillkoret uppfylls anropar regeln den externa utvärderingen och utför de konfigurerade åtgärderna. På samma sätt som externa anrop ärvs inte externa utvärderingar av barn. Om du vill använda en extern utvärdering i en regel måste du konfigurera den externa utvärderingen i den miljö som du vill anropa den från.

Skapa en extern utvärdering

Om du vill skapa en extern utvärdering måste du först se till att du har rätt behörighet att utföra den här åtgärden. Mer information om användarroller och behörigheter finns i Användarroller och åtkomst

1. I det vänstra navigeringsfältet i bedrägeriskyddsportalen väljer du externa utvärderingaroch väljer sedan + Ny extern utvärdering.
2. På sidan Ny extern utvärdering anger du följande fält:

• Målutvärdering för att anropa – I listrutan kan du se alla privata utvärderingar, konfigurerade i samma rotmiljö samt alla tillgängliga delade utvärderingar, konfigurerade i alla rotmiljöer i samma klientorganisation. Välj den utvärdering som du vill rikta in dig på.

Not

Om den delade utvärderingen som du vill länka den externa utvärderingen till inte visas i listrutan, kontrollerar du inställningen Delning för utvärderingen och försäkrar dig om att den är satt till Delad. Mer information om hur du konfigurerar inställningen Delning finns i Översikt över utvärderingskonfiguration.

• Name – Ange det namn som du ska använda för att referera till den externa utvärderingen från dina regler. Namnet får bara innehålla siffror, bokstäver och understreck. Det kan inte börja med ett tal.

Not

Du kan inte ändra namnet på en extern utvärdering när du har använt den i en regel.

• Description – Lägg till en beskrivning som hjälper ditt team att snabbt identifiera den externa utvärderingen.
• API för att förhandsgranska – Välj det API som du vill förhandsgranska exempelkoden för. Exempelkoden är den FQL som du kan använda i en regel för att anropa den här delade utvärderingen

Not

Du kan använda den externa utvärderingen för att anropa utvärderings-, observations- eller etikett-API:et för den delade eller privata utvärderingen som den pekar på.

• Exempelsvar – Det här avsnittet innehåller det exempelsvar som förväntas från målutvärderingen. Den information som visas tillhandahålls manuellt av målutvärderingsadministratören och används för att aktivera beskrivningar (knappbeskrivningar) och förslag på automatisk komplettering när utvärderingen refereras till i en regel.

3. När du är klar med att ange obligatoriska fält väljer du Skapa.

Anropa en extern utvärdering

Om du vill använda dina externa utvärderingar refererar du till dem från dina regler. Om du till exempel vill referera till en extern utvärdering med namnet myAssessmentanvänder du följande syntax i regeln:

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

I exemplet ovan kopplar $baseInput = @@alla fält som behövs av den gemensamma/externa utvärderingen från den anropande utvärderingens datapaket. Du kan endast mappa specifika fält. Du kan också definiera vilka åtgärder du vill att regeln ska vidta baserat på den information som den får tillbaka från det externa utvärderingsanropet.

Till exempel

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

Du kan konfigurera en regel för att anropa den externa utvärderingen med hjälp av Använd en extern utvärdering regelmall eller kopiera/klistra in exempel-FQL från den externa utvärderingssidan. Se till att använda exempelkoden för API:et (utvärdera, observera, etikett) som du vill anropa. Exempelkoden visar alla fält som kan skickas till den delade utvärderingen. De obligatoriska fälten markeras som sådana i koden.

Här är ett annat exempel på FQL för att anropa utvärderings-API:et för extern utvärdering med namnet 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)

Du kan också komma åt diagnostikobjektet i regler, vilket gör att du kan identifiera viktig diagnostik- och felsökningsinformation från en extern utvärderings svar. Diagnostikobjektet innehåller nyttolasten Request, HttpStatus kod, felmeddelande och svarstid. Diagnostikobjektet måste skapas först med hjälp av motsvarande tilläggsmetod, ". GetDiagnostics()", innan objektets fält kan användas i reglerna.

Följande är ett exempel på en regel som använder diagnostikobjektet på svaret från en extern utvärdering med namnet ExtAssessment2:

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

Externa anrop och externa utvärderingar kan kräva komplexa strukturerade objekt som en del av deras begärandeschema. Mer information om hur du använder JSON-matriser och -objekt finns i referensguiden Language.

Not

Externa utvärderingar kan också refereras i Functions. Mer information finns i Functions.

Övervaka externa utvärderingar i bedrägeriskyddsportalen

Bedrägeriskydd visar en panel som innehåller tre mått för varje extern utvärdering som du definierar:

• Begäranden per sekund – Det totala antalet begäranden dividerat med det totala antalet minuter inom den valda tidsramen.
• Genomsnittlig svarstid – Det totala antalet begäranden dividerat med det totala antalet minuter inom den valda tidsramen.
• Framgångsfrekvens – Det totala antalet lyckade förfrågningar dividerat med det totala antalet förfrågningar som gjordes.

De siffror och diagram som visas på den här panelen innehåller endast data för den tidsram som du väljer i listrutan i det övre högra hörnet på sidan.

Not

Mått visas bara när din externa utvärdering används i en aktiv regel.

• Om du vill fördjupa dig i data om din externa utvärdering väljer du Prestanda i det högra hörnet av panelen. Bedrägeriskydd visar en ny sida med en mer detaljerad vy över måtten.
• Om du vill visa mått för en tidsram under de senaste tre månaderna justerar du inställningen Datumintervall överst på sidan.

Förutom de tre mått som beskrevs tidigare visas även ett Fel diagram. Det här diagrammet visar antalet fel efter feltyp och kod. Om du vill visa antalet fel över tid eller om du vill visa fördelningen av fel väljer du Cirkeldiagram.

Förutom HTTP-klientfel (400, 401 och 403) kan följande fel visas:

• Ogiltigt program-ID – Program-ID:t som angavs finns inte i din klientorganisation eller så är det inte giltigt.
• Microsoft Entra-fel – Det gick inte att hämta Microsoft Entra-token.
• Definition hittades inte – Det externa anropet togs bort, men det refereras fortfarande i en regel.
• Timeout – Begäran till destinationen tog längre tid än den angivna avbrottstiden.
• Kommunikationsfel – Det gick inte att upprätta någon anslutning till målet på grund av ett nätverksproblem eller på grund av att målet inte är tillgängligt.
• Kretsbrytare – Om det externa anropet misslyckades kontinuerligt och överskred ett visst tröskelvärde, pausas alla ytterligare anrop under ett kort intervall.
• okänt fel – ett internt Dynamics 365-fel inträffade.