Importando usuários

É possível importar usuários com filtros e grupos relacionados de arquivos do Excel, origens do LDAP ou uma combinação de ambos.

Recomendamos que você tenha uma tarefa de importação por conjunto de usuários, grupos e filtros. Você pode ter fontes diferentes para as mesmas entidades. Por exemplo: um arquivo do Excel para gerentes e um arquivo do Excel para fornecedores, em que os dois arquivos têm um grupo ou filtro comum. Ambas as fontes devem ser anexadas à mesma tarefa de importação. Você pode alterar o caminho das suas fontes do Excel e do LDAP quando necessário.

Você deve executar tarefas de importação, uma de cada vez. Se você executar várias tarefas de importação simultaneamente, poderão surgir conflitos, e essas tarefas poderão falhar.

Limitações

Há algumas limitações ao importar:

• Não é possível importar filtros usando LDAP. Você deve usar um arquivo do Excel.
• Não é possível importar e-mails alternativos usando LDAP. Você deve usar um arquivo do Excel.
• Se você precisar criar ou excluir funções de segurança, faça isso manualmente no Console da Web do Qlik NPrinting. Consulte: Gerenciando funções (somente em inglês)
• Você pode importar de florestas, árvores e domínios do LDAP diferentes do servidor do Qlik NPrinting. No entanto, não há suporte para associações cruzadas entre florestas.
• Ao importar usuários do LDAP, valores de localidade e fuso horário não estão disponíveis. Os usuários importados dessa maneira serão padronizados para inglês e UTC. Você pode definir diferentes valores de localidade e fuso horário importando usuários de um arquivo do Excel ou alterando-os manualmente. A importação dos mesmos usuários novamente via LDAP não substituirá os valores de localidade e fuso horário.

Há algumas limitações ao importar usuários via Excel:

• Se grupos, funções ou filtros adicionados na linha não existirem, eles serão ignorados.

• Se o nome de um filtro, usuário ou função incluir vírgulas, use aspas duplas como delimitadores. Exemplo: "Jeremy Martinson, Jr."

• Se um valor de campo incluir aspas duplas, espaços iniciais/finais ou "{", "}", você deve começar e terminar a cadeia com aspas duplas. Caracteres de aspas duplas devem ser inseridos duas vezes para serem diferenciados de aspas de escape.

  Exemplo:

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

• Para importar um campo com espaços iniciais/finais, você deve começar e terminar a cadeia de caracteres com colchetes.

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

• Você não pode inserir "[", "]" como nomes de campo.

• Você pode excluir os campos de filtro existentes adicionando campos (valores, valores numéricos ou colunas de fórmulas) com um nome válido e uma lista de valores vazia. A caixa de seleção Atualizar filtros se modificados deve ser marcada.

  Exemplo:

  • [Country] => entrada ignorada
  • [Country]={} => campo de filtro com o nome do país removido

 

Importar sintaxe em documentos do Excel

Você deve criar um arquivo do Excel com os seguintes nomes exatos nas planilhas e colunas. Você não pode reordenar ou remover colunas. Você não pode reorganizar ou remover planilhas.

Se você quiser um arquivo do Excel com usuários de amostra para testes: visite Arquivos de amostra (somente em inglês), baixe Examples.zip e abra Recipients.xls.

Importar sintaxe de filtro

A primeira planilha contém as definições de filtro. Se um valor ou uma fórmula contiver vírgulas, use aspas duplas como delimitadores. Por exemplo: [SalesmanName]={"Jeremy Martinson, Jr.", Tom Lindwall}.

