Portée et résultats vides - Credit Benchmark Docs

Les analyses séparent la sélection des entrées de la mise en forme des sorties.

« scope » définit les entités prises en compte dans l’analyse.
« result_filter » (Sélection de la structure de données) définit la structure des lignes renvoyées à l’issue de l’analyse.

Pour la sélection des routes, consultez Choix d’un itinéraire. Pour metric et rating_scale, consultez Indicateurs et échelles.

Portée

scope est évaluée avant que le point de terminaison ne calcule son résultat.

Portée du portefeuille
Portée du filtre
Portefeuille et filtres
Syntaxe de jointure de filtres

Utilisez scope.portfolio lorsque vous connaissez déjà les entités.

{
  "scope": {
    "portfolio": {
      "CB_ID": ["CB0000022706", "CB0000022177"]
    }
  }
}

Les colonnes de portefeuille personnalisées peuvent être utilisées comme facet_column valeurs lorsque le point de terminaison prend en charge les facettes.

Utilisation scope.filters lorsque l’API doit construire l’univers à partir de conditions de champ.

{
  "scope": {
    "filters": [
      {
        "key": "CB_Country",
        "operator": "==",
        "values": "United States"
      },
      {
        "key": "CB_CCR_21_Notch",
        "operator": ">=",
        "values": 8
      }
    ]
  }
}

Si filters_join si aucun filtre n’est spécifié, les filtres multiples sont combinés par une opérateur « ET ».

Lorsque les deux sont fournis, la route utilise l’intersection.

{
  "scope": {
    "portfolio": {
      "CB_ID": ["CB0000022706", "CB0000022177"]
    },
    "filters": [
      {
        "key": "CB_Sector",
        "operator": "==",
        "values": "Banks"
      }
    ]
  }
}

Cela signifie les entités de votre portefeuille qui sont des banques, et non votre portefeuille plus l’ensemble des banques.

Utilisation filters_join Utilisez-le uniquement lorsque vous avez besoin d’une logique explicite « OU » ou « NON ». Il s’agit d’un opérateur positionnel comportant un élément supplémentaire par rapport à filters.

{
  "scope": {
    "filters": [
      {
        "key": "CB_Country",
        "operator": "==",
        "values": "United States"
      },
      {
        "key": "CB_Sector",
        "operator": "==",
        "values": "Banks"
      }
    ],
    "filters_join": ["", "|", ""]
  }
}

Filtre de résultats

result_filter ne modifie pas l’univers d’entrée. Il permet uniquement de filtrer, trier ou limiter les lignes de sortie calculées.

Mécanisme	S’applique à
`scope.filters`	Entités avant l’exécution de l’analyse
`result_filter.filters`	lignes après l’exécution de l’analyse
`result_filter.sort`	Ordre des lignes dans la réponse
`result_filter.limit`	Nombre maximal de lignes renvoyées

Utilisez scope pour définir les éléments à inclure. Utilisez result_filter pour définir le contenu renvoyé.

Couverture MyRating

Avec metric: "CCR", l’analyse utilise les entités du périmètre pour lesquelles il existe des données consensuelles. Avec metric: "MyRating", l’analyse utilise uniquement la partie de votre périmètre pour laquelle votre banque a soumis des notations pour la période demandée. En d’autres termes, la sélection de MyRating peut réduire l’univers de « l’ensemble de la demande » à « les entités demandées que votre banque a notées ». Si votre banque n’a noté aucune entité dans le périmètre demandé, l’API renvoie une réponse de réussite vide plutôt qu’une erreur.

Portée demandée	la couverture de votre banque	MyRating utilise
3 entités	3 entités notées	3 entités
3 entités	2 entités notées	2 entités
3 entités	0 entité notée	Réponse de réussite vide

Pour les routes MyRating de type agrégé, les champs « ex-me » sont calculés sur ce même sous-ensemble couvert. Ils ne constituent pas une référence à portée complète pour les entités que votre banque ne note pas. Ne comparez pas AGG_EntityCount les CCR ne pas comparer les réponses « from » avec AGG_ClientEntityCount réponses. MyRating réponses comme si elles partageaient le même dénominateur.

Réponse vide par route

Itinéraire	Réponse de réussite vide
`getdata`	`{}` ou des tableaux de colonnes vides.
`aggregatetrend`	`{}`
`creditbreakdown`	`{}`
`entityratingchange`	`{}`
`ratingdistribution` avec `metric: "CCR"`	`{"ccr": {}}`
`ratingdistribution` avec `metric: "MyRating"`	`{"my_bank": {}, "ex_me": {}}`

​Portée

​Filtre de résultats

​Couverture MyRating

​Réponse vide par route

Portée

Filtre de résultats

Couverture MyRating

Réponse vide par route