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?
Exact Online の品目には、追加品目フィールドを定義することができます。
追加品目フィールドの値を取得するには、新しいビュー ItemExtraFieldValues を使用してください。ただし、以下の説明に注意する必要があります。
歴史的には、これはテーブル関数であり、すべての SQL クエリで、管理会社(administratie)と品目の値をそれぞれ division と itemId として必ず指定する必要がありました。
そのため、これは少々使い勝手の悪いテーブル関数でした。特に数万件、数十万件という品目を持つユーザーはその必要性を感じていましたが、各品目を呼び出すたびに API コール 1 回としてカウントされ、より賢い API も用意されていませんでした。
Exact Online はこの指摘を真摯に受け止め、しばらく前から ItemExtraField API の安定版も提供されるようになりました。これにより、複数品目の追加品目フィールドの値を一度に取得できます。品目を指定しない場合は、すべての追加品目フィールドが返されます。これはAPI ドキュメントには記載されていませんが、実際にはそのように動作します。この改良により、すべての品目、または特定の 1 つの品目について、追加フィールドの値を簡単に取得できるようになりました。それ以外の切り口はサポートされていません。
変更日(wijzigingsdatum)の指定は引き続き必須です。また、この API の安定性やエラーメッセージの読みやすさは依然として課題であり、今後さらに改善されることを期待しています。
例えば、追加フィールドは定義されているものの、その値を使用している品目が 1 件も存在しない管理会社に対して追加品目フィールドを問い合わせると、次のエラーが発生します。
itgenoda061: Invalid: ItemID or Modified.
The remote server returned an error: (400) Bad Request.
そのため、事前にすべての管理会社に、追加品目フィールドの具体的な値を持つ品目が少なくとも 1 件存在することを確認してください。
今後さらに品質改善が進めば、変更日を活用してデータの変更分を段階的(インクリメンタル)に取得できるようにすることも考えられます。品目数が 10,000 件を超えるような本当に大規模な品目構成については、最適化のための何らかのサポートが引き続き必要になるでしょう。
次のようなクエリを使用すると、選択したすべての Exact Online 管理会社について追加品目フィールドを取得できます。
--
-- 正しく設定されたいくつかの管理会社を選択します。
--
use 868035, 868057
--
-- 追加品目フィールドの値を取得します。
--
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 は現時点でパラメータ付きの OData クエリをサポートしていません。そのため、次のリリースでは、選択したすべての Exact Online 管理会社から品目フィールドの値を取得するビュー ItemExtraFieldValues が追加されます。
ほとんどの Invantive SQL ビューは、ドライバー内部で既知のテーブルのみを使用しています。そのため、上記の SQL 文を使って選択されたディビジョンのみを取得することはできません。その代わりに、ビュー ExactOnlineREST.System.Settings を使用します。これは、選択された Exact ディビジョンごとにちょうど 1 行を返します。続いてこれを SystemDivisions と関連付けて管理会社の作成日を特定し、管理会社の開始以降に変更されたすべての品目フィールドを取得します。
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 /* アクティブ */
品目フィールドの値は、ExtraFieldDefinitionsEx や Items といった XML API 経由でも取得することができます。詳細については、Exact Online ドライバーのドキュメントで「extra fields」を検索してください。
追加フィールドの値の読み込みは、現時点では Inlezen extra velden van Exact Online artikelen に記載されている通り、XML API 経由でしか行えません。
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.