Λογισμικό SARTORIUS Sim Api

Προδιαγραφές

• Όνομα προϊόντος: Οδηγός SimApi
• Ημερομηνία κυκλοφορίας: 5 Σεπτεμβρίου 2024
• Σκοπός: Παροχή δεδομένων σε προϊόντα Umetrics Suite

Οδηγίες χρήσης προϊόντος

Εισαγωγή στο SimApis

• Τα SimApis χρησιμοποιούνται για την ανάκτηση δεδομένων για τη δημιουργία έργου και τη δημιουργία μοντέλων σε προϊόντα Umetrics Suite.

Λήψη SimApis

• Για να αποκτήσετε το SimApis, ανατρέξτε στην επίσημη τεκμηρίωση ή επικοινωνήστε με την υποστήριξη πελατών για βοήθεια.

Λειτουργίες SimApi

• Το SimApis παρέχει δεδομένα σε πραγματικό χρόνο για παρακολούθηση, έλεγχο και δημιουργία μοντέλων σε SIMCA και SIMCA-online.

Μόνο Τρέχουσα χρήση δεδομένων

• Συνιστάται να χρησιμοποιείτε μόνο τρέχοντα δεδομένα και να αποφεύγετε τα ιστορικά δεδομένα για βέλτιστη απόδοση.

Προετοιμασία για εγκατάσταση SimApi

• Πριν από την εγκατάσταση, βεβαιωθείτε ότι το σύστημά σας πληροί τις ελάχιστες απαιτήσεις που καθορίζονται στον οδηγό χρήσης.

Εγκατάσταση ενός SimApi

• Ακολουθήστε τις οδηγίες βήμα προς βήμα που παρέχονται στο εγχειρίδιο χρήστη για να εγκαταστήσετε το SimApi στο σύστημά σας.

Ρύθμιση SimApi για SIMCA

• Διαμορφώστε τις ρυθμίσεις SimApi στο SIMCA σύμφωνα με τις οδηγίες που παρέχονται.

Ρύθμιση SimApi για SIMCA-online

• Ρυθμίστε το SimApi για λειτουργίες ανάκτησης δεδομένων και εγγραφής σε πραγματικό χρόνο στο SIMCA-online.

Δοκιμές και αντιμετώπιση προβλημάτων

• Μετά την εγκατάσταση, εκτελέστε δοκιμές για να διασφαλίσετε τη σωστή λειτουργία. Σε περίπτωση προβλημάτων, ανατρέξτε στην ενότητα αντιμετώπισης προβλημάτων στον οδηγό χρήσης.

Δοκιμές από τη SIMCA-online

• Δοκιμάστε την ενσωμάτωση SimApi από το SIMCA-online για να επαληθεύσετε την ανάκτηση δεδομένων.

Αντιμετώπιση προβλημάτων με το αρχείο καταγραφής Files

• Χρησιμοποιήστε το αρχείο καταγραφής SimApi file για τον εντοπισμό και την επίλυση τυχόν προβλημάτων εγκατάστασης ή λειτουργίας.

Διαμόρφωση λογαριασμού υπηρεσίας

• Διασφαλίστε τη σωστή διαμόρφωση του λογαριασμού υπηρεσίας SIMCA-online για απρόσκοπτη λειτουργία.

Τεχνικές λεπτομέρειες

• Ανατρέξτε στην ενότητα 7 του οδηγού χρήσης για αναλυτικές τεχνικές πληροφορίες για το SimApis.

Εισαγωγή στο SimApis

• Το SimApi είναι μια διεπαφή λογισμικού μεταξύ του λογισμικού Umetrics® Suite και μιας πηγής δεδομένων. Ο πρωταρχικός σκοπός ενός SimApi είναι να παρέχει δεδομένα σε SIMCA®-online ή SIMCA®.
• Η Sartorius Stedim Data Analytics AB αναπτύσσει το SimApis για πολλές διαφορετικές πηγές δεδομένων, όπως ιστορικούς διεργασιών και βάσεις δεδομένων γενικού σκοπού.
• Αυτό το έγγραφο δείχνει τι είναι ένα SimApi και πώς χρησιμοποιείται σε προϊόντα Umetrics Suite. Θα μάθετε πώς να σχεδιάζετε και να εγκαθιστάτε ένα SimApi, πώς να αντιμετωπίζετε προβλήματα και πώς να δοκιμάσετε την εγκατάστασή σας. Το τελευταίο κεφάλαιο περιέχει τεχνικές λεπτομέρειες του SimApis που απευθύνεται σε προγραμματιστές.

Σκοπός SimApi: παροχή δεδομένων σε προϊόντα Umetrics Suite

• Ο πρωταρχικός σκοπός ενός SimApi είναι να παρέχει δεδομένα σε SIMCA-online ή SIMCA από μια πηγή δεδομένων. Η πηγή δεδομένων δεν αποτελεί μέρος του SIMCA-online, αλλά μπορεί να είναι ιστορικός διεργασιών ή άλλο σύστημα που διατηρεί και διαχειρίζεται τα δεδομένα.
• Ένα SimApi εκθέτει μια ιεραρχία κόμβων, που αντιστοιχεί σε φακέλους στο α file σύστημα. Κάθε κόμβος μπορεί να περιέχει άλλους κόμβους ή tags. ΕΝΑ tag αντιστοιχεί σε μια μεταβλητή. Για αυτά tags, μπορούν να ληφθούν δεδομένα. Η εικόνα δείχνει α tag, Temp, επιλεγμένο στον κόμβο
• BakersYeastControlGood σε μια πηγή δεδομένων στο SIMCA-online. Εμφανίζει επίσης τις πιο πρόσφατες τιμές που λαμβάνονται από την πηγή δεδομένων.

Χρήση SimApi στη σουίτα Umetrics

• Το λογισμικό επιτραπέζιου υπολογιστή SIMCA μπορεί να χρησιμοποιήσει ένα SimApi για να ανακτήσει δεδομένα για τη δημιουργία έργου και τη δημιουργία μοντέλων, όπως φαίνεται στην παρακάτω εικόνα.
• Το SIMCA-online χρησιμοποιεί το SimApis για τη λήψη δεδομένων σε πραγματικό χρόνο για παρακολούθηση και έλεγχο, καθώς και για την εγγραφή δεδομένων στην πηγή δεδομένων. Η παρακάτω εικόνα δείχνει πού βρίσκεται το SimApi σε ένα σύστημα που αποτελείται από μια πηγή δεδομένων, διακομιστή SIMCA-online και πελάτες.

SimApis που χρησιμοποιείται συνήθως

• Τα πιο ευρέως χρησιμοποιούμενα SimApis είναι:
• Το PI AF SimApi για σύνδεση με συστήματα PI Aveva (πρώην OSIsoft).
• Το OPC UA SimApi
• Το ODBC SimApi – για γενική πρόσβαση σε βάσεις δεδομένων όπως ο SQL Server ή η Oracle
• Όλα τα διαθέσιμα SimApis παρατίθενται μαζί με τα χαρακτηριστικά τους στην παράγραφο 3.

Το DBMaker SimApi για δεδομένα προσομοίωσης

• Το DBMaker είναι μια εφαρμογή που παρέχεται με την εγκατάσταση διακομιστή SIMCA-online. Προσομοιώνει μια πηγή δεδομένων, όπως έναν ιστορικό διεργασίας, χρησιμοποιώντας έναν προφορτωμένο πίνακα δεδομένων όπου οι παρατηρήσεις παρέχονται μία προς μία στο SIMCA-online μέσω του DBMaker SimApi.
• Το DBMaker χρησιμοποιείται μόνο για σκοπούς επίδειξης και δεν μπορεί να χρησιμοποιηθεί στην παραγωγή με ζωντανά δεδομένα από μια πηγή δεδομένων. Δείτε την ενσωματωμένη βοήθεια για να μάθετε περισσότερα σχετικά με το DBMaker.

Πρόσθετη τεκμηρίωση

• Αυτό το έγγραφο είναι ένα από ένα σύνολο σχετικών εγγράφων, το καθένα με διαφορετική εστίαση και κοινό-στόχο:

Πηγή	Τι	Οπου
SIMCA-σε απευθείας σύνδεση web σελίδα	Εισαγωγικές πληροφορίες και λήψεις	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe and Installation.pdf	Εγκατάσταση και πώς να ξεκινήσετε με τα διαδικτυακά δεδομένα επίδειξης SIMCA	Στο zip εγκατάστασης file
SIMCA-online Οδηγός Εφαρμογής	Περιγράφει τη λειτουργικότητα του SIMCA-online, τη θέτει σε πλαίσιο με άλλο λογισμικό Umetrics Suite, περιγράφει απαιτήσεις και βέλτιστες πρακτικές για επιτυχή ανάπτυξη και οδηγίες εγκατάστασης βήμα προς βήμα.	sartorius.com/umetrics-simca- online
Οδηγός SimApi	Προετοιμασία και εκτέλεση εγκαταστάσεων SimApi, συμπεριλαμβανομένης της αντιμετώπισης προβλημάτων. Περιέχει επίσης τεχνικές λεπτομέρειες για το SimApis για προγραμματιστές.	sartorius.com/umetrics-simapi
Οδηγοί χρήστη SimApi	Τεκμηρίωση για κάθε δημοσιευμένο SimApi με χαρακτηριστικά, οδηγίες εγκατάστασης και λεπτομέρειες διαμόρφωσης.	sartorius.com/umetrics-simapi
SIMCA-Ηλεκτρονικός Τεχνικός Οδηγός	Τεχνική αναφορά για τον προγραμματισμό εγκατάστασης διακομιστή SIMCA-online, την αντιμετώπιση προβλημάτων και τον σε βάθος τρόπο λειτουργίας του SIMCA-online.	sartorius.com/umetrics-simca-online
Διαδικτυακή βοήθεια SIMCA	Web-Βοήθεια με βάση τον τρόπο χρήσης του SIMCA-online και τον τρόπο λειτουργίας του SIMCA-online.	Στο ίδιο το λογισμικό και σε αυτό sartorius.com/umetrics-simca
SIMCA-σε απευθείας σύνδεση Web Οδηγός εγκατάστασης πελάτη	Περιγράφει την εγκατάσταση του SIMCA-online Web Πελάτης.	sartorius.com/umetrics-simca-online
Βάση γνώσεων Umetrics	Βάση δεδομένων με δυνατότητα αναζήτησης με άρθρα σχετικά με κάθε έκδοση λογισμικού που έχει κυκλοφορήσει, τεχνικά άρθρα και γνωστά ζητήματα στα προϊόντα Umetrics Suite.	sartorius.com/umetrics-kb
Βοήθεια/οδηγός χρήστη SIMCA	Πώς να χρησιμοποιήσετε το SIMCA επιτραπέζιου υπολογιστή για τη δημιουργία έργων και τη μοντελοποίηση δεδομένων.	Στη SIMCA και στο εξής sartorius.com/umetrics-simca
Υποστήριξη web σελίδα	Πώς να αποκτήσετε τεχνική υποστήριξη.	sartorius.com/umetrics-support

Τεχνική υποστήριξη