Se um filtro usar o recurso Selecionar excluídos para excluir valores, adicione <excluded> ao final. Por exemplo: [CategoryName]={Babywear, Men´s Wear, Women's Wear}<excluded>

O atributo <override> pode ser usado ao importar campos de filtro do Excel com o sinalizador de substituição de valores habilitado. Por exemplo:

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

Importar sintaxe de usuário

A segunda planilha contém as definições de usuário.

Nos campos E-mail alternativo, você pode adicionar mais de um endereço de e-mail, separados por ponto e vírgula. Seu provedor de e-mail determina quantos endereços podem ser adicionados a cada campo.

Importar sintaxe de grupo

A terceira planilha contém as definições de grupo.

Sintaxe de importação em fontes do LDAP

Sintaxe de conexão

Sintaxe de atributos da entrada

Os atributos da entrada devem refletir os nomes dos atributos do seu servidor do LDAP.

Sintaxe avançada

Active Directory

Os usuários do Active Directory devem alterar o valor de Identificação do usuário de inetOrgPerson para user ou person. O comportamento padrão é importar todos os grupos. Se você deseja importar um grupo específico, use os campos Caminho do grupo alternativo ou Filtros de grupo adicionais.

Mesclando dados da fonte de importação

A política de mesclagem refere-se às regras a serem aplicadas ao mesclar dados de uma etapa de importação com os resultados das etapas anteriores. A sincronização no repositório do Qlik NPrinting de resultados de mesclagem de dados da fonte de importação não usa uma política de mesclagem. Eles são baseados nas configurações da tarefa de importação. Consulte: Criando uma tarefa de importação.

Chave de mesclagem de usuários

Isso especifica o campo do usuário usado para identificar quando um usuário recuperado de fontes de importação está se referindo a um usuário existente. O algoritmo usado para mesclar os dados do usuário é baseado em políticas de mesclagem de entidades e associações. Para corresponder as entidades importadas ao repositório do Qlik NPrinting, o nome de usuário é sempre usado, portanto, essa chave de mesclagem não é considerada.

Política de mesclagem de entidades

Isso especifica o algoritmo usado para mesclar os dados recuperados de diferentes fontes de importação que estão se referindo à mesma entidade (usuário, grupo ou filtro). Isso não é aplicado a campos que estão mapeando uma associação para outra entidade (filtros, funções e grupos de usuários e campos de filtro).

Os valores aceitos são Sobrescrever, Atualizar ausentes e Ignorar. Os dados recuperados de uma fonte de importação anterior são:

• Sobrescrever: removido e substituído pela importação mais recente. Colunas que existem em uma etapa anterior, mas não na etapa mais recente, não são alteradas.
• Atualizar ausentes: ignorado, exceto os valores não presentes nas tarefas de importação anteriores, que são adicionados. Isso se aplica a colunas perdidas, não a células vazias.
• Ignorar: ignorado.

Política de mesclagem de associações

Isso especifica o algoritmo usado para mesclar os dados recuperados de diferentes fontes de importação que estão se referindo à mesma entidade (usuário, grupo ou filtro). Isso é aplicado a campos que estão mapeando uma associação para outra entidade (filtros, funções e grupos de usuários e campos de filtro).

Os valores aceitos são Sobrescrever, Mesclar e Ignorar. A lista de entidades recuperadas de etapas de importação anteriores é:

• Sobrescrever: removido e substituído pela importação mais recente. Colunas que existem em uma etapa anterior, mas não na etapa mais recente, não são alteradas.
• Mesclar: mesclado.
• Ignorar: ignorado.

Atribuindo direitos de importação a uma função de segurança

Para importar usuários, faça logon no Console da Web do Qlik NPrinting como usuário com direitos para a Tarefa de importação em pelo menos uma função de segurança. Os usuários com a função Administrator possuem direitos para a Tarefa de importação. Se você aplicar a função Administrator a um usuário, ele também terá todos os outros privilégios administrativos.

Você também pode atribuir direitos de importação a uma função de segurança, sem conceder outra autoridade administrativa.

Faça o seguinte:

1. Faça logon no Console da Web do Qlik NPrinting como um usuário com a função de segurança Administrator.
2. No menu principal do Qlik NPrinting, clique no menu suspenso Admin.
3. Clique em Funções de segurança.
4. Clique na função à qual você deseja conceder direitos para a Tarefa de importação.
5. Clique na guia Aplicativos.
6. Role para as caixas de seleção de direitos para a Tarefa de importação.
7. Marque a caixa de seleção à esquerda de Tarefa de importação para atribuir todos os direitos da tarefa de importação para a função.

   Também é possível selecionar apenas direitos específicos, marcando as caixas de seleção apropriadas.

8. Clique em Salvar.

Criando uma tarefa de importação

Faça o seguinte:

1. No menu principal do Qlik NPrinting, selecione Tarefas e, em seguida, Tarefa de importação.
2. Clique em Criar tarefa de importação.

3. Insira o Nome da tarefa. Por exemplo: Import Users.

4. Verifique se a caixa de seleção Habilitado está marcada. Caso contrário, sua tarefa será ignorada pelo Qlik NPrinting Engine.
5. Em Fontes, clique em Adicionar origem. No menu suspenso, selecione Importar do Excel ou Importar do LDAP.
6. Os próximos passos dependerão do tipo de origem:

   1. Excel: Adicione o Caminho do arquivo de importação (no servidor) do Qlik NPrinting Server em que o arquivo Excel é salvo.

      Por exemplo: C:\ProgramData\NPrinting\Imports\NP_Web_Imports.xlsx. Esse não é o caminho do arquivo no computador local.

      Você também pode usar um caminho de rede de computador remoto. O usuário do Windows que executa o Serviço de Agendador do Qlik NPrinting deve ter acesso à pasta remota do Qlik NPrinting Server. Consulte: Importar sintaxe em documentos do Excel.

   2. LDAP: Adicione o Caminho de conexão da origem do LDAP.

      Você pode preencher os outros campos conforme necessário. Consulte: Sintaxe de importação em fontes do LDAP.

7. Verifique se a caixa de seleção Habilitado está marcada. Caso contrário, sua origem será ignorada pelo Qlik NPrinting Engine.
8. Clique em Adicionar origem para adicionar outra origem.
9. Clique em , à direita, para excluir uma origem. Clique em para duplicá-la.
10. Em Configurações, marque as caixas de seleção que especificam como você deseja lidar com conflitos de mesclagem:
    • Criar usuários, se inexistentes
    • Atualizar usuários, se modificados

    • Remover usuários que não estão presentes nas fontes de importação mais recentes

      Somente usuários adicionados em uma execução anterior da mesma importação serão removidos. Outros usuários, como aqueles adicionados manualmente, não serão removidos.

    • Substituir associações de usuário existentes (filtros, funções e grupos)

      As associações de usuário existentes serão removidas se não estiverem presentes no arquivo de importação. Elas serão substituídas por associações em novos arquivos.

    • Remover grupos que não estão presentes nas fontes de importação mais recentes

      Somente grupos adicionados em uma execução anterior da mesma importação serão removidos. Outros grupos, como aqueles adicionados manualmente, não serão removidos.

    • Criar filtros se inexistentes
    • Atualizar filtros se modificados

    • Remover filtros que não estão presentes nas fontes de importação mais recentes

      Somente filtros adicionados em uma execução anterior da mesma importação serão removidos. Outros filtros, como aqueles adicionados manualmente, não serão removidos.

    • Substituir campos de filtro existentes

      Os campos de filtro existentes serão removidos se não estiverem presentes no arquivo de importação. Eles serão substituídos por campos de filtro do arquivo de importação.

11. Em Notificações, você pode selecionar Enviar notificações de tarefa. Um e-mail será enviado para os endereços especificados em Configurações > Tarefas. Consulte: Notificações de execução de tarefa (somente em inglês).
12. Clique em Criar.

Executando a tarefa de importação

Verificando o status da tarefa

Na página principal Importar filtros e tarefa de destinatários, você pode ver o status de suas tarefas de importação.

• Última execução: mostra a data e hora da última execução.
• Status da última execução: se uma tarefa tiver sido executada com sucesso, ela será mostrada como Concluída. Caso contrário, ela será mostrada como Falha.
• Progresso da última execução: mostra até onde uma tarefa ativa progrediu.

• Log da última importação: clique no link Download para ver os logs mais recentes associados à tarefa.

  Se ocorrer um erro durante a importação, o arquivo de log mostrará a mensagem de erro no local atual do computador em que a importação foi executada. A importação para todos os usuários será pausada no primeiro erro, e toda a importação será revertida. O download do arquivo de log contém uma linha de log para cada ação de importação. Os logs de execução de tarefas contêm apenas os logs principais, como erros e informações de progresso.

• Habilitado: se esta caixa de seleção não estiver marcada, sua tarefa será ignorada pelo Qlik NPrinting Engine.
• Ações: Clique no para editar, excluir, executar ou testar a tarefa.

Verifique os usuários importados na página Usuários para ver os usuários recém-criados. Você pode verificar se os filtros associados foram criados abrindo a tab Filtros.