Passa al contenuto principale
Documentazione
Documentazione
Administrator Guide
Ultimo aggiornamento: 2025-04-04
Concetto: Oggetti business correlati in WQL

Concetto: Oggetti business correlati in WQL

È possibile accedere ai campi da un oggetto business correlato in
SELECT
 clausola che utilizza parentesi graffe
{}
 notazione
È anche possibile filtrare i risultati delle query in base ai campi RBO utilizzando
WHERE ON
 clausola Entrata
WHERE ON
 clausole, omettere le parentesi graffe
{}
 notazione per i campi RBO.
Le risposte dei seguenti endpoint restituiscono ora l'oggetto business correlato per ogni campo:
  • GET /dataSources/{ID}/fields
  • GET /dataSources/{ID}/dataSourceFilters/{subresourceID}

Sintassi

SELECT
field1
{
relatedBusinessObjectField1, relatedBusinessObjectField2
} FROM
dataSource
Esempio:
SELECT dependents{age} FROM allWorkers
È possibile fare riferimento a un singolo campo o a più campi separati da virgole da un campo RBO.
È anche possibile assegnare un alias personalizzato a un campo RBO. Esempio:
dependents{age} as DependentsAge

Esempi

Restituire il collaboratore e più campi dall'elenco di gestione delle persone
a carico
 in un gruppo:
SELECT worker, dependents{legalName_FirstName, legalName_LastName, age}
FROM allWorkers
Restituire il collaboratore e più campi dall'elenco di gestione delle persone
a carico
 come gruppi separati: 
SELECT worker, dependents{legalName_FirstName} as FirstName, dependents{legalName_LastName} as LastName, dependents{age} as Age
FROM allWorkers
Quando si richiamano più campi separatamente dallo stesso campo di ricerca, utilizzare un alias campo univoco.

Limitazioni

Quando il campo di ricerca per RBO è a istanze multiple, il sistema supporta solo fino a 500 valori per il campo RBO. Esempio: si specifica un collaboratore come oggetto business principale e le persone a carico del collaboratore come RBO. Quando la query restituisce più di 500 persone a carico per un collaboratore, WQL visualizza un errore. Valutare la possibilità di utilizzare un'origine dati basata su un'origine dati Dependents.
Non è possibile accedere ai campi da RBO:
  • Nelle query che utilizzano a
    GROUP BY
     clausola
  • Al di fuori del
    SELECT
     e
    WHERE ON
     clausole
Quando si utilizza un client API di terzi, potrebbe essere necessario prima codificare la query. Alcuni client di terze parti non elaborano le parentesi graffe
{}
 notazione
Esempio di query prima della codifica: 
SELECT worker, dependents{legalName_FirstName} as FirstName FROM allWorkers
Esempio di query dopo la codifica:
SELECT%20worker%2C%20dependents%7BlegalName_FirstName%7D%20as%20FirstName%20FROM%20allWorkers