# Importar usuários automaticamente

Agora você pode automatizar o processo de importação de usuários por CSV alterando uma entrada na tabela **globalconfig**. Esse recurso ajuda a atualizar o repositório de usuários regularmente.

## Etapa 1: Habilitar CSVUserImportSchedule

A importação automática de usuários pode ser habilitada somente se a entrada **CSVUserImportSchedule** estiver definida como *true* na tabela **globalconfig**. Isso permite que um agendador [se conecte a um servidor de banco de dados](https://www.manageengine.com/br/service-desk/help/adminguide/introduction/setting_up_database.html) e atualize os detalhes.

Execute a consulta abaixo para verificar se a entrada da tabela globalconfig com a categoria **CSVUserImportSchedule** está definida como *true* ou *false*.

```sql
select * from globalconfig where category like 'CSVUserImportSchedule';
```

![Uma ilustração da verificação da entrada da tabela globalconfig no terminal do Windows](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2021_08_27_07_41_071.png)

Por padrão, o CSVUserImportSchedule é definido como *false*. Você pode habilitar o agendador executando a consulta abaixo:

```sql
update globalconfig set paramvalue=true where category like 'csvuserimportschedule';
```

Você também pode verificar o status da entrada **CSVUserImportSchedule** executando a consulta abaixo no ServiceDesk Plus em **Relatórios >> Novo relatório de consulta**.

```sql
select * from globalconfig where category like 'CSVUserImportSchedule';
```

Um relatório será gerado, no qual a entrada **CSVUserImportSchedule** será refletida na coluna **paramvalue**. No entanto, você não pode modificar a tabela globalconfig pela interface do aplicativo.

![Relatório refletindo o valor de CSVUserImportSchedule](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2021_08_27_07_41_072.png)

Reinicie o aplicativo para que a configuração tenha efeito.

## Etapa 2: Mapear campos

Certifique-se de que os dados do usuário sejam atualizados em um arquivo requesters.csv para que a automação funcione com eficiência. Você pode encontrar o arquivo requesters.csv em **[SDP-Home]**. Você também pode atualizar os dados do usuário em outros arquivos CSV fornecidos, se tiver mapeado o arquivo conforme explicado abaixo:

1. Configure o nome e o caminho do arquivo CSV em que os dados do usuário são atualizados em um arquivo ScheduledCSVUserImportMapping.xml. O arquivo ScheduledCSVUserImportMapping.xml está presente no diretório **[SDP-HOME\conf]**.
2. Mapeie manualmente os campos do arquivo CSV para os campos do usuário adicionando AppFieldName e CsvFieldName ao código a seguir.

```xml
<USERFIELDMAPPING AppFieldName="{nome-do-campo-SDP}" CsvFieldName="{nome-do-campo-CSV}"/>
```

Use a captura de tela a seguir como referência:

![Mapeamento de campos no arquivo ScheduledCSVUserImportMapping.xml](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2021_08_27_07_41_073.png)

Certifique-se de que o formato de data seja semelhante para todos os campos de data tanto no arquivo CSV quanto no arquivo ScheduledCSVUserImportMapping.xml.

## Etapa 3: Atualizar o horário agendado da importação

A importação automática pode ser agendada depois que a entrada CSVUserImportSchedule for habilitada na tabela globalconfig. Você pode configurar a hora de início da importação usando a seguinte consulta:

```sql
update task_input set schedule_time='yyyy-mm-dd hh:mm:ss' where schedule_id in (select schedule_id from schedule where schedule_name like 'csvuserimportschedule');
```

Por exemplo, se você deseja atualizar o horário agendado da importação para 20 de agosto de 2040, 18:00:44 horas, a consulta será:

```sql
update task_input set schedule_time='2040-08-20 18:00:44' where schedule_id in (select schedule_id from schedule where schedule_name like 'csvuserimportschedule');
```

Reinicie o aplicativo após atualizar o horário agendado da importação.

## Etapa 4: Configurar a frequência de importação

Por padrão, a importação automatizada é agendada uma vez a cada 24 horas. Você pode atualizar a frequência de importação usando a seguinte consulta:

```sql
update periodic set time_period=6 where schedule_id in (select schedule_id from schedule where schedule_name like 'csvuserimportschedule');
```

Na consulta acima, informe a frequência em horas substituindo `6` em `time_period=6` pelo número de horas que você deseja configurar como intervalo de tempo para a importação automatizada.

Você pode usar a seguinte consulta para visualizar o intervalo de tempo agendado para a importação automática.

```sql
select * from periodic where schedule_id in (select schedule_id from schedule where schedule_name like 'csvuserimportschedule');
```

O processo de importação será iniciado automaticamente no horário agendado e o arquivo CSV será renomeado para confirmar a conclusão do processo de importação. O nome do arquivo importado será atualizado com a data e o horário de execução para referência.

**Nomes de arquivos de exemplo:**

requesters_08_16_2021_18_00.csv  
requesters_08_17_2021_18_00.csv

A seguir está uma captura de tela de um visualizador de logs do sistema quando o arquivo de importação está ausente no local configurado.

![Visualizador de logs do sistema mostrando ausência do arquivo de importação](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/image.png)