MyQ X Server
10.3 10.2 Print Server Central Server English French German Italian Portuguese Spanish
10.3 10.2 Print Server Central Server English French German Italian Portuguese Spanish

Sincronizar usuários a partir de CSV

O MyQ X pode importar e sincronizar usuários a partir de um arquivo CSV.

Orientações sobre quando utilizar esta fonte são fornecidas no Guia de Implantação. Consulte User Synchronization.


Pré-requisitos

  • Um arquivo CSV acessível a partir do servidor MyQ, formatado de acordo com a sintaxe descrita neste artigo.

  • Caso a autenticação dos usuários seja feita por meio de um servidor externo, em vez do banco de dados do MyQ, é necessário um servidor de autenticação LDAP ou RADIUS configurado no MyQ em MyQ > Configurações > Servidores de autenticação.


Considerações importantes

O CSV não é um diretório ativo. Ao contrário da sincronização LDAP ou Entra ID, a sincronização CSV reflete apenas o conteúdo do arquivo no momento em que a sincronização é executada. Se usuários forem adicionados ou removidos da organização, o arquivo CSV deverá ser atualizado manualmente antes da próxima sincronização.

A ordem das colunas só é relevante quando não há linha de cabeçalho. Por padrão, o MyQ lê os nomes das colunas a partir da primeira linha do CSV e os mapeia independentemente da ordem. Se a opção Sem linha de cabeçalho estiver ativada, as colunas serão mapeadas de acordo com sua posição no arquivo, na ordem listada na tabela “Sintaxe do arquivo CSV” abaixo.

Um arquivo CSV de exemplo está disponível em C:\ProgramData\MyQ\Data\Import\Users_example.csv. Preencha-o com seus dados e importe-o diretamente, ou utilize-o como referência de formatação.


Crie uma fonte de sincronização CSV

users-settings-sync-csv.png


  1. Acesse MyQ > Configurações > Sincronização de usuários e clique em +Adicionar.

  2. Selecione Adicionar fonte CSV. O painel de propriedades de sincronização CSV será aberto.

  3. Defina o caminho para o arquivo CSV no campo Arquivo CSV e configure as opções de sincronização.

  4. Clique em Salvar.


Opções de configuração

Configuração

Descrição

Ativado

Ative ou desative esta fonte de sincronização.

Arquivo CSV

Caminho para o arquivo CSV no servidor MyQ. Utilize %app% como parâmetro para o diretório do aplicativo MyQ; por exemplo, %app%\Data\Import\Users.csv.

Codificação

Codificação de caracteres do arquivo CSV. O valor padrão depende das configurações do sistema operacional do computador no qual você acessa a Interface Web do MyQ.

Delimitador de coluna no CSV

Delimitador utilizado no arquivo CSV. Se definido como Padrão, o MyQ utiliza o delimitador configurado na guia Configurações gerais.

Sem linha de cabeçalho

Quando desativada (padrão), a primeira linha é interpretada como uma linha de cabeçalho e as colunas são mapeadas por nome. Quando ativada, o CSV não deve conter nenhuma linha de cabeçalho e as colunas são mapeadas por posição.

Importar grupos sob este grupo

Coloca todos os grupos importados como filhos de um grupo existente do MyQ.

Fonte de sincronização

Atribui um nome de fonte personalizado aos usuários importados deste arquivo. Útil ao utilizar CSV para atualizar usuários originalmente importados de uma fonte LDAP – defina-o para corresponder ao nome da fonte LDAP ou ative a opção “Ignorar fonte de sincronização”.

Ignorar fonte de sincronização

Quando ativada, esta fonte considera todos os usuários no MyQ, independentemente da fonte que os importou. Quando desativada, a fonte atualiza apenas os usuários que importou originalmente.

Usar servidor de autenticação

Autentica os usuários importados por meio de um servidor LDAP ou RADIUS, em vez do banco de dados do MyQ.

Servidor de autenticação

O servidor LDAP ou RADIUS a ser utilizado para autenticação quando a opção “Usar servidor de autenticação” estiver ativada.

Desativar usuários ausentes

Desativa os usuários importados desta fonte que não constam mais no arquivo CSV. Combine com a opção “Ignorar fonte de sincronização” para desativar também usuários de outras fontes.

Adicionar novos usuários

Importa novos usuários do arquivo CSV. Se desativada, apenas as contas MyQ existentes serão atualizadas.

Emparelhar usuários por número pessoal

Emparelha usuários por número pessoal, em vez de nome de usuário, durante a ressincronização. Útil ao atualizar usuários cujos nomes de usuário serão alterados – por exemplo, durante uma migração do AD para o Entra ID.

