Οδηγός διασύνδεσης του Epicor Kinetic για χρονοπρογραμματισμό παραγωγής με το SkyPlanner APS

Η Epicor αναφέρει: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Όλες οι υπηρεσίες του Kinetic, συμπεριλαμβανομένων των επιχειρησιακών αντικειμένων, διαδικασιών, αναφορών, BAQs και Epicor Functions, είναι προσβάσιμες μέσω REST endpoints.) Η διασύνδεση για τον χρονοπρογραμματισμό βασίζεται σε τέσσερις τεχνολογίες της Epicor:

1. Kinetic REST API v2 (OData v4). Τα επιχειρησιακά αντικείμενα διατίθενται ως υπηρεσίες με ονόματα της μορφής Erp.BO.<Name>Svc. Η συνήθης διαδρομή είναι /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. Το REST v1 εξακολουθεί να υπάρχει, αλλά είναι παλαιότερη τεχνολογία, οπότε βασίστε την υλοποίησή σας στο v2. Επιβεβαιώστε τα σύνολα οντοτήτων και τις μεθόδους για τη δική σας έκδοση στο REST Help, στη διεύθυνση /api/help/v2/.
2. Business Activity Queries (BAQ) μέσω REST. Κάθε BAQ διατίθεται στη διαδρομή /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Είναι ένας πρακτικός τρόπος άντλησης δεδομένων για τον προγραμματισμό, καθώς επιτρέπει τη συνένωση των JobHead, JobOper, JobMtl, PartWhse και PORel σε μία κλήση (παράδειγμα από την κοινότητα).
3. Epicor Functions (EFx). Συναρτήσεις που εκτελούνται στον διακομιστή και καλούνται στη διαδρομή /api/v2/efx/{Company}/{Library}/{Function}. Η Epicor αναφέρει ότι “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (μπορούν να ενεργοποιηθούν από πολλά σημεία εισόδου, όπως BPM, υπηρεσίες REST, προγραμματισμένες εκτελέσεις και συμβάντα εφαρμογών).
4. Οδηγίες BPM. Τα Method Directives και Data Directives ενεργοποιούνται όταν αλλάζει μια εργασία ή φάση και μπορούν να καλέσουν μια συνάρτηση που αποστέλλει δεδομένα σε εξωτερικό σύστημα.

Για ανταλλαγή αρχείων, το DMT αναλαμβάνει τις εισαγωγές και οι εξαγωγές BAQ παρέχουν τα εξερχόμενα δεδομένα. Η Epicor προσφέρει επίσης το Epicor Automation Studio, το οποίο περιγράφει ως “a low-code app for integration-led automations” (εφαρμογή χαμηλού κώδικα για αυτοματισμούς που βασίζονται σε διασυνδέσεις). Αποφύγετε την απευθείας πρόσβαση στη βάση δεδομένων: τα REST, BAQs και οι συναρτήσεις λειτουργούν με τον ίδιο τρόπο τόσο σε τοπικές εγκαταστάσεις όσο και στο Kinetic Cloud.

Η Epicor δεν τεκμηριώνει κάποιο γενικό API για εξερχόμενα webhooks, οπότε οι αλλαγές του Kinetic φτάνουν στο SkyPlanner με έναν από δύο τρόπους:

• Με ενεργοποίηση από συμβάντα. Μια BPM Data Directive στο JobHead ή στο JobOper καλεί μια Epicor Function, η οποία αποστέλλει την τροποποιημένη εντολή παραγωγής στο REST API του SkyPlanner.
• Προγραμματισμένος περιοδικός έλεγχος. Ένα BAQ με φίλτρο στην ημερομηνία αλλαγής εκτελείται κάθε λίγα λεπτά ή κάθε ώρα. Είναι απλούστερο στη διαχείριση και στην αποκατάσταση μετά από σφάλμα.

Στην αντίθετη κατεύθυνση, το SkyPlanner αποστέλλει αλλαγές κατάστασης και προγράμματος μέσω των webhooks του. Το ενδιάμεσο λογισμικό σας ή ένα EFx endpoint τις λαμβάνει και τις καταχωρίζει στο Kinetic.

1. Αρχική φόρτωση βασικών δεδομένων. Αντλήστε είδη, ομάδες πόρων, πόρους, δυνατότητες, ημερολόγια και εργαζομένους. Δημιουργήστε τα κέντρα εργασίας του SkyPlanner από τους πόρους του Kinetic και τις ομάδες κέντρων εργασίας από τις ομάδες πόρων. Για μεγάλους όγκους δεδομένων, χρησιμοποιήστε σελιδοποίηση με $top και $skip ή μαζική ανάκτηση μέσω BAQ.

