Οδηγός διασύνδεσης SAP S/4HANA με το SkyPlanner APS για τον χρονοπρογραμματισμό παραγωγής

Το S/4HANA παρέχει δυνατότητες διασύνδεσης μέσω επίσημα διαθέσιμων υπηρεσιών OData, οι οποίες παρατίθενται στο SAP Business Accelerator Hub (api.sap.com). Η διασύνδεση για τον χρονοπρογραμματισμό βασίζεται σε υπηρεσίες OData V2. Τα IDocs και BAPIs εξακολουθούν να υπάρχουν, αλλά αυτός ο οδηγός χρησιμοποιεί τα επίσημα διαθέσιμα OData APIs.

Έλεγχος ταυτότητας ανά έκδοση

• On-premise και Private Edition. Οι υπηρεσίες ενεργοποιούνται στο SAP Gateway με τη συναλλαγή /IWFND/MAINT_SERVICE. Ο χρήστης της διασύνδεσης χρειάζεται τα αντίστοιχα αντικείμενα εξουσιοδότησης, όπως C_AFRU_AWK για τις επιβεβαιώσεις, C_AFKO_AWK για τις γραμμές κινήσεων υλικών που καταχωρίζονται μαζί τους και M_PLAF_ORG για τις προγραμματισμένες εντολές.
• Public Edition. Οι υπηρεσίες διατίθενται μόνο μέσω ρυθμίσεων επικοινωνίας. Ακολουθώντας τις οδηγίες της SAP για τη ρύθμιση εισερχόμενης επικοινωνίας, δημιουργείτε έναν χρήστη επικοινωνίας, ένα σύστημα επικοινωνίας και μια ρύθμιση επικοινωνίας στην εφαρμογή Communication Arrangements, με βάση ένα σενάριο επικοινωνίας της SAP (SAP_COM_xxxx). Το σενάριο ορίζει ποιες υπηρεσίες διατίθενται και ποιες μέθοδοι ελέγχου ταυτότητας είναι διαθέσιμες:

– με token: ροές bearer μέσω OAuth, SAML ή OpenID Connect, με μεταβίβαση ταυτότητας (principal propagation) σε επιχειρησιακό χρήστη – με πιστοποιητικό πελάτη – με βασικό έλεγχο ταυτότητας και τεχνικό χρήστη επικοινωνίας

Η SAP συνιστά έλεγχο ταυτότητας με token ή πιστοποιητικό.

Από την πλευρά του, το SkyPlanner διαθέτει REST API με έλεγχο ταυτότητας JWT και τεκμηρίωση σε Swagger/OpenAPI (αναφορά API). Έτσι, το ενδιάμεσο λογισμικό χειρίζεται τον έλεγχο ταυτότητας SAP από τη μία πλευρά και το JWT από την άλλη.

APIs για τον χρονοπρογραμματισμό παραγωγής

Υπηρεσία	Οντότητες και ενέργειες που χρησιμοποιούνται	Σκοπός
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2, A_ProductionOrderItem_2, A_ProductionOrderOperation_2, A_ProductionOrderComponent_2, A_ProductionOrderStatus_2, A_ProductionRsceTools_2· ενέργειες ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Εντολές, φάσεις, συστατικά, PRTs, κατάσταση, επιστροφή του χρονοπρογράμματος
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Κέντρα εργασίας, κατηγορίες δυναμικότητας, χρονικά διαστήματα και βάρδιες
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Τυπικά φασεολόγια για προγραμματισμό πριν από τη δημιουργία εντολών
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Πολυεπίπεδη δομή προϊόντος
API_PRODUCT_SRV (Product Master A2X)	A_Product	Υλικά (στο API ονομάζονται Product). Η SAP συνιστά πλέον το API Product (Version 2) για τις περισσότερες οντότητες προϊόντων
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Αποτελέσματα του MRP Live πριν από τη μετατροπή
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Απόθεμα ανά εγκατάσταση και αποθηκευτικό χώρο, για τον έλεγχο διαθεσιμότητας υλικών
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Ανοικτές εντολές αγοράς για αναμενόμενα υλικά
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm· ενέργειες GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Επιβεβαιώσεις και κινήσεις υλικών από τον χώρο παραγωγής

Στο API εντολών παραγωγής, οι φάσεις ταυτοποιούνται με τον συνδυασμό των OrderInternalBillOfOperations και OrderIntBillOfOperationsItem, όχι με τον αριθμό φάσης που βλέπει ο υπεύθυνος προγραμματισμού. Η ενέργεια GetConfProposal του API επιβεβαιώσεων αναφέρεται στην ίδια φάση μέσω των OrderID και OrderOperation. Αποθηκεύστε στο SkyPlanner τόσο τα εσωτερικά κλειδιά όσο και τον αριθμό φάσης από την πρώτη φόρτωση.

