Ámbito y resultados vacíos

Analytics separa la selección de entradas de la configuración de salidas.

«scope» define las entidades que se incluyen en el análisis.
«result_filter» determina las filas devueltas tras la ejecución del análisis.

Para la selección de rutas, consulte Elección de una ruta. Para metric y rating_scale, consulte Métricas y escalas.

Ámbito

scope se evalúa antes de que el punto final calcule su resultado.

Ámbito de la cartera
Ámbito del filtro
Cartera y filtros
Sintaxis de unión de filtros

Utilice scope.portfolio cuando ya conozca las entidades.

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

Las columnas de cartera personalizadas pueden utilizarse como facet_column valores cuando el punto final admita facetas.

Utilice scope.filters cuando la API deba construir el universo a partir de condiciones de campo.

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

Si filters_join Si se omite, los filtros múltiples se combinan con «AND».

Cuando se proporcionan ambos, la ruta utiliza la intersección.

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

Esto se refiere a las entidades de su cartera que son bancos, no a su cartera más todos los bancos.

Utilícelo filters_join solo cuando necesite una lógica explícita «O» o «NO». Es posicional y tiene un elemento más que filters.

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

Filtro de resultados

result_filter no modifica el universo de entrada. Solo filtra, ordena o limita las filas de salida calculadas.

Mecanismo	Aplicable a
`scope.filters`	Entidades antes de que se ejecute el análisis
`result_filter.filters`	Filas tras la ejecución del análisis
`result_filter.sort`	Orden de las filas en la respuesta
`result_filter.limit`	Número máximo de filas devueltas

Utilice scope para decidir qué se incluye. Utilice result_filter para decidir qué se devuelve.

Cobertura de MyRating

Con metric: "CCR", el análisis utiliza entidades del ámbito que cuentan con datos consensuados. Con metric: "MyRating", el análisis utiliza únicamente la parte de su ámbito en la que su banco ha enviado calificaciones para el intervalo de fechas solicitado. En otras palabras, al seleccionar MyRating puede reducir el universo de «todo lo solicitado» a «las entidades solicitadas que su banco ha calificado». Si su banco no ha calificado ninguna entidad en el ámbito solicitado, la API devuelve una respuesta de éxito vacía en lugar de un error.

Ámbito solicitado	Cobertura de su banco	MyRating utiliza
3 entidades	3 entidades calificadas	3 entidades
3 entidades	2 entidades calificadas	2 entidades
3 entidades	0 entidades calificadas	Respuesta de éxito vacía

En las rutas MyRating de tipo agregado, los campos «ex-me» se calculan para ese mismo subconjunto cubierto. No constituyen un punto de referencia de alcance completo para las entidades que su banco no califica. No comparar AGG_EntityCount las respuestas «from». CCR respuestas con AGG_ClientEntityCount las MyRating respuestas como si compartieran el mismo denominador.

Respuesta vacía por ruta

Ruta	Respuesta de éxito vacía
`getdata`	`{}` o matrices de columnas vacías
`aggregatetrend`	`{}`
`creditbreakdown`	`{}`
`entityratingchange`	`{}`
`ratingdistribution` con `metric: "CCR"`	`{"ccr": {}}`
`ratingdistribution` con `metric: "MyRating"`	`{"my_bank": {}, "ex_me": {}}`

Resumen

Puntos finales

Modelo de resolución de entidades

Análisis

Ámbito

Filtro de resultados

Cobertura de MyRating

Respuesta vacía por ruta

​Ámbito

​Filtro de resultados

​Cobertura de MyRating

​Respuesta vacía por ruta

Ámbito

Filtro de resultados

Cobertura de MyRating

Respuesta vacía por ruta