Importazione degli utenti

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

Si consiglia un'unica attività di importazione per set di utenti, gruppi e filtri. È possibile avere più origini per le stesse entità, ad esempio un file Excel per i responsabili e un file Excel per i fornitori, dove entrambi i file hanno un gruppo o filtro comune. Entrambe queste origini devono essere collegate alla stessa attività di importazione. È possibile modificare il percorso delle origini Excel e LDAP, se necessario.

Le attività di importazione dovrebbero essere eseguite una alla volta. Se si eseguono più attività di importazione insieme, possono verificarsi conflitti e le attività potrebbero presentare errori.

Limitazioni

L'importazione prevede alcune limitazioni:

• Non è possibile importare i filtri usando LDAP. È necessario utilizzare un file Excel.
• Non è possibile importare e-mail alternative usando LDAP. È necessario utilizzare un file Excel.
• Se è necessario creare o eliminare ruoli di sicurezza, l'operazione dovrà essere eseguita manualmente in Console web Qlik NPrinting. Vedere: Gestione dei ruoli (solo in lingua inglese)
• È possibile eseguire l'importazione da foreste, alberi e domini LDAP diversi dal server di Qlik NPrinting. L'appartenenza a più foreste non è tuttavia supportata.
• Quando si importano utenti da LDAP, i valori di impostazioni locali e fuso orario non sono disponibili. Gli utenti importati in questo modo avranno come valore predefinito la lingua inglese e il fuso orario UTC. È possibile definire valori diversi di impostazioni locali e fuso orario importando gli utenti da un file Excel oppure tramite modifica manuale. La reimportazione degli stessi utenti tramite LDAP non sovrascrive i valori di impostazioni locali e fuso orario.

L'importazione di utenti da Excel prevede alcune limitazioni:

• 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 valore di un campo contiene virgolette doppie, spazi iniziali/finali o "{", "}", è necessario iniziare e terminare la stringa con 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:

  • [Country] => input ignorato
  • [Country]={} => campo di filtro con nome Country 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 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 (solo in lingua inglese), 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 esclusi per escludere valori, aggiungere <excluded> alla fine. Ad esempio: [CategoryName]={Babywear, Men´s Wear, Women's Wear}<excluded>

L'attributo <override> può essere utilizzato al momento di importare campi di filtro da Excel con il flag Sostituisci valori attivato. 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 proprio e-mail provider determina quanti indirizzi possono essere aggiunti 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 voce devono riflettere i nomi di attributi del server LDAP.

Sintassi avanzata

Active Directory

Per gli utenti Active Directory è necessario modificare il valore di Identificazione utente da inetOrgPerson a user o person. Il comportamento predefinito prevede l'importazione di tutti i gruppi. Per importare un gruppo specifico, usare 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. Si applica alle colonne mancanti, non alle 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) del 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.

      È anche possibile utilizzare il percorso di rete di un computer remoto. L'utente di Windows che esegue Service utilità 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à (solo in lingua inglese).
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 verificare 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.