2. Συγχρονισμός παραγγελιών. Αποστείλετε τις εντολές παραγωγής που έχουν αποδεσμευτεί και οριστικοποιηθεί, μαζί με τις φάσεις και τα υλικά τους. Ανακτήστε ολόκληρη τη δενδρική δομή της εντολής με GetDatasetForTree ή με BAQ, όχι κάθε οντότητα χωριστά. Αφήστε τις μη οριστικοποιημένες εντολές MRP στο Kinetic μέχρι να οριστικοποιηθούν. Παράλληλα με την ανάκτηση αποθεμάτων, συγχρονίστε τις ανοικτές τμηματικές παραδόσεις εντολών αγοράς μαζί με τις ημερομηνίες παράδοσής τους. Το SkyPlanner θεωρεί τα παραγγελμένα υλικά διαθέσιμα κατά την ημερομηνία παράδοσης και ενημερώνει το απόθεμα όταν η εντολή αγοράς επισημανθεί ως Delivered. Έτσι, ο χρονοπρογραμματισμός ελέγχει τόσο το απόθεμα όσο και τις αναμενόμενες αγορές.

3. Εγγραφή του χρονοπρογράμματος στο Kinetic. Το webhook του SkyPlanner στέλνει την προγραμματισμένη έναρξη, λήξη και το κέντρο εργασίας κάθε φάσης σε ένα endpoint EFx (/api/v2/efx/{Company}/{Library}/{Function}). Η συνάρτηση πραγματοποιεί την εγγραφή μέσω της μηχανής χρονοπρογραμματισμού του Kinetic, δηλαδή του ίδιου επιχειρησιακού αντικειμένου που χρησιμοποιούν ο χρονοπρογραμματισμός στο Job Entry και οι πίνακες χρονοπρογραμματισμού (παράδειγμα από την κοινότητα):

1. Η ScheduleEngine.GetNewParamsForJob δημιουργεί το σύνολο δεδομένων που χρειάζεται η μηχανή χρονοπρογραμματισμού για την εντολή παραγωγής.
2. Η συνάρτηση ορίζει τον αριθμό εντολής παραγωγής, τους αριθμούς ακολουθίας συναρμολόγησης και φάσης, καθώς και την προγραμματισμένη ημερομηνία και ώρα έναρξης. Στη συνέχεια καλεί τη ScheduleEngine.MoveJobItem.
3. Όταν το SkyPlanner έχει τοποθετήσει τη φάση σε άλλον πόρο της ομάδας, η ScheduleEngine.ChangeResource τη μεταφέρει σε αυτόν. Η MoveJobItem από μόνη της διατηρεί τον προεπιλεγμένο πόρο της ομάδας.
4. Η συνάρτηση ενεργοποιεί το κλείδωμα χρονοπρογράμματος της εντολής παραγωγής (JobHead.SchedLocked, η επιλογή Lock στο Job Entry), ώστε το Global Scheduling να διατηρεί τις ημερομηνίες του SkyPlanner.

Η συγκέντρωση αυτών των κλήσεων σε μία Epicor Function εξασφαλίζει ατομική εγγραφή ανά εντολή παραγωγής και σας επιτρέπει να προσθέσετε τους δικούς σας ελέγχους εγκυρότητας. Αν μια εγκατάσταση προτιμά να μην έχει προσαρμοσμένη συνάρτηση, η ίδια ακολουθία εκτελείται με απευθείας κλήσεις REST στο Erp.BO.ScheduleEngineSvc. Μην γράφετε ποτέ απευθείας στο ResourceTimeUsed ή στα πεδία ημερομηνιών του JobOper: έτσι παρακάμπτεται η μηχανή και οι κατανομές στους πίνακες παύουν να συμφωνούν με το χρονοπρόγραμμα.

4. Επιβεβαιώσεις από την παραγωγή. Οι χειριστές καταγράφουν την εργασία τους στο SkyPlanner με τα Mobile Confirmations, Production Timer ή Quick Log Mode. Κάθε ολοκληρωμένη καταγραφή χρόνου μεταφέρεται ως καταχώριση εργασίας στο Kinetic μέσω του Erp.BO.LaborSvc: με StartActivity και EndActivityByEmp για δραστηριότητα σε πραγματικό χρόνο ή με Labors και Update για εκ των υστέρων καταχωρίσεις. Αν η εγκατάστασή σας απαιτεί έγκριση, συμπεριλάβετε το submitForApproval στη ροή και στα δικαιώματα πρόσβασης της διασύνδεσης.

5. Κανόνες ευθύνης και επίλυσης συγκρούσεων. Καταγράψτε τους πριν από την έναρξη της παραγωγικής λειτουργίας:

Οι εργασίες που χρονοπρογραμματίζει το SkyPlanner έχουν ενεργό κλείδωμα χρονοπρογραμματισμού, ώστε το Global Scheduling να μην αλλάζει τις ημερομηνίες τους. Διατηρήστε τον χρονοπρογραμματισμό του Kinetic για όσους πόρους δεν προγραμματίζει το SkyPlanner.

Η υλοποίηση ολοκληρώνεται συνήθως μέσα σε λίγες εβδομάδες από την έναρξη της αρχικής παραμετροποίησης. Ένα έργο διασύνδεσης με το Kinetic καλύπτει:

1. Δοκιμή 30 ημερών με εξαγωγές εργασιών, φάσεων και πόρων σε CSV ή Excel, πριν από οποιαδήποτε ανάπτυξη.
2. Κλειδί API, πεδίο πρόσβασης, αποκλειστικό χρήστη για τη διασύνδεση και τα BAQs που αυτή διαβάζει.
3. Αντιστοίχιση βασικών δεδομένων: των δυνατοτήτων, ομάδων πόρων, πόρων, ημερολογίων και εργαζομένων με τους σταθμούς εργασίας, τις ομάδες, τις βάρδιες και το προσωπικό του SkyPlanner.
4. Αρχική φόρτωση ειδών, μεθόδων παραγωγής (BOM και φάσεων) και πόρων.
5. Συγχρονισμός εντολών παραγωγής και εντολών αγοράς (ημερομηνίες παράδοσης του PORel), καθώς και αποθέματος από το PartWhse.
6. Εγγραφή των προγραμματισμένων ημερομηνιών των φάσεων στο Kinetic μέσω ScheduleEngineSvc (MoveJobItem, ChangeResource) μέσα σε μια Epicor Function, με ενεργοποιημένο το κλείδωμα της εντολής παραγωγής.
7. Μεταφορά των επιβεβαιώσεων από την παραγωγή ως καταχωρίσεων εργασίας μέσω LaborSvc.
8. Δοκιμές παράλληλα με το τρέχον πρόγραμμα του Kinetic και, στη συνέχεια, έναρξη παραγωγικής λειτουργίας.

Κανένα εργοστάσιο δεν χρησιμοποιεί το Kinetic ακριβώς όπως κάποιο άλλο. Τα φασεολόγια βάσει δυνατοτήτων, τα ημερολόγια ομάδων πόρων, ο σχεδιασμός των BAQs, οι οδηγίες BPM και οι μέθοδοι επανεγγραφής δεδομένων ανά έκδοση διαφέρουν από εγκατάσταση σε εγκατάσταση. Η σωστή ρύθμισή τους κάνει τη διαφορά ανάμεσα σε ένα πρόγραμμα που εμπιστεύονται οι υπεύθυνοι προγραμματισμού και σε ένα που αναγκάζονται να διορθώνουν.

1. Η ομάδα του SkyPlanner την παραμετροποιεί κατά την αρχική εγκατάσταση και την υποστηρίζει μετά την έναρξη της παραγωγικής λειτουργίας. Η ομάδα αντιστοιχίζει τους πόρους, τις εργασίες και τις τμηματικές παραδόσεις των εντολών αγοράς σας και ρυθμίζει την ανάγνωση των BAQs, τα εναύσματα BPM και τη συνάρτηση επανεγγραφής δεδομένων. Συνδέει το REST API και τα webhooks του SkyPlanner με το Kinetic REST v2. Η υποστήριξη συνεχίζεται όταν αλλάζουν τα BAQs, τα BPMs ή η έκδοση του Kinetic.
2. Ο συνεργάτης σας για το Epicor. Συνεργάτες που ήδη αναπτύσσουν BAQs, BPMs και Epicor Functions μπορούν να χρησιμοποιήσουν το ίδιο τεκμηριωμένο REST API του SkyPlanner, το οποίο διαβάζει και καταχωρίζει εντολές, προϊόντα, υλικά, φάσεις και καταγραφές χρόνου.
3. Οι δικοί σας προγραμματιστές. Εσωτερικές ομάδες με εμπειρία στο Kinetic REST μπορούν να αναπτύξουν τη διασύνδεση απευθείας ή μέσω του Automation Studio, αν το χρησιμοποιείτε. Ένα κλειδί API του SkyPlanner αρκεί για να ξεκινήσουν (οδηγός διασύνδεσης), ενώ η ομάδα του SkyPlanner βοηθά όπου χρειάζεται. Η τεκμηρίωση του προϊόντος είναι δημόσια διαθέσιμη στην τεκμηρίωση SkyPlanner.

Η ίδια προσέγγιση με API και webhooks λειτουργεί ήδη σε παραγωγικό περιβάλλον με άλλα ERP, για παράδειγμα στην UTU. Στη Laboratory & Allied, η εσωτερική ομάδα πληροφορικής ανέπτυξε τη διασύνδεση με το SAP Business One σε μεγάλο βαθμό μόνη της, με τη βοήθεια του SkyPlanner.

Όποια διαδρομή κι αν επιλέξετε, η αρχή είναι ίδια: ξεκινήστε τη δωρεάν δοκιμή 30 ημερών με εισαγωγές CSV, επιβεβαιώστε ότι το πρόγραμμα λειτουργεί για εσάς και έπειτα υλοποιήστε τη διασύνδεση. Οι τιμές ξεκινούν από 199 € τον μήνα με 5 σταθμούς εργασίας, μηνιαία χρέωση και δυνατότητα ακύρωσης οποιαδήποτε στιγμή. Λαμβάνετε εξαρχής προσφορά για τη διασύνδεση, προσαρμοσμένη στη διαδικασία και στις ανάγκες σας, μαζί με το πακέτο συνδρομής σας, ώστε να γνωρίζετε το συνολικό κόστος πριν ξεκινήσετε.