Criação de serviços de interface

O serviço de interface permite que o usuário importe ou exporte dados para uma tabela SCV de/para um arquivo CSV ou Excel. Este tópico descreve o processo de criação de um serviço de interface com Entidade de dados = Tabela SCV e Tipo de interface = CSV.

Para criar um serviço de interface:

  1. Selecione Configuração > Dados comuns > Serviços de interface > Serviços de interface.
  2. Clique em Novo. Uma janela Novo serviço de interface é exibida.
  3. Especifique as seguintes informações:
    Tipo de interface
    O tipo da interface. Selecione CSV.
    Entidade de dados
    A entidade de dados a ser mapeada para a interface. Selecione a tabela SCV.
    Nota: A caixa de seleção Coluna por medida será exibida se o campo Entidade de dados estiver definido como Valor do cenário.
    Direção da interface
    A direção do fluxo de dados. Possíveis valores:
    • Importar
    • Exportar
  4. Clique em OK. Uma nova página Serviços de interface é exibida.
  5. Especifique as seguintes informações na guia Detalhes da interface:
    Nome
    O nome específico do serviço de interface.
    Nome de exibição
    O nome exibido para o serviço de interface. Se não for especificado, o valor especificado no campo Nome será assumido como padrão.
    Sistema
    Indica o status do serviço de interface. Possíveis valores:
    • Ativado (habilitado)
    • Desativado (desabilitado)
    Nota: Essa opção é habilitada para a entidade definida pelo sistema.
    Tipo de interface
    O tipo da interface. Esse valor é assumido como padrão na janela Novo serviço de interface.
    Entidade de dados
    A entidade de dados a ser mapeada para a interface. Esse valor é assumido como padrão na janela Novo serviço de interface.
    Direção da interface
    A direção do fluxo de dados. Esse valor é assumido como padrão na janela Novo serviço de interface.
  6. Especifique as seguintes informações na guia Origem de dados:
    Origem de dados
    O nome da origem de dados (Arquivo, FTP ou Amazon S3) definido no SCP. A definição definida na origem de dados é usada ao executar o serviço de interface usando uma macro.
    Nota: Se você estiver importando ou exportando dados manualmente usando um serviço de interface de arquivo, procure o arquivo a ser usado no seu computador local.
    Usar padrão de nome de arquivo
    Um padrão ou expressão para definir o nome do arquivo. Isso dá suporte à importação de vários arquivos e classificação ou agrupamento de arquivos para importar a versão mais recente. O nome do arquivo com o padrão correspondente é importado.
    Nota: Essa opção será exibida somente se o campo Tipo de interface estiver definido como Importar.
    Arquivos
    O nome do arquivo a ser usado para o serviço de interface. Os arquivos exibidos são baseados na Origem de dados definida. Se os arquivos não forem exibidos, clique em mais (+) para adicionar o arquivo necessário.
    Nota: Se a opção Usar padrão de nome de arquivo estiver definida como Ativada, a etiqueta de campo será exibida como Padrão de nome de arquivo e a expressão regular poderá ser usada como nome de arquivo. Estas variáveis são aceitas com um sublinhado como separador entre as variáveis:
    • Qualquer caractere alfabético (A-Z)
    • Qualquer caractere alfanumérico (A-Z,0-9)
    • Qualquer caractere numérico
    Nomes do campo na linha de cabeçalho
    Indica o conteúdo da primeira linha do arquivo importado ou exportado. Se definido como Ativado, estes são os cenários possíveis:
    • Quando o arquivo é importado, a primeira linha do arquivo de importação contém etiquetas de campo e pode ser ignorada.
    • Quando o arquivo é exportado, a primeira linha do arquivo de exportação contém os cabeçalhos de campo.
  7. Selecione o nome da tabela SCV necessário na guia Tabela SCV. Os dados na guia Mapeamentos são exibidos com base na tabela SCV selecionada.
    Nota: 
    • Quando o arquivo é importado, todas as tabelas registradas em SZ_REG_TABLE com o campo table_area = Caixa de entrada ou %_Import estão listadas.
    • Quando o arquivo é exportado, todas as tabelas SCV e visualizações são listadas.
  8. Especifique as seguintes informações na guia Detalhes do arquivo:
    Delimitador de arquivo
    O tipo de delimitador de arquivo. Opções possíveis:
    • Vírgula
    • Guia
    • Barra vertical
    Nota: Por padrão, o valor é definido para Comma.
    Formato de número
    O formato de número dos valores a serem validados ao importar dados para campos numéricos no banco de dados SCV. Os valores numéricos são exportados com base no formato definido.
    Formato de data
    O formato de data dos valores a serem validados ao importar dados para os campos de data no banco de dados SCV. Os valores de data são exportados com base nesse formato definido.
    Nota: É necessário especificar o indicador Mês e o indicador Hora com letra maiúscula.
  9. Clique na guia Processamento de arquivo.
    Nota: Essa guia é exibida apenas se o campo Direção da interface estiver definido como Importar.
  10. Especifique as seguintes informações:
    Ordenar arquivos por
    A ordem (ascendente) em que os arquivos são organizados no diretório com base no valor especificado. Estas variáveis podem ser usadas:
    • %file_1 = A primeira variável no nome do arquivo
    • %file_2 = A segunda variável no nome do arquivo
    Nota: Essa opção será habilitada somente se a opção Usar padrão de nome de arquivo estiver definida como Ativada na guia Origem de dados.
    Importar arquivo mais recente
    Indica o padrão de importação do serviço de interface. Possíveis cenários:
    • Ativado: Importa o arquivo mais recente com base no carimbo de data/hora dos arquivos ou pelo valor especificado na opção Ordenar arquivos por.
    • Desativado: Importe todos os arquivos de uma ordem por Carimbo de data/hora (a data/hora do sistema quando o arquivo foi salvo) ou pelo valor especificado na opção Ordenar arquivos por.
    Nota: 
    • Essa opção será habilitada somente se a opção Usar padrão de nome de arquivo estiver definida como Ativada.
    • O carimbo de data/hora é baseado no SO de origem.
    Agrupar arquivos por
    Os critérios com base nos quais os arquivos são ordenados em um grupo. Os arquivos são ordenados em cada grupo com base no valor especificado na opção Ordenar arquivos por. Caso contrário, os arquivos serão ordenados pela última data e hora. O arquivo mais recente em cada grupo é importado.
    Nota: Essa opção será habilitada somente se a opção Usar padrão de nome de arquivo estiver definida como Ativada.
    Renomear arquivo após importação
    As variáveis com base nas quais os arquivos importados com êxito são renomeados. Estas variáveis são usadas para renomear:
    • %file = Nome do arquivo completo
    • %file_0 = nome de arquivo sem extensão

    Exemplos:

    • %file_save: TAR_MD_BOM_20170705060012.csv é renomeado para TAR_MD_BOM_20170705060012_save.csv.
    • %file_0_complete: O arquivo TAR_MD_BOM_20170705060012.csv é renomeado para TAR_MD_BOM_20170705060012_complete
  11. Especifique estas informações na guia Comportamento de importação:
    Limpar tabela de destino antes de importar
    Indica se a tabela de destino deve ser limpa de todas as linhas ou se os dados devem ser adicionados ao registro de saída antes da execução das linhas de interface e importação. Possíveis cenários:
    • Ativado: Excluir e inserir
    • Desativado: Anexar
    Limpar com base na coluna de origem/valor
    A condição com base na qual os registros são excluídos da tabela de destino. Possíveis cenários:
    • Se os valores não forem especificados nesse campo, todos os registros serão excluídos da tabela de destino.
    • Se especificado, somente os registros para os quais os valores especificados nos campos Coluna de origem e Valor forem os mesmos serão excluídos.
    Nota: Essas opções são habilitadas apenas se a opção Limpar tabela de destino antes de importar estiver definida como Ativada.
  12. Clique na guia Exportar filtro. Esta guia permite definir as condições para filtrar os dados na exportação.
  13. Especifique as seguintes informações:
    Coluna
    O nome da coluna da tabela SCV.
    Operador
    O operador usado para definir a condição de filtro. Possíveis valores:
    • É igual a
    • Não é igual a
    • Como
    • Não é igual a
    • É nulo
    • Não é nulo
    Valor
    O valor ao qual a condição de filtro é aplicável.
  14. Clique na guia Comportamento de exportação.
    Nota: Esta guia é exibida apenas se a direção da interface estiver definida como Importar.
  15. Especifique as seguintes informações:
    Anexar carimbo de data/hora ao nome do arquivo
    Indica se um Carimbo de data/hora deve ser adicionado ao nome do arquivo exportado.
    Nota: 
    • O Carimbo de data/hora deve ser especificado no formato UTC e adicionado ao nome do arquivo antes da extensão e precedido por um sublinhado. Por exemplo, FileName_20171030135355.csv.
    • Por padrão, o valor é definido para Desativado.
    Inclui aspas para valores exportados
    Indica se os valores exportados devem ser inseridos entre aspas.
    Nota: Por padrão, o valor é definido para Ativado.
  16. Clique na guia Mapeamentos. A guia Mapeamentos exibe a lista de atributos. A lista de atributos é padronizada com base na tabela SCV selecionada.
  17. Adicione um novo atributo, se necessário. Consulte Adicionando novo atributo.
  18. Clique na guia Constantes de importação. Essa guia contém uma lista de atributos da tabela SCV que devem ser mapeados um valor constante ao importar os dados.
    Nota: 
    • Essa guia é exibida apenas se o campo Direção da interface estiver definido como Importar.
    • O valor especificado nessa guia substitui os dados mapeados na guia Mapeamento.
  19. Adicionar uma nova constante de importação, se necessário. Consulte Adição de nova constante de importação.
  20. Clique na guia Constantes de exportação. Essa guia contém uma lista de atributos da tabela SCV a serem mapeados um valor constante durante a exportação.
    Nota: Essa guia será exibida somente se o campo Direção da interface estiver definido como Exportar.
  21. Adicione uma nova constante de exportação, se necessário. Consulte Adicionar nova constante de exportação.
  22. Clique em Salvar.