Συμβάντα

Το S/4HANA εκπέμπει τα επιχειρησιακά συμβάντα Production Order Created και Production Order Changed, με τα ManufacturingOrder, ProductionOrder, ProductionOrderType και ProductionPlant στο ωφέλιμο φορτίο. Το ωφέλιμο φορτίο περιέχει μόνο κλειδιά, οπότε η διασύνδεση διαβάζει ξανά την εντολή και τις φάσεις της. Το συμβάν Changed ενεργοποιείται σε κάθε αλλαγή της εντολής, γι’ αυτό εφαρμόστε μηχανισμό debounce. Στην αντίστροφη κατεύθυνση, τα webhooks του SkyPlanner στέλνουν ειδοποιήσεις σε πραγματικό χρόνο όταν αλλάζει το χρονοπρόγραμμα ή η κατάσταση μιας εργασίας.

Ξεκινήστε με αρχεία

Για τη δοκιμή, εξαγάγετε εντολές παραγωγής και κέντρα εργασίας από τις αναφορές λίστας του S/4HANA σε Excel ή CSV και εισαγάγετέ τα στο SkyPlanner. Έτσι επαληθεύετε το χρονοπρόγραμμα πριν γίνει οποιαδήποτε παρέμβαση στο Gateway ή στις ρυθμίσεις επικοινωνίας.

1. Φόρτωση βασικών δεδομένων. Φορτώστε υλικά, BOM, κέντρα εργασίας με τα διαστήματα δυναμικότητας και τις βάρδιές τους, καθώς και φασεολόγια. Σε αυτό το στάδιο αποφασίστε ποιο σύστημα θα διαχειρίζεται τις βάρδιες. Ένας καταμερισμός που λειτουργεί: το εργοστασιακό ημερολόγιο παραμένει στο S/4HANA, ενώ τα αναλυτικά προγράμματα βαρδιών, οι απουσίες και οι υπερωρίες τηρούνται στο SkyPlanner, όπου οι υπεύθυνοι προγραμματισμού τα αλλάζουν καθημερινά.

2. Συγχρονισμός εντολών. Εγγραφείτε στα συμβάντα Production Order Created/Changed ή, όπου δεν έχουν ρυθμιστεί επιχειρησιακά συμβάντα, ελέγχετε περιοδικά το A_ProductionOrder_2 βάσει της χρονικής σήμανσης αλλαγής. Φιλτράρετε με βάση την εγκατάσταση, τον τύπο εντολής και την κατάσταση. Στέλνετε τις εντολές κατά τη δημιουργία τους, ώστε το SkyPlanner να μπορεί να προγραμματίζει εκ των προτέρων, και αποδεσμεύστε τις στο S/4HANA (ReleaseOrder ή ReleaseOperation) μόλις τις χρονοπρογραμματίσει το SkyPlanner.

3. Επιστροφή του χρονοπρογράμματος. Όταν ένα webhook του SkyPlanner αναφέρει αλλαγή στο χρονοπρόγραμμα, η διασύνδεση καλεί την ενέργεια ScheduleProductionOrderOperation στο API_PRODUCTION_ORDER_2_SRV για κάθε φάση που άλλαξε. Στέλνει:

• τα ManufacturingOrder, OrderInternalBillOfOperations και OrderIntBillOfOperationsItem ως κλειδιά
• το OpSchedulingMode με τιμή F (προς τα εμπρός), με την έναρξη που όρισε το SkyPlanner στα OpSchedldStartDate και OpSchedldStartTime
• το OpSchedulingStatus με τιμή DISP (ανάθεση προς εκτέλεση) και το υποχρεωτικό OpSchedulingStrategy με τιμή M
• το ETag στο if-match

Όλες οι φάσεις μιας εντολής περιλαμβάνονται σε ένα σύνολο αλλαγών, με τη σειρά που ορίζει το SkyPlanner. Έτσι, το S/4HANA εφαρμόζει ολόκληρο το πρόγραμμα της εντολής με μία κλήση. Η λειτουργία K δεν χρησιμοποιείται ποτέ: διατηρεί τις αρχικές ημερομηνίες των φάσεων και αγνοεί τις ημερομηνίες που αποστέλλονται.

