Explorer: Diritti e Sicurezza

• Tipo non definito

Questo documento spiega come abilitare e utilizzare l'editing ad albero in Immersive Explorer. È destinato a integratori, amministratori di Immersive e utenti autorizzati.

Si occupa solo dell'uso dell'interfaccia: attivazione dei comandi, assegnazione dei diritti, creazione, modifica ed eliminazione di una cartella Immersive.

1. Principio generale

La modalità Edit si basa su due condizioni aggiuntive:

1. L'integratore richiede la visualizzazione delle funzioni di editing con EnableEditing: true ;
2. l'utente effettuato l'accesso ha il diritto necessario alla cartella Immersive in questione.

La barra dei comandi può offrire:

• Nuova cartella ;
• Modifica ;
• Elimina ;
• Refresh.

I comandi non autorizzati non vengono visualizzati. I controlli vengono effettuati anche all'apertura del pannello e poi durante il salvataggio.

2. Abilita l'editing con EnableEditing

La modalità modifica è disabilitata di default nella libreria JavaScript.

const explorer = new MediaExplorer(
    document.getElementById("MediaExplorerHost"),
    {
        RootFolderIdentifier: 15,
        EnableEditing: true
    }
);

await explorer.initialize();

La pagina Esplora fornita da RestFrontage già abilita questa modalità. Un'applicazione client deve abilitarla esplicitamente quando costruisce il componente stesso.

EnableEditing	Diritti degli utenti	Risultato nell'interfaccia
false o assente	qualsiasi	I controlli di modifica sono nascosti. Refresh rimane disponibile.
true	Nessun diritto di modifica	I comandi non autorizzati rimangono nascosti.
true	Uno o più diritti	Vengono visualizzati solo i comandi che corrispondono a questi diritti.

3. Diritti utilizzati dall'Explorer

I diritti sono per la cartella Immersive attuale.

Diritto	Bandiera	Effetto nell'Explorer
Folder See	1	Permette di visualizzare la cartella.
Folder Read	3	Permette di visualizzare il contenuto della cartella.
Folder Modify	5	Poster Modifica e autorizza la modifica del nome e della descrizione.
Folder Write	11	Poster Nuova cartella e autorizza la creazione di un bambino. Questo diritto sarà utilizzato anche per aggiungere contenuti multimediali quando saranno disponibili.
Folder FullControl	15	Poster Elimina e include tutti i diritti precedenti.

Diritti Modify e Write Soddisfare esigenze diverse: un utente che ha il permesso di creare un figlio può non avere il permesso di rinominare la cartella genitore.

3.1 Utenti sempre autorizzati

I seguenti profili hanno tutti i controlli per gestire le cartelle Immersive:

• Cerebrates;
• Membri del Gruppo Globale Administrators l'organizzazione quotidiana;
• Membri del Gruppo Globale DomainAdministrators sul server attuale.

Questa regola è indipendente da EnableEditing. Per vedere i comandi, l'opzione deve essere ancora attiva nel componente.

3.2 Cartelle Blob

Una cartella Immersive con un Percorso virtuale a blob diventa un punto di modifica in sola lettura.

In questa cartella e nel suo albero Blob:

• Nuova cartella, Modifica e Elimina non vengono offerte;
• Refresh e la navigazione rimangono disponibili;
• I diritti di modifica della cartella immersiva non permettono di modificare il contenuto del Blob da Esplora.

4. Preparare i diritti di un'organizzazione

I diritti vengono assegnati su base organizzativa. Il metodo raccomandato è utilizzare gruppi di permessi e poi collocare gli utenti nei gruppi che corrispondono al loro ruolo.

4.1 Controlla la struttura di sicurezza

In RestFrontage:

1. Open Sicurezza ;
2. Open Strumenti di sicurezza ;
3. in Struttura di sicurezza delle organizzazioni, seleziona Avvia la verifica ;
4. monitorare l'organizzazione interessata;
5. se la sua condizione è Incompleto, usa Regolarizzazione.

La regolarizzazione crea solo gli elementi standard mancanti. Preserva gli utenti, i gruppi, le iscrizioni e i diritti esistenti.

L'organizzazione deve avere:

• Un'unità Gruppi ;
• Un'unità Utenti ;
• Gruppi Administrators e Users ;
• un amministratore di organizzazione che è membro di Administrators.

4.2 Scelta di un gruppo di permessi

I gruppi di permessi riconosciuti per i record seguono la seguente convenzione:

