Configuração
A configuração das regras de validação do nome de arquivo e as ações executadas pelo STCPRen podem ser criadas com o auxílio do programa STCPRenCfg.EXE ou de um editor de texto, por exemplo, NOTEPAD.EXE.
Nesta seção veremos como utilizar o programa STCPRenCfg.EXE para criar ou editar o arquivo de configuração de regras.
Adicionar ou criar um arquivo de configuração de regras
Acesse a pasta de instalação do STCPRen e execute o programa STCPRenCfg.exe.
Clique no botão Adicionar para selecionar o arquivo de configuração ou criar um novo.
Clique no botão indicado para localizar o arquivo.
Para criar um novo arquivo, digite um novo nome e clique no botão Abrir.
Clique no botão OK para adicionar ou criar o arquivo de configuração de regras.
Caso o arquivo de configuração não exista, uma janela de aviso será apresentada, clique no botão Sim para confirmar.
Alterar os parâmetros de configuração do arquivo de regras
Selecione o arquivo de configuração desejado e clique no botão Propriedades.
Na guia Geral, configure os parâmetros desejados.
| Parâmetro | Descrição |
|---|---|
| ScanDir | Define o nome do diretório para varredura. Obs.: Este parâmetro será utilizado somente se a opção –scan for definida na linha de comando do STCPRen. |
| ScanDirRegEx | Define uma expressão regular para validar os subdiretórios que serão processados na varredura. |
| ScanDirRegExNeg | Define uma expressão regular para validar os diretórios que não serão excluídos da varredura. |
| ScanLockSem | Define um nome de semáfora para sincronização do modo de varredura. Obs.: Utilizado para sincronizar a execução de múltiplos processos do STCPREN. Válido somente com o uso da opção -scan. |
| ScanLockSemTimeout | Intervalo entre as execuções das instâncias do STCPRen. |
| ScanLockSemOptions | Executa uma instância por vez. |
| ScanFirstRule | Define a primeira regra de validação do nome do arquivo a ser executada. |
| ScanSubDir | Define se os subdiretórios serão verificados. 0 = Não 1 = Sim |
| ScanCheckFileInUse | Habilita/desabilita a verificação se o arquivo está em uso. 0 = Não 1 = Sim |
| MaxRetries | Define o número de tentativas a serem realizadas antes de abandonar a operação (cópia, criação de diretório e apagar). |
| DelayRetry | Define o tempo de espera (em milisegundos) antes de realizar uma nova tentativa de operação (cópia, criação de diretório e apagar). |
| LogErrorOption | Define a opção de registro dos eventos de falha na localização de um diretório ou arquivo. 0 = Não registra 1 = Registra se o arquivo não existir 2 = Registra se o diretório não existir 3 = Registra se arquivo ou diretório não existirem |
Na guia Acesso, é possível configurar os parâmetros para utilização de um compartilhamento de rede.
| Parâmetro | Descrição |
|---|---|
| LocalName | Define o nome do recurso local (não é obrigatório). |
| RemoteName | Define o nome do recurso de rede para ter acesso. |
| UserName | Define o nome do usuário para acesso ao recurso. |
| UserPswd | Define a senha do usuário para acesso ao recurso. |
| Confirmar | Confirma a senha digitada anteriormente. |
Na guia Log, é possível configurar os parâmetros para gravação dos registros de eventos de execução do STCPRen.
| Parâmetro | Descrição |
|---|---|
| LogIni | Define o nome do arquivo contendo as diretivas de log. |
| LogLevelOnSucess | Define o nível de log dos eventos de sucesso da aplicação. |
| LogLevelOnInfo | Define o nível de log dos eventos de informação da aplicação. |
| LogLevelOnWarning | Define o nível de log dos eventos de alerta da aplicação. |
| LogLevelOnError | Define o nível de log dos eventos de erro da aplicação. |
| MessageFile | Define o diretório para criação do arquivo de mensagem geral. |
| MessageFileUser | Define o diretório para criação do arquivo de mensagem do usuário. |
| Verbose | Define o nível de informação a ser armazenada. |
| UserLog | Define se as mensagens serão geradas por usuário: 0 = Log geral 1 = Log por usuário |
Na guia Variáveis, você pode definir regras de substituição dos valores informados nas variáveis (–var0 à –var9) utilizados na linha de comando do STCPRen.
Clique no botão Adicionar para configurar uma nova regra de substituição dos valores de uma variável.
Configure os parâmetros da regra de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| $Var | Define a identificação da variável que será utilizada. Valor: 0 a 9. |
| Ocorrência | Define a sequência de execução da substituição. Valor: 0 a 999 |
| Descrição | Define o nome da regra de substituição. |
| RegExReplaceFrom | Define a expressão regular para selecionar o que será substituído. |
| RegExReplaceTo | Define o valor para substituição. |
| RegExReplaceOcorr | Define a quantidade de repetições da substituição: 0 = Todas |
Na guia Listas, você pode substituir as linhas do arquivo pelos valores das variáveis (-var0 à -var9) ou através de uma expressão regular criando regras de substituição.
O arquivo de lista pode conter nomes de diretórios ou arquivos que serão processados. As regras de substituição serão aplicadas às linhas do arquivo.
Clique no botão Adicionar para configurar uma nova regra de substituição através de uma variável.
Configure os parâmetros da regra de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução da substituição. Valor: 0 a 999 |
| Descrição | Define o nome da regra de substituição. |
| VarReplaceFileNamePosFrom | Modifica o novo nome do arquivo com parte do valor da variável (var0,var1, …, varn) a partir da posição de origem definida. |
| VarReplaceFileNamePosTo | Modifica o novo nome do arquivo com parte do valor da variável (var0,var1, …, varn) para a posição de destino definida. |
| VarReplaceFileNameLen | Modifica o novo nome do arquivo com parte do valor da variável (var0,var1, …, varn) com o tamanho definido. |
| VarReplaceFileNameValue | Define o valor da variável quando não for informado na linha de comando (-varn). |
Clique no botão Adicionar para configurar uma nova regra de substituição através de uma expressão regular.
Configure os parâmetros da regra de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução da substituição. Valor: 0 a 999 |
| Descrição | Define o nome da regra de substituição. |
| RegExReplaceFrom | Define a expressão regular para selecionar os dados que serão substituídos. |
| RegExReplaceTo | Define o valor para substituição. |
| RegExReplaceOcorr | Define a quantidade de repetições da substituição: 0 = Todas |
Criar e modificar as Regras de Validação dos nomes de arquivos
Na guia Regras de Validação, clique no botão Adicionar para criar uma nova regra ou selecione uma regra e clique no botão Propriedades para modificá-la.
Clique no botão Adicionar para criar uma nova regra.
Configure a identificação da regra e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Regra | Define o número da regra (ordem de execução). |
| Nome | Define o nome da regra. |
Selecione uma regra e clique no botão Ordenar regras.
Nesta tela, selecione o intervalo de ordenação das regras:
Selecione uma regra e clique no botão Propriedades para modificar os seus parâmetros.
Para mudar o número da regra (ordem de execução), selecione-a e pressione um dos botões abaixo:
Na guia Geral, configure os parâmetros de identificação da regra, validação do arquivo e outros:
| Parâmetro | Descrição |
|---|---|
| Regra | Define o número da regra (ordem de execução). |
| Nome | Define o nome da regra. |
| DirRegEx | Define a expressão regular para validar o nome do diretório. |
| FileRegEx | Define a expressão regular para validar o nome do arquivo. |
| SrcRegEx | Define a expressão regular para validar o nome do usuário de origem (opção –src da linha de comando). |
| ContentRegEx | Habilita a validação do arquivo através de seu conteúdo. |
| Description | Define a descrição da regra. |
| ExecProgBefore | Define o nome do programa ou batch que deve ser executado antes de processar o arquivo. |
| ExecProgAfter | Define o nome do programa ou batch que deve ser executado após processar o arquivo. |
| ExecProgError | Define o nome do programa ou batch que deve ser executado quando ocorrer um erro. |
| DestinationUser | Nome do usuário/módulo de destino do STCP OFTP (opcional). |
| SourceUser | Nome do usuário/módulo de origem do STCP OFTP (opcional). |
| NextSection | Define a próxima seção de processamento a ser executada para esta regra. O nome do arquivo para processamento é o mesmo do início da regra. |
| RemoveAfterCopy | Ativa ou inibe a remoção do arquivo: Não = Não remove o arquivo Sim = Remove o arquivo |
| RemoveAfterHours | Remove o arquivo somente se o último acesso tiver ocorrido antes da quantidade de horas estabelecida neste parâmetro: 0 = Remove imediatamente 0 = Remove após a quantidade de horas especificada. |
| Overwrite | Ativa ou inibe a sobreposição do arquivo: Não = Não sobrepõe Sim = Sobrepõe Obs: Veja a opção de CopyFileOption e BackupFileOption para habilitar a sobreposição em cada operação individualmente. |
| ProcessAfterSeconds | Processa o arquivo somente se o último acesso tiver ocorrido após a quantidade de segundos estabelecida neste parâmetro. |
Na guia Renomeio de Arquivo I, configure os parâmetros que serão utilizados na definição do Novo Nome do Arquivo.
| Parâmetro | Descrição |
|---|---|
| RenameFileTo | Define o novo nome para o arquivo. Obs.: Se este parâmetro não for definido, o nome original será utilizado. |
| InsertTimestamp | Define a utilização do timestamp na nova nomenclatura: 0 = Não insere 1 = Insere no final do nome do arquivo 2 = Insere no início do nome do arquivo 4 = Insere customizado (através das opções de substituição)  |
| InsertTimestampPart | Define o tipo de timestamp a ser utilizado pela opção InsertTimestamp: 0 = Data e hora do sistema (computador local) 1 = Data e hora da criação do arquivo 2 = Data e hora da última modificação do arquivo 4 = Data e hora do último acesso ao arquivo  |
Na guia Renomeio de Arquivo I, clique em Adicionar e configure as regras de renomeio do Novo Nome do Arquivo com as opções de Substituição através do nome original.
Configure as opções de substituição através do nome original do arquivo e do diretório, variáveis, número de sequência, timestamp e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução da substituição. Valor: 0 a 999 |
| Descrição | Define a identificação da regra de renomeio. |
| ReplaceFileNamePosFrom | Modifica o novo nome do arquivo com parte do nome antigo a partir da posição de origem definida. |
| ReplaceFileNamePosTo | Modifica o novo nome do arquivo com parte do nome antigo para a posição de destino definida. |
| ReplaceFileNameLen | Modifica o novo nome do arquivo com parte do nome antigo com o tamanho definido. |
| ReplaceFileNameFromPathPosFrom | Modifica o novo nome do arquivo com parte do path do arquivo original a partir da posição de origem definida. |
| ReplaceFileNameFromPathPosTo | Modifica o novo nome do arquivo com parte do path do arquivo original para a posição de destino definida. |
| ReplaceFileNameFromPathLen | Modifica o nome do arquivo com parte do path do arquivo original com o tamanho definido. |
| VarReplaceFileNamePosFrom | Modifica o novo nome do arquivo com parte do valor da variável (var0,var1, …, varn) a partir da posição de origem definida. |
| VarReplaceFileNamePosTo | Modifica o novo nome do arquivo com parte do valor da variável (var0,var1, …, varn) para a posição de destino definida. |
| VarReplaceFileNameLen | Modifica o novo nome do arquivo com parte do valor da variável (var0,var1, …, varn) com o tamanho definido. |
| VarReplaceFileNameValue | Define o valor da variável quando não for informado na linha de comando (-varn). |
| InsertSeqNumberTo | Insere um número de sequência no novo nome a partir da posição de destino definida. |
| InsertSeqNumberLen | Insere um número de sequência no novo nome com o tamanho definido. |
| InsertSeqNumberMIn | Número de sequência inicial. |
| InsertSeqNumberMax | Número de sequência final. |
| InsertSeqNumberSeq | Número de sequência atual. |
| InsertTimestampPosFrom | Modifica o novo nome com parte do Timestamp a partir da posição de origem definida. |
| InsertTimestampPosTo | Modifica o novo nome com parte do Timestamp para a posição de destino definida. |
| InsertTimestampLen | Modifica o novo nome com parte do Timestamp com o tamanho. |
Na guia Renomeio de Arquivo II, configure as regras de renomeio do Novo Nome do Arquivo através do conteúdo do arquivo original ou de uma expressão regular:
| Parâmetro | Descrição |
|---|---|
| ReplaceFromFileOption | Habilita/Desabilita a utilização do conteúdo do arquivo original para fazer o renomeio. |
Clique em Adicionar para configurar as regras de Substituição através do conteúdo do arquivo original que serão aplicadas no Novo Nome do Arquivo:
Configure os parâmetros de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução. Valor: 0 a 999 |
| Descrição | Define a identificação da regra. |
| ReplaceFromFileRegEx | Define uma expressão regular para validar a linha que contém a informação que deverá ser utilizada na substituição. |
| ReplaceFromFilePosFrom | Define a coluna inicial da linha selecionada. |
| ReplaceFromFilePosTo | Define a posição inicial do novo nome para onde serão copiados. |
| RepalceFromFileLen | Quantidade de caracteres que serão copiados a partir da coluna inicial. |
Clique em Adicionar para configurar as regras de Substituição através de uma expressão regular que serão aplicadas no Novo Nome do Arquivo:
Configure os parâmetros de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução. Valor: 0 a 999 |
| Descrição | Define a identificação da regra. |
| RegExReplaceFrom | Define uma expressão regular para selecionar os dados que deverão ser . |
| RegExReplaceTo | Define o valor para substituição. |
| RegExReplaceOcorr | Define a quantidade de repetições da substituição: 0 = Todas |
Na guia Cópia, configure os parâmetros que serão utilizados na definição do Novo Nome do Diretório para onde será copiado o arquivo original.
| Parâmetro | Descrição |
|---|---|
| CopyToDir | Define o nome do diretório de destino para onde deverá ser copiado o arquivo. |
| CopyFileOption | Define as opções de cópia que deverão ser utilizadas. |
| CopyTempExtension | Define uma extensão temporária para o arquivo enquanto o processo de cópia não é finalizado. |
Clique em Adicionar para configurar as regras de Substituição através do nome original que serão aplicadas no Novo Nome do Diretório.
Configure os parâmetros de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução. Valor: 0 a 999 |
| Descrição | Define a identificação da regra. |
| CopyPathReplacePosFrom | Modifica o nome do path da cópia com parte do path original a partir da posição de origem definida. |
| CopyPathReplacePosTo | Modifica o nome do path da cópia com parte do path original para a posição de destino definida. |
| CopyPathReplaceLen | Modifica o nome do path da cópia com parte do path original com o tamanho definido. |
| CopyPathVarReplacePosFrom | Modifica o nome do path da cópia com parte da variável a partir da posição de origem definida. |
| CopyPathVarReplacePosTo | Modifica o nome do path da cópia com parte da variável para a posição de destino definida. |
| CopyPathVarReplaceLen | Modifica o nome do path da cópia com parte da variável com o tamanho definido. |
| CopyPathVarReplaceValue | Define o valor variável. |
| CopyPathReplaceFFNPosFrom | Modifica o nome do path da cópia com parte do nome original do arquivo (FFN) a partir da posição de origem definida. |
| CopyPathReplaceFFNPosTo | Modifica o nome do path da cópia com parte do nome original do arquivo (FFN) para a posição de destino definida. |
| CopyPathReplaceFFNLen | Modifica o nome do path da cópia com parte do nome original do arquivo (FFN) com o tamanho definido. |
| CopyPathInsertTMPPosFrom | Modifica o nome do path da cópia com o timestamp (TMP) a partir da posição de origem definida. |
| CopyPathInsertTMPPosTo | Modifica o nome do path da cópia com o timestamp (TMP) a partir da posição de origem definida. |
| CopyPathInsertTMPLen | Modifica o nome do path da cópia com o timestamp (TMP) considerando o tamanho definido. |
Clique em Adicionar para configurar as regras de Substituição através de expressão regular que serão aplicadas no Novo Nome do Diretório.
Configure os parâmetros de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução. Valor: 0 a 999 |
| Descrição | Define a identificação da regra. |
| CopyPathRegExReplaceFrom | Define uma expressão regular para selecionar os dados que deverão ser . |
| CopyPathRegExReplaceTo | Define o valor para substituição. |
| CopyPathRegExReplaceOcorr | Define a quantidade de repetições da substituição: 0 = Todas |
Na guia Backup, configure os parâmetros que serão utilizados na definição do Novo Nome do Diretório, para onde será copiado o arquivo original:
| Parâmetro | Descrição |
|---|---|
| BkpToDir | Define o nome do diretório destino para onde deverá ser copiado o arquivo de backup. |
| BkpFileOption | Define as opções de backup que deverão ser utilizadas.
 |
