Documentazione AEM Guides Documentazione di AEM Guides

Gestione delle versioni

Ultimo aggiornamento: 5 maggio 2025

Argomenti:

Creato per:

Esperto
Amministratore

Il controllo delle versioni è un aspetto importante di qualsiasi sistema di gestione dei contenuti. Consente di creare un’istantanea della risorsa digitale in un momento specifico. Con una versione di una risorsa digitale installata, puoi ripristinare la versione richiesta della risorsa e aggiornarla. In genere, per creare una versione di una risorsa, si estrae e si archivia la risorsa richiesta.

In qualità di amministratore, è possibile applicare regole che impediscono agli utenti di modificare un file senza estrarlo. Analogamente, è possibile assicurarsi che tutti i file estratti vengano archiviati per evitare perdite di dati.

In un ambiente multiuso, è inoltre importante assicurarsi che gli utenti non eliminino i file dal sistema. Questo requisito è più critico per i file estratti da altri utenti. Per evitare che gli utenti eliminino accidentalmente i file estratti dal sistema, AEM Guides fornisce una configurazione che è possibile utilizzare. Oltre ai file estratti, è possibile controllare l'eliminazione dei file che contengono riferimenti o a cui si fa riferimento da altri file.

Crea una nuova versione per il file caricato

NOTA

Questa configurazione è applicabile solo durante il caricamento dei file.

Per abilitare l'opzione Crea nuova versione per il file caricato, effettuare le seguenti operazioni:

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione.
Nel file di configurazione, fornisci i seguenti dettagli di (property) per configurare l'opzione Crea nuova versione per il file caricato:

PID Chiave proprietà Valore proprietà
com.adobe.fmdita.confi g.ConfigManager create.ver.new.content Booleano (true/false).
Valore predefinito: true

PID	Chiave proprietà	Valore proprietà
`com.adobe.fmdita.confi g.ConfigManager`	`create.ver.new.content`	Booleano (true/false). Valore predefinito: `true`

NOTA

Quando l’opzione è selezionata, si verifica un nuovo meccanismo di gestione delle versioni e ignora il comportamento di caricamento predefinito per qualsiasi caricamento successivo. I contenuti del file caricato vengono salvati come nuova versione. Se l’opzione è deselezionata, AEM Guides utilizza il meccanismo predefinito di gestione delle versioni dell’AEM.

Configura le impostazioni per consentire la modifica dei file estratti

AEM Guides Web Editor consente di creare e aggiornare argomenti DITA. È possibile configurare l'Editor Web in modo da consentire la modifica solo dei documenti estratti dal repository. In questo modo nessun altro autore sovrascrive accidentalmente un argomento aperto per la modifica da un altro autore. Una volta aperto un argomento per la modifica, un autore può archiviare il file al momento della chiusura.

Un'altra regola importante consiste nel garantire che i file estratti vengano nuovamente archiviati nel sistema. In questo modo gli utenti non potranno chiudere accidentalmente i file senza archiviarli di nuovo.

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornire i dettagli (property) seguenti per configurare la modifica dei file estratti:

PID	Chiave proprietà	Valore proprietà
`com.adobe.fmdita.xmleditor.config.XmlEditorConfig`	`xmleditor.autocheckout`	Booleano (true/false). Valore predefinito: `false`

È inoltre possibile configurare la visualizzazione di un messaggio di avviso ogni volta che un file estratto viene chiuso senza essere salvato o archiviato nuovamente nel repository.

PID	Chiave proprietà	Valore proprietà
`com.adobe.fmdita.xmleditor.config.XmlEditorConfig`	`xmleditor.checkin`	Booleano (true/false). Valore predefinito: `false`

NOTA

Indipendentemente dal fatto che questa funzione venga attivata o disattivata, le opzioni Estrai e Archivia file sono sempre disponibili nell'anteprima di un argomento.

Sovrascrivi file estratto al caricamento

NOTA

Questa configurazione è applicabile solo quando si creano file dall'interfaccia utente di Assets e non quando si caricano file tramite lo strumento WebDAV.

Per consentire agli utenti di sovrascrivere il file durante il caricamento che è stato estratto da loro o da un altro utente, effettuare le seguenti operazioni:

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione.
Nel file di configurazione, fornisci i seguenti dettagli di (property) per configurare l'opzione Sovrascrivi file estratto al caricamento:

PID	Chiave proprietà	Valore proprietà
`com.adobe.fmdita.confi g.ConfigManager`	`overwrite.checkout.onupload`	Booleano (true/false). Valore predefinito: `false`

NOTA

Per impostazione predefinita, questa opzione è disattivata. Se questa opzione è selezionata, gli utenti potranno sovrascrivere i file estratti. Se l'opzione non è selezionata, il file non può essere sovrascritto se è stato estratto da un altro utente o da un altro utente.

Impedisci l'eliminazione dei file estratti

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornire i seguenti dettagli (property) per impedire agli utenti di eliminare accidentalmente i file estratti:

PID	Chiave proprietà	Valore proprietà
`com.adobe.fmdita.xmleditor.config.XmlEditorConfig`	`xmleditor.preventcheckedoutcontentdeletion`	Booleano (true/false). Valore predefinito: `true`

Impedisci l'eliminazione dei file di riferimento

In qualità di amministratore, puoi controllare chi può eliminare i file dall’archivio AEM. In particolare, se un file contiene riferimenti o vi fa riferimento un altro file, puoi definire chi può eliminare tali file.

