Integrationer / ERP / Oracle Fusion Cloud
Guide til integration af Oracle Fusion Cloud med SkyPlanner APS til produktionsplanlægning
Denne guide viser partnere og IT-teams, hvordan de forbinder Oracle Fusion Cloud Manufacturing med SkyPlanner APS. SkyPlanner integreres med Oracle Fusion Cloud i begge retninger via Oracles egne REST-ressourcer:
- Produktionsordrer med tilhørende operationer, arbejdsdefinitioner, arbejdscentre, produktionsressourcer, kalendere, varer, varestrukturer, lagerbeholdninger og indkøbsordrer overføres til SkyPlanner.
- Planlagte start- og slutdatoer sendes tilbage til hver operation på produktionsordren.
- Operatørernes tilbagemeldinger sendes tilbage som operations- og ressourcetransaktioner.
- SkyPlanner sender ændringer i planen via webhooks, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres Oracle Fusion Cloud-opsætning under onboarding og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, som vil deltage i arbejdet eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
Integrationsgrænseflader i Oracle Fusion Cloud
Oracle Fusion Cloud giver et eksternt planlægningssystem tre veje til data:
- REST API for Oracle Fusion Cloud SCM. Basisstien er
/fscmRestApi/resources/11.13.18.05/. Et planlægningssystem bruger ressourcerneworkOrders(med de underordnede ressourcerWorkOrderOperation,WorkOrderOperationResourceogWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructuresoginventoryOnhandBalances. Fremdrift registreres viaoperationTransactions,resourceTransactionsogmaterialTransactions. Indkøbsordrer hentes frapurchaseOrdersi Procurement REST API. (REST-endpoints) - File-Based Data Import (FBDI). Processen Import Work Orders opretter eller opdaterer produktionsordrer med tilhørende operationer og operationsressourcer ud fra en skabelon, og Import Work Order Resource Transactions indlæser ressourceposteringer. Oracle er tydelig om tidsaspektet: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Denne mulighed er ikke egnet til import af produktionsdata i realtid.) (kilde)
- Oracle Integration (OIC). Oracles integrationsplatform håndterer dataflow mellem Fusion og andre systemer. En integrationsopskrift i Oracle Integration lytter efter hændelsen Work Order Status Change i Oracle Fusion Cloud Manufacturing (kilde). Brug den, hvis jeres virksomhed allerede anvender OIC.
REST er den primære vej til løbende detailplanlægning. FBDI egner sig til den første indlæsning af stamdata.
Autentificering og adgang
- Sikkerhed i Oracle REST. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (REST API’erne i Fusion Applications bruger en global sikkerhedspolitik i Oracle Web Services Manager (OWSM) med navnet Multi Token Over SSL RESTful Service Policy.) Den accepterer Basic-autentificering via SSL og tokenbaseret autentificering, f.eks. med et SAML 2.0 bearer-token. (Kom godt i gang)
- Integrationsbruger. Opret en særskilt Oracle-bruger til integrationen. Tildel jobroller med de nødvendige rettigheder til produktionsordrer, arbejdsdefinitioner, lager og transaktioner, og begræns adgangen til de produktionsorganisationer, integrationen omfatter.
- Sideinddeling. Oracle begrænser antallet af poster, som et enkelt SCM REST-kald returnerer. Læs derfor med
limitogoffset, og filtrer efter organisation og status (kilde)
Hos SkyPlanner bruger REST API’et et API-token i headeren Authorization-Token til autentificering (SkyPlanner Settings > API) og er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Hændelser og polling
Data fra Oracle hentes via polling. Filtrerede REST-forespørgsler henter nye og ændrede produktionsordrer, statusændringer til frigivet, lagerbeholdninger og indkøbsordrer. Hyppigheden fastsættes for hver fabrik, fra med få minutters mellemrum for produktionsordrer til hver time for lagerbeholdninger. Hvis I bruger Oracle Integration, kan hændelsen Work Order Status Change udløse en øjeblikkelig læsning.
SkyPlanner sender webhooks, når tilstanden eller planen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| Oracle Fusion Cloud-objekt (REST-ressource) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
Varer (itemsV2), måleenheder | Produkter og materialer | Oracle → SkyPlanner | Første indlæsning, derefter polling |
Varestrukturer (itemStructures) | Produktstruktur, delprodukter, materialer pr. produkt | Oracle → SkyPlanner | Første indlæsning, derefter ved ændringer |
Arbejdsdefinitioner (workDefinitions): operationer, operationsressourcer, forbrug, Basis Type | Procestrin med varigheder, klargørings- og afslutningstider | Oracle → SkyPlanner | Første indlæsning, derefter ved ændringer |
Arbejdscentre (workCenters), produktionsressourcer (productionResources) til udstyr og arbejdskraft | Arbejdsstationer, grupper af arbejdsstationer, personale, effektivitetsgrader | Oracle → SkyPlanner | Første indlæsning, derefter sjældent |
Kalendere og skiftehold (calendars, skifteholdsundtagelser) | Skiftehold og arbejdsfrie dage | Oracle → SkyPlanner | Dagligt, eller egne skiftehold i SkyPlanner |
| Produktionsorganisationer | Grupper af arbejdsstationer pr. fabrik | Oracle → SkyPlanner | Første indlæsning |
Produktionsordrer (workOrders, processWorkOrders) med WorkOrderOperation og WorkOrderOperationMaterial | Ordrer og opgaver med leveringsfrister og materialebehov | Oracle → SkyPlanner | Polling med få minutters mellemrum |
Lagerbeholdninger (inventoryOnhandBalances) | Lagerbeholdninger | Oracle → SkyPlanner | Polling hver time eller ved planlægningskørsel |
Indkøbsordrer (purchaseOrders) med lovede leveringsdatoer | Indkøbsordrer, indgående materialer efter leveringsdato | Oracle → SkyPlanner | Polling hver time eller ved planlægningskørsel |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Planlagt start og slut pr. opgave | SkyPlanner → Oracle | Ved ændringer i planen via SkyPlanner-webhook |
Datoer for WorkOrderOperationResource (PATCH) | Ressourcetildeling pr. opgave | SkyPlanner → Oracle | Ved ændringer i planen, hvis valgt |
operationTransactions (POST) | Færdigmeldte mængder pr. operation | SkyPlanner → Oracle | Ved hver tilbagemelding |
resourceTransactions (POST) | Tidsregistreringer: arbejds- og maskintid | SkyPlanner → Oracle | Ved hver tilbagemelding eller pr. skiftehold, hvis valgt |
| Findes ikke i Oracle Fusion Cloud | Matrix for klargørings- og afslutningstider, værktøjer som ressourcer med begrænset kapacitet, alternative maskiner og medarbejdere | Vedligeholdes i SkyPlanner | Opsættes under onboarding |
Integrationsmønstre
1. Første indlæsning af stamdata. Hent varer, varestrukturer, arbejdsdefinitioner, arbejdscentre, produktionsressourcer og kalendere via REST, eller indlæs dem én gang fra FBDI-udtræk. Tag bevidst stilling til mapping af arbejdscentre: Et arbejdscenter med fire maskiner knyttet til samme ressource bliver til én gruppe af arbejdsstationer eller fire arbejdsstationer. Hver produktionsorganisation bliver til en gruppe af arbejdsstationer, så alle fabrikker indgår i én plan.
2. Synkronisering af produktionsordrer. Læs frigivne og ikke-frigivne produktionsordrer med tilhørende operationer og materialer samt åbne indkøbsordrer. SkyPlanner betragter bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered.
Planlæg produktionsordrer, ikke planlagte ordrer fra Supply Planning. Planlagte ordrer skal først omdannes til produktionsordrer i Oracle.
3. Tilbageskrivning af planen. Når planlægningsmotoren placerer eller flytter en opgave, udløser en webhook fra SkyPlanner et PATCH-kald til workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} med PlannedStartDate og PlannedCompletionDate. Oracles regel gælder: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (Den planlagte startdato må ikke ligge før produktionsordrens startdato eller efter dens slutdato.) (kilde) Hvis den nye plan ligger uden for disse datoer, opdaterer integrationen derfor først datoerne i produktionsordrens hoved med PATCH og derefter operationerne.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen ajour. Færdigmeldte mængder sendes til operationTransactions, og arbejds- og maskintid sendes til resourceTransactions. Hvis fabrikken allerede indberetter i Oracle, læser SkyPlanner i stedet fremdriften derfra.
5. Regler for dataejerskab og konflikter. Skriv dem ned inden idriftsættelsen:
| Data | Ejer |
|---|---|
| Varer, varestrukturer, arbejdsdefinitioner, mængder, produktionsordrens status | Oracle Fusion Cloud |
| Operationsrækkefølge, start- og sluttidspunkter, tildeling af ressourcer | SkyPlanner |
| Matrix for klargørings- og afslutningstider, krav til værktøjer og operatører, alternative ressourcer | SkyPlanner |
| Skiftehold og arbejdsfri dage | Ét system, som vælges under afklaringen |
| Ressource-, operations- og materialetransaktioner | Oracle, med registrering direkte i Oracle eller overførsel fra SkyPlanners tidsregistreringer |
Vælg ét system til at skrive operationernes datoer. SkyPlanner kræver intet planlægningsarbejdsområde i Oracle og erstatter derfor Production Scheduling som det system, der skriver de planlagte datoer. Hvis Production Scheduling fortsat frigiver planer, skal dets organisationer holdes adskilt fra dem, SkyPlanner planlægger for.
Typiske projekttrin
Implementeringen afsluttes normalt i løbet af ugerne efter starten på onboarding, også i store virksomheder. Inden da kan I validere planen i den gratis prøveperiode på 30 dage med arbejdscentre, arbejdsdefinitioner og åbne produktionsordrer eksporteret fra Oracle som CSV eller Excel.
- Mapping. Fastlæg mappingtabellen, reglerne for dataejerskab, de omfattede organisationer, synkroniseringshyppigheden og om transaktioner skal skrives tilbage.
- Adgang til Oracle. Opret integrationsbrugeren og rollerne. Test først i et Oracle-miljø, der ikke er i produktion.
- Første indlæsning. Varer, varestrukturer, arbejdsdefinitioner, arbejdscentre, produktionsressourcer og kalendere.
- Synkronisering af produktionsordrer og indkøbsordrer. Polling med filtre, paginering og genforsøg.
- Opsætning af begrænsninger i SkyPlanner. Matrix for klargørings- og afslutningstider, værktøjer, antal operatører pr. opgave og alternative maskiner eller medarbejdere.
- Tilbageskrivning af planen. PATCH-kald udløst af webhooks fra SkyPlanner samt transaktioner, hvis det er valgt.
- Paralleltest. Kør SkyPlanner parallelt med den nuværende plan, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning fabrik for fabrik, når data stemmer overens.
Det skal I tage højde for ved en integration med Oracle Fusion Cloud
- Standardplanlæggerens adfærd. Oracles planlægningsmotor uden kapacitetsbegrænsninger kører ved oprettelse og “certain update actions.” (visse opdateringshandlinger). Test i jeres miljø, hvilke opdateringer der genberegner datoer, og sørg for, at SkyPlanner er det sidste system, der skriver operationernes datoer.
- Produktionsordrernes tidsrammer. Operationernes datoer skal ligge inden for produktionsordrens start- og slutdato. Opdatér først ordrehovedet med PATCH.
- Basis Type. Ressourceforbruget er kun angivet pr. enhed, når Basis Type er Variable. Fixed betyder en fast tid pr. operation. Omregn ved import, ellers bliver alle varigheder forkerte.
- Diskret produktion og procesproduktion. Fabrikker med diskret produktion bruger
workOrders, mens procesfabrikker brugerprocessWorkOrders. Map begge, hvis I har begge produktionstyper. - Paginering. Oracle begrænser antallet af poster pr. REST-kald. Brug paginering i alle forespørgsler, og filtrér efter organisation og status.
- Kvartalsvise opdateringer. Oracle opdaterer Fusion hvert kvartal. Lås REST-versionen i stien, og test igen efter hver opdatering.
- Statusregler. Produktionsordrer med status Pending Approval eller lukket status bør ikke få nye datoer. Filtrér dem fra ved læsning.
Hvem opsætter og supporterer integrationen med Oracle Fusion Cloud?
- SkyPlanner-teamet opsætter integrationen under opstarten og yder support efter idriftsættelsen for de aftalte REST-ressourcer og organisationer. Hver fabrik bruger Oracle Fusion Cloud på sin egen måde, og her kommer den viden i spil.
- Jeres Oracle-partner kan deltage. Partneren kender jeres organisationer, roller og udvidelser og kan sammen med SkyPlanner-teamet opsætte integrationsbrugeren, rollerne og eventuelle flows i Oracle Integration.
- Jeres egne udviklere kan bygge videre på integrationen via SkyPlanners REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. I finder integrationsdokumentationen i SkyPlanners integrationsdokumentation.
SkyPlanner fås fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen, tilpasset jeres processer og behov, sammen med abonnementet. Se priser, produktionsplanlægning med Oracle Fusion Cloud inden for den faktiske maskin- og personalekapacitet, siden om Oracle Fusion Cloud og oversigten over ERP-integrationer. Bruger I NetSuite? Se integrationsguiden til NetSuite.
Produktionsvirksomheders anmeldelser af SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-ark til produktionsoptimering i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når frem til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
99,2%leveringssikkerhed
“SkyPlanner har gjort det lettere at få øje på flaskehalse og skabt mere overblik i produktionsstyringen.”
Toni Tuori, produktionschef
Piristeel · Tagsikkerhed og regnvandssystemer
Leveringssikkerheden nåede 99,2% i år, og planlægningen sparer op til fire timers arbejdstid om dagen.
1.000-visaf produktionsordrer planlagt automatisk
“Vi har fået styr på produktionen på en helt anden måde, og vores forståelse af kapaciteten er på et helt andet niveau.”
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle blandere, pumper og højteknologisk kontraktproduktion
Tusindvis af produktionsordrer planlægges automatisk, og hele organisationen har overblik over produktionen i realtid.
Ofte stillede spørgsmål
Har Oracle Fusion Cloud et API til produktionsordrer?
Ja. REST API til Oracle Fusion Cloud SCM har workOrders med underressourcer til operationer, ressourcer og materialer samt processWorkOrders til procesproduktion. Det understøtter GET, POST og PATCH.
Hvordan skrives planlagte datoer tilbage til Oracle Fusion Cloud?
Med et PATCH-kald til produktionsordrens underressource WorkOrderOperation, som sætter PlannedStartDate og PlannedCompletionDate. Operationernes datoer skal ligge inden for produktionsordrens datoer, så ordrehovedet opdateres først med PATCH, når det er nødvendigt.
Hvordan overføres operatørernes tilbagemeldinger til Oracle?
Færdigmeldte mængder sendes til operationTransactions, og arbejds- og maskintid sendes til resourceTransactions. Begge er REST-ressourcer i Fusion Manufacturing, der understøtter POST.
Understøtter Oracle Fusion Cloud webhooks?
Fusion publicerer forretningshændelser som Work Order Status Change, som Oracle Integration kan abonnere på. Uden Oracle Integration forespørger integrationen REST API’et med et interval, der fastlægges for hver fabrik. SkyPlanners egne webhooks sender ændringer i produktionsplanen, så snart de sker.
Bør en Oracle-partner foreslå Oracle Production Scheduling eller SkyPlanner?
SkyPlanner, når kunden ønsker én samlet produktionsplan på tværs af fabrikker, der tager højde for den faktiske kapacitet og holder sig selv opdateret. Production Scheduling aktiveres under Supply Chain Planning, beregner planen for hver planlægningsorganisation og anvender kun omstillingsregler på udstyr med én enhed (Oracles dokumentation). SkyPlanner tilsluttes via SCM REST API, omplanlægger automatisk og planlægger omstillinger, værktøjer, bemanding og materialer. Prisen starter ved 199 € pr. måned med et ubegrænset antal brugere.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med import af CSV- eller Excel-filer fra Oracle. Der kræves ikke kreditkort. Start prøveperioden, eller kontakt salg for at få afklaret integrationens omfang.