• Η ομάδα ηλεκτρονικής υποστήριξης Sartorius απαντά σε τεχνικές ερωτήσεις σχετικά με το SimApis και μπορεί επίσης να προωθήσει αιτήματα για βελτίωση του SimApis στα κατάλληλα άτομα. Μάθετε περισσότερα στο sartorius.com/umetrics-support.

Λήψη SimApis

• Παρέχουμε τεκμηρίωση για τα διαθέσιμα SimApis και συνδέσμους προς προγράμματα εγκατάστασης στη διεύθυνση sartorius.com/umetrics-simapi.
• Κάθε SimApi τεκμηριώνεται στον Οδηγό χρήσης του.
• Ο Οδηγός SimApi, τον οποίο διαβάζετε όχι, συμπληρώνει αυτές τις πληροφορίες με συμπληρωματικές πληροφορίες SimApi όσον αφορά τον σχεδιασμό, την εγκατάσταση και την αντιμετώπιση προβλημάτων SimApi.

Λειτουργίες SimApi

• Δεν είναι όλες οι πηγές δεδομένων ίδιες. Ένα SimApi δεν χρειάζεται να υλοποιεί όλες τις λειτουργίες της προδιαγραφής. Για αυτούς τους λόγους, διαφορετικά SimApis προσφέρουν διαφορετική λειτουργικότητα. Η παρακάτω μήτρα παραθέτει τα διαθέσιμα SimApis και τις δυνατότητές τους.
• Τα χαρακτηριστικά επεξηγούνται παρακάτω. Σημειώστε ότι ο πίνακας έχει ξεχωριστές στήλες για να δείξει ποιες δυνατότητες είναι διαθέσιμες σε SIMCA-online και SIMCA αντίστοιχα.

Χαρακτηριστικό	Σκοπός	SIMCA-online χρήση	Χρήση SIMCA
Τρέχοντα δεδομένα	Διαβάστε μια μεμονωμένη παρατήρηση με την πιο πρόσφατη τιμή από την πηγή δεδομένων.	Κανονική εκτέλεση σε πραγματικό χρόνο	–
Ιστορικά στοιχεία	Διαβάστε πολλές παρατηρήσεις ταυτόχρονα με ιστορικά δεδομένα από την πηγή δεδομένων.	Ανακαλύψτε και προβλέψτε δεδομένα του παρελθόντος, δημιουργήστε έργα χρησιμοποιώντας File > Νέο	Βάση δεδομένων Import Wizard για εισαγωγή δεδομένων διεργασίας για δημιουργία μοντέλου.
Διακριτά δεδομένα	Διαβάστε τα δεδομένα εργαστηρίου/IPC από την πηγή δεδομένων. Πολλές παρατηρήσεις ανά παρτίδα.	Για έργα παρτίδας με φάσεις ή συνθήκες παρτίδας διαμορφωμένες για διακριτή ανάκτηση δεδομένων.	–
Δεδομένα παρτίδας	Διαβάστε τις συνθήκες παρτίδας και τα χαρακτηριστικά τελικής ποιότητας (ή	Συνθήκες παρτίδας ή τοπικό κεντράρισμα.	Οδηγός εισαγωγής βάσης δεδομένων για ανάγνωση συνθηκών παρτίδας

Χαρακτηριστικό	Σκοπός	SIMCA-online χρήση	Χρήση SIMCA
	άλλα δεδομένα τύπου MES). Μία παρατήρηση ανά παρτίδα.		δημιουργία μοντέλου σε επίπεδο παρτίδας.
Κόμβος παρτίδας	Καθορίστε την ώρα έναρξης και την ώρα λήξης (κενή για μια ενεργή παρτίδα) για μια συγκεκριμένη παρτίδα. Αριθμήστε όλες τις παρτίδες που υπήρχαν σε ένα χρονικό εύρος.	Απαιτείται για την εκτέλεση διαμορφώσεων παρτίδας.	Βάση δεδομένων Import Wizard για επιλογή παρτίδων προς εισαγωγή.
Γράψτε πίσω – συνεχή δεδομένα	Γράψτε συνεχή δεδομένα, όπως προβλέψεις, πίσω στην πηγή δεδομένων.	Γράψτε πίσω δεδομένα από το επίπεδο εξέλιξης παρτίδας, για το Control Advisor ή για συνεχείς διαμορφώσεις	–
Γράψτε πίσω – διακριτικό	Γράψτε διακριτά δεδομένα, όπως προβλέψεις, πίσω στην πηγή δεδομένων.	Γράψτε πίσω για διαμορφώσεις παρτίδας στο επίπεδο εξέλιξης παρτίδας για φάσεις που έχουν διαμορφωθεί για διακριτή ανάκτηση δεδομένων	–
Γράψτε πίσω – δεδομένα παρτίδας	Γράψτε πίσω δεδομένα επιπέδου παρτίδας, όπως προβλέψεις ή τελικές ιδιότητες ποιότητας, στην πηγή δεδομένων.	Γράψτε πίσω για τη διαμόρφωση παρτίδας σε επίπεδο παρτίδας	–
Ιεραρχία κόμβων	Το SimApi υποστηρίζει μια ιεραρχία κόμβων, παρόμοια με το a file σύστημα. Κάθε κόμβος μπορεί να περιέχει tags και άλλους κόμβους. Η ιεραρχία καθιστά ευκολότερη τη διαχείριση μεγάλου αριθμού κόμβων και tags.	Υποστηρίζεται σε όλα τα μέρη όπου tags χρησιμοποιούνται.
Παράταξη tag επέκταση	Μια συστοιχία tag αποθηκεύει πολλαπλές τιμές. Το SimApi επεκτείνει τον πίνακα tag σε πολλά άτομα tags, ένα για κάθε στοιχείο του πίνακα.	Υποστηρίζεται όπου tags χρησιμοποιούνται για συνεχή δεδομένα. Το καθένα επεκτάθηκε tag πρέπει να αντιστοιχιστεί σε μια μεταβλητή στο έργο SIMCA.
Πολλαπλές πηγές δεδομένων	Το SimApi μπορεί να συνδεθεί σε περισσότερες από μία πηγές δεδομένων ή υποστηρίζει πολλαπλές παρουσίες του εαυτού του με μεμονωμένες ρυθμίσεις και αρχείο καταγραφής files για κάθε περίπτωση.	Συνδεθείτε σε πολλές διαφορετικές πηγές δεδομένων του ίδιου είδους.	–
Ανθεκτικότητα σύνδεσης	Εάν το SimApi αποσυνδεθεί από την πηγή δεδομένων, θα προσπαθήσει να αποκαταστήσει τη σύνδεση αυτόματα.	Το SimApi δεν χρειάζεται να γίνει επανεκκίνηση για να αποκατασταθούν οι συνδέσεις με την πηγή δεδομένων.	–
Αναπτύχθηκε εσωτερικά	Το SimApi αναπτύσσεται, παρέχεται και υποστηρίζεται από

Δεν συνιστάται μόνο τρέχοντα δεδομένα, χωρίς ιστορικά δεδομένα

• Ορισμένα SimApis, ιδίως το OPC DA, υποστηρίζουν μόνο την ανάγνωση τρεχόντων δεδομένων και όχι ιστορικών δεδομένων.
• Ένα SimApi που υποστηρίζει μόνο τρέχοντα δεδομένα δεν μπορεί να χρησιμοποιηθεί στην επιτραπέζια SIMCA, επειδή δεν θα μπορεί να διαβάσει ιστορικά δεδομένα στα οποία θα δημιουργηθούν τα μοντέλα.
• Για το SIMCA-online, συνιστούμε ανεπιφύλακτα μια πηγή δεδομένων και το SimApi που παρέχουν όχι μόνο τρέχοντα δεδομένα για εκτέλεση σε πραγματικό χρόνο, αλλά και ιστορικά δεδομένα για να είναι δυνατή η πρόβλεψη και η κάλυψη προηγούμενων δεδομένων. Το SIMCA-online αλλάζει αυτόματα μεταξύ δεδομένων σε πραγματικό χρόνο και ιστορικών δεδομένων, όπως απαιτείται και αυτό δεν μπορεί να απενεργοποιηθεί.
• Μια πηγή δεδομένων που παρέχει μόνο τρέχοντα δεδομένα, αλλά όχι ιστορικά δεδομένα, μπορεί να λειτουργήσει για συνεχή έργα στο SIMCA-online, αλλά για έργα ομαδικής χρήσης, απαιτούνται δεδομένα ιστορικού.

Προετοιμασία για εγκατάσταση SimApi

• Αυτή η ενότητα περιγράφει σημαντικές πληροφορίες για μια επιτυχημένη εγκατάσταση ενός SimApi.

SimApis 64-bit ή 32-bit

• Υπάρχουν εκδόσεις 32-bit και 64-bit για κάθε SimApi.
• Το SIMCA-online και το SIMCA είναι 64-bit και απαιτούν τις παραλλαγές SimApis 64-bit. Τα παλαιού τύπου SimApi 32-bit εξακολουθούν να είναι διαθέσιμα για παλαιότερες εγκαταστάσεις.

Θέση για το ημερολόγιο file και τις ρυθμίσεις

• Ένα SimApi αποθηκεύει το αρχείο καταγραφής του files στον κρυφό φάκελο Program Data1:
  %programdata%\Umetrics\SimApi, όπου το %programdata% αντιστοιχίζεται στον πραγματικό φάκελο του υπολογιστή σας. Από προεπιλογή είναι C:\ProgramData.
• Κάθε SimApi χρησιμοποιεί συνήθως το δικό του αρχείο καταγραφής file, που παρόμοια με το αρχείο καταγραφής διακομιστή SIMCA-online file θα περιέχει περισσότερα ή λιγότερα δεδομένα ανάλογα με μια ρύθμιση επιπέδου καταγραφής. Αυτό file είναι χρήσιμο για την αντιμετώπιση προβλημάτων. Το κούτσουρο file ονομάζεται
  .log όπου είναι το SimApi που εγκαθιστάτε, π.χample PIAFSimApi. Δείτε επίσης την επόμενη ενότητα για ονόματα παρουσιών SimApi σε απευθείας σύνδεση SIMCA.
• Αυτός ο φάκελος περιέχει επίσης τις ρυθμίσεις SimApi σε ένα XML file ονομάστηκε .xml.
• Τα περισσότερα SimApis διαθέτουν γραφικές διεπαφές χρήστη που αλλάζουν τις ρυθμίσεις στο xml file, αλλά για κάποιους εισάγετε τις αλλαγές απευθείας στο XML file με ένα πρόγραμμα επεξεργασίας κειμένου, όπως το Σημειωματάριο. Δείτε τον οδηγό χρήσης για κάθε SimApi.

File ονόματα όταν χρησιμοποιούνται επώνυμες παρουσίες με το SIMCA-online

