> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambito e risultati vuoti

> In che modo «scope» e «result_filter» restringono le query dell’API Credit Benchmark Analytics e perché una richiesta andata a buon fine può comunque restituire un insieme di risultati vuoto.

Analytics separa **la selezione degli input** dalla **modellazione degli output**.

* **`scope`** definisce quali entità vengono incluse nell’analisi.
* «**`result_filter`**» determina le righe restituite al termine dell’elaborazione analitica.

Per la selezione delle rotte, consultare [Scelta del percorso](/api-reference/analytics-endpoints). Per `metric` e `rating_scale`, consultare [Metriche e scale](/api-reference/metrics-and-rating-scales).

## Ambito

`scope` vengono valutati prima che l’endpoint calcoli il proprio risultato.

<Tabs>
  <Tab title="Ambito del portafoglio">
    Utilizzi `scope.portfolio` quando si conoscono già le entità.

    ```json theme={null}
    {
      "scope": {
        "portfolio": {
          "CB_ID": ["CB0000022706", "CB0000022177"]
        }
      }
    }
    ```

    Le colonne personalizzate del portafoglio possono essere utilizzate come `facet_column` valori laddove l’endpoint supporti i filtri.
  </Tab>

  <Tab title="Ambito del filtro">
    Utilizzo `scope.filters` quando l’API deve costruire l’universo a partire dalle condizioni dei campi.

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

    Se `filters_join` se omesso, i filtri multipli vengono combinati con AND.
  </Tab>

  <Tab title="Portafoglio e filtri">
    Quando entrambi sono specificati, il percorso utilizza l’**intersezione**.

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

    Ciò significa le entità presenti nel Suo portafoglio che sono Banche, non il Suo portafoglio più tutte le Banche.
  </Tab>

  <Tab title="Sintassi di join con filtro">
    Utilizzare `filters_join` solo quando è necessaria una logica OR o NOT esplicita. È posizionale e presenta un elemento in più rispetto a `filters`.

    ```json theme={null}
    {
      "scope": {
        "filters": [
          {
            "key": "CB_Country",
            "operator": "==",
            "values": "United States"
          },
          {
            "key": "CB_Sector",
            "operator": "==",
            "values": "Banks"
          }
        ],
        "filters_join": ["", "|", ""]
      }
    }
    ```
  </Tab>
</Tabs>

## Filtro dei risultati

`result_filter` non modifica l’universo di input. Si limita a filtrare, ordinare o limitare le righe di output calcolate.

| Meccanismo              | Si applica a                              |
| ----------------------- | ----------------------------------------- |
| `scope.filters`         | Entità prima dell’esecuzione dell’analisi |
| `result_filter.filters` | righe dopo l’esecuzione dell’analisi      |
| `result_filter.sort`    | Ordine delle righe nella risposta         |
| `result_filter.limit`   | Numero massimo di righe restituite        |

Utilizzi `scope` per definire l’input. Utilizzi `result_filter` per determinare l’output.

## copertura MyRating

Con `metric: "CCR"`, l’analisi utilizza entità nell’ambito di applicazione che dispongono di dati di consenso.

Con `metric: "MyRating"`, l’analisi utilizza solo la parte del vostro ambito in cui la vostra banca ha inviato valutazioni per l’intervallo di date richiesto.

In altre parole, selezionando `MyRating` può ridurre l’universo da «tutto ciò che avete richiesto» a «le entità richieste **che la vostra banca ha valutato**». Se la vostra banca non ha valutato alcuna entità nell’ambito richiesto, l’API restituisce una risposta di successo vuota anziché un errore.

| Ambito richiesto | Copertura della Sua banca | MyRating utilizza          |
| ---------------- | ------------------------- | -------------------------- |
| 3 entità         | 3 entità valutate         | 3 entità                   |
| 3 entità         | 2 entità valutate         | 2 entità                   |
| 3 entità         | 0 entità valutate         | Risposta di successo vuota |

Per i percorsi MyRating in stile aggregato, i campi «ex-me» vengono calcolati per lo stesso sottoinsieme coperto. Essi non costituiscono un parametro di riferimento a tutto campo per le entità che la vostra banca non valuta.

Non confrontare `AGG_EntityCount` le `CCR` risposte con `AGG_ClientEntityCount` risposte. `MyRating` risposta come se avessero lo stesso denominatore.

## Risposta vuota per percorso

| Percorso                                      | Risposta di successo vuota     |
| --------------------------------------------- | ------------------------------ |
| `getdata`                                     | `{}` o array di colonne vuoti  |
| `aggregatetrend`                              | `{}`                           |
| `creditbreakdown`                             | `{}`                           |
| `entityratingchange`                          | `{}`                           |
| `ratingdistribution` con `metric: "CCR"`      | `{"ccr": {}}`                  |
| `ratingdistribution` con `metric: "MyRating"` | `{"my_bank": {}, "ex_me": {}}` |