SoftOne-VSCode 0.7.6

Αυτόνομη επέκταση για συγχρονισμό AdvancedJS και Form Scripts μεταξύ VS Code και SoftOne. Το VSIX περιέχει τον client συγχρονισμού και τις εξαρτήσεις του. Εκτελούνται μέσα στο VS Code: δεν απαιτείται εγκατάσταση Node.js, npm ή φάκελος _tools στον υπολογιστή του χρήστη.

Νέα εγκατάσταση / επανεγκατάσταση

Εγκατάστησε VS Code 1.100 ή νεότερο σε Windows.
Άνοιξε το Extensions στο VS Code και αναζήτησε στο Marketplace την επέκταση SoftOne-VSCode, με publisher delbi76 και αναγνωριστικό delbi76.softone-vscode.
Επίλεξε Install και επαναφόρτωσε το VS Code αν ζητηθεί.
Τοποθέτησε το project σε οποιονδήποτε φάκελο. Στη ρίζα του χρειάζεται softone.config.json με τις σωστές ρυθμίσεις σύνδεσης.
Άνοιξε το project ή τον γονικό φάκελο στο VS Code και επίτρεψε Workspace Trust, εφόσον εμπιστεύεσαι τα αρχεία του.
Η βάση εντοπίζεται από τα softone.config.json. Για χειροκίνητη επιλογή: SoftOne: Select Base Folder.
Η επέκταση δημιουργεί στη βάση τον φάκελο _SoftOneBridge και το αρχείο VSCodeBridge.cst, εφόσον το αρχείο λείπει. Στην ειδοποίηση επίλεξε Άνοιγμα φακέλου για να το βρεις.
Αν το VSCodeBridge δεν έχει εγκατασταθεί στο SoftOne, ακολούθησε την ενότητα «Πρώτη εγκατάσταση του Bridge στο SoftOne» παρακάτω. Αν λειτουργεί ήδη, παράλειψε την εισαγωγή CST.

Συνιστάται να διατηρείς ενεργοποιημένη την επιλογή AUTO UPDATE στην επέκταση, ώστε να λαμβάνεις αυτόματα τις νέες εκδόσεις που δημοσιεύονται στο Marketplace.

Πριν από το πρώτο Pull/Push απαιτείται πρόσβαση στο SoftOne endpoint και εγκατεστημένο VSCodeBridge στο SoftOne. Η επέκταση διαθέτει το αρχείο αρχικής εγκατάστασης στον υπολογιστή· η αντιγραφή του αρχείου δεν εγκαθιστά το Bridge στο SoftOne και δεν εκτελεί συγχρονισμό.

Παράδειγμα softone.config.json (αντικατάστησε το URL):

{
  "url": "https://your-endpoint.example/s1services",
  "bridge": "VSCodeBridge",
  "outputFolder": "AdvancedJS"
}

Δομή χρήστη:

Οποιοσδήποτε βασικός φάκελος/
├── _SoftOneBridge/
│   └── VSCodeBridge.cst      αρχείο για πρώτη εισαγωγή στο SoftOne
└── PROJECT/
    ├── softone.config.json
    ├── AdvancedJS/
    ├── OBJECT/_FormScripts/
    └── .softone/             baseline, backups και conflicts

Τα projects, οι ρυθμίσεις, τα backups και το state παραμένουν εκτός της εγκατάστασης της επέκτασης και δεν χάνονται σε αναβάθμισή της.

Πρώτη εγκατάσταση του Bridge στο SoftOne

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

Στο VS Code, βρες το _SoftOneBridge/VSCodeBridge.cst στη βάση εργασίας. Ο φάκελος είναι δίπλα στα projects, όχι μέσα στο AdvancedJS. Αν άνοιξες μόνο έναν φάκελο project στο VS Code, το _SoftOneBridge βρίσκεται στον γονικό του φάκελο και μπορεί να μην εμφανίζεται στον Explorer του VS Code.
Στο SoftOne, συνδέσου στο περιβάλλον που αντιστοιχεί στο URL του project, με χρήστη που έχει δικαίωμα εισαγωγής custom λύσεων.
Από το Custom Administration του SoftOne, επίλεξε το παραπάνω VSCodeBridge.cst και ολοκλήρωσε την εισαγωγή. Κράτησε το όνομα του module VSCodeBridge.
Επέστρεψε στο VS Code και επίλεξε με δεξί κλικ στο project SoftOne: Refresh Endpoint. Η επιτυχία του Refresh αφορά την ανανέωση του endpoint· δεν επιβεβαιώνει από μόνη της τη σωστή εγκατάσταση του Bridge.
Για πρώτο έλεγχο σύνδεσης, σε νέο project χωρίς τοπικές αλλαγές επίλεξε SoftOne: Pull Project. Η εντολή κατεβάζει scripts από το SoftOne στον υπολογιστή. Έλεγξε το αποτέλεσμα στο terminal πριν προχωρήσεις σε Push.

