Informazioni su come gestire gli oggetti con controllo della versione utilizzando vari metodi.
Gestione di oggetti con controllo della versione nel metodo di blocco
Queste procedure si applicano agli oggetti con controllo della versione nel metodo di blocco.
Se si utilizza il metodo di blocco, i seguenti oggetti sono con controllo della versione: GeoEsplora, reti, oggetti domanda alternativa, controlli, configurazioni dati live, template di digitalizzazione e modelli base.
- Prima di poter modificare un oggetto con controllo della versione, è necessario estrarlo (gli oggetti appena creati vengono estratti automaticamente).
- L'oggetto estratto non può essere modificato da nessun altro utente.
- Una volta terminato di utilizzare l'oggetto, è necessario archiviarlo (o annullare l'estrazione).
Estrazione di oggetti
Per modificare un oggetto con controllo della versione esistente, è necessario estrarlo.
Come estrarre un oggetto con controllo della versione
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto.
- Selezionare Estrai nel menu.
Viene suggerito un nome del nuovo oggetto, che può essere modificato se richiesto.
- Per estrarre l'oggetto, fare clic su OK.
Viene creata una nuova versione dell'oggetto, annidata sotto l'oggetto estratto.
L'oggetto estratto viene visualizzato con un bordo rosso spesso intorno alla relativa icona.
È ora possibile aprire e apportare modifiche all'oggetto estratto. Quando si è terminato di apportare le modifiche, è necessario archiviare nuovamente la nuova versione, in modo che possa essere utilizzato da altre persone.
Oggetti Ramo
Per creare una versione alternativa di un oggetto con controllo della versione, è necessario generare un ramo.
Come ramificare un oggetto con controllo della versione
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto da ramificare.
- Selezionare Estrai e ramo nel menu.
Viene suggerito un nome del nuovo oggetto, che può essere modificato se richiesto.
- Per estrarre l'oggetto e creare un ramo, fare clic su OK.
È ora possibile modificare l'oggetto con controllo della versione per creare il nuovo ramo. Dopo aver apportato le modifiche, archiviare nuovamente il nuovo ramo.
Il nome di default di un nuovo ramo è costituito dal nome della versione da cui è stato ramificato, seguito da un carattere di sottolineatura e dal numero del ramo. Ad esempio, alla prima ramificazione di un oggetto denominato Wallingford#4 viene assegnato il nome di default Wallingford#4_1.
Confronto di oggetti
È possibile confrontare due oggetti con controllo della versione per identificare le parti degli oggetti che sono diverse. I risultati possono essere visualizzati sullo schermo o salvati in un file CSV o di testo.
Se si utilizza un database Oracle, è anche possibile produrre un rapporto delle differenze tra le versioni di rete archiviate di un singolo asset. Per ulteriori informazioni, vedere Visualizzazione della cronologia di un asset.
Confronto tra due oggetti
- Visualizzare la finestra di dialogo Selezione confronto rete:
- Fare clic con il pulsante destro del mouse su un oggetto con controllo della versione nella finestra Esplora risorse o Gruppo di modelli e scegliere Confronta nel menu a comparsa. Viene visualizzata la finestra di dialogo Selezione confronto rete con il campo Confronta questo compilato con l'oggetto di rete su cui si è fatto clic.
- In alternativa, selezionare i due oggetti da confrontare nella finestra Gruppo di modelli o Esplora risorse e selezionare Confronta nel menu a comparsa. Viene visualizzata la finestra di dialogo Selezione confronto rete con i campi Confronta questo e Con compilati con gli oggetti selezionati.
- Se la casella Con non è già compilata, selezionare l'oggetto con controllo della versione da confrontare oppure selezionare la casella Sorgente per compilare automaticamente la casella Con con l'elemento principale dell'oggetto da confrontare.
- Facoltativamente, includere un elenco di selezione per limitare il confronto ad una selezione di oggetti nell'oggetto da confrontare. Questa opzione non si applica al modello base.
- Selezionare le opzioni in base alle esigenze:
- Ignora modifiche apportate ai flag: consente di omettere le differenze tra i flag nel rapporto di confronto.
- Seleziona oggetti modificati: se la rete da confrontare è aperta, tutti gli oggetti modificati vengono evidenziati nella finestra Planimetria.
- Ignora modifiche dovute a valori di default: consente di omettere le differenze tra i campi contrassegnati #D nel rapporto di confronto.
- Confronto basato sul codice ID: consente di confrontare le reti confrontando oggetti o gruppi di oggetti con lo stesso codice ID. Questa opzione è disponibile solo quando si confrontano reti.
- Selezionare la destinazione del rapporto di confronto:
- Schermo: il rapporto viene visualizzato in una vista generale del file di testo. Il rapporto può quindi essere stampato, salvato su file oppure i dati possono essere copiati negli Appunti.
- File: il rapporto viene salvato in un file. Assegnare il nome e la posizione del file nella casella di immissione adiacente.
- File CSV: viene creato un file CSV contenente tutti i dati del primo elemento che sono diversi da quelli del secondo elemento. Assegnare il nome e la posizione del file CSV nella casella di input adiacente.
- Per completare l'operazione, fare clic sul pulsante Confronta. La finestra di dialogo rimane visibile per consentire di impostare un altro confronto, se necessario.
Confrontare una rete aperta con molte altre reti
Una rete attualmente aperta può essere confrontata con più reti. Se sono presenti altri oggetti con controllo della versione attualmente associati alla rete, anche questi oggetti possono essere inclusi per il confronto.
Per effettuare un confronto con più oggetti, è necessario richiamare la finestra di dialogo Selezione confronto rete tramite il menu Rete.
- Selezionare Confronta nel menu Rete. Viene visualizzata la finestra di dialogo Selezione confronto rete.
- Trascinare una o più reti nella casella Con della finestra di dialogo Selezione confronto reti.
- Trascinare gli oggetti con controllo della versione associati nella casella Con. È possibile includere solo tipi di oggetto validi.
Ogni confronto genera un rapporto separato. I rapporti non possono essere inviati ad un file CSV quando si confrontano gli oggetti tramite il menu Rete.
Utilizzo di un file CSV per applicare le modifiche ad altri oggetti
Poiché il formato di un file CSV generato da un confronto è corretto, può essere utilizzato per applicare le stesse modifiche ad altri oggetti con controllo della versione.
- Fare clic con il pulsante destro del mouse su un oggetto con controllo della versione estratto nella finestra Gruppo di modelli e scegliere Aggiorna
Da CSV. Viene visualizzata la finestra di dialogo Importa/aggiorna dati CSV.
- Seguire la procedura descritta in Aggiornamento da dati CSV, ricordandosi di impostare le seguenti opzioni:
- Il Tipo di aggiornamento deve essere Misto (in base al campo dati). Questa opzione utilizza il campo Azione, necessario per eliminare gli oggetti.
- Assicurarsi che la casella Consenti ai campi vuoti in CSV di sovrascrivere i dati esistenti sia deselezionata. Gli eventuali campi che non sono stati modificati tra le varie versioni vengono lasciati vuoti nel file CSV.
- Per completare il processo, fare clic su OK.
I dati del file CSV sovrascrivono i dati della rete. Tutti gli oggetti contrassegnati per l'eliminazione verranno eliminati.
Oggetti duplicati
È possibile creare un duplicato di un oggetto con controllo della versione in un gruppo di modelli selezionato nel database.
I duplicati possono essere utilizzati per creare un punto iniziale per varie opzioni di analisi.
Come duplicare un oggetto con controllo della versione
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto archiviato da duplicare.
- Selezionare Duplica nel menu.
- Selezionare il gruppo di modelli in cui creare il duplicato e fare clic su OK. Nella finestra di dialogo Nuovo nome, viene proposto un nome del nuovo oggetto. È possibile modificare il nome qui se necessario.
- Per creare l'oggetto duplicato, fare clic su OK.
L'oggetto duplicato viene creato nel gruppo di modelli selezionato. Come l'oggetto originale, il duplicato è con metodo di blocco del controllo della versione.
Il nome di default dell'oggetto duplicato è quello dell'oggetto originale seguito da ' - Copia'. Se l'oggetto originale viene nuovamente duplicato, il nome del duplicato sarà seguito da ' - Copia (2)' e così via.
L'icona del nuovo oggetto è di colore blu.
Combinare oggetti
Due oggetti con controllo della versione possono essere combinati per formare un nuovo oggetto con controllo della versione contenente tutti i dati dei due oggetti originali. Il nuovo oggetto con controllo della versione sarà una nuova versione del primo oggetto selezionato o un ramo di tale oggetto.
Come combinare due oggetti con controllo della versione
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto con controllo della versione da cui creare la nuova versione o il nuovo ramo. L'oggetto deve essere archiviato.
- Se l'oggetto combinato deve essere una nuova versione del primo oggetto, selezionare Combina nel menu a comparsa oppure, se l'oggetto combinato deve essere un nuovo ramo, selezionare Combina e ramo.
- Individuare e selezionare l'oggetto da combinare con il primo oggetto e fare clic su OK. Sarà possibile scegliere solo un oggetto con controllo della versione del tipo corretto.
Viene suggerito un nome per l'oggetto, che può essere modificato.
- Per creare l'oggetto combinato, fare clic su OK.
Archiviazione di oggetti
Quando si estrae un oggetto con controllo della versione, non può essere modificato da nessun altro utente. Pertanto, una volta terminata la modifica di un oggetto o la creazione di un nuovo ramo, è necessario archiviarlo il prima possibile.
Come archiviare un oggetto con controllo della versione
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto da archiviare.
- Selezionare Archivia nel menu.
Se il tipo dell'oggetto consente la convalida o se questa operazione non è ancora stata eseguita, verrà visualizzato un messaggio di richiesta in InfoWorks WS Pro.
- Per convalidare l'oggetto, fare clic su Sì oppure, per archiviare l'oggetto senza convalida, fare clic su No.
Dopo la convalida, si verrà avvisati se sono stati riscontrati errori.
- Per verificare l'oggetto, fare clic su Sì oppure, per indagare o correggere gli errori, fare clic su No.
Viene visualizzata la finestra di dialogo Controlla nei commenti contenente gli eventuali commenti aggiunti alla pagina Descrizione della finestra di dialogo Proprietà dell'oggetto.
- Nella finestra di dialogo Controlla nei commenti, modificare i commenti, se necessario, quindi, per archiviare l'oggetto, fare clic su OK (oppure, fare clic su Annulla per interrompere l'archiviazione e continuare la modifica).
Se nelle simulazioni sono state utilizzate versioni provvisorie dell'oggetto estratto, viene visualizzata la finestra di dialogo Conserva versioni provvisorie.
- Selezionare le simulazione per le quali archiviare le versioni provvisorie e fare clic su OK.
Quando la nuova versione o il nuovo ramo sono stati registrati, saranno disponibili per la modifica da parte di altri utenti.
Annullamento delle estrazioni
È possibile annullare un'estrazione se non sono state apportate modifiche all'oggetto con controllo della versione o se non è richiesto il salvataggio delle modifiche.
Come annullare un'estrazione
- Se l'oggetto estratto è aperto nell'area di lavoro, chiuderlo.
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto estratto.
- Selezionare Annulla estrazione nel menu.
Viene visualizzato un messaggio di avvertimento.
- Per confermare l'annullamento dell'estrazione, fare clic su Sì.
La versione o il ramo che si stavano creando non verranno salvati nel database.
Annullamento archiviazioni
È possibile annullare l'archiviazione di un oggetto con controllo della versione, ripristinando lo stato estratto dell'oggetto.
L'opzione Annulla archiviazione sarà disponibile per un oggetto archiviato in precedenza, se è l'ultimo oggetto in un ramo e non viene utilizzato come riferimento da un altro oggetto (ad esempio, una simulazione).
Come annullare un'archiviazione
- Se l'oggetto archiviato è aperto nell'area di lavoro, chiuderlo.
- Nella finestra Esplora risorse o Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto archiviato.
- Selezionare Annulla archiviazione nel menu.
Se non è possibile annullare l'archiviazione, viene visualizzato un messaggio di avvertimento.
Gestione degli oggetti con controllo della versione con il metodo di unione
Queste procedure si applicano agli oggetti con controllo della versione nel metodo di unione.
Se si utilizza il metodo di unione, i seguenti oggetto sono con controllo della versione: GeoEsplora, reti, oggetti domanda alternativa, controlli, configurazioni dati live, modelli base, configurazione DemandWatch e template di digitalizzazione.
- È importante ricevere le modifiche degli altri utenti prima di apportare le proprie.
- Si esegue il commit delle modifiche nel database in modo che siano visibili agli altri utenti.
- Si risolvono eventuali conflitti tra i dati di cui si è eseguito il commit e quelli di cui hanno eseguito il commit altri utenti.
Ottenere le modifiche da altri utenti
È importante ricevere regolarmente le modifiche degli altri utenti per ridurre al minimo la possibilità che vengano apportate modifiche in conflitto agli stessi dati. Quando si ricevono modifiche di altri utenti, possono verificarsi conflitti che devono essere risolti. Non è possibile eseguire il commit delle modifiche finché i conflitti non sono stati risolti.
Come aggiornare un elemento con controllo della versione con le modifiche di altri utenti
- Fare clic con il pulsante destro del mouse sull'elemento del database nella finestra Gruppo di modelli e scegliere Aggiorna (ottieni modifiche apportate da altri utenti).
Se sono state apportate modifiche in conflitto con quelle apportate da un altro utente, tali conflitti devono essere risolti. In caso di conflitti, viene visualizzata la finestra di dialogo Risolvi conflitti di aggiornamento. Per ulteriori informazioni, vedere Risoluzione dei conflitti.
Esecuzione del commit delle modifiche
Quando si apportano modifiche ad un elemento del database con controllo della versione, tali modifiche vengono memorizzate nella propria copia locale della rete (nella cartella di lavoro locale). Per rendere queste modifiche disponibili agli altri utenti, è necessario eseguire il commit nel database.
Come eseguire il commit delle modifiche
- Fare clic con il pulsante destro del mouse sull'elemento del database nella finestra Gruppo di modelli e scegliere Commit delle modifiche nel database.
Viene visualizzata la finestra di dialogo Commit della modifica sul server. In questa finestra di dialogo è possibile:
- Visualizzare un riepilogo delle modifiche, delle aggiunte e delle eliminazioni effettuate.
- Aggiungere un commento che sarà disponibile per gli altri utenti quando esaminano la cronologia dell'elemento di controllo della versione.
- Confrontare la versione corrente dell'elemento del database con la versione più recente nel database o con un elemento completamente separato dello stesso tipo. Per eseguire questa operazione, fare clic sul pulsante Diff.
- Per eseguire il commit delle modifiche, fare clic su OK (oppure, per interrompere l'operazione di commit e chiudere la finestra di dialogo Commit della modifica sul server, fare clic su Annulla).
La copia locale dell'elemento del database verrà aggiornata con le modifiche apportate da altri utenti e le modifiche personali verranno copiate nel database, a meno che non vi siano conflitti con le modifiche apportate da un altro utente. In caso di conflitti, viene visualizzata la finestra di dialogo Risolvi conflitti di aggiornamento. Per ulteriori informazioni, vedere Risoluzione dei conflitti.
Annullamento delle proprie modifiche
È possibile eliminare tutte le modifiche apportate ad un elemento con controllo della versione dall'ultima volta che è stato eseguito il commit delle modifiche al database.
Per annullare la singola modifica più recente, utilizzare l'opzione Annulla nel menu Modifica.
Come ignorare tutte le modifiche apportate dall'ultima volta che è stato eseguito il commit delle modifiche
- Fare clic con il pulsante destro del mouse sull'elemento del database nella finestra Gruppo di modelli e scegliere Annulla modifiche.
Viene visualizzata una finestra di avvertimento.
- Per ripristinare tutte le modifiche dall'ultimo commit, fare clic su OK.
Risoluzione dei conflitti
Se si verificano conflitti quando si ottengono le modifiche di altri utenti, il database locale verrà aggiornato e verrà visualizzato un messaggio che mostra il numero di oggetti con conflitti.
- Fare clic su OK per visualizzare la finestra di dialogo Risolvi conflitti di aggiornamento.
In questa finestra di dialogo vengono visualizzati i conflitti per un oggetto. È possibile scorrere l'elenco degli oggetti con conflitti e risolvere i conflitti per ciascun oggetto. L'oggetto che si sta risolvendo viene evidenziato nelle finestre griglia e sulla Planimetria.
I pulsanti nella parte superiore della finestra di dialogo consentono di lavorare con tutti gli oggetti in conflitto.
Tutte le informazioni sotto la riga rappresentano i conflitti nell'oggetto corrente.
- Quando si è sicuri che le selezioni effettuate risolvono tutti i conflitti per l'oggetto corrente, fare clic sul pulsante Risolvi conflitto. In questo modo si applicano i valori scelti, si contrassegna l'oggetto come risolto e si passa automaticamente all'oggetto successivo con conflitti.
- Dopo che tutti i conflitti in sospeso sono stati risolti, fare clic sul pulsante Commit.
Verrà visualizzata la finestra di dialogo Commit delle modifiche in cui è possibile eseguire il commit delle modifiche.
Visualizzazione della cronologia commit
Ogni volta che si esegue il commit delle modifiche al database, le modifiche apportate vengono registrate in modo permanente. Poiché non vengono sovrascritte quando viene apportata la serie successiva di modifiche, l'intera cronologia di un elemento con controllo della versione è disponibile per la revisione.
Come visualizzare la cronologia commit di un elemento con controllo della versione
- Fare clic con il pulsante destro del mouse sull'elemento del database nella finestra Gruppo di modelli e scegliere Mostra cronologia commit.
Viene visualizzata la finestra di dialogo Cronologia commit. Mentre si esegue il download della cronologia dal database in InfoWorks WS Pro potrebbero verificarsi dei ritardi nella visualizzazione della finestra.
Nella finestra di dialogo è possibile:- Visualizzare i dettagli di ogni commit precedente, ad esempio l'ID utente, il numero di oggetti modificati e tutti i commenti aggiunti.
- Visualizzare le differenze tra le due versioni utilizzando il pulsante Diff. Vedere Confronto tra due versioni dello stesso oggetto.
- Aprire una versione precedente dell'elemento del database (come copia di sola lettura).
- Creare un ramo. Vedere Creazione di un ramo.
- Copiare la cronologia negli Appunti, utilizzando l'opzione Copia elementi selezionati negli Appunti nel menu contestuale.
- Creare una copia dell'oggetto in un'altra posizione all'interno del database, utilizzando il pulsante Copia.
- Al termine dell'utilizzo della finestra di dialogo, fare clic su Chiudi.
Visualizzazione delle modifiche di cui non è stato eseguito il commit
È possibile elencare le modifiche di cui non è stato eseguito il commit quando si confronta la copia locale dell'elemento con controllo della versione con la versione più recente nel database.
- Nella finestra Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto con controllo della versione e scegliere Confronta.
Viene visualizzata la finestra di dialogo Confronto.
- Selezionare l'opzione Commit modifiche personali non ancora eseguito.
- Facoltativamente, impostare le condizioni Ignora nella sezione Opzioni.
- Nella sezione Output, scegliere la destinazione del rapporto.
- Fare clic sul pulsante Mostra differenze.
Confronto tra due versioni dello stesso oggetto
È possibile confrontare due versioni per identificare le parti delle versioni che sono diverse.
- Nella finestra Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto con controllo della versione e scegliere Mostra cronologia commit.
Viene visualizzata la finestra di dialogo Cronologia commit.
- Selezionare due versioni dell'elemento, quindi fare clic sul pulsante Diff.
Viene visualizzata la finestra di dialogo Confronto. L'opzione Differenze rispetto ad un'altra rete viene selezionata automaticamente.
- Impostare le opzioni nella finestra di dialogo come richiesto, quindi fare clic sul pulsante Mostra differenze.
Confrontare due diversi oggetti con controllo della versione
È possibile confrontare due diversi oggetti con controllo della versione per identificare le parti degli oggetti che sono diverse.
- Nella finestra Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto con controllo della versione e scegliere Confronta.
Viene visualizzata la finestra di dialogo Confronta oggetto.
- Selezionare l'opzione Differenze rispetto ad un'altra rete.
- Selezionare l'oggetto con controllo della versione con cui eseguire il confronto: trascinarlo dalla struttura nella casella o utilizzare la funzione Sfoglia per selezionare l'oggetto di confronto.
- Impostare le opzioni nella finestra di dialogo come richiesto, quindi fare clic sul pulsante Mostra differenze.
Creazione di un ramo
- Eseguire qualche forma di analisi "what if" senza influire sui dati dell'asset.
- Tornare ad una versione precedente perché sono emersi errori successivi e scartarli è il modo di correzione più semplice.
Come creare un ramo
- Fare clic con il pulsante destro del mouse sull'oggetto con controllo della versione nella finestra Gruppo di modelli e scegliere Mostra cronologia commit.
Viene visualizzata la finestra di dialogo Cronologia commit.
- Selezionare la riga della griglia relativa alla versione dell'oggetto del database in cui creare il ramo.
Il nuovo ramo condividerà la cronologia dell'oggetto del database originale fino alla versione evidenziata inclusa.
- Fare clic sul pulsante Ramo.
Viene chiesto di confermare il nome del nuovo ramo. Il nome suggerito è basato sul nome dell'oggetto del database originale. È possibile modificare tale nome, se necessario.
- Al termine dell'operazione, fare clic su OK.
In InfoWorks WS Pro viene creato un ramo nella struttura del database al di sotto dell'elemento del database principale.
- Al termine dell'utilizzo della finestra di dialogo Cronologia commit, fare clic su Chiudi.
Il nuovo oggetto database sarà ora disponibile nella struttura del database un passo sotto l'oggetto di rete da cui è stato creato. I due oggetti database avranno una cronologia identica fino al punto del ramo.
Prenotazione di un oggetto con controllo della versione
È possibile prenotare un oggetto con controllo della versione per impedire ad altri utenti di eseguire il commit delle modifiche allo stesso. Ciò consente di apportare modifiche complesse all'elemento del database, garantendo al contempo l'assenza di conflitti al momento del commit delle modifiche. È possibile rimuovere la prenotazione su un oggetto con controllo della versione in qualsiasi momento.
Come prenotare o annullare la prenotazione di un oggetto con controllo della versione
- Nella finestra Gruppo di modelli, fare clic con il pulsante destro del mouse sull'oggetto con controllo della versione e selezionare Avanzate.
- Selezionare una delle seguenti opzioni:
Oggetto di riserva: l'oggetto database locale viene aggiornato con la versione più recente del server, se non è aggiornato, e l'oggetto database viene riservato. Quando un oggetto con controllo della versione viene riservato, gli altri utenti non possono eseguire il commit delle modifiche all'oggetto. Se l'oggetto database con controllo della versione è già riservato, verrà visualizzato un messaggio contenente i dettagli dell'utente che ha eseguito la prenotazione.
Annulla prenotazione oggetto: la prenotazione verrà rimossa dall'oggetto database. Gli altri utenti saranno ora in grado di eseguire il commit delle modifiche apportate all'oggetto. In questo caso, solo l'utente che ha originariamente applicato la prenotazione potrà rimuoverla. L'annullamento della prenotazione non andrà a buon fine se un altro utente tenta di rimuovere la prenotazione utilizzando questa opzione.
Forza annullamento prenotazione oggetto: la prenotazione verrà rimossa dall'oggetto database, a prescindere dall'utente che ha eseguito la prenotazione. Tutti gli utenti saranno ora in grado di eseguire il commit delle modifiche apportate all'elemento del database.