Gruppo Organizzativo	Ruolo consigliato
Folder SeeFolder	Guarda le cartelle senza consultarne il contenuto.
Folder ReadFolder	Consulta la struttura degli alberi e il substrato.
Folder ModifyFolder	Cambia il nome e la descrizione delle cartelle.
Folder WriteFolder	Crea sottocartelle.
Folder FullControlFolder	Amministrare completamente i registri, inclusa la loro cancellazione.

Questi gruppi devono essere inseriti nell'unità Gruppi dell'organizzazione in questione. Se non esistono, un amministratore della sicurezza può crearli da Security Explorer rispettando il loro nome esatto.

4.3 Aggiungere un utente a un gruppo

Sono possibili due percorsi nell'interfaccia.

Dall'utente

1. Open Sicurezza, allora Utenti e gruppi ;
2. Seleziona l'utente.
3. Nella zona Gruppi, scegli Gruppi di Gestione ;
4. Aggiungi il/i gruppo di permessi necessario/i.
5. Convalida il pannello.

Dal gruppo

1. Open Sicurezza, allora Utenti e gruppi ;
2. Seleziona il gruppo di permessi.
3. Nella zona Membri, scegli Membri Gestori ;
4. Seleziona Aggiungi un membro ;
5. Scegli quali utenti o gruppi aggiungere.
6. Valida con Aggiungi al carrello.

I gruppi possono essere usati come membri per assegnare lo stesso ruolo a più utenti.

4.4 Applicare i diritti alle cartelle esistenti

Aggiungere un utente a un gruppo è sufficiente solo se il gruppo ha già diritto alle cartelle in questione.

Per verificare e completare i diritti automatici:

1. Open Sicurezza, allora Strumenti di sicurezza ;
2. in Diritti automatici degli oggetti esistenti, seleziona Avvia la verifica ;
3. Scegli il tipo di oggetto Cartelle ;
4. Seleziona l'organizzazione.
5. Scegli Refresh ;
6. controllare lo stato di ogni file;
7. Utilizzo Regolarizzazione su una cartella o Regolarizzare la selezione per diversi casi.

Stato	Significato	Azione consigliata
Sold out	Sono presenti tutti i diritti automatici attesi.	Nessuno.
Incompleto	Uno o più diritti automatici mancano.	Utilizzo Regolarizzazione.
Configurazione	La politica sui diritti o l'organizzazione non possono essere risolte.	Correggi la configurazione prima di ri-auditare.

L'adeguamento aggiunge solo i diritti automatici mancanti. Non rimuove gli altri diritti esistenti.

4.5 Nuove Commissioni di Archivio

Quando una cartella viene creata, i diritti automatici dell'organizzazione vengono applicati immediatamente.

La politica raccomandata è:

Beneficiario	Consigliato giusto
Gruppo Users dell'organizzazione	Folder Read
Gruppo Administrators dell'organizzazione	Folder FullControl
Gruppo Specializzato per le Autorizzazioni	Destra corrispondente al nome del gruppo

La definizione di questa politica è un'operazione di operazione server. L'HMI Diritti automatici degli oggetti esistenti permette che venga controllata e applicata, ma non serve a inventare o modificare la politica stessa.

5. Barra di comando Explorer

La barra dei comandi si trova sopra l'albero e il contenuto.

Ordine	Condizioni di visualizzazione	Azione
Nuova cartella	EnableEditing: true e legge Folder Write sul file attuale.	Apri il pannello Crea una cartella.
Modifica	EnableEditing: true e legge Folder Modify sul file attuale.	Apri il pannello Modifica cartella.
Elimina	EnableEditing: true e legge Folder FullControl sul file attuale.	Apri il pannello Elimina cartella.
Refresh	Sempre disponibile	Ricarica la visualizzazione ad albero e il contenuto attuale.

Nella radice generale dell'Explorer, solo Nuova cartella e Refresh può essere proposto. La radice generale non è una cartella Immersive, quindi non può essere modificata o cancellata.

Un utente non amministratore può creare in questa root se ha Folder Write su almeno una cartella root nell'organizzazione. La nuova cartella viene creata nell'organizzazione corrente.

6. Pannello "Crea cartella"

Il Nuova cartella apre un pannello senza ricaricare la pagina.

Il sottotitolo indica dove vuoi creare:

• nella cartella Immersive attuale.
• O alla radice dell'organizzazione attuale.