Το SkyPlanner υπολογίζει τις διάρκειες των φάσεων από τις ίδιες πρότυπες τιμές φασεολογίων και τους ίδιους τύπους δυναμικότητας κέντρων εργασίας που χρησιμοποιεί το S/4HANA. Επομένως, η ημερομηνία λήξης που υπολογίζει το S/4HANA με βάση την απεσταλμένη ημερομηνία έναρξης συμφωνεί με το πρόγραμμα του SkyPlanner. Μετά από κάθε σύνολο αλλαγών, η διασύνδεση διαβάζει ξανά τις φάσεις και επισημαίνει κάθε ημερομηνία που διαφέρει, ώστε ο υπεύθυνος προγραμματισμού να τη βλέπει πριν από την επόμενη βάρδια.

4. Επιβεβαιώσεις από τον χώρο παραγωγής. Κάθε καταγραφή χρόνου από το Mobile Confirmations ή το Production Timer μετατρέπεται σε επιβεβαίωση στο S/4HANA. Το webhook του SkyPlanner ενεργοποιεί την καταχώριση ProdnOrdConf2 με την ποσότητα καλών τεμαχίων, τη φύρα και τους χρόνους δραστηριοτήτων. Η διασύνδεση καλεί πρώτα το GetConfProposal, ώστε το S/4HANA να προτείνει ποσότητες, δραστηριότητες, ημερομηνίες και στοιχεία προσωπικού. Το GetGdsMvtProposal προτείνει τις κινήσεις υλικών.

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

Το S/4HANA παραμένει το σύστημα αναφοράς για τις παραλαβές: όταν καταχωρίζεται μια παραλαβή αγαθών, το απόθεμα αυξάνεται και η ανοικτή ποσότητα της γραμμής της εντολής αγοράς μειώνεται. Ο επόμενος συγχρονισμός ενημερώνει το απόθεμα στο SkyPlanner και ορίζει μια εντολή αγοράς που έχει παραληφθεί πλήρως ως Delivered. Μετά από μερική παραλαβή, η υπόλοιπη ανοικτή ποσότητα παραμένει αναμενόμενη κατά την ημερομηνία της αντίστοιχης γραμμής προγράμματος παράδοσης. Η διαχείριση των εντολών αγοράς στο SkyPlanner περιγράφεται στην τεκμηρίωση του SkyPlanner.

5. Κανόνες αρμοδιότητας. Το S/4HANA διαχειρίζεται τις ποσότητες, τη BOM, το φασεολόγιο, την κοστολόγηση και την κατάσταση. Το SkyPlanner διαχειρίζεται την αλληλουχία, την ανάθεση σε κέντρα εργασίας και τις ημερομηνίες των φάσεων. Μην επιτρέπετε ποτέ και στα δύο συστήματα να γράφουν στο ίδιο πεδίο. Αν οι υπεύθυνοι προγραμματισμού εξακολουθούν να μετακινούν φάσεις στο Capacity Scheduling Board, αποφασίστε ποια αλλαγή υπερισχύει. Είτε ο επόμενος συγχρονισμός εντολών μεταφέρει την αλλαγή τους στο SkyPlanner είτε το συγκεκριμένο κέντρο εργασίας παραμένει εκτός του πεδίου διαχείρισης του SkyPlanner.