• Στο SIMCA-online, κάθε στιγμιότυπο SimApi έχει τη δική του διαμόρφωση file και ημερολόγιο file για εργασία με πολλαπλές παρουσίες κάθε SimApi. Τα ονόματα αυτών fileΤα s έχουν κατάληξη με το όνομα της παρουσίας όπως δίνεται στην καρτέλα SimApi στο παράθυρο διαλόγου Επιλογές διακομιστή SIMCA-online.
• Οι παρακάτω π.χample δείχνει την ονομασία αυτών files, όπου πρέπει να αντικατασταθεί με το όνομα SimApi.
• Όνομα διαμόρφωσης που δίνεται όταν προστίθεται η παρουσία: OmegaServer
• Διαμόρφωση file όνομα: OmegaServer.xml
• Κούτσουρο file όνομα: OmegaServer.log
• Σημειώστε ότι το γενικό file .κούτσουρο file εξακολουθεί να δημιουργείται. Αυτό το αρχείο καταγραφής file περιέχει καταχωρήσεις που για τεχνικούς λόγους δεν μπορούν να κατευθυνθούν στο αρχείο καταγραφής file των περιπτώσεων..
• Αυτός ο φάκελος είναι κρυμμένος στα Windows από προεπιλογή. Για να το δεις μέσα File Ο Explorer που ρυθμίζετε να εμφανίζεται κρυφός fileμικρό. Σημειώστε ότι μπορείτε να πλοηγηθείτε σε έναν κρυφό φάκελο πληκτρολογώντας μια διεύθυνση File Γραμμή διευθύνσεων του Explorer.
• Λάβετε υπόψη ότι η SIMCA δεν υποστηρίζει πολλαπλές παρουσίες του SimApi και επομένως χρησιμοποιεί τα ονόματα χωρίς όνομα παρουσίας όπως περιγράφεται παραπάνω.

Σχεδιασμός δικτύου

• Θα πρέπει να εντοπίσετε τον διακομιστή SIMCA-online κοντά στην πηγή δεδομένων στο δίκτυο. Αυτό εξασφαλίζει γρήγορη σύνδεση μεταξύ του SIMCA-online και της πηγής δεδομένων του.
• Ο εξοπλισμός δικτύου ενδέχεται να επηρεάσει τη σύνδεση μεταξύ του SIMCA-online και της πηγής δεδομένων.

Λογαριασμοί χρηστών και δικαιώματα πηγής δεδομένων

• Οι πηγές δεδομένων ελέγχουν συνήθως την πρόσβαση στα δεδομένα τους. Αυτό γίνεται συνήθως με ονόματα χρήστη και κωδικούς πρόσβασης, αλλά μπορούν επίσης να χρησιμοποιηθούν περιορισμοί που βασίζονται στη διεύθυνση IP ή στο DNS (π.χ.ample PI Trusts στο σύστημα Aveva PI).
• Το όνομα χρήστη και ο κωδικός πρόσβασης μπορούν να παρέχονται στην πηγή δεδομένων με διάφορους τρόπους:
• Ένα SimApi εκτελείται ως χρήστης των Windows του χρήστη που χρησιμοποιεί επιτραπέζιο SIMCA ή τον λογαριασμό ηλεκτρονικής υπηρεσίας SIMCA στον υπολογιστή διακομιστή. Το SimApi μπορεί να συνδεθεί με την πηγή δεδομένων χρησιμοποιώντας αυτόν τον λογαριασμό. Έτσι λειτουργούν το OPC I και το PI SimApi και το ODBC εάν δεν παρέχετε διαπιστευτήρια κατά τη διαμόρφωσή του.
• Για γενικό ODBC μπορείτε να χρησιμοποιήσετε την εφαρμογή ODBC Data Sources Administrator που βρίσκεται στο Start στα Windows.
• Ορισμένοι πάροχοι βάσεων δεδομένων παρέχουν τα δικά τους προγράμματα οδήγησης και εργαλεία για τις βάσεις δεδομένων τους. Βάσεις δεδομένων Oracle, π.χample, χρησιμοποιήστε τα Oracle Data Access Components (ODAC).
• Ορισμένα SimApis, όπως το PI AF και το ODBC, διαθέτουν διαλόγους διαμόρφωσης που αποθηκεύουν τα κρυπτογραφημένα διαπιστευτήρια στη διαμόρφωση SimApi XML file.
• Το PI έχει επίσης διάφορες επιλογές ασφαλείας διαθέσιμες στα Εργαλεία διαχείρισης συστήματος PI στον υπολογιστή διακομιστή PI. Διαβάστε περισσότερα στον Οδηγό χρήστη PI AF SimApi. Αυτός ο οδηγός είναι χρήσιμος ακόμα κι αν χρησιμοποιείτε το παλαιότερο OSIsoft PI SimApi.
• Το OPC DA και το HDA χρησιμοποιούν το DCOM ως μεταφορά μεταξύ μιας πηγής δεδομένων και του SimApi. Το DCOM έχει ρυθμιστεί με το εργαλείο Component Services (DCOMCNFG.EXE) στα Windows και χρησιμοποιεί έλεγχο ταυτότητας των Windows.
• Για το παλαιότερο OSIsoft PI SimApi (όχι το νεότερο AF SimApi), η εφαρμογή OSIsoft AboutPI-SDK (PISDKUtility.exe) χρησιμοποιείται για τη ρύθμιση της σύνδεσης με τον διακομιστή PI.

Επαλήθευση συνδεσιμότητας πηγής δεδομένων
Όταν θέλετε να εγκαταστήσετε ένα SimApi σε έναν υπολογιστή, μπορεί να είναι χρήσιμο να επαληθεύσετε τη συνδεσιμότητα από αυτόν τον υπολογιστή στην πηγή δεδομένων με ένα άλλο εργαλείο:

• Οι πηγές δεδομένων ODBC στα Windows χρησιμοποιούνται για τη διαμόρφωση και τη δοκιμή γενικού ODBC. Σημειώστε ότι υπάρχουν δύο εκδόσεις αυτού του εργαλείου σε Windows 64 bit: μία για εφαρμογές 32 bit και μία για 64 bit. Χρησιμοποιήστε το κουμπί Test Data Source στο τέλος του οδηγού διαμόρφωσης ODBC για να επαληθεύσετε τη συνδεσιμότητα με τη βάση δεδομένων. Συνιστούμε να διαμορφώσετε τις πηγές δεδομένων σας ως DSN συστήματος.
• Ένα εργαλείο σύνδεσης για συγκεκριμένη βάση δεδομένων από τον πάροχο της βάσης δεδομένων, όπως τα Oracle Data Access Components.
• Η Εξερεύνηση συστήματος PI μπορεί να χρησιμοποιηθεί για τη δοκιμή της συνδεσιμότητας με τον διακομιστή PI AF. Αποτελεί μέρος του PI AF Client που αποτελεί προϋπόθεση για το PI AF SimApi.
• OPC UA Expert από την Unified Automation – Το UaExpert είναι ένας δοκιμαστικός πελάτης πολλαπλών πλατφορμών για διακομιστές OPC UA.
• Η εφαρμογή PI-SDK (PISDKUtility.exe) μπορεί να χρησιμοποιηθεί για τον έλεγχο της συνδεσιμότητας και για view τυχόν μηνύματα σφάλματος που μπορεί να έχουν καταγραφεί όταν η SIMCA-online προσπαθεί να συνδεθεί στον διακομιστή PI. Αυτό χρησιμοποιείται μόνο για το παλαιότερο OSIsoft SimApi, όχι για το PIAF.
• Τα Εργαλεία διαχείρισης συστήματος PI χρησιμοποιούνται στον υπολογιστή διακομιστή PI για την αντιμετώπιση προβλημάτων από αυτήν την πλευρά. Για π.χample, για να αναζητήσετε ζητήματα ασφαλείας που εμποδίζουν την πρόσβαση από τον διαδικτυακό διακομιστή SIMCA. Μάθετε περισσότερα για την αντιμετώπιση προβλημάτων συστήματος PI σε αυτό το βίντεο του YouTube.
• Το Excel μπορεί να χρησιμοποιηθεί για τη λήψη δεδομένων από μια σύνδεση ODBC και από τα περισσότερα άλλα συστήματα όταν έχει εγκατασταθεί ένα κατάλληλο πρόσθετο.
• Το Matrikon OPC Explorer for Ior HDA (αυτά είναι ξεχωριστά εργαλεία) μπορεί να χρησιμοποιηθεί για τη δοκιμή συνδεσιμότητας OPC και το Matrikon OPC Analyzer μπορεί να χρησιμοποιηθεί για τη διάγνωση προβλημάτων συνδεσιμότητας OPC. Κατεβάστε αυτά τα δωρεάν εργαλεία από https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (για DInd HDA) από το OPC Training Institute's web site «επιτρέπει στους χρήστες να διαγνώσουν εύκολα προβλήματα επικοινωνίας και ασφάλειας και να τα επιδιορθώσουν άμεσα με το πάτημα ενός κουμπιού. Όλα αυτά μπορούν να γίνουν χωρίς να χρειάζεται ποτέ να μάθουμε να διαμορφώνουμε το DCOM"

Εγκατάσταση ενός SimApi

Δείτε πώς να εγκαταστήσετε ένα SimApi σε έναν υπολογιστή:

1. Διαβάστε τον Οδηγό χρήσης για το SimApi που εγκαθιστάτε. Περιέχει λεπτομέρειες για αυτό το SimApi που συμπληρώνουν τις γενικές οδηγίες που διαβάζετε τώρα.
2. Εγκαταστήστε και διαμορφώστε τυχόν προαπαιτούμενα που αναφέρονται στον Οδηγό χρήσης SimApi (π.χampπρογράμματα οδήγησης βάσης δεδομένων ή SDK)
3. Εκτελέστε το πρόγραμμα εγκατάστασης για να εγκαταστήσετε το SimApi. Εγκαταστήστε την έκδοση 64 bit (x64) ή 32 bit (x86) που ταιριάζει με το λογισμικό στο οποίο θα το εκτελέσετε.
4. Διαμορφώστε το SimApi σε SIMCA-online ή SIMCA όπως περιγράφεται στις ακόλουθες ενότητες και ανατρέξτε στον οδηγό χρήσης του SimApi για περιγραφές των διαθέσιμων ρυθμίσεων.
5. Εκκινήστε τον διακομιστή SIMCA-online. Σημειώστε ότι αυτό μπορεί να πάρει χρόνο, γιατί όταν αρχικοποιηθεί το SimApi, θα απαριθμήσει όλα tags στην πηγή δεδομένων.
6. Δοκιμάστε το SimApi λαμβάνοντας ορισμένα δεδομένα. Για SIMCA-online, μπορείτε να χρησιμοποιήσετε File > Εκχύλισμα όπως περιγράφεται στο 6.1.
7. Εάν το SimApi αποτύχει να λειτουργήσει όπως αναμένεται, ανατρέξτε στο αρχείο καταγραφής SimApi files για αντιμετώπιση προβλημάτων και στον οδηγό χρήστη SimApi.

Ρύθμιση του SimApi για χρήση στη SIMCA

Δείτε πώς μπορείτε να χρησιμοποιήσετε το SimApi στη SIMCA:

1.  Ξεκινήστε την εισαγωγή της βάσης δεδομένων με έναν από τους παρακάτω τρόπους:
   • a. Για να δημιουργήσετε ένα νέο έργο στη SIMCA: File > Νέο κανονικό έργο ή νέο έργο παρτίδας. Επιλέξτε Από τη βάση δεδομένων στην καρτέλα Αρχική σελίδα.
   • b. Για να εισαγάγετε ένα σύνολο δεδομένων σε ένα υπάρχον έργο σε SIMCA: Από το σύνολο δεδομένων στην καρτέλα Δεδομένα ενός ανοιχτού έργου SIMCA.
