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

Η τεκμηριωμένη διεπαφή διασύνδεσης του Monitor G5 είναι το Monitor ERP API v1. Συνδυάζει CQRS και REST και χρησιμοποιεί JSON μέσω HTTPS. (Monitor ERP API)

• Τα ερωτήματα διαβάζουν δεδομένα με GET. Δέχονται επιλογές τύπου OData: $filter, $select, $expand, $orderby, $top και $skip.
• Οι εντολές γράφουν δεδομένα με POST, για παράδειγμα Manufacturing/ManufacturingOrderOperations/Update.
• Το Batch εκτελεί πολλές εντολές σε μία συναλλαγή μέσω POST /api/v1/Batch: είτε εκτελούνται όλες είτε καμία. Προσθέστε /Simulate ή /Validate για να δοκιμάσετε μια δέσμη εντολών και να αναιρέσετε τις αλλαγές της. Αυτός είναι ο ασφαλής τρόπος εγγραφής ενός ολόκληρου προγράμματος. (Batch)

Το βασικό URL είναι https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Ο αριθμός εταιρείας συνδυάζει τον αριθμό βάσης δεδομένων και το αναγνωριστικό εταιρείας, για παράδειγμα 004.1.

Για την αδειοδότηση, η Monitor αναφέρει: “It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.” (Τα ερωτήματα και η εξαγωγή πληροφοριών από το API είναι δωρεάν για όλους τους πελάτες. Για τη χρήση εντολών και την εγγραφή δεδομένων στο ERP απαιτείται αγορά του Monitor ERP API.) Προβλέψτε την άδεια εγγραφής στο έργο από την πρώτη ημέρα. (api.monitor.se)

Η τεκμηρίωση του Monitor ERP API δεν περιγράφει webhooks ή συνδρομές σε συμβάντα. Οι αλλαγές εντοπίζονται με περιοδικά ερωτήματα:

• Το Common/EntityChangeLogs (από την έκδοση 2.33) επιστρέφει ChangeType (Update, Create, Delete), EntityTypeId, EntityId και ModifiedTimestamp. Υποβάλετε ερώτημα κάθε λίγα λεπτά και ανακτήστε μόνο τις εγγραφές που έχουν αλλάξει. (EntityChangeLog)
• Περιορίστε τα ερωτήματα εντολών παραγωγής στις ανοιχτές εντολές και χρησιμοποιήστε $top και $skip για τη σελιδοποίηση.

Το SkyPlanner στέλνει webhooks όταν αλλάζει η κατάσταση ή το πρόγραμμα. Έτσι, η εγγραφή δεδομένων πίσω στο Monitor ενεργοποιείται από συμβάντα.

1. Αρχική φόρτωση βασικών δεδομένων. Διαβάστε τα κέντρα εργασίας, τις γραμμές φάσεων, τις γραμμές εναλλακτικών φάσεων, τις γραμμές υλικών, τα είδη και τα ωράρια. Αντιστοιχίστε προσεκτικά κάθε κέντρο εργασίας σε ένα κέντρο εργασίας του SkyPlanner. Ένα κέντρο εργασίας τύπου Pool αντιστοιχεί σε ομάδα κέντρων εργασίας. Τα κέντρα που περιλαμβάνει γίνονται τα κέντρα εργασίας μεταξύ των οποίων επιλέγει η μηχανή χρονοπρογραμματισμού.

2. Συγχρονισμός εντολών. Διαβάστε τις ανοιχτές εντολές παραγωγής μαζί με τους κόμβους, τις φάσεις και τα υλικά τους, καθώς και τα αποθέματα και τις ανοιχτές παραγγελίες αγοράς. Το SkyPlanner θεωρεί τα παραγγελθέντα υλικά διαθέσιμα κατά την ημερομηνία παράδοσης της παραγγελίας αγοράς και ενημερώνει το απόθεμα όταν αυτή λάβει την κατάσταση Delivered. Μετά την πρώτη φόρτωση, οι μεταβολές αντλούνται από το Common/EntityChangeLogs.

3. Εγγραφή του προγράμματος πίσω στο Monitor. Για κάθε φάση που η μηχανή χρονοπρογραμματισμού τοποθέτησε ή μετακίνησε, το SkyPlanner στέλνει ManufacturingOrderOperations/Update με PlannedStartDate και PlannedFinishDate. Αν η φάση μεταφέρθηκε σε άλλο μηχάνημα της ίδιας ομάδας, προηγείται το SetWorkCenter. Οι εντολές για μία εντολή παραγωγής περιλαμβάνονται σε ένα Batch, ώστε το Monitor να τις δέχεται όλες ή καμία. Κατά τις δοκιμές, εκτελέστε τη δέσμη μέσω /Validate.

