Importazione degli utenti

È possibile importare utenti con filtri e gruppi correlati da file Excel, sorgenti LDAP o una combinazione di entrambi.

Si consiglia di eseguire un'attività di importazione per ogni set di utenti, gruppi e filtri. È possibile avere diverse sorgenti per le stesse entità. Ad esempio: un file Excel per i manager e un file Excel per i rivenditori, dove entrambi i file hanno un gruppo o un filtro comune. Entrambe le sorgenti devono essere collegate alla stessa attività di importazione. È possibile modificare il percorso delle sorgenti Excel e LDAP, quando necessario.

Si consiglia di eseguire le attività di importazione una alla volta. Se si eseguono diverse attività di importazione simultaneamente, potrebbero sorgere dei conflitti e le attività potrebbero fallire.

Limitazioni

Durante l'importazione si applicano alcune limitazioni:

• Non è possibile importare i filtri utilizzando LDAP. È necessario utilizzare un file Excel.
• Non è possibile importare indirizzi e-mail alternativi utilizzando LDAP. È necessario utilizzare un file Excel.
• Se bisogna creare o eliminare ruoli di sicurezza, è necessario farlo manualmente in Console web Qlik NPrinting. Vedere: Gestione dei ruoli
• È possibile importare da forest, alberi e domini LDAP diversi dal server Qlik NPrinting. Tuttavia, le appartenenze incrociate tra più forest non sono supportate.
• Quando si importano gli utenti da LDAP, i valori locali e del fuso orario non sono disponibili. Gli utenti importati in questo modo avranno come impostazione predefinita l'inglese e l'UTC. È possibile impostare diversi valori per località e fuso orario importando gli utenti da un file Excel, oppure modificandoli manualmente. Se si importano nuovamente gli stessi utenti tramite LDAP non sovrascriverà i valori per località e fuso orario.

Per le operazioni di importazione degli utenti, si applicano alcune limitazioni Excel:

• Se i gruppi, i ruoli o i filtri aggiunti alla riga non esistono, verranno ignorati.

• Se il nome di un filtro, utente o ruolo contiene virgole, utilizzare le virgolette doppie come delimitatori. Esempio: "Jeremy Martinson, Jr."

• Se il nome di un campo contiene virgolette doppie, spazi iniziali/finali o "{" e "}" è necessario iniziare e terminare la stringa con le virgolette doppie. I caratteri di virgolette doppie devono essere inseriti due volte per distinguerle dalle virgolette di escape.

  Esempio:

  • [Country]={" Italy, France ", "Germany",Spain} => " Italy, France ","Germany","Spain"
  • [Country]={"""Italy"""} => ""Italy""
  • [Country]={"{Sweden}"} => {Sweden}

• Per poter importare un campo con spazi iniziali/finali, è necessario aggiungere una parentesi quadra iniziale e una parentesi quadra finale alla stringa.

  Esempio: [ Country ]={Italy}, CountryBorn ={Italy} => " Country "={Italy}, "CountryBorn"={Italy}

• Non è possibile inserire "[", "]" come nomi di campo.

• È possibile eliminare campi di filtri esistenti aggiungendo campi (valori, valori numerici o colonne di formule) con un nome valido e un elenco di valori vuoto. La casella di controllo Aggiorna i filtri se modificati deve essere selezionata.

  Esempio:

  • Input [Country] => ignorato
  • Il campo del filtro [Country]={} => con nome del Paese rimosso

 

Sintassi di importazione nei documenti di Excel

È necessario creare un file Excel con i seguenti nomi esatti nei fogli di lavoro e nelle colonne. Non è possibile riordinare o rimuovere le colonne. Non è possibile riordinare o rimuovere fogli di lavoro.

Se si desidera disporre di un file Excel con utenti campione per scopi di test: visitare File di esempio, scaricare Examples.zip e aprire Recipients.xls.

Sintassi di importazione di filtri

Il primo foglio di lavoro contiene le definizioni dei filtri. Se un valore o una formula contiene virgole, utilizzare le virgolette doppie come delimitatori. Ad esempio: [SalesmanName]={"Jeremy Martinson, Jr.", Tom Lindwall}.

