La API Teamleader V2 presenta una struttura che si discosta da molte altre API introdotte di recente, in quanto non segue OData o specifiche di query simili. Si basa invece su un filtraggio parametrizzato, simile a piattaforme più tradizionali come Twinfield.
I valori per tali parametri possono essere specificati in una query come:
select *
from TimeTracking(ends_after => trunc(sysdateutc) - 7)
La maggior parte degli utenti non specifica parametri per le funzioni tabellari, aumentando così il tempo di esecuzione delle query Teamleader in tempo reale. L’uso da parte degli utenti di Invantive SQL e Power BI di clausole where e, rispettivamente, di passaggi di filtro per ridurre i dati richiesti non veniva precedentemente tradotto automaticamente in filtri parametrizzati, laddove possibile. Al contrario, venivano recuperate tutte le righe e il filtraggio avveniva nel motore Invantive SQL.
Un filtro che elimina il 90% dei dati ridurrà anche il tempo di esecuzione e il traffico di rete del 90% quando inoltrato al server API di Teamleader.
A partire dalla release 22.0.717, Invantive SQL proietterà circa 30 tipi di filtri sulle colonne data nelle tabelle Teamleader V2 su parametri per la API Teamleader. I miglioramenti delle prestazioni si applicano automaticamente senza che siano necessarie modifiche da parte dell’utente.
Ad esempio, una query su TimeTracking come:
select *
from TimeTracking
where ends_at >= trunc(sysdateutc) - 7
nella release 22.0.716 recupererebbe tutti i record temporali e li filtrerebbe localmente, mentre nella release 22.0.717 recupera solo quelli più recenti, senza alcuna necessità di specificare manualmente i valori dei parametri.
Il tempo di esecuzione in questo esempio diminuirà tipicamente di due ordini di grandezza, mentre in molti scenari le prestazioni possono persino aumentare di un ulteriore ordine di grandezza, poiché i rigidi limiti di frequenza (rate limits) di Teamleader non vengono esauriti in un breve lasso di tempo.
Tuttavia, le prestazioni non cambieranno negli scenari in cui la API Teamleader non ha fornito un filtraggio parametrizzato per i filtri sulle date.
Per maggiori dettagli sul filtraggio lato server.