Ik wil graag de waardes van de extra velden van artikelen uit Exact Online kunnen oproepen binnen de PowerBI connector.
Ik kan echter de endpoint ItemExtraField nergens vinden in de OData feed.
Hoe kan ik de extra velden benaderen?
Ik wil graag de waardes van de extra velden van artikelen uit Exact Online kunnen oproepen binnen de PowerBI connector.
Ik kan echter de endpoint ItemExtraField nergens vinden in de OData feed.
Hoe kan ik de extra velden benaderen?
Sur les articles Exact Online, vous pouvez définir des champs d’article supplémentaires.
Utilisez la nouvelle vue ItemExtraFieldValues pour récupérer les valeurs des champs d’article supplémentaires, mais tenez compte des explications suivantes.
Historiquement, il s’agissait d’une fonction table où chaque requête SQL devait obligatoirement fournir la valeur de l’administration et de l’article, respectivement sous la forme division et itemId.
C’était donc une fonction table un peu malheureuse : les utilisateurs disposant de dizaines ou de centaines de milliers d’articles en ressentaient particulièrement le besoin, alors que chaque appel pour un article comptait comme 1 appel API et qu’il n’existait pas d’API plus intelligente disponible.
Exact Online a pris en compte ces remarques et, depuis quelque temps, il existe également une version stable de l’API ItemExtraField qui permet de récupérer en une seule fois les valeurs des champs d’article supplémentaires de plusieurs articles. Si aucun article n’est spécifié, tous les champs d’article supplémentaires seront renvoyés ; cela ne figure pas dans la documentation de l’API, mais c’est bien le cas en pratique. Cette amélioration permet de récupérer facilement les valeurs des champs supplémentaires pour tous les articles ou pour un seul article. Les autres sous-ensembles ne sont pas pris en charge.
La fourniture de la date de modification reste toutefois obligatoire. La stabilité de cette API ainsi que la lisibilité des messages d’erreur restent également des points d’attention, et on espère qu’ils seront encore améliorés à l’avenir.
Par exemple, la récupération des champs d’article supplémentaires dans des administrations où des champs supplémentaires sont bien définis, mais où aucun article n’utilise ces valeurs, génère le message d’erreur suivant :
itgenoda061: Invalid: ItemID or Modified.
The remote server returned an error: (400) Bad Request.
Vérifiez donc au préalable que toutes les administrations contiennent au moins un article avec des valeurs concrètes pour les champs d’article supplémentaires.
Une fois d’autres améliorations de qualité apportées, il sera également possible de travailler davantage avec la date de modification afin de mettre à disposition les mutations de données de manière incrémentielle. Pour les assortiments d’articles vraiment plus importants, à partir de 10 000 articles, un certain support pour l’optimisation restera nécessaire.
Avec une requête telle que la suivante, vous pouvez récupérer les champs d’article supplémentaires pour toutes les administrations Exact Online sélectionnées :
--
-- Choisissez quelques administrations correctement configurées.
--
use 868035, 868057
--
-- Récupérez les valeurs des champs d'article supplémentaires.
--
select sdn.code
, sdn.created
, ief.*
from SYSTEMPARTITIONS@DataDictionary spn
join systemdivisions sdn
on sdn.code = to_number(spn.code)
join itemextrafields(sdn.code, null, sdn.created) ief
where spn.is_selected = true
Power BI ne prend actuellement pas en charge les requêtes OData avec paramètres. C’est pourquoi une vue ItemExtraFieldValues a été ajoutée dans la prochaine version, qui récupère les valeurs des champs d’article de toutes les administrations Exact Online sélectionnées.
La plupart des vues Invantive SQL utilisent uniquement des tables connues à l’intérieur du driver. Il n’est donc pas possible d’utiliser l’instruction SQL ci-dessus pour ne récupérer que les divisions sélectionnées. À la place, la vue utilise ExactOnlineREST.System.Settings, qui renvoie exactement 1 ligne pour chaque division Exact sélectionnée. Celle-ci est ensuite mise en relation avec SystemDivisions afin de déterminer la date de création de l’administration et ainsi récupérer tous les champs d’article modifiés depuis le début de l’administration :
select ief.*
from ExactOnlineREST.System.settings stg
join systemdivisions sdn
on sdn.code = stg.division
join itemextrafields(sdn.code, null, sdn.created) ief
where sdn.status = 1 /* Actif. */
Il est également possible de récupérer les valeurs des champs d’article via les API XML telles que ExtraFieldDefinitionsEx et Items. Vous trouverez plus d’informations en recherchant « extra fields » dans la documentation du driver Exact Online.
L’importation de valeurs pour les champs supplémentaires n’est actuellement possible que via les API XML, comme décrit sur Inlezen extra velden van Exact Online artikelen.
Begrijp ik het nu goed dat ik de Extra velden nog niet kan benaderen in PowerBI en moet wachten op de nieuwe release?
Wanneer komt de nieuwe release?
Dat is correct: standaard zit het in de volgende release. Je kunt eventueel er om heen werken met On Open SQL op de database en daar al met SQL een in-memory tabel materialiseren, maar dat raad ik gezien de setting niet aan.
De verwachting is in de loop van deze week.
Gezien de zware belasting van het Exact Online API ecosysteem verwerken we een aantal wijzigingen in de volgende release zodat gebruikers gemakkelijker trickle loading op grote omgevingen kunnen managen met honderden administraties of meer. De release komt kort nadat die wijzigingen voldoende stabiel zijn om praktische waarde te leveren voor de gebruikers van Data Replicator, OEM en Premium Finance abonnementen.
De vandag beschikbaar gekomen release 20.1.356 biedt ook de extra artikelvelden op Exact Online.