Collaborators Visualization & Conflict Prevention

La combinazione di Altium Designer e di un Workspace connesso fornisce una piattaforma altamente efficace per la condivisione dei dati, che supporta la collaborazione di progettazione tra i membri del team, basata su progetti sotto controllo di versione (VCS) archiviati in tale Workspace.

Una parte fondamentale del processo di collaborazione alla progettazione consiste nel gestire tale accesso condiviso e nel trattare il potenziale di conflitti nei dati, che possono verificarsi tipicamente quando più di un utente modifica lo stesso documento di progetto (la propria “copia” di quel file basato sul Workspace). Tali conflitti di dati vengono infine gestiti dal VCS del Workspace quando il documento viene salvato nel Workspace, ma fino a quel momento non si ha una reale visibilità sullo stato attivo di condivisione del documento.

Per soddisfare l’esigenza di informazioni e controllo in tempo reale sulla condivisione dei documenti nell’ambiente di modifica del progetto, Altium Designer lavora con un Workspace connesso per fornire un sistema integrato che consente di visualizzare e gestire lo stato corrente dei documenti condivisi. Il sistema è reso possibile dal libero flusso di dati di condivisione dei documenti tra i client di progettazione (tramite il Workspace) ed è realizzato attraverso una serie di nuove icone di stato, una barra Collaboratori e logiche aggiuntive di blocco dei file.

Prerequisiti

Le informazioni e il controllo della collaborazione in tempo reale per i documenti condivisi sono disponibili alle seguenti condizioni:

• Il progetto da condividere è ospitato su un Workspace connesso come progetto Workspace sotto controllo di versione (VCS).
• I collaboratori sono membri del Workspace e vi sono connessi.
• Il progetto Workspace è stato condiviso con tutti i collaboratori, con diritti di modifica per quegli utenti che richiedono accesso completo.
• I collaboratori hanno l’opzione System.Softlocks abilitata nella finestra di dialogo Advanced Settings.

Barra di notifica Collaboratori

La barra di notifica Collaboratori () apparirà nell’angolo superiore destro dell’editor documenti di Altium Designer quando il documento attualmente attivo è stato aperto da un altro utente. Passare il cursore sopra le icone utente nella barra per vedere lo stato di condivisione in tempo reale. Si noti che uno stato “in visualizzazione” indica che l’utente ha aperto il documento in Altium Designer ma non ha apportato modifiche. Lo stato di apertura di un documento locale è indicato dall’icona nel pannello Projects.

Stato di modifica

Oltre a indicare chi sta viewing un documento, il sistema fornisce anche informazioni su chi sta editing un documento condiviso. Un documento è considerato nello stato “in modifica” quando è stato cambiato da un altro utente. Ciò è indicato dalla barra Collaboratori, che separa dinamicamente le icone utente dei collaboratori tra quelli che stanno visualizzando e quelli che stanno modificando; quest’ultimo gruppo è associato all’icona .

Sopra: passare il mouse per attivare l’animazione.

Il documento che viene modificato da un altro utente avrà un’icona associata alla sua voce nel pannello Projects oppure un’icona se quel documento è attualmente aperto nell’editor. Si noti che il testo al passaggio del mouse riporterà anche i nomi di più utenti che stanno modificando (o hanno modificato) il documento condiviso.

Prevenzione dei conflitti

Per gestire l’accesso alla modifica dei file ed evitare la possibilità di conflitti nei dati, il sistema blocca di fatto un documento al primo utente che lo modifica o che ne ha causato la modifica. Questo “soft-lock” dell’utente rimane associato al file finché l’utente non termina la modifica: esegue il commit o annulla le modifiche, oppure viene scavalcato da un altro utente o da un amministratore.

Nell’immagine di esempio seguente, in cui due utenti hanno aperto lo stesso schema del progetto, il progettista che utilizza lo schermo inferiore ha modificato il documento, facendolo bloccare (soft) a quell’utente. Questo stato di modifica viene indicato all’altro utente (schermo superiore) tramite la barra Collaboratori e l’icona del documento nel pannello Projects.

Se un altro utente tenta di apportare una modifica al documento soft-locked, il suo stato bloccato (in modifica) attiverà finestre di dialogo pop-up per entrambi gli utenti. Il proprietario effettivo del documento (schermo inferiore nell’immagine seguente) verrà avvisato che un altro utente ha modificato il documento e che esiste un rischio associato di revisioni in conflitto.

Viceversa, all’utente che ha modificato il documento bloccato (schermo superiore) viene presentata l’opzione di annullare le proprie modifiche (Revert My Edits) oppure di ignorare la condizione mantenendo le proprie modifiche (Ignore Lock). Nel normale corso degli eventi, l’utente annullerebbe la modifica (Revert) e attenderebbe che l’altro utente abbia completato la sessione di modifica corrente.

Se tuttavia viene selezionata l’opzione Ignore Lock, ciò significa che ci sarà più di una versione modificata del documento che potrebbe essere sottoposta a commit nel Workspace: le modifiche degli utenti sono potenzialmente in conflitto, come indicato dall’icona del documento nel pannello Projects per entrambi gli utenti.

❯ ❮ Javascript ID: SoftLocks_ConflictWarnings_AD24_5

In questa situazione, in cui più di un utente sta modificando un documento, la sua icona cambierà in se il documento viene salvato localmente. Ciò indica che le modifiche locali sono state completate, ma lo stato del documento rimane in conflitto con la copia modificata da un altro utente. L’icona del documento cambierà in se il documento viene chiuso.

Per risolvere il conflitto in questa fase, è possibile annullare le modifiche locali facendo clic sull’icona e selezionando il comando Revert My Edits to Resolve Conflict dal pop-up.

Se tutti gli utenti insistono nel sottoporre a commit le proprie modifiche nel Workspace, ignorando i blocchi dei file e gli avvisi del controllo di versione, le diverse versioni del file provocheranno un Conflict Prevention del VCS, come indicato dall’icona del file nei pannelli Projects e Storage Manager. Questo può essere risolto adottando la versione “head” del file (tramite un “pull” o aggiornamento dal Workspace), oppure il file in conflitto può essere mantenuto come versione solo locale. Fare clic sull’icona per selezionare l’azione richiesta.

Quando si tenta di salvare nel Workspace un progetto che include documenti nello stato Conflict Prevention (), verrà visualizzata la finestra di dialogo informativa Action Required, che elenca i documenti in conflitto che devono essere risolti. Tali documenti avranno lo stato Conflict Detected con l’icona VCS . Utilizzare il menu contestuale VCS di un documento nello stato Conflict Detected per risolvere il conflitto aggiornando il documento con la sua revisione più recente dal Workspace oppure utilizzando il documento locale (o, per un documento PCB, confrontando e unendo le modifiche tramite la funzionalità PCB CoDesign).