Στις εκδόσεις του Monitor πριν από την 24.5, οι προγραμματισμένες ημερομηνίες δεν μπορούν να εγγραφούν μέσω Update. Χρησιμοποιήστε αντί γι’ αυτό το ManufacturingOrders/ReplanOperation (από την έκδοση 2.40) με StartDate και FinishDate και ρυθμίστε το RestrictToOrderBounds σύμφωνα με τους κανόνες σας.

4. Επιβεβαιώσεις από την παραγωγή. Διατηρήστε ένα μόνο κανάλι καταγραφής:

• Το Monitor παραμένει το κανάλι καταγραφής. Οι χειριστές καταγράφουν την εργασία τους στο Recording terminal ή μέσω της διασύνδεσης με τα μηχανήματα, όπως και σήμερα. Το SkyPlanner διαβάζει το ManufacturingOrderOperationReportings για να ενημερωθεί για την πρόοδο και αναπροσαρμόζει το πρόγραμμα.
• Το SkyPlanner γίνεται το κανάλι καταγραφής. Οι χειριστές καταγράφουν την εργασία τους με το Mobile Confirmations ή το Production Timer και το SkyPlanner στέλνει ReportManufacturingOrderOperation στο Monitor.

Η καταγραφή και από τις δύο πλευρές διπλοκαταχωρίζει χρόνους και ποσότητες.

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

Η κύρια αιτία συγκρούσεων είναι ότι οι υπεύθυνοι προγραμματισμού συνεχίζουν να επεξεργάζονται το πλάνο προτεραιοτήτων. Η λειτουργία Rescheduling according to New finish και η μεταφορά γραμμών στο Priority planning αντικαθιστούν τις ημερομηνίες που έγραψε το SkyPlanner. Μόλις το SkyPlanner αναλάβει τον καθορισμό της σειράς, το Priority planning χρησιμοποιείται μόνο για προβολή. Με το Autopilot, το SkyPlanner αναπροσαρμόζει αυτόματα το χρονοπρόγραμμα όταν αλλάζουν τα δεδομένα της παραγωγής.

• Συντελεστής διαθεσιμότητας. Το Monitor μετατρέπει την ακαθάριστη δυναμικότητα σε καθαρή μέσω του συντελεστή διαθεσιμότητας, με προεπιλεγμένη τιμή 80 % για κάθε νέο κέντρο εργασίας. Εφαρμόστε τον μόνο μία φορά: είτε ως αποδοτικότητα στο SkyPlanner είτε ως μικρότερη διάρκεια βαρδιών, ποτέ και με τους δύο τρόπους.
• Χρονική ακρίβεια. Στο Day planning, η δυναμικότητα των κέντρων εργασίας εκφράζεται ως βασικός χρόνος ανά ημέρα, χωρίς ώρες βαρδιών. Αντιστοιχίστε τις πραγματικές βάρδιες στο SkyPlanner με βάση τα προγράμματα παραγωγής, ώστε οι εργασίες να τοποθετούνται εντός του ωραρίου εργασίας.
• Χρόνος αναμονής και επικάλυψη. Οι γραμμές φάσεων περιέχουν χρόνο αναμονής και επικάλυψη σε %. Αποφασίστε κατά τον καθορισμό εύρους πώς θα αντιστοιχιστεί το καθένα στο SkyPlanner, διαφορετικά οι χρόνοι διεκπεραίωσης θα αλλάξουν μετά την έναρξη παραγωγικής λειτουργίας.
• Ομάδες κέντρων εργασίας. Οι ομάδες κέντρων εργασίας προγραμματίζονται στο Pool planning, όχι στο Priority planning. Ανακτήστε τα κέντρα εργασίας που περιλαμβάνονται στην ομάδα, όχι μόνο τη γραμμή της ομάδας.
• Απαιτούμενες εκδόσεις. Οι προγραμματισμένες ημερομηνίες μέσω Update απαιτούν την έκδοση 24.5. Τα πεδία δυναμικότητας των κέντρων εργασίας στο API απαιτούν την 24.3 και το OIDC την 25.8. Ελέγξτε το build πριν από τον καθορισμό εύρους.
• Δίκτυο και πιστοποιητικό. Στις τοπικές εγκαταστάσεις, το Monitor παρέχει το API στη θύρα 8001 με αυτοϋπογεγραμμένο πιστοποιητικό. Το SkyPlanner λειτουργεί στο cloud, οπότε προβλέψτε έναν κανόνα τείχους προστασίας ή έναν αναμεταδότη και ρυθμίστε ρητά την εμπιστοσύνη στο πιστοποιητικό.
• Άδειες χρήσης. Κάθε εφαρμογή τρίτου που γράφει δεδομένα χρειάζεται δικούς της χρήστες με άδεια API. Κάθε σύστημα περιλαμβάνει έναν χρήστη API μόνο για ανάγνωση.