Article (Artikel)

De Article-entiteit beheert alle magazijnartikelen in Ultimo. Dit omvat reservedelen, verbruiksmaterialen, cateringartikelen en IT-artikelen. Artikelen zijn gekoppeld aan magazijnen, leveranciers en kunnen als reserveonderdeel aan equipment worden toegewezen.

Entiteitsnaam: Article Databasetabel: Article Primaire sleutel: ARTID (nvarchar 9)

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

Veel Article-properties worden niet alleen handmatig ingesteld, maar door workflows bewaakt, berekend of opnieuw gezet bij configuratiewijzigingen. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik lookup_property_usage("Article", "<property>") voor de volledige, actuele lijst workflows per property en lookup_workflow("<naam>") voor de XML.

• InventoryMethod en UseOwnInventoryMethod — De voorraadmethode bepaalt hoe Ultimo inkoopadvies en batchbeheer afhandelt voor een artikel. Article_SetInventoryMethod is de centrale orchestrator: zodra de methode wijzigt, toont hij een dialoogvenster (Dialog_Article_SetInventoryMethod) waarmee de gebruiker kiest of het artikel de methode van zijn artikelgroep overneemt (UseOwnInventoryMethod = false) of een eigen methode krijgt. De vlag DeviateFromInventoryMethod registreert of het artikel afwijkt van de groepsinstelling. Aan de groepskant bewaakt ArticleGroup_UpdateInventoryMethodWhenAllArticlesHaveSameInventoryMethod of alle artikelen in een groep dezelfde methode hebben; zo ja, dan wordt de groepsinstelling automatisch bijgewerkt. Consultanttip: wijzig de inventarismethode nooit direct in de database — de workflow verzorgt ook de validatie op MinimumNumberOfDaysBetweenDeliveryAndExpiryDate voor artikelen met een vervaldatum.

• RegisterStock — Deze Boolean bestuurt of Ultimo fysieke voorraad bijhoudt voor het artikel. Article_ToggleRegisterStock verwerkt de schakelaar: als RegisterStock wordt uitgezet terwijl er nog geen InventoryMethod is, maakt de workflow automatisch WarehouseServeOut-boekingen aan om de resterende voorraad uit alle magazijnlocaties weg te boeken. Staat er wél een InventoryMethod, dan worden openstaande batches verwerkt. RegisterStock wordt door 41 workflows gelezen — onder andere bij het aanmaken van een magazijnlocatiekoppeling (Article_AddWarehouseLocation) en bij bestelprocesvalidaties — wat het tot een van de meest invloedrijke velden maakt.

• Purchase, PurchaseLevel en MaximumStock — Deze drie velden sturen het automatisch inkoopadvies aan. Article_ResetArticlePurchase zet alle drie op nul/false wanneer bij de systeeminstelling ManageStockPerWarehouse wordt omgeschakeld en een artikel geen magazijnkoppeling meer heeft. De bredere workflow Article_ActionField1106_UpdateWarehouse (systeeminstelling-toggle) itereert over alle artikelen en roept Article_ResetArticlePurchase aan voor artikelen zonder ArticleWarehouse. Consultanttip: als na een instellingswijziging bestelniveaus verdwenen zijn, controleer dan of deze workflow correct is uitgevoerd.

• PurchasePrice, Raise, ChargeRaiseInternal en ChargeRaiseExternal — Prijzen en opslagpercentages bepalen de kostprijsberekening bij materiaalgebruik op een werkorder (via JobMaterial_UpdateMaterialCost) en bij magazijn-uitgifte (WarehouseServeOutline_PreApprove). ActionField1775 (toggle UltimoSettings.PurchasePricePerSite) kopieert bij activering de artikel-niveau-prijzen naar alle ArticleSite-records en leegt daarna de waarden op artikel-niveau. Vanaf dat moment zijn PurchasePrice, Raise, ChargeRaiseInternal en ChargeRaiseExternal georganiseerd per vestiging in plaats van per artikel. Bij import via REST_Article_Import of Article_ImportMicrosoftDynamics worden deze velden direct gevuld.

• VendorPerSite en voorkeursleverancier — Article_GetPreferredVendor is de lookup-workflow die bij inkoopregelverwerking (PurchaseLine_ValidateAndCopyArticleData_ArticleVendor) de juiste leverancier ophaalt. De logica is: als UltimoSettings.StockLevelPerSite én Article.VendorPerSite allebei true zijn, wordt de voorkeursleverancier opgezocht in ArticleSiteVendor (per vestiging); anders in ArticleVendor (artikel-breed). De keuze voor vestigingsspecifieke leveranciers (VendorPerSite = true) wordt gezet via ActionField660. Consultanttip: zet VendorPerSite alleen aan als de klant daadwerkelijk per vestiging inkoopt bij andere leveranciers; de extra configuratielast is aanzienlijk.