• Η επιστροφή δεδομένων γίνεται με κλήση ενέργειας και ETag. Ο τεκμηριωμένος τρόπος χρονοπρογραμματισμού μιας φάσης είναι η ενέργεια ScheduleProductionOrderOperation, όχι ένα PATCH στο A_ProductionOrderOperation_2. Η λειτουργία F προγραμματίζει προς τα εμπρός από την έναρξη και η B προς τα πίσω από τη λήξη, ενώ οι K και S διατηρούν τις υφιστάμενες ημερομηνίες και αγνοούν αυτές που στέλνετε. Το ETag στο if-match σχηματίζεται από το LastChangeDateTime της εντολής (YYYYMMDDHHMMSS), οπότε οποιαδήποτε αλλαγή στην εντολή το καθιστά παρωχημένο. Υλοποιήστε ανάγνωση πριν από κάθε εγγραφή και ουρά επαναπροσπαθειών.
• Η δυναμικότητα δεν βρίσκεται στην κεφαλίδα του κέντρου εργασίας. Η διαθέσιμη δυναμικότητα προκύπτει από την κατηγορία δυναμικότητας (001 μηχανή, 002 ανθρώπινη εργασία), το εργοστασιακό ημερολόγιο και τα χρονικά διαστήματα και τις βάρδιες που υπερισχύουν αυτού. Οι τύποι υπολογισμού δυναμικότητας μετατρέπουν τις πρότυπες τιμές του φασεολογίου σε απαιτήσεις προετοιμασίας, επεξεργασίας και αποσυναρμολόγησης. Διαβάστε το A_WorkCenterCapacityInterval_2 και τις οντότητες βαρδιών και συμφωνήστε πώς θα μετατρέπονται οι τύποι υπολογισμού σε διάρκειες στο SkyPlanner.
• Οι πρότυπες τιμές χρειάζονται έλεγχο και διόρθωση. Τα φασεολόγια που τηρούνται για την κοστολόγηση συχνά περιέχουν μέσους χρόνους προετοιμασίας ή χρόνους προετοιμασίας καταχωρισμένους σε λάθος κατηγορία δυναμικότητας.
• Οι κανόνες επιβεβαίωσης είναι αυστηροί. Η SAP συνιστά κλήσεις batch για μαζικές καταχωρίσεις. Κάθε σύνολο αλλαγών εφαρμόζεται ολόκληρο ή καθόλου, οπότε ένα λανθασμένο δελτίο χρόνου μπλοκάρει τις υπόλοιπες καταχωρίσεις του ίδιου συνόλου. Οι ακυρώσεις σε μια παρτίδα πρέπει να εκτελούνται με αντίστροφη σειρά ConfirmationCount. Δεν μπορείτε να συνδυάζετε τύπους επιβεβαίωσης στην ίδια εντολή, να καταχωρίζετε κινήσεις υλικών χωρίς επιβεβαίωση ή να επιβεβαιώνετε φάσεις των οποίων τα σημεία ενεργοποίησης απαιτούν παράθυρο διαλόγου.
• Ελέγξτε αν είναι ενεργό το PP/DS. Το ενσωματωμένο PP/DS απαιτεί την ενέργεια Customizing Activate Advanced Planning and Scheduling και το SAP HANA integrated liveCache. Η SAP το πωλεί ως ξεχωριστό προϊόν, το SAP S/4HANA Manufacturing for planning and scheduling. Όπου είναι ενεργό, αποφασίστε για κάθε υλικό ποιο σύστημα αναλαμβάνει τον χρονοπρογραμματισμό: τα υλικά με σήμανση για προηγμένο προγραμματισμό υπάγονται στο PP/DS. Η SAP αναφέρει επίσης για το API προγραμματισμένων εντολών: “Automatic integration to PP/DS is not enabled from this API.” (Η αυτόματη διασύνδεση δεν ενεργοποιείται μέσω αυτού του API.)
• Μονάδες μέτρησης. Οι μονάδες για τις ποσότητες των φάσεων, τις βασικές ποσότητες των φασεολογίων και τις επιβεβαιώσεις μπορεί να διαφέρουν. Κάντε ρητή μετατροπή με βάση τη μονάδα της φάσης, όχι τη βασική μονάδα του υλικού.
• Διαφορές μεταξύ εκδόσεων. Το SAP Learning δείχνει ότι ο κλασικός πίνακας προγραμματισμού CM21/CM22 αντικαθίσταται από τα Manage Work Center Capacity, Capacity Scheduling Table και Capacity Scheduling Board. Η Public Edition διαθέτει APIs μόνο μέσω σεναρίων επικοινωνίας, ενώ οι εκδόσεις υπηρεσιών που προσφέρει μπορεί να διαφέρουν από εκείνες της τοπικής εγκατάστασης. Το API φασεολογίων δεν μπορεί να διαγράψει φασεολόγια ή να ενημερώσει αναθέσεις υλικών. Κατά τον καθορισμό εύρους, η ομάδα του SkyPlanner ορίζει σταθερές εκδόσεις υπηρεσιών για το σύστημα κάθε πελάτη, χρησιμοποιώντας την καταχώριση του API Business Accelerator Hub για τη συγκεκριμένη έκδοση.
• Περιορισμοί που δεν αποτυπώνονται στα φασεολόγια. Διαχειριστείτε στο SkyPlanner τις αλλαγές παραγωγής που εξαρτώνται από την αλληλουχία, τις συγκρούσεις στη χρήση εργαλείων και τις φάσεις με πολλούς χειριστές, όχι στις πρότυπες τιμές των φασεολογίων. Ο πίνακας χρόνων προετοιμασίας αποθηκεύει τους χρόνους αλλαγής παραγωγής ανά ζεύγος προϊόντων. Τα εργαλεία από τα PRTs της εντολής έχουν περιορισμένη διαθεσιμότητα και χρησιμοποιούνται σε ένα κέντρο εργασίας κάθε φορά, ενώ μια φάση μπορεί να απαιτεί πολλά άτομα ταυτόχρονα.