Αν το Bridge υπάρχει ήδη, μην εισάγεις ξανά το CST για να το ενημερώσεις.

Αν δεν εμφανιστεί το CST

Άνοιξε έναν τοπικό φάκελο στο VS Code, επίτρεψε Workspace Trust εφόσον εμπιστεύεσαι τα αρχεία και εκτέλεσε SoftOne: Select Base Folder. Χωρίς επιλεγμένη ή εντοπισμένη βάση δεν δημιουργείται το αρχείο. Αν εμφανιστεί σφάλμα αντιγραφής, έλεγξε τα δικαιώματα εγγραφής και επίλεξε ξανά τη βάση.

Υπάρχον _SoftOneBridge/VSCodeBridge.cst δεν αντικαθίσταται. Η αναβάθμιση της επέκτασης δεν απαιτεί επανεισαγωγή CST στο SoftOne. Το AUTO UPDATE αφορά την επέκταση του VS Code.

Χρήση

Δεξί κλικ στο project: Pull Project, Pull only NEW Scripts, Refresh Endpoint.
Δεξί κλικ σε AdvancedJS/*.js: Pull Module, Push Module, FORCE Pull.
Δεξί κλικ σε φάκελο OBJECT ή _FormScripts: Pull Form Scripts.
Δεξί κλικ σε OBJECT/_FormScripts/<CSTINFO>_<NAME>.js: Pull/Push και FORCE Pull.
Terminal → Run Task: ενσωματωμένα SoftOne: Pull Project και SoftOne: Push Module, με επιλογή project/module.
SoftOne: Refresh Indicators ενημερώνει τις ενδείξεις του Explorer.

Δεν απαιτείται .vscode/tasks.json. Το Config/tasks.json είναι προαιρετικό πρότυπο με tasks τύπου softoneConfig. Παλιά προσωπικά tasks που εκτελούν την εντολή node εξακολουθούν να χρειάζονται Node.js· χρησιμοποίησε τα ενσωματωμένα tasks ή ενημέρωσε το προσωπικό tasks.json.

Η κανονική λήψη διατηρεί τις τοπικές συγκρούσεις. Το FORCE Pull αντικαθιστά το επιλεγμένο αρχείο μετά από επιβεβαίωση. Οι έλεγχοι CP1253/UTF-8, τα backups και η επαλήθευση μετά από Push παραμένουν ενεργά.

Το .softone/workflow.lock εμποδίζει παράλληλο συγχρονισμό του ίδιου project από διαφορετικά παράθυρα ή CLI. Αν κλείσεις το terminal κατά τη διάρκεια αιτήματος, ο τρέχων συγχρονισμός ολοκληρώνεται στο παρασκήνιο ώστε να μη διακοπεί η ακολουθία backup/Push/επαλήθευσης. Περίμενε πριν κλείσεις ή επαναφορτώσεις το VS Code. Μετά από απότομο τερματισμό, αφαίρεσε το lock μόνο αφού βεβαιωθείς ότι δεν εκτελείται άλλο task.

Συντήρηση και διανομή του module SoftOne Bridge

Η επέκταση SoftOne-VSCode διανέμεται και ενημερώνεται μέσω του Visual Studio Code Marketplace.

Το CST αρχικής εγκατάστασης περιλαμβάνεται στην επέκταση και διατίθεται στον φάκελο _SoftOneBridge με τη διαδικασία που περιγράφεται παραπάνω. Για βοήθεια στην εισαγωγή ή για ενημέρωση του module VSCodeBridge στο SoftOne, επικοινώνησε με τον υπεύθυνο στις παρακάτω διευθύνσεις:

SoftOne-VSCode