2. Κάντε κλικ στην Προσθήκη νέας πηγής δεδομένων
3. Επιλέξτε SimApi ως τύπο σύνδεσης, κάντε κλικ στο κουμπί … και εντοπίστε το .dll στο φάκελο εγκατάστασης και κάντε κλικ στο Άνοιγμα.
4. Κάντε κλικ στο Configure και ανατρέξτε στον ατομικό Οδηγό χρήστη SimApi πώς να κάνετε τις ρυθμίσεις.
5. Κάντε κλικ στη σύνδεση προέλευσης δεδομένων δοκιμής για να βεβαιωθείτε ότι μπορείτε να συνδεθείτε στη βάση δεδομένων. Αυτό μπορεί να διαρκέσει πολύ εάν υπάρχουν πολλά tags στην πηγή δεδομένων.
6. Κάντε κλικ στο OK για να ολοκληρώσετε τη διαμόρφωση.
7. Ανατρέξτε στη βοήθεια της SIMCA για τον τρόπο εργασίας με εισαγόμενα δεδομένα.

Ρύθμιση του SimApi για χρήση στο SIMCA-online

• Σημαντικό: Για να μπορείτε να χρησιμοποιήσετε ένα SimApi, απαιτείται μια άδεια διακομιστή SIMCA-online. Μια επίδειξη εγκατάστασης του SIMCA-online δεν επιτρέπει τη χρήση του SimApis.
• Για να προσθέσετε ένα SimApi στο σύστημα, εκτελείτε τις Επιλογές διακομιστή SIMCA-online στον υπολογιστή διακομιστή. Μάθετε τα βήματα λεπτομερειών στο θέμα της ηλεκτρονικής βοήθειας SICMA Προσθήκη και διαμόρφωση ενός SimApi στο διακομιστή.
• Συμβουλή: Εάν κάνετε αλλαγές για ένα SimApi, μπορείτε να επανεκκινήσετε αυτό το SimApi ξεχωριστά από τις Επιλογές διακομιστή χωρίς επανεκκίνηση ολόκληρου του διακομιστή.
• Για να διαμορφώσετε πολλές παρουσίες αυτού του SimApi, επαναλάβετε τα παραπάνω βήματα και χρησιμοποιήστε μοναδικά ονόματα για κάθε παρουσία. Διαβάστε περισσότερα σχετικά με το διαφορετικό αρχείο καταγραφής και τη διαμόρφωση files για τις περιπτώσεις στο 4.2.

Δοκιμή και αντιμετώπιση προβλημάτων ενός SimApi

• Αυτό το κεφάλαιο αφορά τη δοκιμή και την αντιμετώπιση προβλημάτων μιας εγκατάστασης SimApi.

Δοκιμή ενός SimApi από το SIMCA-online

• Μόλις ξεκινήσει με επιτυχία ο διακομιστής SIMCA-online, μπορείτε να δοκιμάσετε το SimApi σας σε SIMCA-online (εάν ο διακομιστής δεν ξεκινήσει, βλ. 6.2):
• Συνδεθείτε στον διακομιστή στον ηλεκτρονικό υπολογιστή-πελάτη SIMCA και μεταβείτε στην επιλογή Εξαγωγή στο File αυτί. Το Extract σάς βοηθά να δοκιμάσετε το SimApi λαμβάνοντας δεδομένα μέσω αυτού:
• Οι κόμβοι ("φάκελοι") του SimApi εμφανίζονται στο αριστερό πλαίσιο. Tags για τον επιλεγμένο κόμβο εμφανίζονται πάνω δεξιά.
• Τα τρέχοντα δεδομένα μπορούν να ελεγχθούν γρήγορα απλά κάνοντας κλικ view> ενεργό tags που παρέχουν δεδομένα συνεχούς διαδικασίας (δείτε το στιγμιότυπο οθόνης)
• Κάντε δεξί κλικ σε έναν κόμβο για να βρείτε παρτίδες εντός χρονικού εύρους. Ο κόμβος πρέπει να είναι ένας κόμβος παρτίδας που γνωρίζει για παρτίδες.
• Επιλέγω tags στο Εξαγωγή και κάντε κλικ στο Επόμενο και ολοκληρώστε τον οδηγό για να λάβετε δεδομένα χρησιμοποιώντας τους διαφορετικούς τρόπους ανάκτησης δεδομένων: τρέχοντα, ιστορικά, ομαδικά και διακριτά δεδομένα.
• Συγκρίνετε τα εξαγόμενα δεδομένα με αυτά που βλέπετε στην πηγή δεδομένων σας χρησιμοποιώντας τα εργαλεία της. Μάθετε περισσότερα σχετικά με τη δοκιμή και την επικύρωση όλων των δυνατοτήτων ενός SimApi στην έκδοση 7.13.

Αντιμετώπιση προβλημάτων SimApi χρησιμοποιώντας το αρχείο καταγραφής SimApi file

• Εάν ο διακομιστής δεν ξεκινήσει, το SimApi δεν λειτουργεί όπως αναμένεται ή η εξαγωγή αποτύχει, πρέπει να συμβουλευτείτε το αρχείο καταγραφής SimApi file που σου λέει ποιο είναι το πρόβλημα. Ενεργοποιήστε την καταγραφή σε επίπεδο εντοπισμού σφαλμάτων στο αρχείο καταγραφής SimApi για να λάβετε πλήρεις λεπτομέρειες. Βλέπε 4.2.
• Σημείωση: τα αρχεία καταγραφής διακομιστή SIMCA-online δεν είναι τόσο χρήσιμα εδώ. Θα δείξουν πώς φορτώθηκε και αρχικοποιήθηκε το SimApi από τον διακομιστή, αλλά οι συγκεκριμένες λεπτομέρειες του SimApi βρίσκονται στο αρχείο καταγραφής του file.

Χρησιμοποιήστε τον σωστό λογαριασμό ηλεκτρονικής υπηρεσίας SIMCA

• Όταν δοκιμάζετε την πρόσβαση στην πηγή δεδομένων, να θυμάστε ότι έχετε συνδεθεί ως συγκεκριμένος χρήστης στον υπολογιστή διακομιστή (συνήθως ο δικός σας λογαριασμός χρήστη σε έναν τομέα Windows), αλλά ότι ο λογαριασμός υπηρεσίας διακομιστή SIMCA-online είναι ένας διαφορετικός λογαριασμός, από προεπιλογή LocalSystem, ο οποίος έχει διαφορετικά δικαιώματα πρόσβασης σε σύγκριση με τον λογαριασμό χρήστη σας.
• Για αυτόν τον λόγο, δεν είναι ασυνήθιστο οι δοκιμές να λειτουργούν όταν εκτελούνται ως λογαριασμός σας, αλλά το SIMCA-online να αποτυγχάνει να συνδεθεί με την πηγή δεδομένων.
• Για την επίλυση αυτού του ζητήματος, πρέπει να παραχωρηθεί πρόσβαση για τον λογαριασμό που χρησιμοποιείται από την υπηρεσία διακομιστή SIMCA-online. Συνήθως, αλλάζετε το LocalSystem σε έναν συγκεκριμένο λογαριασμό υπηρεσίας τομέα και εκχωρείτε δικαιώματα σε αυτόν τον λογαριασμό. Λάβετε υπόψη ότι αυτό δεν ισχύει εάν το SimApi χρησιμοποιεί διαπιστευτήρια που έχουν οριστεί στη διαμόρφωση του SimApi, επειδή αυτά τα διαπιστευτήρια έχουν προτεραιότητα.

Τεχνικές λεπτομέρειες στο SimApis

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

Πότε να σκεφτείτε την ανάπτυξη ενός SimApi και πότε όχι;

Πριν σκεφτείτε την ανάπτυξη ενός SimApi για μια πηγή δεδομένων:

1. Εξετάστε εάν υπάρχει ήδη ένα SimApi που μπορείτε να χρησιμοποιήσετε. Ίσως μπορείτε να ενεργοποιήσετε κάποια δυνατότητα στην πηγή δεδομένων σας για να χρησιμοποιήσετε ένα από τα υπάρχοντα SimApis, όπως το OPC UA.
2. Διαβάστε προσεκτικά αυτό το έγγραφο και τις αναφορές του και διερευνήστε εάν η πηγή δεδομένων σας πληροί τις απαιτήσεις: π.χample, πρέπει να είναι αρκετά γρήγορο, να παρέχει όχι μόνο τρέχοντα δεδομένα, αλλά και ιστορικά δεδομένα.

• Για αυτούς τους λόγους, δεν συνιστούμε την ανάπτυξη ενός SimApi που συνδέεται με υλικό ή όργανα χαμηλού επιπέδου. Είναι καλύτερα να συνδέσετε αυτά τα όργανα με έναν ιστορικό διεργασίας όπως το Aveva PI System, και να το αφήσετε να λάβει δεδομένα από το όργανο και να το ιστορικό. Στη συνέχεια, το PIAF SimApi μπορεί να χρησιμοποιηθεί για τη λήψη δεδομένων από το PI στο προϊόν Umetrics.

Ανάπτυξη SimApi και προδιαγραφή SimApi

• Η προδιαγραφή SimApi, SimApi-v2, περιέχει τεκμηρίωση για όλες τις λειτουργίες C στο SimApi που χρειάζεται να εφαρμόσει ένα DLL SimApi, καθώς και κάποιες οδηγίες για τον τρόπο ανάπτυξης ενός SimApi.
• Η υλοποίηση ενός SimApi χρησιμοποιώντας C ή C++ είναι στις περισσότερες περιπτώσεις σε αδικαιολόγητα χαμηλό επίπεδο.
• Ο προτεινόμενος και ευκολότερος τρόπος για την υλοποίηση ενός SimApi είναι να το βασίσετε στο ExampΟ πηγαίος κώδικας leSimApi που παρέχουμε. Είναι πρώηνample SimApi υλοποίηση που χειρίζεται τη διεπαφή C και τη μεταφράζει σε.NET Framework όπου γίνεται η πραγματική υλοποίηση. Διαθέτει επίσης κώδικα πλαισίου για καταγραφή, ρυθμίσεις, GUI διαμόρφωσης και άλλον κώδικα πλαισίου.
• Για να αναπτύξει ένα SimApi, η ομάδα προγραμματιστών χρειάζεται εμπειρία στην ανάπτυξη Windows, .NET Framework, C ή C++. Απαιτείται επίσης καλή γνώση της πηγής δεδομένων στην οποία θα πρέπει να συνδεθεί το SimApi, επειδή ο σκοπός ενός SimApi είναι να μεταφράζει αιτήματα δεδομένων από το SIMCA-online ή το SIMCA στο API της πηγής δεδομένων. Μια υλοποίηση SimApi δεν είναι ποτέ ένα μεμονωμένο έργο, αλλά συνήθως χρειάζεται συνεχή υποστήριξη και περιστασιακή συντήρηση.

Ανάγνωση ή εγγραφή δεδομένων