Se un filtro utilizza la funzione Seleziona escluso per escludere i valori, aggiungere <excluded> alla fine. Ad esempio: [CategoryName]={Babywear, Men´s Wear, Women's Wear}<excluded>

L'attributo <override> può essere utilizzato quando si importano i campi del filtro da Excel con il flag sostituisci valori abilitato. Ad esempio:

• [Country]={Sweden}<override>
• [Country]={"France"}<override,excluded>

Sintassi di importazione di utenti

Il secondo foglio di lavoro contiene le definizioni utente.

Nei campi E-mail alternativa, è possibile aggiungere più indirizzi e-mail, separati da due punti. Il provider di posta elettronica utilizzato determina il numero di indirizzi che è possibile aggiungere a ciascun campo.

Sintassi di importazione di gruppi

Il terzo foglio di lavoro contiene le definizioni dei gruppi.

Sintassi di importazione nelle sorgenti di LDAP

Sintassi connessione

Sintassi attributi voce

Gli attributi della voce devono riflettere i nomi degli attributi del server LDAP utilizzato.

Sintassi avanzata

Active Directory

Gli utenti di Active Directory devono cambiare il valore di Identificazione utente da inetOrgPerson a user o person. Il comportamento predefinito è importare tutti i gruppi. Se si desidera importare un gruppo specifico, utilizzare i campi Percorso gruppi alternativo o Filtri gruppi aggiuntivi.

Unione dei dati sorgente di importazione

Il criterio di unione fa riferimento alle regole da applicare quando si uniscono dati da un passaggio di importazione con i risultati dei passaggi precedenti. La sincronizzazione nel repository di Qlik NPrinting dei risultati dell'unione dei dati sorgente di importazione non utilizza un criterio di unione. Sono basati sulle impostazioni delle attività di importazione. Vedere: Creazione di un'attività di importazione.

Chiave di unione utenti

Specifica il campo utente utilizzato per identificare quando un utente recuperato da sorgenti di importazione fa riferimento a un utente esistente. L'algoritmo utilizzato per unire i dati utente è basato sui criteri di unione di entità e associazioni. Per abbinare le entità importate al repository di Qlik NPrinting, viene sempre utilizzato il Nome utente, quindi questa unione non viene presa in considerazione.

Criteri di unione entità

Specifica l'algoritmo utilizzato per unire i dati recuperati da diverse sorgenti di importazione che fanno riferimento alla stessa entità (utente, gruppo o filtro). Non viene applicato ai campi che mappano un'associazione a un'altra entità (filtri utenti, ruoli e gruppi, campi di filtri).

I valori supportati sono Sovrascrivi, Aggiorna mancanti e Ignora. I dati recuperati da una sorgente di importazione precedente sono i seguenti:

• Sovrascrivi: rimossi e sostituiti dall'importazione più recente. Le colonne esistenti in un passaggio precedente, ma non nell'ultimo passaggio, non vengono modificate.
• Aggiorna mancanti: ignorati, ad eccezione dei valori non presenti nelle attività di importazione precedenti, che vengono aggiunte. Questo vale per le colonne mancanti, non per le celle vuote.
• Ignora: ignorate.

Criteri di unione associazioni

Specifica l'algoritmo utilizzato per unire i dati recuperati da diverse sorgenti di importazione che fanno riferimento alla stessa entità (utente, gruppo o filtro). Viene applicato ai campi che mappano un'associazione a un'altra entità (filtri utenti, ruoli e gruppi, campi di filtri).

I valori supportati sono Sovrascrivi, Unisci e Ignora. Le entità recuperate dai passaggi di importazione precedenti sono le seguenti:

• Sovrascrivi: rimosse e sostituite dall'importazione più recente. Le colonne esistenti in un passaggio precedente, ma non nell'ultimo passaggio, non vengono modificate.
• Unisci: unite.
• Ignora: ignorate.

Assegnazione di diritti di importazione a un ruolo di sicurezza

Per importare utenti, è necessario accedere alla Console web Qlik NPrinting come utente che dispone dei diritti Attività di importazione in almeno un ruolo di sicurezza. Gli utenti con un ruolo di Amministratore dispongono dei diritti Attività di importazione. Se si applica il ruolo di Administrator (Amministratore) a un utente, quest'ultimo disporrà anche di tutti gli altri privilegi amministrativi.

È inoltre possibile assegnare diritti di importazione a un ruolo di sicurezza, senza concedere autorizzazioni amministrative.

Procedere come segue:

1. Accedere alla Console web Qlik NPrinting come utente con il ruolo di sicurezza Administrator (Amministratore).
2. Nel menu principale di Qlik NPrinting, fare clic sul menu a discesa Sistema.
3. Fare clic su Ruoli di sicurezza.
4. Fare clic sul ruolo a cui si desidera concedere i diritti Attività di importazione.
5. Fare clic sulla scheda App.
6. Scorrere fino alle caselle di controllo dei diritti Attività di importazione.
7. Selezionare la casella di controllo a sinistra di Attività di importazione per assegnare tutti i diritti delle attività di importazione al ruolo.

   È possibile scegliere inoltre solo i diritti specifici selezionando le caselle di controllo appropriate.

8. Fare clic su Salva.

Creazione di un'attività di importazione

Procedere come segue:

1. Nel menu principale di Qlik NPrinting, selezionare Attività, quindi selezionare Attività di importazione.
2. Fare clic su Crea attività di importazione.

3. Immettere il Nome dell'attività. Ad esempio: Import Users.

4. Verificare che la casella di controllo Abilitato sia selezionata. In caso contrario, l'attività verrà ignorata da Qlik NPrinting Engine.
5. In Sorgenti, fare clic su Aggiungi sorgente. Nel menu a discesa selezionare Importa da Excel o Importa da LDAP.
6. I passaggi successivi variano in base al tipo di sorgente:

   1. Excel: aggiungere il Percorso file di importazione (sul server) di Qlik NPrinting Server in cui è salvato il file Excel.

      Ad esempio: C:\ProgramData\NPrinting\Imports\NP_Web_Imports.xlsx. Questo non è il percorso file del computer locale.

      È possibile anche utilizzare un percorso di rete di un computer remoto. L'utente Windows che esegue Servizio di pianificazione Qlik NPrinting deve avere accesso alla cartella remota da Qlik NPrinting Server. Vedere: Sintassi di importazione nei documenti di Excel.

   2. LDAP: aggiungere il Percorso di connessione della sorgente LDAP.

      È possibile compilare gli altri campi secondo necessità. Vedere: Sintassi di importazione nelle sorgenti di LDAP.

7. Verificare che la casella di controllo Abilitato sia selezionata. In caso contrario, la sorgente verrà ignorata da Qlik NPrinting Engine.
8. Fare clic su Aggiungi sorgente per aggiungere un'altra sorgente.
9. Fare clic su , a destra, per eliminare una sorgente. Fare clic su per duplicarla.
10. In Impostazioni, selezionare le caselle di controllo che consentono di specificare le modalità di gestione dei conflitti di unione:
    • Crea utenti se non presenti
    • Aggiorna gli utenti se modificati

    • Rimuovi utenti non presenti nelle ultime sorgenti di importazione

      Verranno rimossi soltanto gli utenti aggiunti in un'esecuzione precedente della stessa importazione. Gli altri utenti, ad esempio quelli aggiunti manualmente, non verranno rimossi.

    • Sostituisci associazioni utente esistenti (filtri, ruoli e gruppi)

      Le associazioni utente esistenti verranno rimosse se non sono presenti nel file di importazione. Verranno sostituite con le associazioni in un nuovo file.

    • Rimuovi gruppi non presenti nelle ultime sorgenti di importazione

      Verranno rimossi soltanto i gruppi aggiunti in un'esecuzione precedente della stessa importazione. Gli altri gruppi, ad esempio quelli aggiunti manualmente, non verranno rimossi.

    • Crea filtri se non presenti
    • Aggiorna i filtri se modificati

    • Rimuovi filtri non presenti nelle ultime sorgenti di importazione

      Verranno rimossi i filtri aggiunti in un'esecuzione precedente della stessa importazione. Gli altri filtri, ad esempio quelli aggiunti manualmente, non verranno rimossi.

    • Sostituisci campi di filtro esistenti

      I campi di filtro esistenti non inclusi nel file di importazione verranno eliminati. Verranno sostituiti da campi di filtro dal file di importazione.

11. In Notifiche, è possibile selezionare Invia notifiche attività. Verrà inviata un'email agli indirizzi specificati in Impostazioni > Attività. Vedere: Notifiche di esecuzione delle attività.
12. Fare clic su Crea.

Esecuzione dell'attività di importazione

Verifica dello stato dell'attività

Nella pagina principale di Attività di importazione filtri e destinatari, è possibile visualizzare lo stato delle attività di importazione.

• Ultima esecuzione: mostra la data e l'ora dell'ultima esecuzione.
• Stato dell'ultima esecuzione: se un'attività è stata eseguita correttamente, verrà mostrata come Completata. In caso contrario, verrà mostrata come Non riuscita.
• Avanzamento ultima esecuzione: mostra l'avanzamento di un'attività attiva.

• Log ultima importazione: fare clic sul link Download per visualizzare gli ultimi registri associati all'attività.

  Se durante l'importazione si verifica un errore, nel file di registro verrà visualizzato un messaggio di errore nella lingua corrente impostata per il computer in cui è stata eseguita l'importazione. Al primo errore che si verifica, l'importazione si interromperà e verranno annullate tutte le modifiche dell'intera importazione. Il download del file di registro contiene una riga di registro per ogni azione di importazione. I registri di esecuzione delle attività contengono solo i registri principali, ad esempio errori e informazioni sull'avanzamento.

• Abilitata: se questa casella di controllo non è selezionata, l'attività verrà ignorata da Qlik NPrinting Engine.
• Azioni: fare clic su per modificare, eliminare, eseguire o testare l'attività.

Per visualizzare i nuovi utenti creati in seguito all'importazione, accedere alla pagina Utenti. È possibile verificare che siano stati creati i file associati aprendo la scheda Filtri.