Eksterne vurderinger
Ekstern vurdering er en mekanisme, der kan kalde en vurdering fra alle andre vurderinger. En ekstern vurdering er ikke en vurdering i sig selv. Den fungerer i stedet som en datakilde, der giver dig mulighed for at sende data og modtage et svar fra en målvurdering. En vurdering kan have en af to mulige indstillinger til deling:
- Privat: Kun tilgængelig i vurderingens rodmiljø.
- Delt: Tilgængelig i alle miljøer i lejeren.
Eksterne vurderinger kan pege på alle private vurderinger, der er tilgængelige i det samme rodmiljø, eller enhver delt vurdering, der er tilgængelig i et hvilket som helst rodmiljø i lejeren.
Bemærk
Du kan finde flere oplysninger om, hvordan du ændrer indstillingen Deling for en vurdering fra Privat til Delt eller Delt til Privat, i oversigt over vurderingskonfiguration.
Når du har konfigureret en ekstern vurdering, kan den kaldes via en regel fra en hvilken som helst vurdering i det pågældende miljø.
Til privat vurdering: Miljø Y = Miljø X
For Delt vurdering: Miljø Y = Alle rodmiljøer i samme lejer
En opkaldsvurdering henviser til enhver vurdering, der kalder en privat eller delt vurdering via en ekstern vurdering. Opkaldsvurderingen skal have konfigureret en ekstern vurderingsregel. Når regelbetingelsen er opfyldt, kalder reglen den eksterne vurdering og udfører de konfigurerede handlinger. På samme måde som med eksterne kald nedarves eksterne vurderinger ikke af underordnede. Hvis du vil bruge en ekstern vurdering i en regel, skal du konfigurere den eksterne vurdering i det miljø, du vil kalde den fra.
Opret en ekstern vurdering
Hvis du vil oprette en ekstern vurdering, skal du først sikre dig, at du har de rette tilladelser til at udføre denne handling. Du kan få flere oplysninger om brugerroller og tilladelser under Brugerroller og adgang
- I Fraud Protection-portalen skal du vælge Eksterne vurderinger i venstre navigationspanel og derefter vælge + Ny ekstern vurdering.
- På siden Ny ekstern vurdering skal du angive følgende felter:
- Målvurdering, der skal ringes til – På rullelisten kan du se alle de private vurderinger, der er konfigureret i det samme rodmiljø, samt alle tilgængelige delte vurderinger, der er konfigureret i et hvilket som helst rodmiljø i den samme lejer. Vælg den vurdering, du vil gå efter.
Seddel
Hvis den delte vurdering, du vil pege din eksterne vurdering på, ikke vises på rullelisten, skal du kontrollere indstillingen Deling for vurderingen og sikre, at den er angivet til Delt. Du kan få mere at vide om, hvordan du konfigurerer delingsindstillingen, i Oversigt over vurderingskonfiguration.
- Navn – Angiv det navn, du vil bruge til at referere til det eksterne vurdering fra reglerne. Navnet kan kun indeholde tal, bogstaver og understregninger. Det kan ikke starte med et tal.
Seddel
Du kan ikke ændre navnet på en ekstern vurdering, efter at du har brugt det i en regel.
- Beskrivelse – Tilføj en beskrivelse, der kan hjælpe dit team med hurtigt at identificere den eksterne vurdering.
- API, der skal vises som eksempel – Vælg den API, du vil have vist eksempelkoden for. Eksempelkoden er det FQL, du kan bruge i en regel, som kalder denne delte vurdering
Bemærk
Du kan bruge den eksterne vurdering til at kalde API'en for evaluering, observation eller mærkat for den delte eller private vurdering, den peger på.
- Eksempelsvar – dette afsnit indeholder det eksempelsvar, der forventes fra målvurderingen. De viste oplysninger leveres manuelt af administratoren af målvurderingen og bruges til at aktivere beskrivelser (værktøjstip) og forslag til autofuldførelse, når der refereres til vurderingen i en regel.
- Når du er færdig med at angive de påkrævede felter, skal du vælge Opret.
Ring til en ekstern vurdering
Hvis du vil bruge eksterne vurderinger, skal du referere til dem fra reglerne. Hvis du f.eks. vil referere til en eksternt vurdering, der hedder myAssessment i din regel, skal du bruge følgende syntaks:
Assessments.myAssessment.Evaluate($baseInput = @@)
I ovenstående eksempel $baseInput = @@
kan du tilknytte alle felter, der skal bruges til den delte/eksterne vurdering, fra opkaldsvurderingens nyttelast. Du kan kun tilknytte bestemte felter. Du kan også definere, hvilke handlinger reglen skal udføre på baggrund af de oplysninger, den modtager fra det eksterne vurderingsopkald.
Eksempel:
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 oprette en regel, så du kan kalde den eksterne vurdering ved enten at bruge skabelonen Brug en ekstern vurderingsregel eller kopiere/indsætte vareprøveskabelonen fra den eksterne vurderingsside. Sørg for at bruge eksempelkoden til den API (evaluer, overhold, mærkat), du vil kalde. Eksempelkoden viser alle de felter, der kan sendes til den delte vurdering. De påkrævede felter er markeret som sådanne i koden.
Her er endnu et eksempel på et FQL-eksempel til kald af API'en til ekstern vurdering med navnet 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 også få adgang til diagnosticeringsobjektet i regler, som giver dig mulighed for at finde vigtige diagnosticerings- og fejlfindingsoplysninger fra en ekstern vurderingssvar. Diagnosticeringsobjektet indeholder nyttedata for anmodning , HttpStatus-kode , fejlmeddelelse og ventetid. Diagnosticeringsobjektet skal først oprettes ved hjælp af den tilsvarende udvidelsesmetode ". GetDiagnostics()", før objektets felter kan bruges i reglerne.
Følgende er et eksempel på en regel, der bruger diagnosticeringsobjektet i svaret på en ekstern vurdering med navnet ExtAssessment2:
LET $result = Assessments.ExtAssessment2.evaluate($baseInput =@@)
LET $diagnostics = $result.GetDiagnostics()
RETURN Approve(), Output (Diagnostics = $diagnostics)
WHEN $diagnostics.httpStatusCode==200
Eksterne kald og eksterne vurderinger kan kræve komplekse strukturerede objekter som en del af deres anmodningsskema. Du kan finde flere oplysninger om, hvordan du bruger JSON-matrixer og -objekter, i vejledning til sprogreference.
Bemærk
Der kan også refereres til eksterne vurderinger i Functions. Du kan få flere oplysninger under Funktioner.
Overvåge eksterne kald på portalen Fraud Protection
Fraud Protection viser et felt, der indeholder tre målepunkter for hver ekstern vurdering, som du definerer:
- Anmodninger pr. sekund – Det samlede antal anmodninger divideret med det samlede antal minutter i den valgte tidsramme.
- Gennemsnitlig ventetid – Det samlede antal anmodninger divideret med det samlede antal minutter i den valgte tidsramme.
- Succesrate – det samlede antal vellykkede anmodninger divideret med det samlede antal anmodninger, der blev foretaget.
De tal og diagrammer, der vises i dette felt, omfatter kun data for den tidsramme, du vælger på rullelisten i sidens øverste højre hjørne.
Seddel
Målepunkter vises kun, når din eksterne vurdering bruges i en aktiv regel.
- Hvis du vil dykke ned i dataene om din eksterne vurdering, skal du vælge Ydeevne i højre hjørne af feltet. Fraud Protection viser en ny side, der indeholder en mere detaljeret visning af disse målepunkter.
- Hvis du vil have vist målepunkter for en tidsramme i de sidste tre måneder, skal du justere indstillingen af Datointerval øverst på siden.
Ud over de tre målepunkter, der er beskrevet tidligere, vises også et Fejldiagram. Dette diagram viser antallet af fejl efter fejltype og -kode. Hvis du vil have vist fejlantal over tid, eller hvis du vil have vist fordelingen af fejl, skal du vælge Cirkeldiagram.
Ud over HTTP-klientfejl (400, 401 og 403) kan der være følgende fejl:
- Ugyldigt program-id – Det angivne program-id findes ikke i din lejer, eller det er ikke gyldigt.
- Microsoft Entra-fejl – Microsoft Entra-tokenet kunne ikke hentes.
- Definitionen blev ikke fundet – det eksterne kald blev slettet, men der refereres stadig til den i en regel.
- Timeout – Anmodningen om målet tog længere tid end den angivne timeout.
- Kommunikationsfejl – Der kan ikke oprettes forbindelse til målet på grund af et netværksproblem, eller fordi målet ikke er tilgængeligt.
- Kredsløbsafbryder – hvis det eksterne opkald mislykkedes løbende og overskred en bestemt grænse, afbrydes alle yderligere opkald i et kort interval.
- Ukendt fejl – Der opstod en intern Dynamics 365-fejl.