• Ένα SimApi έχει το κύριο καθήκον να παρέχει δεδομένα από μια πηγή δεδομένων. Αυτό αναφέρεται ως δεδομένα ανάγνωσης.
• Οι περισσότερες υλοποιήσεις SimApi υποστηρίζουν επίσης την εγγραφή δεδομένων. Αυτό σημαίνει εγγραφή πίσω δεδομένων μέσω του SimApi στην πηγή δεδομένων. Η εγγραφή δεδομένων είναι μια προαιρετική δυνατότητα στο SIMCA-online.

Tags και Κόμβοι

• A tag είναι ένα αναγνωριστικό μιας στήλης ή "μεταβλητής" σε μια πηγή δεδομένων. ΕΝΑ tagΤο όνομα του χρησιμοποιείται για την αναγνώριση του tag. Τα ονόματα εντός του κόμβου πρέπει να είναι μοναδικά. Το SIMCA-online 18 είναι η πρώτη έκδοση που υποστηρίζει έναν κόμβο που περιέχει έναν υποκόμβο και tag με το ίδιο όνομα. Για π.χample: ο κόμβος Parent μπορεί να έχει έναν υποκόμβο που ονομάζεται Batch και a tag που ονομάζεται Batch.
• Ένας κόμβος είναι ένα δοχείο του tags. Ένας κόμβος μπορεί επίσης να περιέχει άλλους κόμβους, παρόμοια με τον α file το σύστημα έχει φακέλους σε φακέλους.
• Όπως σε ένα file σύστημα, ο κόμβος και tag Τα ονόματα μπορούν να συνδυαστούν σε μια πλήρη διαδρομή που προσδιορίζει μοναδικά το α tag. Ο tag Οι διαδρομές χρησιμοποιούνται σε SIMCA-online ή SIMCA κατά την επιλογή tags για χρήση. ΕΝΑ tag Η διαδρομή ξεκινά με ένα όνομα παρουσίας SimApi ακολουθούμενο από τη δομή κόμβου και τελειώνει με το tag όνομα, κάθε στοιχείο χωρίζεται με άνω και κάτω τελεία (:). Για π.χample “:ODBCSQLSserver:Node:SensorTag1”.

Το SimApi απαριθμεί tags και κόμβους κατά την εκκίνηση

• Μια υλοποίηση SimApi περιηγείται στον διακομιστή για κόμβους και tags στην πηγή δεδομένων όταν αρχικοποιείται το SimApi και τα παρακολουθεί έτσι ώστε οι διάφορες συναρτήσεις SimApi που χρησιμοποιούνται για την απαρίθμηση tags και ο κόμβος μπορεί να υλοποιηθεί.
• Η προετοιμασία του SimApi δεν πραγματοποιείται μόνο κατά την εκκίνηση του διακομιστή, αλλά μπορεί επίσης να ενεργοποιηθεί ξανά από έναν χρήστη στο SIMCA-online με τη λειτουργία Refresh SimApi.

Ευαισθησία περίπτωσης του tag- και ονόματα κόμβων

• Tag Τα ονόματα και τα ονόματα κόμβων κάνουν διάκριση πεζών-κεφαλαίων.
• Έτσι, α tag ονομάζεται "tag1» δεν είναι το ίδιο με το «Tag1» λόγω της διαφορετικής περίπτωσης του «Τ». Συνιστούμε να μην χρησιμοποιείτε tags ή ονόματα κόμβων που διαφέρουν μόνο σε περίπτωση.

Κόμβος συνεχούς διαδικασίας 

• Όταν ένας κόμβος περιέχει tags με δεδομένα συνεχούς διεργασίας, μπορεί να αναφέρεται ως κόμβος διεργασίας. Τα ακόλουθα δύο στιγμιότυπα οθόνης δείχνουν μια πίνακα αναπαράστασης ενός κόμβου διεργασίας με δεδομένα που ακολουθείται από μια εικόνα που δείχνει πώς φαίνεται ο κόμβος κατά την επιλογή tags σε SIMCA-online.

Οι κόμβοι συνεχούς διεργασίας πρέπει να είναι ανεξάρτητοι από παρτίδες, εκτελέσεις ή χρόνο

• Για να λειτουργήσει καλά σε ένα SimApi ένας κόμβος πρέπει να είναι ανεξάρτητος από παρτίδες, εκτελέσεις ή χρόνο. Η ύπαρξη ενός κόμβου που περιέχει δεδομένα για μια συγκεκριμένη παρτίδα ή χρονικό εύρος δεν θα λειτουργούσε καλά στο SIMCA-online επειδή η διαμόρφωση του έργου θα μπορούσε να διαβάσει μόνο δεδομένα για αυτήν την παρτίδα και να μην χρησιμοποιηθεί για άλλες παρτίδες.
• Αντίθετα, ένας κόμβος θα πρέπει να αντιστοιχιστεί σε μία ή περισσότερες φυσικές μονάδες στη διαδικασία όπου εκτελούνται οι μετρήσεις.

Ταυτότητα παρτίδας tag απαιτείται στους κόμβους συνεχούς διεργασίας για την εκτέλεση έργων κατά παρτίδες

• Κάθε συνεχής διαδικασία πρέπει να έχει ένα tag (μεταβλητή) κρατώντας το αναγνωριστικό παρτίδας για κάθε παρατήρηση. Αυτό το αναγνωριστικό παρτίδας χρησιμοποιείται από τη SIMCA ή τη SIMCA-online για να γνωρίζει σε ποια παρτίδα ανήκει κάθε παρατήρηση.
• Το $BatchID tag στα στιγμιότυπα στην 7.4.3 είναι ένα τέτοιο π.χample.
  Αν και δεν απαιτείται, συνιστάται να έχετε ένα tag στον κόμβο διεργασίας που δείχνει την τρέχουσα φάση ή βήμα της διαδικασίας. Αυτό tag μπορεί στη συνέχεια να χρησιμοποιηθεί σε συνθήκες εκτέλεσης φάσης στο SIMCA-online ή στο SIMCA κατά την εισαγωγή δεδομένων. Αξίες για αυτό tag μπορεί να είναι για π.χample “phase1”, “clearing”, “phase2”.

Κόμβος περιβάλλοντος παρτίδας

• Ένας κόμβος παρτίδας είναι ένας κόμβος που παρακολουθεί τις παρτίδες. τα αναγνωριστικά παρτίδας, οι ώρες έναρξης και οι ώρες λήξης. Είναι μια απαίτηση για την εκτέλεση έργου ομαδικής σε SIMCA-online. Μια πηγή δεδομένων μπορεί να έχει περισσότερους από έναν κόμβους παρτίδας που εκθέτουν τις παρτίδες με διαφορετικούς τρόπους. Ο χρήστης επιλέγει τον κόμβο παρτίδας που ισχύει για την εφαρμογή του. Αυτό το πρώηνample εκθέτει παρτίδες που καλύπτουν δύο διαφορετικές μονάδες:
• /Factory1 – παρτίδες με αθροιστική διάρκεια ζωής τόσο στη Μονάδα 1 όσο και στη Μονάδα 2.
• /Factory1/Unit1 – παρτίδες με διάρκεια ζωής μόνο στη Μονάδα 1
• /Factory1/Unit2 – παρτίδες με διάρκεια ζωής μόνο στη Μονάδα 2
• Εάν δεν έχετε έναν κόμβο δέσμης στην πηγή δεδομένων σας, μπορείτε να χρησιμοποιήσετε το Batch Context Generator στο SIMCA-online. Δείτε την ενσωματωμένη βοήθεια.
• Προαιρετικά δεδομένα παρτίδας
• Ένας κόμβος παρτίδας μπορεί επίσης να περιέχει δεδομένα παρτίδας. δεδομένα για τα οποία υπάρχει μόνο μία παρατήρηση για ολόκληρη την παρτίδα. Σημειώστε ότι tags με δεδομένα παρτίδας δεν χρειάζεται να βρίσκονται σε κόμβο που έχει την πλήρη λειτουργικότητα ενός κόμβου παρτίδας. Αρκεί το SimApi να υποστηρίζει την ανάγνωση δεδομένων παρτίδας για το tags. Μάθετε περισσότερα για τα δεδομένα παρτίδας στην έκδοση 7.6.
• Εδώ είναι ένας πρώηνample ενός κόμβου παρτίδας:
• Σημείωση: Το παραπάνω στιγμιότυπο οθόνης έχει ληφθεί από το DBMaker, σε πακέτο με SIMCA-online. Για να το δείτε μόνοι σας στο DBMaker, κάντε κλικ στο View Κουμπί δεδομένων στη βάση δεδομένων Bakers Yeast για εμφάνιση δύο παραθύρων, το ένα από τα οποία είναι ο κόμβος παρτίδας και το άλλο τα δεδομένα διεργασίας.

Τύποι δεδομένων: αριθμητικά δεδομένα, δεδομένα κειμένου και δεδομένα που λείπουν

• Για το καθένα tag, ένα SimApi μπορεί να υποστηρίξει τρεις τύπους δεδομένων: αριθμητικά, text, t και λείπουν:
• Τα αριθμητικά δεδομένα είναι συνήθως πραγματικές τιμές των παραμέτρων διεργασίας, π.χample 6.5123. Το SimApi μπορεί να χειριστεί μόνο τιμές κινητής υποδιαστολής ακριβείας 32-bit. Μορφή κινητής υποδιαστολής απλής ακρίβειας - Wikipedia. Όλοι οι άλλοι τύποι αριθμητικών δεδομένων σε μια πηγή δεδομένων θα πρέπει να μετατραπούν σε float. Ως εκ τούτου, μπορούν να αντιμετωπίσουν τόσο μεγάλες όσο και μικρές τιμές, αλλά μόνο με περίπου 6 ή 7 σημαντικά ψηφία. Μάθετε περισσότερα στον Τεχνικό Οδηγό.
• Αυτό μπορεί να οδηγήσει σε απώλεια ακρίβειας για μεγάλους ακέραιους ή για πραγματικούς αριθμούς που είναι και μεγάλοι και έχουν δεκαδικούς. Για περισσότερες πληροφορίες, ανατρέξτε στον Τεχνικό Οδηγό.
• Τα δεδομένα κειμένου/συμβολοσειράς χρησιμοποιούνται για αναγνωριστικά παρτίδας, συνθήκες εκτέλεσης φάσης ή για ποιοτικές μεταβλητές. Τιμές για κείμενο tag τα δεδομένα είναι διάκριση πεζών-κεφαλαίων. Αυτό σημαίνει ότι η τιμή "running" δεν είναι η ίδια με
  "ΤΡΕΞΙΜΟ". Οι μεταβλητές Datetime δεν υποστηρίζονται απευθείας από το SimApi, αλλά μπορούν να επιστραφούν ως συμβολοσειρά μορφοποιημένη ως ΕΕ-ΜΜ-ΗΗ ΩΩ: ΜΜ (π.χ.ample “2020-09-07 13:45”).
• Οι τιμές που λείπουν σημαίνει ότι δεν υπάρχει τιμή προς επιστροφή, δηλ. δεν υπάρχουν δεδομένα.
• Ο τύπος που επιστρέφεται εξαρτάται από την υλοποίηση SimApi. Ένα SimApi γνωρίζει για τα δεδομένα στην προέλευση δεδομένων και θα πρέπει να επιστρέψει τον τύπο δεδομένων που ταιριάζει καλύτερα.