Utilizzando questa configurazione, puoi consentire o vietare a tutti gli utenti di eliminare i file, oppure consentire solo a un gruppo di utenti specifico di eliminare i file. Se è consentita l’eliminazione del file, viene seguito il seguente processo:

Se si elimina una cartella, che contiene tutti i file di riferimento e di riferimento, tutti i file vengono eliminati. Il processo elimina innanzitutto tutti i file che non contengono riferimenti, seguiti dai file che contengono riferimenti o a cui si fa riferimento.
Se si sta eliminando una cartella e a qualsiasi file all'interno della cartella viene fatto riferimento da un file all'esterno della cartella, verrà richiesto di rimuovere il riferimento prima di eliminare il file.

Utilizza le istruzioni fornite in Sostituzioni configurazione per creare il file di configurazione. Nel file di configurazione, fornisci i dettagli (property) seguenti per definire chi può eliminare un file che contiene riferimenti o a cui fanno riferimento altri file:

PID	Chiave proprietà	Valore proprietà
`com.adobe.fmdita.config.ConfigManager`	`block.unsafe.delete`	I valori possibili sono: - allow_unsafe_delete_for_all - allow_unsafe_delete_for_delete_assets_group - block_unsafe_delete_for_all Valore predefinito: `allow_unsafe_delete_for_delete_assets_group` I dettagli di queste costanti sono riportati di seguito.

A seconda degli utenti a cui si desidera concedere l'accesso per l'eliminazione, specificare una delle seguenti costanti:

allow_unsafe_delete_for_all: concedere a tutti gli utenti l’autorizzazione per eliminare i file. In questo caso, se il file(s) contiene riferimenti o vi fanno riferimento altri file, potete anche eliminarlo forzatamente. Prima di eliminare il file, viene visualizzato un messaggio con i riferimenti, è possibile annullare l'operazione di eliminazione, rimuovere i riferimenti e infine eliminare il file(s). In alternativa, è possibile eliminare forzatamente il file(s) senza rimuovere i riferimenti.
allow_unsafe_delete_for_delete_assets_group: un amministratore o un utente appartenente al gruppo delete-assets può eliminare dei file. Se un altro utente tenta di eliminare file con qualsiasi riferimento, non potrà eliminare tali file finché non saranno stati rimossi tutti i riferimenti. La schermata seguente viene visualizzata quando un utente che non dispone delle autorizzazioni necessarie tenta di eliminare dei file.
block_unsafe_delete_for_all: non consentire a tutti gli utenti (inclusi gli amministratori) di eliminare i file finché i riferimenti a e dal file(s) non vengono rimossi.

Rimuovi versioni precedenti di file DITA

Quando si aggiorna il contenuto e si creano nuove versioni, le versioni precedenti dei file DITA vengono mantenute nell'archivio. Molte versioni potrebbero essere create per i file DITA in un periodo di tempo e, collettivamente, occupano una grande quantità di spazio nell'archivio. AEM Guides consente di configurare le versioni precedenti da eliminare dall’archivio.

Puoi accedere a questa utility utilizzando l’URL specificato se disponi di diritti di amministratore:

<server folder path> /libs/fmdita/clientlibs/xmleditor_version_purge/page.html

La versione di un file DITA che soddisfa uno qualsiasi dei criteri specificati viene mantenuta e non eliminata:

È la prima versione di un file
È incluso in una baseline
È incluso in qualsiasi flusso di lavoro di traduzione o revisione
Ha un’etichetta applicata
Soddisfa l’età o il numero di criteri di versione definiti

Per eliminare le versioni precedenti, effettua le seguenti operazioni:

Immetti i seguenti dettagli sui file da eliminare:
- Numero di versioni da mantenere dall'ultima versione: immettere il numero di versioni da conservare e non eliminare. Ad esempio, se si immette 5, le ultime 5 versioni vengono mantenute e le versioni precedenti vengono qualificate per l'eliminazione nel caso in cui vengano soddisfatte altre condizioni di rimozione.

Mantieni versioni create entro l'intervallo di tempo (In giorni): immettere l'età massima di una versione in giorni. Le versioni precedenti al numero di giorni specificato possono essere eliminate nel caso in cui siano soddisfatte altre condizioni di eliminazione. Ad esempio, se si immette 100, tutte le versioni create prima di 100 giorni vengono qualificate per l'eliminazione nel caso in cui vengano soddisfatte altre condizioni di rimozione.
Percorso: selezionare il percorso del file o della cartella di cui si desidera eliminare i file.

NOTA
È possibile eliminare solo i file DITA.

Fare clic su Anteprima report di rimozione.

NOTA
Può essere presente una sola attività di eliminazione alla volta. Non è possibile avviare un'altra operazione di eliminazione della versione se una è in corso di elaborazione.

Viene generato il rapporto di eliminazione della versione.
Scarica il rapporto di eliminazione della versione e controlla i file e le versioni che verranno eliminati.
Puoi scegliere di Annullare la rimozione o Avviare la rimozione.

Viene visualizzato lo stato di rimozione.

Fare clic su Scarica rapporto di eliminazione versione per visualizzare le versioni eliminate. Questo rapporto fornisce lo stato di rimozione su tutte le versioni insieme ai motivi per cui una particolare versione è stata mantenuta o eliminata.

NOTA

Il report è stato scaricato nel seguente percorso: /var/dxml/versionpurge

recommendation-more-help