Campo	Richiesto	Descrizione
Nome	Sì	Il nome della nuova cartella Immersive.
Descrizione	No	Testo che descrive l'uso del file.
Percorso virtuale a blob	No	L'URL radice di un container Blob. Se popolato, la cartella diventa un punto di montaggio di sola lettura.

Azioni disponibili:

• Crea Salva la cartella e poi aggiorna l'esploratore.
• Cancella Chiude il pannello senza modifiche.

Se c'è un errore, il pannello rimane aperto e mostra il messaggio. Il contenuto già inserito viene mantenuto per permettere la correzione.

7. Pannello "Modifica cartella"

Il Modifica agisce sulla cartella Immersive attualmente aperta.

Il panel presenta innanzitutto due riferimenti non modificabili:

Riferimento	Utilizzo
ID cartella immersiva	Valore da utilizzare in RootFolderIdentifier.
Percorso relativo dalla radice	Valore da utilizzare in RelativePath. Una cartella radice mostra un valore vuoto.

Ogni riferimento ha un'icona di copia. Questo ti permette di copiare direttamente il valore senza dare l'impressione che sia modificabile.

I campi modificabili sono:

• Nome ;
• Descrizione.

Azioni disponibili:

• Salva Applica le modifiche e poi aggiorna l'albero, le briciole e i contenuti.
• Cancella Chiude il pannello senza modifiche.

Il percorso relativo visualizzato viene calcolato dalla radice dell'Explorer. Può quindi variare a seconda del RootFolderIdentifier Utilizzato dall'integrazione.

8. Pannello "Elimina cartella"

Il Elimina Apre un pannello di conferma.

8.1 Cartella vuota

Il cartello indica che l'operazione è definitiva.

• Elimina conferma l'operazione;
• Cancella Chiude il pannello senza modifiche.

Dopo la cancellazione, l'Esplorante torna al genitore della cartella e aggiorna l'albero.

8.2 Cartella Non Vuota

La cancellazione viene negata se la cartella contiene ancora:

• Una sottocartella Immersive.
• un media immersivo.

Il pannello mostra quindi un avviso e offre solo Chiudi. Il file deve essere svuotato prima di ricominciare.

9. Aggiornamento dopo una modifica dei diritti

Dopo un cambio di gruppo o regolarizzazione dei diritti:

1. ritorno sull'Explorer;
2. Utilizzo Refresh ;
3. Se necessario, riapri il fascicolo interessato.

Può essere necessaria una riconnessione se l'appartenenza al gruppo viene mantenuta nella sessione corrente.

10. Risoluzione dei problemi

Non appare alcun pulsante di modifica

Controlla successivamente:

• Che EnableEditing vale true ;
• che l'utente sia autenticato;
• che appartiene al gruppo giusto nell'organizzazione del fascicolo;
• che la revisione dei diritti del fascicolo indica Sold out ;
• La cartella corrente non è un punto di montaggio Blob.
• che l'integrazione con il client carichi l'infrastruttura del pannello attesa.

"Nuova cartella" appare ma "Modifica" non

Proprietà dell'utente Folder Write, ma non Folder Modify. Aggiungi il gruppo di cambiamento se è permesso rinominarlo.

"Modifica" appare ma "Elimina" non

Proprietà dell'utente Folder Modify, ma non Folder FullControl. La rimozione volontaria richiede il livello più alto.

Il pannello di rimozione nega l'operazione

La cartella contiene ancora una sottocartella o un Immersive media. Cancella o sposta il suo contenuto prima di ricominciare da capo.

I pulsanti non si evolvono dopo un cambio di diritti

• Utilizzo Refresh ;
• riapri il file;
• Esci e poi torna a entrare se l'appartenenza al gruppo è cambiata.
• Rilanciare l'audit automatico dei diritti.

11. Lista di controllo per la commissione

• EnableEditing è abilitato solo nelle integrazioni che devono offrire l'edizione.
• L'organizzazione dispone di una struttura di sicurezza completa.
• I gruppi di permessi necessari per le cartelle esistono all'interno dell'unità Gruppi dell'organizzazione.
• Gli utenti sono membri dei gruppi che corrispondono al loro ruolo.
• La policy predefinita assegna la lettura agli utenti e il pieno controllo agli amministratori dell'organizzazione.
• La revisione Diritti automatici degli oggetti esistenti è completo per il tipo Cartelle.
• Le cartelle blob sono ancora usate come solo lettura.
• Sono stati testati creare, modificare, cancellare una cartella vuota e rifiutare una cartella non vuota.
• Il display era controllato da un computer e con una risoluzione ridotta.