Τρεις τρόποι ανάκτησης δεδομένων: Συνεχής, Batc, h και Διακριτικός

• Η προδιαγραφή SimApi ορίζει τρεις τρόπους ανάκτησης δεδομένων, π.χ. τρεις διαφορετικοί τρόποι από τους οποίους το SimApi μπορεί να παρέχει δεδομένα tags σε μια πηγή δεδομένων (ή προς την άλλη κατεύθυνση: εγγραφή δεδομένων σε tags σε μια πηγή δεδομένων).
• Συνεχής ανάκτηση δεδομένων – αναφέρεται σε δεδομένα που διαβάζονται συνεχώς και διαδοχικά, παρατήρηση ανά παρατήρηση καθώς εξελίσσεται η παρτίδα ή η διαδικασία. Τα δεδομένα διαβάζονται για την τρέχουσα ώρα, ή για ένα συγκεκριμένο εύρος, σε ένα κανονικό διάστημα μεταξύ των παρατηρήσεων. Για π.χample, όλα τα δεδομένα μεταξύ 09:00:00 και 10:00:00 sampled κάθε 60 δευτερόλεπτα, με αποτέλεσμα 61 παρατηρήσεις όταν περιλαμβάνονται τα τελικά σημεία.
• Ανάκτηση δεδομένων παρτίδας – αναφέρεται σε μια ενιαία παρατήρηση με δεδομένα για μια ολόκληρη παρτίδα (που δεν σχετίζεται με συγκεκριμένη ωριμότητα ή χρονικό σημείο). Τα χαρακτηριστικά παρτίδας και τα δεδομένα τοπικού κεντραρίσματος διαβάζονται ως δεδομένα παρτίδας στο SIMCA-online. Οι συνθήκες παρτίδας συνήθως διαβάζονται επίσης ως δεδομένα παρτίδας (εκτός εάν έχουν διαμορφωθεί για διακριτή ανάκτηση δεδομένων).
• Διακριτή ανάκτηση δεδομένων – τα διακριτά δεδομένα μπορεί να αποτελούνται από πολλές παρατηρήσεις για πολλές ωριμάνσεις. Αλλά σε αντίθεση με τα συνεχή δεδομένα, τα διακριτά δεδομένα δεν διαβάζονται διαδοχικά, αλλά όλα τα δεδομένα ταυτόχρονα για μια συγκεκριμένη φάση μιας παρτίδας. Τα δεδομένα δεν χρειάζεται να απέχουν μεταξύ τους τακτικά διαστήματα της μεταβλητής ωριμότητας. Όλα τα δεδομένα διαβάζονται ξανά κάθε φορά που ζητούνται τα δεδομένα, στο διαμορφωμένο διάστημα.
• Για κάθε δεδομένο tag μπορούν να ζητηθούν δεδομένα σε οποιαδήποτε από τις τρεις λειτουργίες, αλλά συνήθως ένα SimApi υποστηρίζει μόνο μία από αυτές τις λειτουργίες για ένα άτομο tag. Ομοίως, αφήνεται να αναμειχθεί tags μέσα σε έναν κόμβο, αλλά συνήθως σε όλους tags εντός ενός συγκεκριμένου κόμβου υποστηρίζουν τον ίδιο τρόπο ανάκτησης δεδομένων.
• Για συνεχή δεδομένα (αλλά όχι για ομαδικά ή διακριτά δεδομένα2), μπορούν να υποβληθούν αιτήματα για τρέχοντα δεδομένα ή ιστορικά δεδομένα που είναι το θέμα της επόμενης ενότητας.
• Δεν υποστηρίζουν όλα τα SimApi όλες τις λειτουργίες. Δείτε τον πίνακα χαρακτηριστικών παραπάνω και το SimApi web σελίδα για λεπτομέρειες.

Τρέχοντα και Ιστορικά συνεχή δεδομένα μέσω ενός SimApi

• Τα συνεχή δεδομένα αναφέρονται σε δεδομένα διεργασίας που αλλάζουν με την πάροδο του χρόνου.

Τρέχοντα δεδομένα

• Η ανάγνωση των τρεχόντων δεδομένων σημαίνει να ζητάτε από την πηγή δεδομένων τις πιο πρόσφατες τιμές του tags τη στιγμή της ερώτησης. Σημειώστε ότι η ώρα της εξωτερικής προέλευσης δεδομένων δεν χρησιμοποιείται εδώ.
• Τα δεδομένα που διαβάζονται ως τρέχοντα δεδομένα είναι αυτά που θα εμφανίσει η SIMCA-online ως ζωντανά δεδομένα. Για το λόγο αυτό, είναι σημαντικό να μην υπάρχουν περιττές καθυστερήσεις στην προέλευση δεδομένων. Τα τρέχοντα δεδομένα πρέπει να είναι όσο το δυνατόν πιο πρόσφατα για να λειτουργούν καλά στο SIMCA-online.
• Η πηγή δεδομένων μπορεί να χρησιμοποιήσει τις γνώσεις της για τα δεδομένα και το χρονικό διάστημα που είναι έγκυρες οι τιμές και να αποφασίσει να επιστρέψει δεδομένα που λείπουν όταν τα ανεπεξέργαστα δεδομένα για ένα χρονικό σημείο είναι πολύ παλιά. Για π.χample: τα δεδομένα ζητούνται στις 15:00:00, αλλά το πιο πρόσφατο σημείο δεδομένων στην πηγή δεδομένων είναι από τις 03:00:00. Σε αυτήν την περίπτωση τα δεδομένα είναι 12 ωρών, οπότε το SimApi μπορεί να αποφασίσει να επιστρέψει την τιμή που λείπει (χωρίς δεδομένα).

Ιστορικά στοιχεία

• Η ανάγνωση ιστορικών δεδομένων σημαίνει να ζητάτε από την πηγή δεδομένων τιμές ενός ή περισσότερων tags για συγκεκριμένο χρονικό εύρος με συγκεκριμένο διάστημα μεταξύ των παρατηρήσεων. Σημειώστε ότι εδώ είναι η τοπική ώρα της πηγής δεδομένων που χρησιμοποιείται για την εύρεση των δεδομένων. Επομένως, ο συγχρονισμός χρόνου μεταξύ της πηγής δεδομένων και των διακομιστών είναι σημαντικός.
• Τα ιστορικά δεδομένα αποτελούνται από μια μήτρα δεδομένων. Εναπόκειται στην υλοποίηση του SimApi να ζητήσει τα δεδομένα από την πηγή δεδομένων και sampαφήστε το στο καθορισμένο διάστημα και κατασκευάστε τον πίνακα δεδομένων που θα επιστρέψετε:
• Μερικές φορές η ίδια η πηγή δεδομένων έχει συναρτήσεις συγκέντρωσης για την επιστροφή των επεξεργασμένων δεδομένων ή sampσυναρτήσεις ling, που μπορούν να χρησιμοποιηθούν για την επιστροφή των σωστών δεδομένων.
• Για άλλες πηγές δεδομένων, το SimApi πρέπει να ζητήσει όλα τα δεδομένα στο χρονικό εύρος και μετά sample τις σωστές παρατηρήσεις για την κατασκευή του πίνακα.
• Τα δεδομένα πρέπει να επιστραφούν για ένα χρονικό εύρος, παρόλο που ενδέχεται να μην υπάρχουν ανεπεξέργαστα δεδομένα στο χρονικό εύρος, αλλά μόνο λίγο πριν από την ώρα έναρξης. Για π.χample: τα δεδομένα υπάρχουν στην πηγή δεδομένων στα χρονικά σημεία 10 και 20. Το SimApi ζητά δεδομένα για το χρόνο 15 και 17. Σε αυτήν την περίπτωση, οι τιμές για το χρονικό σημείο 10 θα πρέπει να επιστραφούν από το SimApi αλλά το timestamped ως χρόνος 15 και 17, καθώς αυτά ήταν τα πιο πρόσφατα σημεία δεδομένων εκείνη την εποχή. Οι τιμές για tags τη χρονική στιγμή 10 αναφέρονται ως τιμές ορίων για το ζητούμενο εύρος. Για μια βαθύτερη εξήγηση των τιμών των ορίων, βλample την τεκμηρίωση για returnBounds στο UA Part 11: Historical Access – 6.4.3 ReadRawModifiedDetails δομή
  (opcfoundation.org)
• Η παρεμβολή δεν πρέπει ποτέ να χρησιμοποιείται για τον υπολογισμό τιμών για μελλοντικά χρονικά σημεία, επειδή τα δεδομένα δεν θα ταιριάζουν με αυτά που διαβάζονται σε πραγματικό χρόνο ως τρέχοντα δεδομένα. Για τον πρώηνample από την προηγούμενη κουκκίδα: εάν τα δεδομένα για το 15 και το 17 επρόκειτο να παρεμβληθούν χρησιμοποιώντας τις τιμές για τα στοιχεία 10 και 20, θα χρησιμοποιούσαν ουσιαστικά τιμές από το μέλλον, κάτι που δεν επιτρέπεται.
• Η πηγή δεδομένων μπορεί να χρησιμοποιήσει τις γνώσεις της σχετικά με τα δεδομένα και τον χρόνο ισχύος των τιμών και να αποφασίσει να επιστρέψει δεδομένα που λείπουν όταν τα ανεπεξέργαστα δεδομένα για ένα χρονικό σημείο είναι παλιά. Για π.χample: τα δεδομένα ζητούνται για τις 15:00:00, αλλά το πιο πρόσφατο σημείο δεδομένων στην πηγή δεδομένων είναι από τις 03:00:00. Σε αυτήν την περίπτωση, τα δεδομένα είναι 12 ωρών, οπότε το SimApi μπορεί να αποφασίσει να επιστρέψει την τιμή που λείπει (χωρίς δεδομένα).

Σημείωμα: Το SIMCA-online συνήθως δεν ζητά περισσότερες από εκατό παρατηρήσεις σε μία κλήση κατά την κανονική εκτέλεση του έργου. Όταν κάνετε εξαγωγή σε SIMCA-online ή όταν εκτελείτε SIMCA επιτραπέζιου υπολογιστή, μπορούν να γίνουν μεγαλύτερα αιτήματα δεδομένων. Αυτά μπορεί να διαρκέσουν πολύ, κάτι που είναι αναμενόμενο.

Τα τρέχοντα δεδομένα και τα ιστορικά δεδομένα πρέπει να ταιριάζουν

• Μερικές φορές μπορεί να υπάρχουν διαφορές όταν τα δεδομένα διαβάζονται ως τρέχοντα δεδομένα σε πραγματικό χρόνο ή δεδομένα ιστορικού. Αυτό προκαλεί προβλήματα στο SIMCA-online επειδή ο διακομιστής αλλάζει αυτόματα μεταξύ των τρεχόντων και των ιστορικών δεδομένων, όπως απαιτείται.

Απόκτηση δεδομένων χαμηλής καθυστέρησης

