Koppelingen / ERP / DELMIAWorks
Handleiding voor de DELMIAWorks koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze DELMIAWorks, het voormalige IQMS, aan SkyPlanner APS koppelen. Via de DELMIAWorks WebAPI wisselt SkyPlanner in beide richtingen gegevens uit met DELMIAWorks:
- Productieorders, Bills of Manufacturing met artikelbewerkingen, werkcentra, gereedschappen en matrijzen, voorraadartikelen, voorraden en inkooporders worden ingelezen.
- De geplande start- en einddatums en het toegewezen werkcentrum worden teruggeschreven naar de productieorders.
- Goedgekeurde producten kunnen als productieregistraties worden geboekt, en instel- en bewerkingstijden als taakuren in Time & Attendance.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Tijdens de onboarding configureert het SkyPlanner-team de koppeling via de REST API voor uw DELMIAWorks-omgeving. Ook na de ingebruikname blijft het team ondersteuning bieden. Deze handleiding is bedoeld voor partners en ontwikkelaars die willen meewerken of zelf willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
Integratie-interfaces van DELMIAWorks
Volgens DELMIAWorks: “WebAPI includes both the API SDK for GRAPHQL APIs and WebAPI SDK for REST APIs” (WebAPI bevat zowel de API SDK voor GRAPHQL API’s als de WebAPI SDK voor REST API’s) (WebAPI-datasheet). Het REST-gedeelte is onderverdeeld in modules en controllers. Een planningskoppeling gebruikt de volgende:
- Manufacturing WorkOrders: WorkOrder, WorkOrders, ScheduledWorkOrders, UnscheduledWorkOrders, CreateWorkOrder, UpdateWorkOrder, UpdateWorkOrderEx, WorkOrderReleases, InventoryItemsForWorkOrder, SalesOrdersForWorkOrder.
- Manufacturing Schedule: RunAutoLoad, RemoveFromSchedule, NextSetup, GetSetupTemplateChecklists.
- Manufacturing WorkCenters: WorkCenter, WorkCenters, WorkCenterDetails, RunningWorkOrder, PMEquipment.
- Manufacturing BOM: BillOfMaterials, BomLabor, PartOperations, StandardOperations, BOMComponents.
- Manufacturing Inventory: InventoryItems, AddProductionRecords, InventoryProductionReportsByWorkOrder.
- Manufacturing Realtime: GetWorkCenterSchedule, ActualCavity, GetSetupTime, RealTimeData.
- Manufacturing Downtime: AddDownTime, CloseDownTime.
- PO Receiving: POs, POLineItems, POReleaseItems, POReceipts.
- Time & Attendance: TimeClock (LogInOut, TaskClockLogin), Tasks (ClockInTATask, ClockOutTATask, UpdateGoodParts), EmployeeCalendar.
De GraphQL SDK is geschikt om grote hoeveelheden gegevens uit te lezen, bijvoorbeeld bij het voor het eerst inladen van artikelen en stuklijsten. Alle schrijfacties verlopen via de REST-controllers.
Authenticatie en licenties
Maak in DELMIAWorks een aparte gebruiker voor de koppeling aan en controleer of de WebAPI voor uw omgeving is gelicentieerd en geïnstalleerd. De module Realtime biedt een AuthToken-controller. De WebAPI-sessie wordt geopend met de inloggegevens van de integratiegebruiker. Uw DELMIAWorks-partner bevestigt de exacte configuratie voor uw versie.
Bij SkyPlanner bevat elke aanroep een API-token in de Authorization-Token-header. U maakt het token in SkyPlanner aan onder Settings > API. Met een API-token kunt u beginnen met bouwen.
Events en polling
SkyPlanner verstuurt bij elke planningswijziging een webhook, zodat wijzigingen in de planning direct naar DELMIAWorks worden teruggeschreven.
Vraag de WebAPI periodiek uit om wijzigingen in DELMIAWorks op te halen. Lees ScheduledWorkOrders en UnscheduledWorkOrders om de paar minuten uit, en inkooporders en voorraadartikelen minder vaak. IQAlert, de functie voor meldingen en acties binnen DELMIAWorks, kan in een partnerproject acties starten op basis van events.
Gegevensmapping
| DELMIAWorks-object (interface) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| Voorraadartikelen (InventoryItems) | Producten en materialen | DELMIAWorks → SkyPlanner | Eerst inladen, daarna polling |
| Bill of Manufacturing, stuklijstcomponenten (BillOfMaterials, BOMComponents) | Productstructuur, materialen per product | DELMIAWorks → SkyPlanner | Eerst inladen, daarna bij wijzigingen |
| Artikelbewerkingen, standaardbewerkingen, arbeidsgegevens in de stuklijst (PartOperations, BomLabor) | Processtappen met bewerkingstijden, insteltijden en aantallen operators | DELMIAWorks → SkyPlanner | Eerst inladen, daarna bij wijzigingen |
| Werkcentra: persen, extruders, cellen (WorkCenters, WorkCenterDetails) | Werkcentra, werkcentrumgroepen, rendementen | DELMIAWorks → SkyPlanner | Eerst inladen, daarna zelden |
| Gereedschappen en matrijzen, familiematrijzen, matrijsholten (BOM, ActualCavity) | Gereedschappen met beperkte beschikbaarheid, aantal per cyclus | DELMIAWorks → SkyPlanner | Eerst inladen, daarna bij wijzigingen |
| Shop Calendar, personeelskalender (EmployeeCalendar) | Diensten, personeel, afwezigheid | DELMIAWorks → SkyPlanner | Dagelijks, of diensten beheren in SkyPlanner |
| Productieorders en afroepen (WorkOrders, ScheduledWorkOrders, UnscheduledWorkOrders) | Orders en taken met leverdatums en materiaalbehoeften | DELMIAWorks → SkyPlanner | Polling om de paar minuten |
| Aanwezige voorraad per artikel (InventoryItems) | Voorraadsaldi | DELMIAWorks → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Inkooporders en afroepen (POs, POReleaseItems) | Inkooporders, inkomend materiaal per leverdatum | DELMIAWorks → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Start- en einddatums van productieorders, werkcentrum (Manufacturing WorkOrders-controller) | Geplande start en gepland einde, toegewezen werkcentrum | SkyPlanner → DELMIAWorks | Bij planningswijzigingen, via een SkyPlanner-webhook |
| Productieregistraties: goedgekeurde producten per productieorder (AddProductionRecords) | Gereedgemelde aantallen uit terugmeldingen | SkyPlanner → DELMIAWorks | Per terugmelding, indien gekozen |
| Taakuren (ClockInTATask, ClockOutTATask) | Tijdregistraties en terugmeldingen van operators | SkyPlanner → DELMIAWorks | Per terugmelding of per dienst, indien gekozen |
| Niet in DELMIAWorks | Omsteltijdenmatrix, alternatieve persen en personeel | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Integratiepatronen
1. Stamgegevens voor het eerst inladen. Lees voorraadartikelen, stuklijsten, artikelbewerkingen, werkcentra en matrijzen uit. Denk goed na over de toewijzing van werkcentra: elke pers is één werkcentrum. Persen die dezelfde matrijsmaat gebruiken, vormen een werkcentrumgroep met alternatieven.
2. Productieorders synchroniseren. Lees openstaande productieorders met hun bewerkingen en materialen uit, samen met openstaande inkooporders. SkyPlanner beschouwt bestelde hars en inzetstukken als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder als Delivered is gemarkeerd.
3. Planning terugschrijven. Wanneer de planningsengine een productieorder inplant of verplaatst, activeert een SkyPlanner-webhook een update van de productieorder via de Manufacturing WorkOrders-controller. Deze update bevat de geplande start- en einddatums en het door SkyPlanner gekozen werkcentrum. Tijdens de scopebepaling bij de onboarding wordt vastgelegd welke velden precies worden gebruikt en hoe het Finite Schedule-bord de waarden uit die velden verwerkt.
4. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden de planning actueel. U kiest of de werkelijke productiegegevens worden teruggeboekt. Zo ja, dan gaan goedgekeurde producten naar AddProductionRecords en arbeidsuren naar de taakaanroepen van Time & Attendance. Zo niet, dan blijven RealTime en Shopworks rapporteren zoals voorheen en leest SkyPlanner de voortgang uit DELMIAWorks.
5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Artikelen, stuklijsten, cyclustijden, matrijsholten, aantallen en status van productieorders | DELMIAWorks |
| Volgorde van productieorders, start- en eindtijden, toewijzing aan persen | SkyPlanner |
| Omsteltijdenmatrix, eisen aan matrijzen en operators, alternatieve persen | SkyPlanner |
| Diensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Productie, uitval, arbeidsuren en materiaaluitgiften | DELMIAWorks, daar geregistreerd of geboekt vanuit SkyPlanner-tijdregistraties |
Laat slechts één systeem de datums van productieorders schrijven. Schakel Auto Load uit voor de werkcentra die SkyPlanner plant, inclusief alle IQAlert-acties die Update Schedule en Auto Load uitvoeren. Gebruik voor deze werkcentra Running Time Lock in SkyPlanner om de kortetermijnplanning vast te zetten, in plaats van een time fence in DELMIAWorks.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Valideer de planning vooraf tijdens de gratis proefperiode van 30 dagen, met werkcentra, stuklijsten en openstaande productieorders die u vanuit DELMIAWorks als CSV of Excel exporteert.
- Gegevensmapping. Leg de mappingtabel, de regels voor gegevenseigenaarschap en de synchronisatiefrequenties vast. Bepaal ook of productie en arbeidsuren worden teruggeboekt.
- Toegang tot DELMIAWorks. Maak de integratiegebruiker aan en controleer de WebAPI-licentie. Test eerst in een testdatabase.
- Eerste gegevensimport. Artikelen, stuklijsten, artikelbewerkingen, werkcentra, matrijzen en kalenders.
- Productieorders en inkooporders synchroniseren. Via polling met filters en herhaalpogingen.
- Beperkingen instellen in SkyPlanner. Omsteltijdenmatrix, matrijzen als gereedschappen, aantal operators per taak, alternatieve persen en personeel.
- Planning terugschrijven. Productieorders bijwerken via webhooks van SkyPlanner, plus productie en arbeidsuren terugboeken als u daarvoor kiest.
- Parallel testen. Laat SkyPlanner naast de huidige Finite Schedule draaien, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel Auto Load uit voor de werkcentra die worden ingepland en schakel het terugschrijven in.
Aandachtspunten voor een DELMIAWorks-koppeling
- Familiematrijzen. Eén matrijs maakt meerdere artikelen in één cyclus. Modelleer zo’n productierun als één taak die alle bijbehorende artikelen produceert, zodat de matrijs maar één keer wordt gereserveerd.
- Caviteiten. Het werkelijke aantal caviteiten kan afwijken van het standaardaantal wanneer een caviteit is geblokkeerd. Bepaal of de bewerkingstijden worden berekend met het standaardaantal of met de waarde ActualCavity uit RealTime.
- Passende persen per matrijs. Niet elke matrijs past op elke pers. Stel de toegestane persen per matrijs in als alternatieven in SkyPlanner, zodat werk alleen wordt verplaatst naar een geschikte pers.
- Kleur- en materiaalwissels. Vul de omsteltijdenmatrix met de werkelijke tijden voor doorspoelen en matrijswissels in beide richtingen. Van blauw naar rood kan bijvoorbeeld 30 minuten duren en van rood naar blauw 60.
- Auto Load en planningsgrenzen. Twee planningssystemen die datums wegschrijven, werken elkaar tegen. Schakel beide vóór ingebruikname uit voor de werkcentra die SkyPlanner inplant.
Wie configureert en ondersteunt de DELMIAWorks-koppeling?
- Het SkyPlanner-team configureert de koppeling tijdens de onboarding en biedt ondersteuning na ingebruikname, voor de afgesproken WebAPI-controllers. Elke fabriek gebruikt DELMIAWorks op een eigen manier. Die praktijkkennis wordt hierin verwerkt.
- Uw DELMIAWorks-partner kan meewerken. Uw partner kent uw versie, aangepaste velden en licenties en kan samen met het SkyPlanner-team de integratiegebruiker en WebAPI instellen.
- Uw eigen ontwikkelaars kunnen de koppeling verder uitbouwen via de REST API van SkyPlanner, met een API-token in de
Authorization-Token-header. Het SkyPlanner-team helpt waar nodig. De integratiedocumentatie vindt u in de SkyPlanner-integratiedocumentatie.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning met DELMIAWorks, de DELMIAWorks-pagina en het overzicht van ERP-koppelingen.
Ervaringen van productiebedrijven met SkyPlanner
2 uurbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd, en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
98%leverbetrouwbaarheid, gestegen van ongeveer 50%
“SkyPlanner speelt een doorslaggevende rol bij het op peil houden van onze leverbetrouwbaarheid.”
Hannu Lahtinen, algemeen directeur
KJH-Comp · Plaatbewerking en productie in opdracht
De leverbetrouwbaarheid steeg van ongeveer 50% naar wel 98%. Voor de planning is nu één leidinggevende nodig in plaats van twee.
6 maandenvooruit zicht op vrije capaciteit voor de verkoopafdeling
“SkyPlanner biedt een betrouwbare basis voor de volledige productieplanning.”
Anu Järvinen, productiemanager
Fredman Operations · Voedselveilig verpakkingspapier
De verkoopafdeling ziet de vrije capaciteit zes maanden vooruit. Verzoeken om de planning aan te passen die vroeger een uur of langer kostten, worden nu binnen enkele seconden beantwoord.
Veelgestelde vragen
Welke API van DELMIAWorks gebruikt SkyPlanner?
De DELMIAWorks WebAPI. SkyPlanner leest gegevens via de REST-controllers, of via de GraphQL SDK voor bulkgegevens. Terugschrijven gebeurt via de REST-controllers: updates van productieorders via de WorkOrders-controller, AddProductionRecords en de taakaanroepen van Time & Attendance.
Wat schrijft SkyPlanner terug naar DELMIAWorks?
De geplande start- en einddatum en het toegewezen werkcentrum voor elke productieorder. Als u daarvoor kiest, worden goedgekeurde producten als productieregistraties geboekt en instel- en bewerkingstijden als arbeidsuren per taak.
Werkt de koppeling met IQMS EnterpriseIQ?
DELMIAWorks is de huidige naam van IQMS EnterpriseIQ. De koppeling gebruikt de WebAPI. Doorslaggevend is dus of de WebAPI voor uw versie is geïnstalleerd en gelicentieerd. Uw partner bevestigt dit tijdens de scopebepaling.
Hoe worden matrijzen en familiematrijzen verwerkt?
Matrijzen worden in SkyPlanner als gereedschappen met beperkte beschikbaarheid gemodelleerd, zodat één matrijs nooit tegelijk in twee persen wordt ingezet. Een productierun met een familiematrijs is één taak die alle bijbehorende artikelen produceert. De toegestane persen per matrijs worden als alternatieven ingesteld.
Wat gebeurt er met Auto Load?
Schakel Auto Load uit voor de werkcentra die SkyPlanner inplant, inclusief de IQAlert-acties die Auto Load uitvoeren. Alleen SkyPlanner schrijft dan nog de datums van productieorders voor die werkcentra weg.
Wie bouwt de koppeling?
Het SkyPlanner-team configureert de koppeling tijdens de onboarding en biedt ondersteuning na ingebruikname. Uw DELMIAWorks-partner of uw eigen ontwikkelaars kunnen ook verder bouwen op de REST API van SkyPlanner met een API-token.
