Külső értékelések

Cikk
05/20/2024

A külső értékelés egy olyan mechanizmus, amely bármely más értékelésből származó értékelést hív meg. A külső értékelés nem maga az értékelés. Ehelyett úgy működik, mint egy adatforrás, amely lehetővé teszi az adatok küldését és a célértékelés válaszának fogadását. Az értékelés két lehetséges megosztási beállítás egyikével rendelkezhet:

Privát: Csak az értékelés gyökérkörnyezetében érhető el.
Megosztott: A bérlő összes környezetében elérhető.

A külső értékelések bármilyen privát értékelésre mutathatnak, amely ugyanabban a gyökérkörnyezetben érhető el, vagy bármely megosztott értékelésre, amely a bérlő bármely gyökérkörnyezetében elérhető.

Feljegyzés

Ha többet szeretne tudni arról, hogyan módosíthatja az értékelés megosztási beállítását privátról megosztottravagy megosztottról privátra, tekintse meg az Értékelés konfigurációjának áttekintését.

A külső értékelés beállítása után egy olyan szabályon keresztül hívható meg, amely az adott környezetben található bármely értékelésből származik.

Külső értékelési folyamat

Privát értékelés esetén: Y környezet = X környezet

Megosztott értékelés esetén: Y környezet = Minden gyökérkörnyezet ugyanabban a bérlőben

A hívó értékelés minden olyan értékelésre utal, amely külső értékelésen keresztül privát vagy megosztott értékelést hív meg. A hívásértékeléshez külső értékelési szabályt kell beállítani. A szabályfeltétel teljesülésekor a szabály meghívja a külső értékelést, és végrehajtja a konfigurált műveleteket. A külső hívásokhoz hasonlóan a külső értékeléseket nem öröklik a gyermekek. Ha külső értékelést szeretne használni egy szabályban, be kell állítania a külső értékelést abban a környezetben, amelyből meghívni szeretné.

Külső értékelés létrehozása

Külső értékelés létrehozásához először győződjön meg arról, hogy rendelkezik a megfelelő engedéllyel a művelet végrehajtásához. További információ a felhasználói szerepkörökről és engedélyekről: Felhasználói szerepkörök és hozzáférés

A Csalás elleni védelem portál bal oldali navigációs sávján válassza a Külső értékelések, majd az + Új külső értékelés lehetőséget.
Az Új külső értékelés lapon állítsa be a következő mezőket:

Meghívandó célértékelés – A legördülő menüben megtekintheti az összes privát értékelést, amely ugyanabban a gyökérkörnyezetben van beállítva, valamint az elérhető megosztott értékelések, amelyek ugyanazon bérlő bármely gyökérkörnyezetében vannak beállítva. Válassza ki a megcélzni kívánt értékelést.

Feljegyzés

Ha a külső értékelésre mutatni kívánt megosztott értékelés nem jelenik meg a legördülő listában, ellenőrizze az értékelés megosztási beállítását, és győződjön meg arról, hogy meg van osztva. A megosztási beállítás konfigurálásáról az Értékelés konfigurációjának áttekintésében olvashat bővebben.

Név – Adja meg azt a nevet, amellyel a szabályokból származó külső értékelésre hivatkozhat. A név csak számokat, betűket és aláhúzásjeleket tartalmazhat. Nem kezdődhet számmal.

Feljegyzés

A külső értékelés nevét nem módosíthatja, miután egy szabályban használta.

Leírás – Adjon hozzá egy leírást, amely segít a csapatnak a külső értékelés gyors azonosításában.
Api előzetes verzióra – Válassza ki azt az API-t, amelyhez a mintakódot meg szeretné tekinteni. A mintakód az a teljes tartománynév, amelyet egy szabályban használhat a megosztott értékelés meghívásához

Feljegyzés

A külső értékeléssel meghívhatja az általa megjelölt megosztott vagy privát értékelés kiértékelési, megfigyelési vagy címkézési API-ját.

Mintaválasz – Ez a szakasz a célértékeléstől várt mintaválaszt tartalmazza. A megjelenített információkat a célértékelés rendszergazdája manuálisan adja meg, és a leírások (elemleírások) és az automatikus kiegészítésre vonatkozó javaslatok engedélyezésére szolgál, amikor az értékelésre egy szabály hivatkozik.

Ha végzett a szükséges mezők beállításával, válassza a Létrehozás lehetőséget.

Külső értékelés meghívása

A külső értékelések használatához hivatkozzon rájuk a szabályokból. Ha például egy myAssessment nevű külső értékelésre szeretne hivatkozni, a szabályban használja a következő szintaxist:

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

A fenti példában $baseInput = @@a megosztott/külső értékeléshez szükséges összes mezőt leképezi a hívásértékelés hasznos adataiból. Adott mezőket is megfeleltethet. Azt is megadhatja, hogy a szabály milyen műveleteket hajt végre azon információk alapján, amelyeket a külső értékelési hívástól kap vissza.

Például:

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

Beállíthat egy szabályt a külső értékelés meghívásához a Külső értékelési szabály sablon használatával, vagy másolja/illessze be a minta teljes tartománynevet a külső értékelési oldalról. Ügyeljen arra, hogy a meghívni kívánt API-hoz (kiértékeléshez, megfigyeléshez, címkéhez) tartozó mintakódot használja. A mintakód megjeleníti az összes olyan mezőt, amelyet elküldhet a megosztott értékelésnek. A szükséges mezőket a kód ilyenként jelöli meg.

Íme egy másik minta teljes tartománynév az ExtAssessment1 nevű külső értékelés kiértékelési API-jának meghívásához:

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)

A diagnosztikai objektumot szabályokban is elérheti, így fontos diagnosztikai és hibakeresési információkat fedezhet fel egy külső értékelés válaszából. A diagnosztikai objektum tartalmazza a kérelem hasznos adatait, a HttpStatus-kódot , a hibaüzenetet és a késést. A diagnosztikai objektumot először a ". GetDiagnostics()", mielőtt az objektum mezői felhasználhatók a szabályokban.

Az alábbi példa egy olyan szabályra mutat be, amely a diagnosztikai objektumot használja az ExtAssessment2 nevű külső értékelés válaszán:

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

A külső hívások és a külső értékelések összetett strukturált objektumokat igényelhetnek a kérésséma részeként. A JSON-tömbök és -objektumok használatáról további információt a Nyelvi referencia útmutatóban talál.

Feljegyzés

A külső értékelésekre a Functionsben is hivatkozhat. További információ: Functions.