• Όταν μια πηγή δεδομένων χρησιμοποιείται από τη SIMCA-online σε πραγματικό χρόνο, είναι σημαντικό τα δεδομένα στην πηγή δεδομένων να είναι ενημερωμένα. Δεν πρέπει να υπάρχουν περιττές καθυστερήσεις στην απόκτηση δεδομένων στην πηγή δεδομένων. Τα δεδομένα συνεχούς διαδικασίας για όλες τις μεταβλητές πρέπει να είναι διαθέσιμα ταυτόχρονα για κάθε παρατήρηση. Τα δεδομένα που έρχονται καθυστερημένα για ορισμένες μεταβλητές δεν θα ληφθούν από τη SIMCA-online.

Τα δεδομένα μπορούν να διαβαστούν ανά πάσα στιγμή 

• Όταν η SIMCA-online ζητά μια τιμή α tag για το χρόνο t θα λάβει την τιμή από την πηγή δεδομένων από τη στιγμή t, ή την πιο πρόσφατη παρατήρηση στην πηγή δεδομένων πριν από την ώρα t, ή μια παρεμβαλλόμενη τιμή για το χρόνο t. Έτσι, ο διακομιστής θα λαμβάνει πάντα μια τιμή κάθε φορά που ζητά, παρόλο που μπορεί να μην υπάρχει παρατήρηση για αυτό το ακριβές χρονικό σημείο στην πηγή δεδομένων.
• ΈγκαιροςampΤα s στο SimApi είναι πάντα UTC. Οι πελάτες SIMCA-online και η SIMCA παρουσιάζουν την ώρα ως τοπική ώρα.

Σπείρωμα 

• Το SimApi καλείται, από προεπιλογή, από ένα μόνο νήμα από τον χρήστη του SimApi. Αυτό ισχύει για όλες τις εκδόσεις SIMCA και τη SIMCA-online μέχρι την έκδοση 17.
• Το SIMCA-online 18 υποστηρίζει μια σημαία δυνατότητας για ενεργοποίηση της πρόσβασης πολλαπλών νημάτων μέσω του SimApi. Διαβάστε περισσότερα στο θέμα βοήθειας Ταυτόχρονη πρόσβαση στο SimApi.
• Αυτό σημαίνει ότι το SimApis θα πρέπει να προετοιμαστεί για πολλαπλές νήματα, εάν είναι δυνατόν, κάνοντας το νήμα υλοποίησης SimApi ασφαλές, και να τεκμηριώσει αυτό και οποιεσδήποτε σκέψεις για τους χρήστες του SimApi.

Κούτσουρο file

• Ένα SimApi θα πρέπει να καταγράφει ενέργειες, μηνύματα σφάλματος και προειδοποιήσεις στο αρχείο καταγραφής του file για να βοηθήσει στην αντιμετώπιση προβλημάτων. Χρησιμοποιήστε τα διαφορετικά επίπεδα καταγραφής για να δηλώσετε τη σημασία της καταγραφής.
• Συνιστάται η καταγραφή «Not implemented» για λειτουργίες που δεν έχουν εφαρμοστεί σε SimApi.

Διαχείριση σφαλμάτων

• Όταν ένα SimApi δεν μπορεί να εκπληρώσει ένα αίτημα από την πηγή δεδομένων, μπορεί να χειριστεί αυτό το πρόβλημα με έναν από τους δύο τρόπους. επιστρέφοντας τιμές που λείπουν (χωρίς δεδομένα) ή σηματοδοτώντας ένα σφάλμα SimApi:
• Η επιστροφή των τιμών που λείπουν στον καλούντα και η επιτυχία σηματοδότησης επιτρέπει στον καλούντα να συνεχίσει κανονικά (αλλά φυσικά χωρίς δεδομένα). Αυτή είναι μια συνιστώμενη πρακτική για μερικά σφάλματα, όπως όταν μπορούσαν να ληφθούν δεδομένα για ορισμένα, αλλά όχι για όλα, tags σε ένα αίτημα.
• Η σηματοδότηση ενός σφάλματος SimApi επιτρέπει στον καλούντα (π.χampο διακομιστής SIMCA-online) για να το δείτε αμέσως και να ενεργήσετε. Αυτή είναι μια συνιστώμενη πρακτική για αιτήματα που αποτυγχάνουν εντελώς και δεν μπορούν να επιστρέψουν καθόλου δεδομένα.
• Το SIMCA-online χειρίζεται διαφορετικά τις τιμές ή τους κωδικούς σφάλματος που λείπουν, όπως περιγράφεται στον Τεχνικό Οδηγό SIMCA-online.

Απαιτήσεις απόδοσης SimApi

• Οι λειτουργίες στο SimApi χρησιμοποιούνται για τη λήψη δεδομένων.
• Εάν η πρόσβαση στα δεδομένα είναι αργή, το SimApi δεν θα λειτουργήσει καλά, όπως αυτό π.χampΤο le δείχνει: Εάν το SIMCA-online ζητά δεδομένα κάθε δευτερόλεπτο, αλλά χρειάζονται δύο δευτερόλεπτα για να ληφθούν, ο διακομιστής SIMCA-online δεν θα μπορέσει ποτέ να συμβαδίσει σε πραγματικό χρόνο, αλλά σταδιακά θα υστερεί όλο και περισσότερο.
• Στις υποενότητες θα δείξουμε πώς το SIMCA και το SIMCA-online χρησιμοποιούν τις λειτουργίες πρόσβασης δεδομένων SimApi και πόσο συχνά θα καλούνται οι συναρτήσεις SimApi. Αυτό μπορεί να βοηθήσει στον καθορισμό απαιτήσεων απόδοσης για μια υλοποίηση SimApi.

Η χρήση των λειτουργιών SimApi από τη SIMCA

• Όταν SIMCA επιτραπέζιου υπολογιστή ή άλλα προϊόντα εκτός σύνδεσης χρησιμοποιούν ένα SimApi για τη λήψη δεδομένων, αυτά τα αιτήματα θα αφορούν παρτίδες και δεδομένα επεξεργασίας για ένα σύνολο μεταβλητών σε ένα συγκεκριμένο χρονικό εύρος.
• Δεδομένου ότι αυτά τα αιτήματα εκκινούνται με μη αυτόματο τρόπο από έναν χρήστη, δεν συμβαίνουν πολύ συχνά και δεν προκαλούν σημαντικό φορτίο σε μια πηγή δεδομένων.
• Αυτές οι συναρτήσεις SimApi χρησιμοποιούνται για τη λήψη των δεδομένων:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Η χρήση των λειτουργιών SimApi από τη SIMCA-online

• Το SIMCA-online χρησιμοποιείται για την παρακολούθηση μιας διαδικασίας σε πραγματικό χρόνο και ως εκ τούτου ζητά δεδομένα μέσω του SimApi σε τακτά χρονικά διαστήματα. Το συντομότερο διάστημα εκτέλεσης που μπορεί να χρησιμοποιηθεί είναι 1 δευτερόλεπτο. Κάποιοι πρώην πραγματικοίampΤα διαστήματα εκτέλεσης είναι 10 δευτερόλεπτα, 1 λεπτό ή 10 λεπτά.
• Ένας διακομιστής μπορεί να έχει πολλά έργα που εκτελούνται ταυτόχρονα.
• Για να μειώσει τον αριθμό των κλήσεων API μέσω του SimApi, ο διακομιστής βελτιστοποιεί τα αιτήματα δεδομένων ομαδοποιώντας πολλά ταυτόχρονα μικρότερα αιτήματα σε ένα μόνο μεγαλύτερο αίτημα για όλες τις μεταβλητές ταυτόχρονα (μάθετε περισσότερα στο θέμα βοήθειας "Η βελτιστοποιημένη ανάγνωση από πηγές δεδομένων βελτιώνει την απόδοση").
• Ο αλγόριθμος εκτέλεσης του διακομιστή λειτουργεί ως εξής όταν ζητά δεδομένα χρησιμοποιώντας τις λειτουργίες SimApi που αναφέρονται παρακάτω:
• Όλες οι φάσεις που εκτελούνται στο ίδιο διάστημα ομαδοποιούνται σε μία κλήση SimApi για να μειωθεί ο αριθμός των κλήσεων. Ο διακομιστής διαβάζει τα πιο πρόσφατα δεδομένα για όλες τις μεταβλητές που χρησιμοποιούνται από όλα τα μοντέλα που μοιράζονται το διάστημα, δηλαδή, αυτή η κλήση θα οδηγήσει σε μια ευρεία σειρά δεδομένων η οποία στη συνέχεια χρησιμοποιείται από όλα τα έργα.
  • simapi2_connectionReadCurrentData
• Για κάθε έργο παρτίδας, ο διακομιστής πρέπει επίσης να γνωρίζει ποιες παρτίδες είναι ενεργές. Αυτό πρέπει επίσης να συμβαίνει κάθε φορά που εκτελείται ένα έργο:
  • simapi2_nodeGetActiveBatches
  • Το simapi2_nodeGetBatchTimes καλείται λιγότερο συχνά.
• Επιπλέον, το SIMCA-online απαιτεί επίσης ιστορικά δεδομένα. Αυτά τα αιτήματα συμβαίνουν μόνο όταν χρειάζεται, όπως να καλύψει την αρχή μιας παρτίδας που ξεκίνησε πριν από την έναρξη του SIMCA-online ή όταν ο διακομιστής υστερεί και χρειάζεται να διαβάσει ένα μπλοκ δεδομένων:
  • simapi2_connectionReadHistoricalDataEx
• Προαιρετικά, ορισμένες ρυθμίσεις παραμέτρων έργου χρησιμοποιούν λειτουργίες που χρησιμοποιούν δεδομένα παρτίδας ή διακριτά δεδομένα που έχουν ως αποτέλεσμα κλήσεις SimApi σε:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Προαιρετικά, ορισμένες ρυθμίσεις παραμέτρων έργου χρησιμοποιούν εγγραφή για να ωθήσουν τα δεδομένα πίσω στην πηγή δεδομένων:
  • simapi2_connectionWriteHistoricalDataEx (και αντίστοιχες συναρτήσεις για δεδομένα παρτίδας, διακριτά δεδομένα)
• Είναι σημαντικό κάθε κλήση προς τις βασικές συναρτήσεις για τη λήψη δεδομένων, readCurrentData, getActiveBatches/getBatchTimes, να είναι γρήγορη και αυτό δεν είναι υπολογιστικά δύσκολο για την ίδια την πηγή δεδομένων, δεδομένου του πόσο συχνά μπορεί να καλεί αυτές τις συναρτήσεις η SIMCA-online.

Δοκιμή και επικύρωση δεδομένων SimApi

• Αυτή η ενότητα αφορά τη δοκιμή ενός SimApi για να επαληθεύσετε ότι τα δεδομένα που επιστρέφονται από αυτό ταιριάζουν με τα δεδομένα στην ίδια την πηγή δεδομένων. Η εκτέλεση δοκιμών όπως αυτή είναι σημαντική μετά τη δημιουργία ή την αλλαγή της εφαρμογής SimApi ή όταν αλλάζει το API μιας πηγής δεδομένων.
• Στην πράξη, η επικύρωση δεδομένων πραγματοποιείται χρησιμοποιώντας το SIMCA-online και τη λειτουργικότητά του Extract για την άντληση δεδομένων από την πηγή δεδομένων μέσω του SimApi και, στη συνέχεια, τη σύγκριση με τα ανεπεξέργαστα δεδομένα στην πηγή δεδομένων. Το Desktop SIMCA δεν μπορεί να χρησιμοποιηθεί για τον έλεγχο των πτυχών ενός SimApi σε πραγματικό χρόνο.

