Todos os gatilhos começam com um sublinhado. Quando um importador automático tem mais de um gatilho, todos os gatilhos aparecem no nome do arquivo, por exemplo:
- Nome de arquivo com um único gatilho: filename_addnewcols.txt
- Nome de arquivo com dois gatilhos: filename_addnewcols_adjustfields.txt
- Add New Columns: _addnewcols_
- Adicione automaticamente novas colunas à tabela se elas aparecerem no arquivo. Colunas renomeadas serão tratadas como novas.
Exemplo: Use filename_addnewcols.txt.
- Adjust Columns: _adjustfields_
- Ajuste automaticamente tipos e comprimentos de dados, se necessário. Utiliza as opções _nopad_ para forçar a leitura do arquivo completo e determinar tipos e comprimentos de dados sem preenchimento.
Exemplo: Use filename_adjustfields.txt.
- Auto Adjust: _autoadjust_
- Combinação de _addnewcols_ e _adjustfields_.
Exemplo: Use filename_autoadjust.txt.
- Auto Commit: _autocommit_
- Não use transação para inserir. Use para aumentar a velocidade das grandes importações.
Exemplo: Use filename_autocommit.txt.
- _brgroupGUID_
- Execute o processo de dados identificado pelo GUID após a conclusão da importação do arquivo.
Exemplo: Use filename_brgroup123456789qwer.txt para executar o GUID 123456789qwer do processo de dados após a importação.
- Default Value: _dfltN[VAL123]_
- Defina VAL123 como valor padrão para a Coluna 'N'. Se o campo na coluna 'N' estiver vazio durante a importação, ele é preenchido com o valor que você definiu. Não use caracteres especiais no valor.
Exemplo: Use filename_dflt4[10].txt quando o valor padrão for 10 para a4ª coluna.
- Encoding: _encENCODING_
- Especifique a codificação de caracteres do arquivo. Por padrão, a codificação é UTF8. Gatilhos suportam os seguintes tipos de codificação:
- UTF16
- UTF16LE
- UTF16BE
- ISO8859
- WINDOWS1251
- WINDOWS1252
Exemplo: Use filename_encISO88591.txt para um arquivo com codificação de caracteres ISO-8859-1.
- _estGUID_
- Crie uma nova tabela dentro da pasta identificada pelo GUID para importar o arquivo. Se o arquivo for comprimido com múltiplos arquivos, uma tabela para cada arquivo é criada. Pode ser usado em conjunto com _nst[NEWFOLDER]_ para criar uma nova pasta em uma pasta existente.
Exemplo: Use filename_est1234456789qwer_nst[SampleData].zip para criar uma nova pasta chamada 'SampleData' dentro de uma pasta identificada por GUID 123456789qwer. Crie novas tabelas para cada arquivo no zip.
- Force Null: _frcnull_
- Forçar valores vazios a serem NULLs no banco de dados. O padrão é uma cadeia vazia.
Exemplo: Use filename_frcnull.txt.
- Texto da Força: _frctext_
- Forçar todos os campos a campos de texto.
- Include Empty Records: _incempty_
- Inclua registros vazios na importação. Por padrão, registros vazios são ignorados.
Exemplo: Use filename_incemptytxt.
- Insert Only New Records Based On: _insnewN_
- Insira novos registros usando a coluna 'N' como chave única. Pode usar vários.
Exemplo: Use filename_insnew5.txt para usar a coluna 5 dos arquivos como chave única para inserir novos registros.
- Minimum Text Field Length: _mrgcolN_
- Insira novos registros e atualize registros existentes usando a coluna 'N' como chave única.
Exemplo: Use filename_mrgcol3_mrgcol5.txt para usar as colunas 3 e 5 do arquivo como chave única para mesclar.
- Merge New Records Based On: _mstGUID_
- Mesture subarquivos de um arquivo comprimido em uma pasta.
- Se existir uma tabela na pasta, especificada pelo GUID, que tenha o mesmo nome do arquivo, ela será importada para essa tabela.
- Se uma tabela não existir na pasta, ela criará uma nova tabela usando o nome do arquivo.
- Se não houver GUID, ele usará a pasta da tabela especificada.
Exemplo: Use fileName_mst.zip para procurar na pasta os nomes das tabelas que correspondem aos nomes dos arquivos no arquivo zip. Importe para as tabelas que combinam, ou crie novas tabelas para as que não combinam.
Exemplo: Use filename_mst1234567890qwer.zip para buscar na pasta identificada por GUID 1234567890qwer nomes de tabelas que correspondam aos nomes dos arquivos no arquivo zip. Importe para as tabelas que combinam, ou crie novas tabelas para as que não combinam.
- _mtlN_
- Forçar todos os campos de texto recém-criados a terem um comprimento mínimo de 'N'.
Exemplo: Use filename_mtl150.txt para criar campos de texto a partir dessa importação que tenham comprimento mínimo de 150.
- No Padding: _nopad_
- Combinação de _nopadtxt_ e _nopadnum_.
Exemplo: Use filename_nopad.txt.
- No Padding (Number): _nopadnum_
- Não adicione preenchimento aos campos numéricos recém-criados. O force lê o arquivo completo para determinar tipos e comprimentos de dados sem preenchimento.
O preenchimento adiciona 2 dígitos à esquerda do decimal. Normalmente, o acolchoamento não é adicionado à direita, a menos que:
- Dígitos à direita do decimal e o valor não é moeda, então o preenchimento é adicionado 1 dígito à direita.
- O valor é moeda e inclui mais de 2 dígitos à direita, depois o preenchimento é adicionado 1 dígito à direita.
Exemplo: Use filename_nopadnum.txt.
- No Padding (Text): _nopadtxt_
- Não adicione preenchimento aos campos de texto recém-criados. O force lê o arquivo completo para determinar tipos e comprimentos de dados sem preenchimento. O preenchimento padrão é o comprimento + 25%, arredondado para um caractere completo.
Exemplo: Use filename_nopadtxt.txt.
- Merge Compressed File Into Folder: _nst[FOLDERNAME]_
- Crie uma nova pasta, chamada 'FOLDERNAME', que conterá uma nova tabela para importar o arquivo. Se o arquivo for comprimido com múltiplos arquivos, uma tabela para cada arquivo é criada. Deve ser um valor simples para uso no disparador de nome de arquivo, sem caracteres especiais.
Exemplo: Use filename_nst[NewFolder].zip para criar uma nova pasta chamada 'NewFolder' no nível raiz e crie uma tabela para cada arquivo no zip.
- Pre Data Process: _prebrgroupGUID_
- Execute o processo de dados identificado pelo GUID antes que a importação de arquivo comece.
Exemplo: Use filename_prebrgroup123456789qwer.txt para executar o processo de dados GUID 123456789qwer antes da importação.
- _rtrnid_
- Retorne os identificadores do sistema para cada linha inserida. Para uso da API.
Exemplo: Use filename_rtrnid.txt.
- Run Custom Fields: _runcftrue_
- Execute campos personalizados ao inserir. O padrão está definido como desligado.
Ao fazer upload via Fix View ou Formulários, _runcftrue_ está ativado por padrão.
Exemplo: Use filename_runcftrue.txt.
- Worksheet to Import: _sheetN_
- Ao importar um arquivo Excel, importe a folha de cálculos número 'N'. Todas as folhas selecionadas são importadas para a tabela de destino padrão. Pode usar várias instâncias.
Observação
Também importará folhas ocultas.
Exemplo: Use filename_sheet3.xlsx para importar aterceira folha de um livro de exercícios.
- _sheetN[GUID]_
- Ao importar um arquivo Excel, importe a folha de cálculo número 'N' para a tabela especificada pelo GUID. Pode usar várias instâncias.
Exemplo: Use filename_sheet3_sheet5[123456789qwer].xlsx para importar a folha 3 de um livro de exercícios para a tabela selecionada e importar a folha 5 para a tabela com GUID 123456789qwer.
- Skip Columns: _skpcolN_
- Ignore a N-ésima coluna no arquivo.
Exemplo: Use filename_skpcol1.txt para pular a primeira coluna de um arquivo.
- Skip Rows: _skpNlns_
- Pule as primeiras linhas 'N' do arquivo.
Exemplo: Use filename_skp10lns.txt para pular as primeiras 10 linhas de um arquivo.
- _sysidN_
- Atualize registros existentes usando a coluna 'N' como identificador do sistema.
Exemplo: Use filename_sysid1.txt para usar a primeira coluna como identificador do sistema.
- Truncate Table: _trntrue_
- Trunque a tabela de destino antes de inserir novos registros.
Exemplo: Use filename_trntrue.txt.
