Το ETS μπορεί να ξεκινήσει με επιπλέον ορίσματα γραμμής εντολών. Με αυτές τις εντολές, ένας χρήστης μπορεί να καθορίσει ενέργειες που θα εκτελεστούν μετά την εκκίνηση του ETS.
Υποστηριζόμενες ενέργειες
Υποστηρίζονται οι ακόλουθες ενέργειες:
Οι παράμετροι γραμμής εντολών κάνουν διάκριση μεταξύ πεζών και κεφαλαίων!
- Ανοίξτε ένα έργο
- Δημιουργήστε ένα έργο
- Διαγράψτε ένα έργο
- Ελέγξτε ένα έργο
- Εισαγάγετε ένα σχέδιο
- Εγκατάσταση μιας ETS Εφαρμογής
- Άνοιγμα μιας ETS Εφαρμογής
- Ξεκινήσετε την παρακολούθηση Ομάδων
- Ξεκινήσετε την παρακολούθηση Bus
- Εκκίνηση του οδηγού δημιουργίας έργου
- Έξοδος ETS
- Βοήθεια
- Έκδοση
Ανοίξτε ένα έργο
--openProject "όνομα έργου"
ή
-o "όνομα έργου"
- Ανοίγει ένα υπάρχον έργο αμέσως μετά την εκκίνηση του ETS.
- Το "όνομα του έργου" θα είναι το πραγματικό όνομα του έργου
- Εάν το έργο απαιτεί έναν κωδικό πρόσβασης, τότε εμφανίζεται το παράθυρο διαλόγου 'Εισαγωγή κωδικού'.
- Μπορεί να συνδυαστεί με την παράμετρο --password για να ανοίξει ένα έργο που προστατεύεται με κωδικό πρόσβασης. Εάν ο κωδικός του έργου είναι εσφαλμένος, τότε εμφανίζεται το παράθυρο διαλόγου 'Εισαγωγή κωδικού' για να εισάγετε τον σωστό κωδικό πρόσβασης.
Παράδειγμα
--openProject "My Home project" --password "Password123@#"
ή
-o "My Home project" --password "Password123@#"
Δημιουργήστε ένα έργο
--createProject "όνομα του έργου" ή -c "όνομα του έργου"
- Δημιουργεί ένα νέο έργο (ίδια λειτουργία με το παράθυρο δημιουργίας τυποποιημένου έργου), με τις ακόλουθες προεπιλεγμένες ρυθμίσεις:
- Μέσο Κεντρικής Γραμμής: IP
- Τοπολογία: Δημιουργία Γραμμής 1.1 με τύπο μέσου TP
- Στυλ Διευθύνσεων Ομάδων: Τρία επίπεδα
- Μπορεί να συνδυαστεί με την παράμετρο --password για να δημιουργήσει ένα έργο που προστατεύεται με κωδικό πρόσβασης.
Παράδειγμα
--createProject "My Home project" --password "Password123@#"
ή
-c "My Home project" --password "Password123@#"
Διαγράψτε ένα έργο
--deleteProject "όνομα του έργου" ή -d "όνομα του έργου"
Διαγράφει ένα υπάρχον έργο από το χώρο αποθήκευσης έργων. Οι τιμές του κωδικού εξόδου δείχνουν τα ακόλουθα:
- Επιτυχής διαγραφή: επιστρεφόμενη τιμή = 0
- Ανεπιτυχής διαγραφή: επιστρεφόμενη τιμή = -2
Παράδειγμα
--deleteProject "My Home project"
ή
-d "My Home project"
Ελέγξτε αν υπάρχει ένα έργο
--existsProject"όνομα του έργου" ή -e "όνομα του έργου"
- Ελέγχει αν υπάρχει ένα έργο με το καθορισμένο όνομα στο χώρο αποθήκευσης έργων
- Οι τιμές του κωδικού εξόδου δείχνουν τα ακόλουθα:
- Το έργο υπάρχει: επιστρεφόμενη τιμή = 1
- Το έργο δεν υπάρχει: επιστρεφόμενη τιμή = 0
- Μετά από αυτό το ETS κλείνει αυτόματα, δηλαδή δεν χρειάζεται να προσθέσετε την παράμετρο --quit.
Παράδειγμα
--existsProject "My Home project"
ή
-e "My Home project"
Εισαγάγετε ένα σχέδιο
--importProject "διαδρομή αποθήκευσης αρχείου έργου" ή -i "διαδρομή αποθήκευσης αρχείου έργου"
- Εισάγει ένα συγκεκριμένο αρχείο έργου (είτε σε μορφή "knxproj" είτε "pr") στην αποθήκευση έργων.
- Εισάγοντας ένα έργο που προστατεύεται με κωδικό πρόσβασης, τότε εμφανίζεται το παράθυρο διαλόγου «Εισάγετε τον κωδικό πρόσβασης» προκειμένου να εισαχθεί χειροκίνητα.
Παράδειγμα
--importProject "C:\MyProjects\MyHomeproject.knxproj"
ή
-i "C:\MyProjects\MyHomeproject.knxproj"
Εγκατάσταση μιας ETS Εφαρμογής
--installApp "διαδρομή αποθήκευσης αρχείου εφαρμογής" ή -a "διαδρομή αποθήκευσης αρχείου εφαρμογής"
- Εγκαθιστά μία ETS Εφαρμογή που εκπροσωπείται από το καθορισμένο αρχείο *.etsapp.
Παράδειγμα
--installApp "C:\MyProjects\MyApp.etsapp"
ή
-ένα "C:\MyProjects\MyApp.etsapp"
Άνοιγμα μιας ETS Εφαρμογής
--openApp "AppId"
- Ανοίγει μια ETS Εφαρμογή με ένα ειδικό Αναγνωριστικό εφαρμογής μέσα σε ένα έργο και επομένως απαιτεί επίσης να καθοριστεί ένα υπάρχον έργο μέσω της εντολής --openProject.
- Ο προηγούμενος χώρος εργασίας του έργου θα απορριφθεί και θα δημιουργηθεί ένας νέος χώρος εργασίας που θα περιέχει μόνο ένα παράθυρο, καρτέλα και πάνελ και το πάνελ θα περιέχει την απαιτούμενη Εφαρμογή.
- Οι τιμές του κωδικού εξόδου δείχνουν τα ακόλουθα:
- «40» όταν δεν έχει οριστεί το AppId
- «41» όταν το δοσμένο AppId δεν είναι έγκυρο
- «42» όταν δεν μπορεί να βρεθεί ETS Εφαρμογή με το δοσμένο AppId
- «43» όταν η ζητούμενη ETS Εφαρμογή απαιτεί εγγενή λειτουργία, αλλά το ETS λειτουργεί σε λειτουργία συμβατότητας
- «44» όταν η ζητούμενη ETS Εφαρμογή απαιτεί λειτουργία συμβατότητας, αλλά το ETS τρέχει σε εγγενή λειτουργία
- «45» όταν η ζητούμενη ETS Εφαρμογή δεν μπορεί να ξεκινήσει
- «46» όταν η ζητούμενη ETS Εφαρμογή δεν είναι αδειοδοτημένη
Παράδειγμα
--openProject "όνομα του έργου" --OpenApp "M00FA-A0005"
Ξεκινήσετε την παρακολούθηση Ομάδων
--groupmon "όνομα του έργου" ή -g "όνομα του έργου"
-
Αυτή η εντολή ξεκινά την παρακολούθηση ομάδων σε ένα δοσμένο έργο.
Παράδειγμα
--groupmon "My Home project"
ή
-g "My Home project"
Ξεκινήσετε την παρακολούθηση Bus
--busmon "όνομα του έργου" ή -b "όνομα του έργου"
-
Αυτή η εντολή ξεκινά την παρακολούθηση bus σε ένα δοσμένο έργο.
Παράδειγμα
--busmon "My Home project"
ή
-b "My Home project"
Εκκίνηση του οδηγού δημιουργίας έργου
--wizard ή -w
-
Αυτή η εντολή ξεκινά τον οδηγό δημιουργίας έργου.
Έξοδος ETS
--quit ή -q
- Κλείνει το ETS μετά την εκτέλεση όλων των άλλων ορισμάτων της γραμμής εντολών.
- Ωστόσο, το ETS δεν θα κλείσει παρά τη δοσμένη παράμετρο --quit αν τουλάχιστον μία από τις άλλες παραμέτρους γραμμής εντολών προκάλεσε σφάλμα που οδήγησε σε παράθυρο διαλόγου σφάλματος/προειδοποίησης του ETS.
Βοήθεια
--help
-
Αυτή η εντολή εμφανίζει τη βοήθεια στην κονσόλα.
Έκδοση
--version
-
Αυτή η εντολή εμφανίζει την τρέχουσα έκδοση ETS στην κονσόλα.
Συνδυασμός ορισμάτων γραμμών-εντολών
Οι μόνοι δυνατοί συνδυασμοί των παραμέτρων γραμμής εντολών είναι
- --openProject και --importProject
- Το --password μπορεί να συνδυαστεί με το --openProject και το --createProject
- Το --quit μπορεί να χρησιμοποιηθεί μαζί με μια άλλη παράμετρο
- Το -openApp απαιτεί πάντα το --openProject (και ένα -- password αν είναι απαραίτητο)
Μόλις ξεκινήσει η διαδικασία ETS6, οι μόνες αποδεκτές εντολές είναι: --createProject, --wizard και -importProject - είναι απαραίτητες για τις εντολές ETS στη γραμμή εργασιών των Windows.
Το OpenProject θα χρησιμοποιήσει το πιο πρόσφατο ενεργό παράθυρο ETS6 και θα ανοίξει - αν χρειαστεί - μια νέα καρτέλα ταμπλό. Οποιαδήποτε άλλη εντολή δόθηκε μετά την εκκίνηση του ETS6, δεν θα προωθηθεί, αλλά μόνο θα φέρει το ETS6 μπροστά από άλλες εφαρμογές.
Χειρισμός σφαλμάτων
Σε περίπτωση σφαλμάτων ή λανθασμένων εντολών, το ETS θα καταγράψει τα μηνύματα στο αρχείο καταγραφής ETS που βρίσκεται στο αρχείο καταγραφής %LOCALAPPDATA%\Knx\ETS6\Log\ETS6.log
Επιστρεφόμενοι Κωδικοί
Για μερικές παραμέτρους γραμμής εντολών (π.χ. --existsProject), το ETS επιστρέφει έναν κωδικό εξόδου. Οι κωδικοί εξόδου δεν εκτυπώνονται στην κονσόλα, αλλά η μεταβλητή «errorlevel»λαμβάνει την τιμή του κωδικού εξόδου.
Για την αξιολόγηση του κωδικού εξόδου, ένα batch script μπορεί να χρησιμοποιήσει την κατασκευήIF ERRORLEVELή να χρησιμοποιήσει μεταβλητή επέκταση όπως στοecho %errorlevel%. Όταν το ETS καλείται απευθείας από τη γραμμή εντολών (και όχι από ένα .bat ή ένα script .cmd), τότε πρέπει να επικληθεί είτε μεcmd /c ETS6.exe ...ήstart /wait ETS6.exe ...
Κοινοί επιστρεφόμενοι κωδικοί
Οι κοινοί επιστρεφόμενοι κωδικοί είναι κωδικοί που μπορούν να οριστούν σε οποιαδήποτε εντολή:
- -1 εάν η σύνταξη/επιλογές παραμέτρου δεν είναι σωστές
- -2 εάν η λειτουργία απέτυχε, π.χ. το έργο δεν ήταν δυνατό να ανοιχθεί, να διαγραφεί, να εισαχθεί ή να δημιουργηθεί λόγω σφάλματος (αλλά οι συγκεκριμένοι κωδικοί επιστροφής εντολών δεν μπορούν να εφαρμοστούν)