Προετοιμασίες και απαιτήσεις

• Ορισμένα στοιχεία είναι προαιρετικά, αλλά μπορούν να εκτελεστούν εάν το εύρος της δοκιμής σας το περιλαμβάνει:

1. Εγκαταστήστε το SIMCA-online όπως περιγράφεται στο ReadMe and Installation Guide.pdf που διατίθεται στο zip του προϊόντος.
2. Αποκτήστε μια άδεια χρήσης για τον διακομιστή SIMCA-online και εγκαταστήστε την. Το SimApi δεν θα λειτουργήσει χωρίς άδεια. Το άρθρο της γνωσιακής βάσης για το SIMCA-online δείχνει τον τρόπο χορήγησης άδειας χρήσης του προϊόντος. Για π.χample: SIMCA-online 18 (sartorius.com)
3. Εγκαταστήστε και διαμορφώστε το SimApi που θέλετε να δοκιμάσετε. Ανατρέξτε στα κεφάλαια 4 – 5 αυτού του εγγράφου και στον οδηγό χρήσης του συγκεκριμένου SimApi.
   • a. Προαιρετικό: βεβαιωθείτε ότι ο οδηγός χρήσης είναι ενημερωμένος και σωστός.
4. Βεβαιωθείτε ότι διαθέτετε ένα εργαλείο για την πηγή δεδομένων σας, το οποίο μπορείτε να χρησιμοποιήσετε για να συγκρίνετε τα δεδομένα SimApi.
5. Στο πρόγραμμα-πελάτη επιτραπέζιου υπολογιστή SIMCA-online, συνδεθείτε στον διακομιστή SIMCA-online και χρησιμοποιήστε το File > Εξαγωγή για λήψη δεδομένων μέσω του SimApi.
6. Προαιρετικό εάν το εύρος δοκιμών σας το περιλαμβάνει: μετά την ολοκλήρωση της δοκιμής, απεγκαταστήστε το SimApi και επαληθεύστε το files αφαιρούνται.

Τι να δοκιμάσετε

• Ο πίνακας χαρακτηριστικών στο κεφάλαιο 3 παραθέτει όλες τις πιθανές δυνατότητες, αλλά μια δεδομένη υλοποίηση SimApi μπορεί να υποστηρίζει μόνο ένα υποσύνολο. Θα πρέπει να δοκιμάσετε όλες τις δυνατότητες που υλοποιούνται από το δεδομένο SimApi.
• Οι ακόλουθες δοκιμές είναι κοινές για τις περισσότερες υλοποιήσεις SimApi:
• Έλεγχος ταυτότητας με ονόματα χρήστη και κωδικούς πρόσβασης
• Δοκιμάστε τις διάφορες ρυθμίσεις στη διαμόρφωση του SimApi
• Ιεραρχία κόμβων: Οι κόμβοι και tags που εκτίθενται από το SimApi είναι σωστά.
  • Πρέπει να υπάρχει ένα tag εκτίθενται για όλες τις «μεταβλητές» που θα πρέπει να είναι διαθέσιμες μέσω του SimApi. Πρώηνamples: μετρήσεις διεργασίας, υπολογισμένες τιμές, σταθερές.
• Ανθεκτικότητα σύνδεσης: εάν η πηγή δεδομένων δεν είναι διαθέσιμη, αυτό έχει ως αποτέλεσμα προειδοποιήσεις ή σφάλματα στο αρχείο καταγραφής file, αλλά ότι η σύνδεση με την πηγή δεδομένων αποκαθίσταται αυτόματα όταν η πηγή δεδομένων είναι διαθέσιμη.
• Πολλαπλές περιπτώσεις: ότι δύο περιπτώσεις μπορούν να διαμορφωθούν και να χρησιμοποιηθούν ανεξάρτητα και ταυτόχρονα, με ξεχωριστά αρχεία καταγραφής files.
• Τρέχοντα δεδομένα: εξαγωγή τρεχόντων δεδομένων για tags. Βεβαιωθείτε ότι τα δεδομένα είναι οι τελευταίες γνωστές τιμές από την προέλευση δεδομένων ή λείπουν λόγω κακής ποιότητας ή όταν τα δεδομένα είναι πολύ παλιά.
  • Εξάγετε δεδομένα κάθε 10 δευτερόλεπτα (ή έτσι) για ένα λεπτό.
• Ιστορικά συνεχή δεδομένα: εξαγωγή ιστορικών δεδομένων για tags.
  • Χρησιμοποιήστε το χρονικό εύρος που ταιριάζει κατά την εξαγωγή των τρεχόντων δεδομένων. Βεβαιωθείτε ότι τα τρέχοντα δεδομένα ταιριάζουν με τα ιστορικά δεδομένα και τα μη επεξεργασμένα δεδομένα στην πηγή δεδομένων.
  • Δοκιμάστε διαφορετικά χρονικά εύρη και sampling διαστήματα, επαληθεύστε ότι τα δεδομένα ταιριάζουν με την πηγή δεδομένων.
  • Δοκιμάστε να εξάγετε δεδομένα κάθε 1 s, που είναι το συντομότερο δυνατό sampδιάστημα ling.
  • Δοκιμάστε διάφορους τύπους tags στην πηγή δεδομένων (μεταβλητές διεργασίας κ.λπ.), φροντίζοντας τα δεδομένα να ταιριάζουν.
  • Σημείωση: Η SIMCA-online μπορεί να χωρίσει ένα μεγάλο αίτημα δεδομένων ιστορικού σε πολλά μικρότερα κομμάτια. Αυτό θα είναι ορατό στο αρχείο καταγραφής SimApi.
• Βεβαιωθείτε ότι το SimApi λειτουργεί με δεδομένα κειμένου, αριθμητικά δεδομένα και δεδομένα που λείπουν.
• Αρχείο καταγραφής SimApi file. Βεβαιωθείτε ότι το αρχείο καταγραφής περιέχει εύλογες καταχωρήσεις.
• Κόμβος παρτίδας: κάντε δεξί κλικ σε έναν κόμβο και κάντε Εύρεση παρτίδων.
  • Επαληθεύστε ονόματα παρτίδων, ώρες έναρξης, ώρες λήξης για παρτίδες.
  • Δοκιμάστε μια ενεργή παρτίδα που εκτελείται στην πηγή δεδομένων. Δεν θα πρέπει να έχει χρόνο λήξης μέσω του SimApi.
• Αναγνωριστικό παρτίδας κόμβου διεργασίας tag. Εάν το SimApi διαθέτει λειτουργία κόμβου παρτίδας (δείτε την προηγούμενη κουκκίδα), πρέπει επίσης να έχει ένα αναγνωριστικό παρτίδας tag στον κόμβο δεδομένων διεργασίας αντιστοίχισης. Δεδομένα για αυτό tag πρέπει να είναι το αναγνωριστικό παρτίδας (όνομα παρτίδας). Αυτά τα δεδομένα απαιτούνται για έργα δέσμης για τον προσδιορισμό σε ποια παρτίδα ανήκει μια σειρά δεδομένων.

Ανάλογα με το αν το SimApi το υποστηρίζει, μπορεί επίσης να θέλετε να δοκιμάσετε:

• Μαζική χρήση δεδομένων File > Απόσπασμα.
• Διακριτά δεδομένα με χρήση File > Απόσπασμα. Σημείωση: για δοκιμή διακριτών δεδομένων με File > Εξαγάγετε τον κόμβο, ο κόμβος παρτίδας και ο διακριτός κόμβος δεδομένων πρέπει να βρίσκονται στο ίδιο SimApi (όταν το SIMCA-online εκτελεί έργα, μπορεί να είναι από διαφορετικά SimApi).
• Γράψτε πίσω – ώθηση δέσμης δεδομένων στην πηγή δεδομένων. Για να το ελέγξετε αυτό, πρέπει να διαμορφώσετε μια διαμόρφωση έργου στο SIMCA-online για την εγγραφή διανυσμάτων δεδομένων στην προέλευση δεδομένων. Στη συνέχεια, εκτελέστε το έργο σε SIMCA-online και ελέγξτε τα δεδομένα που είναι γραμμένα πίσω στην προέλευση δεδομένων.
• Τα συνεχή δεδομένα διαμορφώνονται στη σελίδα Evolution Write Back στη διαμόρφωση του έργου.
• Τα διακριτά δεδομένα διαμορφώνονται στην ίδια σελίδα, αλλά μόνο για μια φάση που έχει διαμορφωθεί για διακριτή ανάκτηση δεδομένων.
• Δεδομένα παρτίδας από το Batch Write back

ΠΕΡΙΣΣΟΤΕΡΕΣ ΠΛΗΡΟΦΟΡΙΕΣ

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Σουηδία
• Τηλέφωνο: + 46 90-18 48 00
• www.sartorius.com
• Οι πληροφορίες και οι αριθμοί που περιέχονται σε αυτές τις οδηγίες αντιστοιχούν στην ημερομηνία έκδοσης που καθορίζεται παρακάτω.
• Η Sartorius διατηρεί το δικαίωμα να κάνει αλλαγές στην τεχνολογία, τα χαρακτηριστικά, τις προδιαγραφές και το σχεδιασμό του εξοπλισμού χωρίς προειδοποίηση. Οι αρσενικοί ή θηλυκοί τύποι χρησιμοποιούνται για τη διευκόλυνση της αναγνωσιμότητας σε αυτές τις οδηγίες και δηλώνουν πάντα ταυτόχρονα όλα τα φύλα.
  Σημείωση πνευματικών δικαιωμάτων:
• Αυτές οι οδηγίες, συμπεριλαμβανομένων όλων των στοιχείων, προστατεύονται από πνευματικά δικαιώματα.
• Οποιαδήποτε χρήση πέραν των ορίων του νόμου περί πνευματικών δικαιωμάτων δεν επιτρέπεται χωρίς την έγκρισή μας.
• Αυτό ισχύει ιδιαίτερα για την επανέκδοση, τη μετάφραση και την επιμέλεια, ανεξάρτητα από τον τύπο του χρησιμοποιούμενου μέσου.

FAQ

• Ε: Ποιος είναι ο σκοπός του SimApis;
  • Α: Ο κύριος σκοπός του SimApis είναι να παρέχει δεδομένα σε προϊόντα Umetrics Suite για τη δημιουργία έργων και τη δημιουργία μοντέλων.
• Ε: Πώς μπορώ να αντιμετωπίσω προβλήματα με την εγκατάσταση του SimApi;
  • Α: Μπορείτε να αντιμετωπίσετε προβλήματα δοκιμάζοντας από το SIMCA-online, ελέγχοντας το αρχείο καταγραφής SimApi file, και διασφάλιση της σωστής διαμόρφωσης λογαριασμού υπηρεσίας.

Έγγραφα / Πόροι

Λογισμικό SARTORIUS Sim Api [pdf] Οδηγός χρήστη Λογισμικό Sim Api, Λογισμικό Api, Λογισμικό

Αναφορές

• Εγχειρίδιο χρήστη