Clique em Adicionar para configurar as regras de Substituição através do nome original que serão aplicadas no Novo Nome do Diretório de backup.
Configure os parâmetros de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de eventos. |
| Descrição | Identifica a regra de Backup. |
| BkpPathReplacePosFrom | Modifica o nome do path de backup com parte do path original a partir da posição de origem definida. |
| BkpPathReplacePosTo | Modifica o nome do path de backup com parte do path original para a posição de destino definida. |
| BkpPathReplaceLen | Modifica o nome do path de backup com parte do path original com o tamanho definido. |
| BkpPathReplaceVarReplacePosFrom | Modifica o nome do path de backup com parte da variável a partir da posição de origem definida. |
| BkpPathVarReplacePosTo | Modifica o nome do path de backup com parte da variável para a posição de destino definida. |
| BkpPathVarReplaceLen | Modifica o nome do path de backup com parte da variável com o tamanho definido. |
| BkpPathVarReplaceValue | Define o valor variável. |
| BkpPathReplaceFFNPosFrom | Modifica o nome do path de backup com parte do nome original do arquivo (FFN) a partir da posição de origem definida. |
| BkpPathFFNPosTo | Modifica o nome do path de backup com parte do nome original do arquivo (FFN) para a posição de destino definida. |
| BkpPathReplaceFFNLen | Modifica o nome do path de backup com parte do nome original do arquivo (FFN) com o tamanho definido. |
| BkpPathInsertTMPPosFrom | Modifica o nome do path de backup com o timestamp(TMP) a partir da posição de origem definida. |
| BkpPathInsertTMPPosTo | Modifica o nome do path de backup com o timestamp (TMP) a partir da posição de origem definida. |
| BkpPathInsertTMPLen | Modifica o nome do path da cópia com o timestamp (TMP) considerando o tamanho definido. |
Clique em Adicionar para configurar as regras de Substituição através de expressão regular que serão aplicadas no Novo Nome do Diretório de backup.
Configure os parâmetros de substituição e clique no botão OK para salvar.
| Parâmetro | Descrição |
|---|---|
| Ocorrência | Define a sequência de execução. Valor: 0 a 999 |
| Descrição | Define a identificação da regra. |
| BkpPathRegExReplaceFrom | Define uma expressão regular para selecionar os dados que deverão ser . |
| BkpPathRegExReplaceTo | Define o valor para substituição. |
| BkpPathRegExReplaceOcorr | Define a quantidade de repetições da substituição: 0 = Todas |
Na guia Avançadas, configure os parâmetros:
| Parâmetro | Descrição |
|---|---|
| CheckLockUnlockOption | Define as opções de criação/utilização do arquivo de sincronização de acesso ao arquivo que está sendo processado.
 |
| CheckLockUnlockFileName | Define o nome do arquivo de bloqueio/desbloqueio que deverá ser verificado. |
| CreateLockUnlockFileName | Define o nome do arquivo de bloqueio/desbloqueio que deverá ser criado. |
| Controle de tamanho de arquivos | Define o tamanho mínimo e máximo que o arquivo pode ter para ser processado pela regra. |
| Período de execução | Define o período (Início, Fim e Dias da Semana) em que uma regra deverá ser executada. |
| DelayNextFileProcess | Define o intervalo mínimo (em milisegundos) para processar o próximo arquivo na mesma regra. |
| ContentLinesToRead | Se o parâmetro ContentRegEx estiver setado esta opção valida o número de linhas que serão lidas do arquivo. |
| ResetSeqNumberDaily | Zera diariamente o número de sequência informado no parâmetro InsertSeqNumberSeq (Renomeio de Arquivo I). |