Controllo di versione con i workspace
In questa pagina
Un workspace di controllo di versione è una cartella su disco, accanto al tuo progetto TIA Portal o in qualsiasi altro punto a tua scelta, che contiene oggetti del progetto come normali file: blocchi, tipi di dati PLC, tabelle delle variabili, oggetti tecnologici e tipi di libreria, un file per oggetto. Poiché la cartella è una cartella normale, puoi versionarla con Git, SVN o qualsiasi altro strumento che usi già. Studio e TIA Portal mantengono allineati il progetto e i file: colleghi gli oggetti ai loro file, scrivi le modifiche del progetto nei file, riporti i file modificati nel progetto e vedi a colpo d'occhio quale lato è cambiato.
I workspace appartengono al progetto. TIA Portal li salva, insieme alle loro cartelle e a ogni collegamento, all'interno del progetto, così li ritrovi alla successiva apertura. Un workspace creato o modificato in un progetto che poi chiudi senza salvare va perso, come qualsiasi altra modifica.
Requisiti
- Una connessione a TIA Portal con un progetto aperto. In un progetto aperto offline i workspace non vengono mostrati.
- TIA Portal V17 o successivo per vedere e gestire workspace e gruppi. La lingua dei file si può scegliere da TIA Portal V18, le impostazioni di importazione della libreria da TIA Portal V20.
- TIA Portal V20 o successivo per collegare oggetti, esportarli, leggere lo stato e sincronizzare. Su V17, V18 e V19 puoi solo gestire i workspace, e lo stato del workspace lo indica.
- Se un'installazione di TIA Portal offra il controllo di versione dipende dalla sua versione e dal suo update. Se non lo offre, il ramo Workspace di controllo versione non compare.
- Vedere i workspace e il loro stato funziona con ogni piano. Creare, modificare ed eliminare workspace, collegare, esportare, importare e scollegare richiedono il piano Pro; senza di esso si apre la finestra di upgrade e nulla viene modificato.
Il ramo dei workspace di controllo di versione
Esplora progetto mostra il ramo del controllo di versione, Workspace di controllo versione, alla fine dell'albero, dopo Libreria di progetto e Global Libraries:
- I gruppi di workspace organizzano i tuoi workspace, ad esempio per linea o per stazione. Un gruppo può contenere workspace e altri gruppi. I gruppi sono elencati prima dei workspace, ciascuno in ordine di nome.
- Le Aree di lavoro mostrano come descrizione la loro cartella radice, oppure Nessuna cartella radice. Passa il mouse su un workspace per vederne la cartella radice, la lingua e, da TIA Portal V20, quanti oggetti vi sono collegati.
- Fai doppio clic su un workspace per aprirne lo Stato del workspace.
Gli oggetti collegati non sono righe dell'albero, perché il loro stato cambia a ogni modifica. Li vedi nello stato del workspace.
Il ramo del controllo di versione viene letto quando ci fai clic o lo espandi, come Hardware, HMI e la Libreria di progetto: fino ad allora la cartella mostra una piccola icona di caricamento. Se vuoi che venga letto appena il progetto si connette, attiva Carica i workspace di controllo versione in Esplora progetto nelle Impostazioni. Aggiorna in Esplora progetto rilegge il ramo insieme al resto dell'albero.
Tutte le voci per i workspace di controllo di versione si trovano nel sottomenu Workspace di controllo versione del menu contestuale.
Creare e gestire i workspace
Nuovo workspace
- Fai clic con il tasto destro su Workspace di controllo versione o su un gruppo e scegli Nuovo workspace.... Su un gruppo, il workspace finisce in quel gruppo; dal riquadro comandi va al livello superiore
- Inserisci il nome. I nomi dei workspace sono univoci in tutto il progetto, anche tra gruppi diversi, e possono avere fino a 128 caratteri senza barra, barra rovesciata o carattere di controllo
- Scegli la cartella radice del workspace. La finestra si apre nella cartella del progetto TIA Portal, come la propone TIA Portal; se scegli la cartella del progetto stessa, Studio usa una sottocartella con il nome del workspace, così i file non finiscono mai accanto al file del progetto. Va bene anche qualsiasi altra cartella esistente
- Da TIA Portal V18, scegli la lingua dei file: Lingua di modifica del progetto, oppure Altra lingua... e inserisci un codice di lingua come
de-DE. La lingua deve essere attiva nel progetto e non può essere cambiata in seguito - Il messaggio conferma il nuovo workspace con la sua cartella radice, e la nuova riga viene selezionata
Da TIA Portal V18 nella cartella radice compare una piccola cartella .vci; TIA Portal vi conserva le impostazioni del workspace. Più workspace possono condividere una stessa cartella radice.
Nuovo gruppo
Fai clic con il tasto destro su Workspace di controllo versione o su un gruppo, scegli Nuovo gruppo... e inserisci il nome. I nomi dei gruppi sono univoci all'interno del gruppo padre.
Rinomina
Rinomina su un gruppo o su un workspace chiede il nuovo nome. Uno stato del workspace aperto segue il workspace al suo nuovo nome.
Elimina
Elimina chiede prima conferma e indica cosa viene rimosso:
- Eliminare un'area di lavoro rimuove il workspace e i collegamenti dei suoi oggetti. Gli oggetti restano nel progetto, e i file e la cartella
.vcirestano nella cartella radice su disco. Conferma con Elimina workspace - Eliminare un gruppo rimuove ogni workspace e ogni gruppo al suo interno, insieme ai loro collegamenti. Gli oggetti restano nel progetto e i file restano su disco. Conferma con Elimina gruppo e workspace
Il messaggio indica quanti collegamenti sono stati rimossi. Uno stato del workspace aperto di un workspace eliminato si chiude.
Imposta cartella radice
Imposta cartella radice... su un workspace sceglie un'altra cartella radice. Se il workspace ha una cartella radice, da TIA Portal V20 puoi anche scegliere Rimuovi cartella radice: il workspace mantiene i suoi collegamenti ma resta senza cartella finché non ne imposti di nuovo una. Collegare ed esportare richiedono una cartella radice.
Impostazioni di importazione della libreria
Da TIA Portal V20, Impostazioni di importazione della libreria... su un workspace stabilisce come i tipi di libreria di quel workspace vengono portati nel progetto:
- Scegli la libreria globale per le importazioni di tipi... sceglie il file della libreria globale in cui finiscono i tipi di libreria importati, e Rimuovi la libreria globale per le importazioni di tipi la cancella di nuovo
- Elimina le versioni di tipo inutilizzate dopo un'importazione oppure Mantieni le versioni di tipo inutilizzate dopo un'importazione decide cosa succede alle versioni di tipo non più usate dopo un'importazione
L'intestazione dello stato del workspace mostra entrambe le impostazioni.
Mostra cartella del workspace
Mostra cartella del workspace apre la cartella radice in Esplora file di Windows. Se apri quella cartella in Studio come cartella tua, il controllo del codice sorgente integrato di Studio prende in carico i file, così puoi farne il commit, confrontarli ed eseguirne il push come qualsiasi altro file; vedi Client Git.
Inserire oggetti in un workspace
Ci sono due modi per portare un oggetto in un workspace. Connetti al workspace... collega gli oggetti a file che esistono già nella cartella, ad esempio dopo aver clonato un repository. Esporta nel workspace... scrive i file dal progetto e li collega in un solo passaggio. Entrambi richiedono TIA Portal V20 o successivo.
Fai clic con il tasto destro su una o più di queste righe, o su una cartella che le contiene, e apri il sottomenu Workspace di controllo versione:
- blocchi (FB, FC, OB, DB, blocchi fail-safe inclusi)
- tipi di dati PLC
- tabelle delle variabili PLC
- oggetti tecnologici
- le cartelle Blocchi di programma, un gruppo di blocchi, Tipi di dati PLC, Variabili PLC e Oggetti tecnologici; una cartella vale per gli oggetti che contiene
I tipi della libreria di progetto si conservano in un workspace tramite l'assistente, vedi Supporto dell'assistente IA.
Esportare nel workspace
- Scegli Esporta nel workspace...
- Scegli il workspace. Se il progetto non ne ha ancora, Studio offre Nuovo workspace...; un workspace senza cartella radice ti chiede prima di impostarne una
- Scegli il formato dei file (vedi sotto)
- Inserisci la cartella sotto la cartella radice che riceve i file, ad esempio
Blocks\Main, oppure lasciala vuota per scrivere nella cartella radice. Una cartella mancante viene creata. Un percorso completo o..non è accettato - Scegli Mantieni la struttura delle cartelle del progetto (l'impostazione predefinita, come in TIA Portal: sotto quella cartella i file finiscono in sottocartelle che rispecchiano i gruppi di blocchi del progetto, ad esempio
Blocks\Functions\fbAgitator.scl) oppure Metti tutti i file in quella cartella - Conferma con Esporta. TIA Portal scrive un file per oggetto e vi collega l'oggetto. Un file con lo stesso nome nella stessa cartella viene sovrascritto
Collegare al workspace
- Scegli Connetti al workspace...
- Scegli il workspace e il formato dei file, come per un'esportazione
- Scegli la cartella che contiene i file. La finestra di selezione si apre nella cartella radice, e la cartella deve essere la cartella radice o trovarsi al suo interno
- Scegli se i file si trovano in sottocartelle che rispecchiano i gruppi di blocchi del progetto (l'impostazione predefinita) oppure tutti in quella cartella
- Ogni oggetto viene collegato al file con il suo nome nella cartella corrispondente. I file devono esistere già; non viene scritto nulla
Formati dei file
Prima della scelta del formato, Studio chiede a TIA Portal quali formati supporta ciascun oggetto. Gli oggetti che TIA Portal non può conservare in un workspace vengono segnalati come non supportati. La scelta offre Formato preferito di ogni oggetto e ogni formato offerto da TIA Portal, ciascuno con il numero di oggetti a cui si applica; gli oggetti che non offrono il formato scelto usano quello preferito.
Blocco SCL
- Formati offerti da TIA Portal
- SCL, SimaticML, SimaticSD
- File
-
.sclo.xml
Blocco LAD o FBD, OB, blocco fail-safe
- Formati offerti da TIA Portal
- SimaticML, SimaticSD
- File
-
.xml
Blocco STL
- Formati offerti da TIA Portal
- AWL, SimaticML
- File
-
.awlo.xml
Blocco dati
- Formati offerti da TIA Portal
- DB, SimaticML, SimaticSD
- File
-
.dbo.xml
Tipo di dati PLC
- Formati offerti da TIA Portal
- UDT, SimaticML, SimaticSD
- File
-
.udto.xml
Tabella delle variabili PLC, oggetto tecnologico
- Formati offerti da TIA Portal
- SimaticML
- File
-
.xml
Formato preferito di ogni oggetto usa SCL dove è offerto, altrimenti SimaticML, altrimenti SimaticSD, altrimenti il primo formato offerto da TIA Portal. Un tipo di libreria viene scritto come tre file: la sua sorgente e due piccoli file di descrizione di cui TIA Portal ha bisogno per rileggerlo.
Il risultato
Un messaggio riassume l'esecuzione, ad esempio 12 oggetti su 14 esportati nel workspace "Station_A"., indica quanti erano già uguali su entrambi i lati e nomina ogni oggetto non elaborato, con il motivo: un oggetto che TIA Portal non può conservare in un workspace, un formato che l'oggetto non offre, un file mancante, un file già collegato, un file di sola lettura, un blocco con protezione know-how oppure, su TIA Portal V21, un oggetto che deve prima essere compilato. Se l'elaborazione di un oggetto non è riuscita, il messaggio è un avviso e offre Apri stato del workspace.
Lo stato del workspace
Apri stato del workspace su un workspace, un doppio clic sulla sua riga o il pulsante nel messaggio di esportazione aprono una scheda per ogni workspace. La scheda mostra lo stato di ogni oggetto collegato.
Intestazione. Il workspace e il suo gruppo, la cartella radice, la lingua dei file e il commento del workspace, se ne ha uno; da TIA Portal V20 anche la libreria globale per le importazioni di tipi e se le versioni di tipo inutilizzate vengono eliminate dopo un'importazione.
Riepilogo. Il numero di oggetti collegati e quanti si trovano in ciascuno stato.
Tabella. Una riga per ogni oggetto collegato con una casella di controllo, l'Oggetto (la sua posizione nel progetto), il File (il suo percorso sotto la cartella radice), il Formato, lo Stato e, in caso di conflitto, i pulsanti Risolvi. Seleziona tutti gli oggetti nell'intestazione della tabella spunta ogni riga.
| Stato | Significato |
|---|---|
| Uguale | L'oggetto nel progetto e il suo file hanno lo stesso contenuto |
| Progetto modificato | L'oggetto è stato modificato nel progetto. Esportalo per scrivere la modifica nel file |
| File modificato | Il file è stato modificato fuori da TIA Portal, ad esempio con un pull da Git. Importalo per portare la modifica nel progetto |
| Entrambi modificati | Sia l'oggetto sia il suo file sono stati modificati. Scegli quale lato prevale; l'altro lato viene sovrascritto |
| File mancante | Il file manca nella cartella del workspace. Esporta l'oggetto per scrivere di nuovo il file |
| Sconosciuto | TIA Portal non è riuscito a determinare lo stato. Aggiorna per leggerlo di nuovo |
La barra degli strumenti offre:
- Aggiorna chiede a TIA Portal lo stato attuale di ogni oggetto collegato
- Esporta selezionati nel workspace scrive nei loro file gli oggetti spuntati che sono cambiati nel progetto o il cui file manca. Le altre righe spuntate vengono escluse
- Importa selezionati dal workspace porta nel progetto i file spuntati che sono cambiati nella cartella. Chiede sempre prima conferma, Importare ... oggetti dal workspace "..." nel progetto?, perché TIA Portal sostituisce ogni oggetto del progetto con il contenuto del suo file. Salva prima il progetto, se vuoi mantenere una via di ritorno. Conferma con Importa
- Scollega rimuove il collegamento degli oggetti spuntati dopo una conferma. Gli oggetti restano nel progetto e i loro file restano nella cartella
TIA Portal legge i file di un workspace così come sono, senza formattarli prima. Se modifichi file SCL di un workspace in Studio, esegui Formatta documento prima di importarli, così arrivano con il layout di TIA Portal e con i valori della sezione Formattazione SCL nelle Impostazioni.
Entrambi modificati. Un oggetto modificato su entrambi i lati non fa mai parte di un'esportazione o importazione della selezione. Decidi invece nella sua riga:
- Mantieni versione del progetto scrive la versione del progetto nel file; le modifiche nel file vanno perse. Conferma con Sovrascrivi file
- Mantieni versione del file importa il file nel progetto; le modifiche fatte nel progetto vanno perse. Conferma con Sovrascrivi oggetto del progetto
Editor aperti. Un blocco, un tipo di dati o una tabella delle variabili aperti in un editor di Studio mentre ne importi il file mostrano subito il contenuto importato. Un editor con modifiche non salvate mantiene il tuo testo; quando lo salvi, Studio ti avvisa che il progetto ha una versione più recente e ti lascia decidere.
Oggetti uguali. Un oggetto uguale su entrambi i lati non può essere sincronizzato; TIA Portal lo rifiuta, e Studio indica che non c'è nulla da sincronizzare.
Salvare un blocco collegato in Studio. Quando apri un blocco collegato da Esplora progetto, lo modifichi e lo salvi, il blocco resta collegato: Studio compila il PLC del blocco salvato, ne mantiene il collegamento e scrive subito la versione salvata nel suo file nella cartella del workspace, così la riga resta Uguale. Un messaggio nomina il file scritto. Se il file non è stato scritto, ad esempio perché è di sola lettura, un avviso ti dice di esportare l'oggetto dallo stato del workspace prima di importare qualsiasi cosa, perché altrimenti il workspace lo mostrerebbe come File modificato.
File di sola lettura. Se il tuo sistema di controllo di versione mantiene i file in sola lettura finché non ne fai il check-out, un'esportazione in un file di questo tipo viene rifiutata. Rendi il file scrivibile, ad esempio facendone il check-out, e riprova.
Dopo ogni azione, il piè di pagina mostra l'operazione in corso, un messaggio riassume il risultato e nomina ogni oggetto non elaborato, e la vista rilegge lo stato. Quando i file nella cartella cambiano mentre la scheda è aperta, ad esempio dopo un pull, compare il banner I file nella cartella del workspace sono cambiati. Fai clic su Aggiorna per leggere lo stato attuale.; la vista non interroga mai TIA Portal di sua iniziativa.
Quando non è ancora collegato alcun oggetto, la vista ti dice di usare Connetti al workspace o Esporta nel workspace in Esplora progetto.
Un flusso di lavoro tipico con Git
- Crea un workspace la cui cartella radice è la cartella del tuo repository, o una cartella al suo interno
- Seleziona la cartella Blocchi di programma e la cartella Tipi di dati PLC ed esegui Esporta nel workspace...
- Fai il commit dei file con Git, nel controllo del codice sorgente di Studio o in qualsiasi altro client
- Dopo un pull, apri lo Stato del workspace: gli oggetti i cui file sono arrivati modificati mostrano File modificato. Spuntali ed esegui Importa selezionati dal workspace
- Dopo aver lavorato in TIA Portal, gli oggetti modificati mostrano Progetto modificato. Esportali e fai di nuovo il commit
Cosa fa TIA Portal
- TIA Portal scrive un file per oggetto, con il nome dell'oggetto, e da TIA Portal V18 una cartella
.vcicon le impostazioni del workspace nella cartella radice - Un'esportazione su un file con lo stesso nome non ancora collegato sovrascrive quel file senza chiedere; la conferma di Studio lo indica prima che tu inizi
- Entrambe le direzioni sovrascrivono l'altro lato: un'esportazione sostituisce il file, un'importazione sostituisce l'oggetto nel progetto. Studio chiede conferma prima di ogni importazione e prima di risolvere un conflitto
- Un oggetto uguale su entrambi i lati non può essere sincronizzato
- Eliminare un workspace o un gruppo, o scollegare oggetti, non elimina mai file e non modifica mai gli oggetti nel progetto
- I workspace vengono salvati con il progetto
Limitazioni note
- Collegare, esportare, lo stato e la sincronizzazione richiedono TIA Portal V20 o successivo. Da V17 a V19 i workspace possono solo essere gestiti
- Il contenuto delle Software Unit non è coperto: blocchi, tipi di dati PLC e tabelle delle variabili all'interno di una Software Unit non possono essere collegati o esportati da Studio, e un oggetto di una Software Unit collegato in TIA Portal stesso compare nello stato del workspace senza il suo tipo
- TIA Portal offre il formato SimaticML per gli oggetti tecnologici, ma può rifiutare di esportarne uno; il messaggio nomina l'oggetto e il motivo indicato da TIA Portal
- Su TIA Portal V21 un oggetto non compilato non può essere esportato; compilalo nel progetto e riprova
- L'importazione di un file di tipo di libreria modificato non è offerta su TIA Portal V20, perché chiuderebbe TIA Portal. Importalo con TIA Portal V21 o successivo. L'esportazione dei tipi di libreria funziona su entrambi
- La lingua di un workspace si sceglie una volta sola, alla sua creazione
- La disponibilità dell'interfaccia di controllo di versione dipende dalla versione e dall'update di TIA Portal installati
Supporto dell'assistente IA
L'assistente raggiunge i workspace di controllo di versione tramite lo strumento Gestisci i workspace di controllo versione TIA. Elenca i gruppi e i workspace, legge lo stato di un workspace e i formati dei file degli oggetti, crea, modifica ed elimina workspace e gruppi (un nuovo workspace può trovarsi nella cartella del progetto TIA Portal connesso, nella tua cartella Documenti o Desktop, nella cartella di esportazione o in una cartella aperta), collega oggetti a file esistenti, esporta oggetti in un workspace (puoi indicare un'intera cartella di Esplora progetto, come Blocchi di programma o un gruppo di blocchi, e i file mantengono la struttura delle cartelle del progetto, a meno che tu non chieda una cartella piatta; una cartella radice che non esiste ancora viene creata dopo la tua approvazione), li scollega e sincronizza nella direzione che chiedi. Ad esempio: "Quali workspace ha il progetto?", "Esporta tutti i blocchi di PLC1 nel workspace StationA, cartella Blocks" oppure "Porta nel progetto i file modificati di Station_A".
Elencare e leggere lo stato non modificano nulla e avvengono senza chiedere. Prima di ogni altra azione l'assistente ti mostra una scheda con ciò che farà, e la esegue solo dopo la tua approvazione: la scheda di un'importazione indica che TIA Portal sostituisce gli oggetti nel progetto, la scheda di un'esportazione che il contenuto precedente di ogni file va perso a meno che il tuo sistema di controllo di versione non lo conservi, e la scheda di un'eliminazione cosa viene rimosso e che i file restano. Un oggetto modificato su entrambi i lati viene toccato solo se lo nomini e dici quale lato prevale. Al termine l'assistente segnala ogni oggetto non elaborato, con il motivo. Lo strumento richiede il piano Pro. Per sapere come la chat IA raggiunge gli strumenti, vedi Integrazione IA.