Converter nome de usuário para letras minúsculas

Evita a criação de contas duplicadas causadas por diferenças de maiúsculas e minúsculas nos nomes de usuário.

Cartões

Modo de sincronização para valores de cartões: Não sincronizar, Sincronização completa, Sincronizar se não estiver vazio (padrão) ou Adicionar novo.

PIN

Modo de sincronização para valores de PIN: as mesmas opções dos Cartões.

Grupos

Modo de sincronização para associações a grupos: as mesmas opções dos Cartões.

Delegados

Modo de sincronização para atribuições de delegados: as mesmas opções dos Cartões.


Sintaxe do arquivo CSV

Os nomes das colunas diferenciam maiúsculas de minúsculas. As colunas podem aparecer em qualquer ordem quando há uma linha de cabeçalho. Valores simples (palavras isoladas, números puros) podem ser escritos como estão; valores que contenham espaços, vírgulas ou caracteres especiais devem ser colocados entre aspas duplas.

Coluna

Obrigatório

Descrição

FULLNAME

Sim

Nome completo do usuário. Coloque entre aspas duplas, por exemplo, "Thomas Pineapple".

USERNAME_ALIASES

Sim

Nome de login e apelidos opcionais. O nome de login deve corresponder ao nome de login do usuário no domínio. Separe os apelidos múltiplos por vírgulas, por exemplo, "Tom,Tommy,Apple".

EMAIL

Não

Endereço de e-mail principal do usuário, por exemplo, "t.pineapple@domain.com".

CARDS

Não

Número do cartão de identificação no formato lido pelo leitor de cartões, por exemplo, 7E9700C9.

GROUPS

Não

Grupo ou ramificação da árvore de grupos. Separe os níveis com barras verticais e grupos múltiplos com vírgulas, por exemplo, `"Atividades

CODE

Não

Número pessoal. Deve ser único para cada usuário. Utilizado para emparelhar usuários entre fontes de sincronização.

SCANSTORAGE

Não

Caminho da pasta ou endereço de e-mail para entrega da digitalização, por exemplo, "\\Users\Tommy".

PIN

Não

Um ou mais PINs. Devem estar no formato MD5 com hash, por exemplo, 14BFA6BB14875E4.

MANAGED_GROUPS

Não

Grupos gerenciados pelo usuário. Utilize a mesma sintaxe de caminho que GROUPS. Por exemplo, `"Activities

AUTHSERVER

Não

Domínio para autenticação do usuário, por exemplo, "testAD.local".

PHONE

Não

Número de telefone do usuário, por exemplo, 080008020.

LANG

Não

Abreviação do idioma padrão, por exemplo, en.

PWD

Não

Senha do MyQ no formato MD5 com hash, por exemplo, 18BFA6BB14875E8. Deixe em branco caso utilize um servidor de autenticação externo.

EXTID

Não

Parâmetro interno do MyQ. Deve ser deixado em branco.

DELEGATES

Não

Delegados que podem imprimir em nome deste usuário. Separe vários delegados com vírgulas, por exemplo, "Carol,Kohei,Eliot".

ALTERNATEEMAILS

Não

Lista separada por vírgulas de endereços de e-mail alternativos.

DEPARTMENT

Não

Departamento do usuário, por exemplo, Marketing.

CUSTOM1

Não

Campo personalizado 1 do perfil do usuário.

CUSTOM2

Não

Campo personalizado 2 do perfil do usuário.

CUSTOM3

Não

Campo personalizado 3 do perfil do usuário.

Exemplo de CSV:

"FULLNAME";"USERNAME_ALIASES";"EMAIL";"CARDS";"GROUPS";"CODE";"SCANSTORAGE";"PIN";"MANAGED_GROUPS";"AUTHSERVER";"PHONE";"LANG";"PWD";"EXTID";"DELEGATES"
"Thomas Pineapple";"Tom,Tommy,Apple";"t.pineapple@domain.com";7E9700C9;"Activities|Outdoor|Swimming,Activities|Outdoor|Birdwatching";22212;"\\Users\Tomy";14BFA6BB14875E4;Birdwatching;testAD.local;080008020;en;18BFA6BB14875E8;;"Carol,Kohei,Eliot"

Executar e agendar a sincronização

Para executar a sincronização imediatamente, acesse MyQ > Configurações > Sincronização de usuários, selecione a fonte e clique em Sincronizar agora. Se configurado corretamente, os usuários e grupos sincronizados aparecerão em MyQ > Usuários.

Para sincronizar automaticamente de acordo com uma programação, acesse MyQ > Configurações > Agendador de Tarefas e configure a tarefa “Sincronização de Usuários”.