In een andere topic (Teamleader Power BI views voor custom fields die meerdere waardes toestaan) werd beschreven hoe “custom fields” van TeamLeader via de V1 database kunnen ingelezen worden in Power BI.
Deze logica gaat echter niet op voor de V2 databank, in geen enkel van de beschikbare tabellen zijn “custom fields” zichtbaar.
Hoe kunnen “custom fields” via de V2 databank uitgelezen worden in Power-BI ?
De V2 API custom fields van Teamleader zijn beschikbaar als views:
CompanyCustomFieldValuesContactCustomFieldValuesDealCustomFieldValuesInvoiceCustomFieldValuesMilestoneCustomFieldValuesProductCustomFieldValuesProjectCustomFieldValuesTaskCustomFieldValuesDaarnaast kunnen de V1 API custom fields gebruikt worden. De V2 API mist nog talrijke elementen, dus de meeste gebruikers werken voornamelijk met de V1 API SQL tabellen. De Invantive documentatie bevat ook alle V1 Teamleader API tabellen, en de vervallen V1 documentatie is te vinden zoals beschreven op Waar vind ik de bestelbonnen in de Teamleader API?.
Voor custom fields die meerdere waardes kunnen hebben en V1 tabellen zijn er in de versies 20.1.394 en nieuwer nieuwe mogelijkheden beschikbaar gekomen door zowel de lijst toe te voegen als een gedenormaliseerde kolom als een view. Meer informatie in Teamleader Power BI views voor custom fields die meerdere waardes toestaan.
Daarnaast staan er in sommige omgevingen veel ongeldige waardes in een custom field. Denk aan een datum in het jaar 20.000 of een getal zoals “KWH”. Meer informatie hoe daarmee om te gaan staat in Fix Teamleader Incorrect Custom Field Values.
Ik merk inderdaad dat een deel van de custom fields nu beschikbaar zijn als view, dat is een hele stap voorwaarts!
Maar het is inderdaad maar een deel, 14 van de 21 om precies te zijn. Er is ook geen lijn in te trekken, het zit hem op alle componenten. Nochtans beweert TeamLeader dat elk van deze custom fields via de V2 API kunnen uitgelezen worden.
De custom fields zijn inderdaad wel allemaal beschikbaar onder de V1-databank, maar die heeft dan weer andere beperkingen waardoor we bewust gekozen hebben om de data uit de V2-databank uit te lezen. Bovendien is het maar een kwestie van tijd voor de V1-databank “obsolete” zal komen te staan.
Als ik het goed begrijp, dan zijn er 21 custom fields op een tabel. Die zijn wel zichtbaar in de Teamleader website qua setup en in de V1 tabellen, maar niet in de V2 views.
Kan een schermafdruk toegevoegd worden van:
Mogelijk dat te achterhalen is waardoor ze niet aanwezig zijn.
Ik heb drie afbeeldingenopgeladen:
Er ontbreken 2 custom fields bij “company”:
custom filesextra modules3 custom fields bij "invoices”:
datesubsidiaryto be converted intoEn 1 custom field bij “subscriptions”:
subsidiarytickets (last activity).Ik begrijp dat Invoice uit Teamleader een voorbeeld is dat niet goed gaat.
De definities in Teamleader zelf zijn:
Date: single line textSubsidiary hsbcad: single selection (keuzelijst)To be converted into: single line textIn de V1 Teamleader tabel (ik vermoed InvoicesAll) staan hiervoor drie velden:
c_datec_subsidiary_hsbcad_...: de ID en waardec_to_be_converted_intoDe afbeelding “Teamleader Custom fields zichtbaar in Power BI” begrijp ik niet. Ik had verwacht een afdruk van de V2Flat tabel InvoiceCustomFieldValues of CustomFieldsByInvoice(invoice_id).
Welke tabel is de afbeelding “Teamleader Custom fields zichtbaar in Power BI”?
De SQL gebruikt in de definitie van de viewInvoiceCustomFieldValues is:
select cfd.type
cfd_type
, cfd.label
cfd_label
, cfd.group
cfd_group
, cfd.required
cfd_required
, ivedet.* prefix with 'ife_'
, ive.* prefix with 'ive_'
from v2.invoices ive
join CustomFieldsByInvoiceId(ive.id) ivedet
on ( ivedet.value_as_string is not null
or
ivedet.value_as_number is not null
or
ivedet.value_as_number is not null
or
ivedet.value_as_array is not null
or
ivedet.value_as_boolean is not null
or
ivedet.value_object_id is not null
)
join CustomFieldDefinitions cfd
on cfd.id = ivedet.definition_id
Mogelijk helpt dat bij het uitzoeken.
Via de Invantive Query Tool zie ik helemaal niks van V2Flat - wat op zich al vreemd is:
Dus ik kan je helaas geen afdruk van de “InvoiceCustomFieldValues” bezorgen.
Via de SQL-editor in de Invantive Cloud zie ik deze tabel wel in de V2Flat:
Echter, als ik de tabel tracht uit te lezen krijg ik de volgende foutmelding (itgenpwf002):
Kortom, er is zeker een tabel “InvoiceCustomFieldValues”, alleen is die overal zichtbaar en kan die niet uitgelezen worden.
Het ontbreken van het schema V2Flat voor de Teamleader V2 API tabellen in het Query Tool komt waarschijnlijk doordat het Query Tool in de 20.0 release geïnstalleerd staat. De V2Flat data is pas toegevoegd in 20.1 BETA. De download van Query Tool hiervoor is te vinden op Invantive Query Tool 22.1.123-BETA | Release Notes en kan geïnstalleerd en gebruikt worden naast de 20.0 release.
De methodologie is:
De itgenpwf error is meestal een timeout. De echte foutmelding wordt helaas niet getoond op dit moment. De V2Flat tabellen zijn erg traag en structurele snelheidswinsten zijn niet te behalen. Voor optimalisatie raden we aan om een consultant te betrekken en vanuit het rapportagedoel te kijken welke shortcuts acceptabel zijn.
Voor deze specifieke vraag raad ik aan om eerst te testen met maar een deel ophalen, zoals bijvoorbeeld:
select *
from InvoiceCustomFieldValues
limit 1
Deze query stopt automatisch direct na ontdekken van de eerste factuur met een waarde voor een custom field.
Mocht dit ook erg lang duren, probeer het dan via de BETA van het Query Tool.
Mocht dat problematisch zijn, dan is advies om de V1 tabellen te gebruiken.
Met behulp van de Query Tool 20.1 zie ik effectief de tabel ““InvoiceCustomFieldValues”, alsook de structuur. Maar zelf met het toevoegen van “limit 1” aan het sql-statement krijg ik een “time-out”. Wat me doet vermoeden dat er toch iets grondig mis is met de onderliggende query.
Fijn dat gelukt is de view te vinden. Helaas zal ook de limit 1 moeten wachten op de eerste rij. Advies is om te kijken of het op V1 beter gaat. De Teamleader API heeft helaas performancetechnisch en qua ontwerp een aantal serieuze beperkingen.
Op basis van Invantive techniek zijn er ook op de dealers pagina een aantal partijen die data repliceren naar een database. Ook is het mogelijk om Azure Data Factory te gebruiken zoals beschreven op Verbind Azure Data Factory met Teamleader Focus, 180 dagen gratis.
De melding itgenpwf002 wordt voortaan getoond met de daadwerkelijke melding, zie Vague itgenpwf002 message replaced by new error window displaying actual error message.