• ReplacedByArticle — Wordt gezet door ActionField1801 en ActionField1807 wanneer een artikel wordt vervangen door een nieuwere versie. Workflows die een verouderd artikel tegenkomen (bijv. ActionField1803) lezen dit veld om automatisch naar het vervangartikel door te verwijzen. Zolang ReplacedByArticle gevuld is, blokkeert ActionField1801 verdere vervangingsketens via een filtercheck.

• Stock (voorraad) — Stock wordt door de database-triggers bijgehouden op basis van transacties, maar drie workflows raken het direct: Article_PostImport en Article_PreImport gebruiken het voor beginstanden bij bulkimport, en Article_ToggleRegisterStock leegt het impliciet bij het uitschakelen van voorraadregistratie. De berekende kolom ArtStckStatCode (B/F/E/V) is direct afgeleid van Stock, PurchaseLevel, ReservedQuantity en lopende bestelhoeveelheden — zie de tabel in Database Details voor de formule.

Het volledige, gegenereerde overzicht van álle Article-properties met hun schrijvende/lezende/filterende workflows staat in reference/properties/Article.

Relaties met andere entiteitenbewerken

Tips voor consultantsbewerken

• Voorraadregistratie: Niet alle artikelen hoeven voorraad te registreren. Zet RegisterStock = false voor diensten of niet-fysieke artikelen.
• ABC-analyse: Via AbcCode en de ABC-bepalingsfunctie kan voorraadprioritering worden ingericht.
• Leveranciers: Een artikel kan meerdere leveranciers hebben via de ArticleVendor-koppeling, met een voorkeursleverancier.
• Reservedelen: Koppel artikelen als reserveonderdeel aan equipment(types) via EquipmentSparePart.
• Webshop: Met ShowInWebShop = true wordt het artikel beschikbaar in de selfservice-webshop.
• Artikelvervanging: Gebruik ReplacedByArticle wanneer een artikel is vervangen door een nieuwere versie.

Database Detailsbewerken

De tabel dba.Article bevat 95 kolommen. Hieronder de belangrijkste technische details.

Computed columns (berekende velden)bewerken

Consultanttip: De ArtStckStatCode is zeer nuttig voor dashboards en rapportages over voorraadstatus. De formule houdt rekening met gereserveerde hoeveelheden, lopende bestellingen en reparatie-hoeveelheden.

Kolommen gezet door triggersbewerken

Belangrijke defaultsbewerken

Triggers en externe triggersbewerken

Article heeft 3 eigen triggers (INSERT, UPDATE, INSTEAD OF DELETE) en wordt beinvloed door 9 externe triggers:

• PurchaseLine-triggers: Bestellijnen updaten ArtPurchQty en ArtPchlPrepQuantity
• PurchaseRequestLine-triggers: Bestelaanvraagregels updaten ArtPchrlPrepQuantity
• ArticleSite-triggers: Vestigingskoppelingen updaten ArtSitId
• Equipment-triggers: Bij koppeling als reserveonderdeel wordt ArtEqmQty bijgewerkt
• ReservableObject-triggers: Synchronisatie reserveerbaar object

Consultanttip: Het INSTEAD OF DELETE-trigger voorkomt directe verwijdering van artikelen. De voorraadgerelateerde trigger-kolommen zijn cruciaal voor correct voorraadbeheer -- pas deze nooit handmatig aan in de database.

Brondatabewerken

Let op: De wiki-samenvatting hierboven toont een curated subset van properties en praktische consultant-tips. Voor ground truth (exacte kolomnamen, alle properties, defaults, triggers) gebruik de onderstaande tools.

• Entity-definitie — lookup_entity("Article") · reference/entities/Article Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("Article") · reference/tables/Article Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="Article") Alle Before/After Save events en andere workflow-ActionFields voor Article. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("Article", "InventoryMethod") · reference/properties/Article Welke workflows de InventoryMethod-, RegisterStock- en prijsvelden lezen/schrijven/filteren — inclusief alle 71 readers van InventoryMethod en de 41 readers van RegisterStock. Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("Article_SetInventoryMethod") Volledige logica van de inventarismethode-orchestrator: dialoogkeuze, UseOwnInventoryMethod-vlag, validatie op vervaldagen en terugkoppeling naar de artikelgroep. Bron: workflows.xml.

Zie ookbewerken

• equipment - Assets waarvoor reservedelen gelden
• purchase - Bestellingen van artikelen
• purchase-request - Bestelaanvragen van artikelen
• supplier - Leveranciers