Ir para o conteúdo

Atividade Insert Rows do Microsoft Excel v3 (Beta) no Jitterbit Studio

Introdução

Uma atividade Insert Rows do Microsoft Excel v3 (Beta), usando sua conexão Microsoft Excel v3 (Beta), escreve uma ou mais linhas em uma planilha e é destinada a ser usada como um destino para consumir dados em uma operação.

Nota

Este conector está atualmente em beta. Para enviar feedback, entre em contato com o Jitterbit Product Team.

Criar uma atividade Insert Rows do Microsoft Excel v3 (Beta)

Uma instância de uma atividade Insert Rows do Microsoft Excel v3 (Beta) é criada a partir de uma conexão Microsoft Excel v3 (Beta) usando seu tipo de atividade Insert Rows.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para obter detalhes, consulte Criar uma instância de atividade em Reutilização de componentes.

Uma atividade Insert Rows do Microsoft Excel v3 (Beta) existente pode ser editada a partir destes locais:

Configurar uma atividade Insert Rows do Microsoft Excel v3 (Beta)

Siga estas etapas para configurar uma atividade Insert Rows do Microsoft Excel v3 (Beta):

Etapa 1: Digite um nome e selecione a pasta de trabalho

Nesta etapa, forneça um nome para a atividade e selecione a pasta de trabalho para a qual deseja escrever. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Menu Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para obter mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado.
  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Insert Rows do Microsoft Excel v3 (Beta) e não deve conter barras / ou dois-pontos :.

  • Selecionar uma pasta de trabalho: Esta seção exibe arquivos de pasta de trabalho disponíveis na pasta configurada do endpoint.

    • Pasta de trabalho selecionada: Depois que uma pasta de trabalho é selecionada, ela é listada aqui.

    • Pesquisar: Digite um valor na caixa de pesquisa para filtrar a lista de arquivos de pasta de trabalho. A pesquisa não diferencia maiúsculas de minúsculas. Se os arquivos de pasta de trabalho já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real com cada pressionamento de tecla. Para recarregar arquivos de pasta de trabalho do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar os arquivos de pasta de trabalho do endpoint. Isso pode ser útil se arquivos de pasta de trabalho foram adicionados à pasta configurada. Esta ação atualiza todos os metadados usados para construir a tabela de arquivos de pasta de trabalho exibida na configuração.

  • Selecionando uma pasta de trabalho: Dentro da tabela, clique em qualquer lugar de uma linha para selecionar uma pasta de trabalho. Apenas uma pasta de trabalho pode ser selecionada. O Nome de cada arquivo de pasta de trabalho é obtido da pasta configurada do endpoint.

    Dica

    Se a tabela não se preencher com os arquivos de pasta de trabalho disponíveis, a conexão pode não ter sido bem-sucedida. Certifique-se de que você está conectado reabrindo a conexão e testando novamente.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Continuar em caso de erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será registrado no log de operação.
  • Salvar e sair: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não é salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Selecionar a planilha

Nesta etapa, selecione a planilha dentro da pasta de trabalho e especifique o comportamento da linha de cabeçalho. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Selecionar uma planilha: Esta seção exibe as planilhas disponíveis na pasta de trabalho selecionada na Etapa 1.

    • Planilha selecionada: Após uma planilha ser selecionada, ela é listada aqui.

    • Pesquisa: Digite um valor na caixa de pesquisa para filtrar a lista de planilhas. A pesquisa não diferencia maiúsculas de minúsculas. Se as planilhas já estiverem exibidas na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar planilhas do endpoint durante a pesquisa, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar planilhas do endpoint. Isso pode ser útil se planilhas foram adicionadas à pasta de trabalho. Esta ação atualiza todos os metadados usados para construir a tabela de planilhas exibida na configuração.

    • Selecionando uma planilha: Dentro da tabela, clique em qualquer lugar de uma linha para selecionar uma planilha. Apenas uma planilha pode ser selecionada. O Nome de cada planilha é obtido da pasta de trabalho selecionada.

  • Especificar linha de cabeçalho: Selecione para indicar que a planilha tem uma linha de cabeçalho. Selecionado por padrão.

  • Número da linha de cabeçalho: Digite o número da linha da linha de cabeçalho. Aceita apenas valores numéricos. O padrão é 1. Disponível apenas quando Especificar linha de cabeçalho está selecionado.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não é salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 3: Revisar os esquemas de dados

Qualquer esquema de solicitação ou resposta é exibido. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquema de dados: O esquema de dados de solicitação contém um campo para cada coluna na planilha selecionada (derivado da linha de cabeçalho), juntamente com um campo rowNumber que indica a linha a ser inserida. O esquema de dados de resposta retorna, para cada linha processada, o path, sheetName e rowNumber, um status de success ou error, e, quando ocorre um erro, um objeto error com campos cause e detailedMessage.

    Cada campo no esquema de dados de solicitação é digitado como uma string, mas o valor realmente escrito em cada célula é determinado pelo formato da célula, conforme descrito em Como valores são escritos nas células.

Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de dados.

Nota

Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

  • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas do endpoint. Essa ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Como valores são gravados em células

Quando uma atividade Insert Rows do Microsoft Excel v3 (Beta) grava um valor mapeado em uma célula, ela determina o tipo de dados do valor usando o próprio valor e o formato da célula de destino, nesta ordem:

  • Fórmula: Se o valor começar com um sinal de igual =, ele será gravado como uma fórmula e avaliado pelo Excel quando a pasta de trabalho for aberta. Se o texto após o sinal de igual não for uma fórmula válida, a atividade falhará com um erro.

  • Booleano: Se o valor for exatamente true ou false (sem distinção de maiúsculas/minúsculas), ele será gravado como um valor booleano.

  • Data ou hora: Se o formato de número da célula for um formato de data ou hora, o valor é analisado em relação aos padrões comuns de data e hora (por exemplo, yyyy-MM-dd ou HH:mm:ss). Se o valor corresponder a um desses padrões, ele será gravado como um valor de data; caso contrário, será gravado como texto.

  • Percentual: Se o formato de número da célula for um formato de percentual, o valor (com ou sem um % à direita) é analisado como um número e dividido por 100.

  • Fração: Se o formato de número da célula for um formato de fração e o valor contiver uma barra /, o valor é analisado como numerador e denominador e gravado como o número resultante.

  • Número: Se o formato de número da célula for General ou um formato numérico e o valor puder ser analisado como um número, ele será gravado como um número.

  • Texto: Qualquer valor que não corresponda a um dos tipos de dados acima é gravado como texto.

Nota

O formato de número da célula usado nessas verificações é o formato da própria coluna da planilha. Se a coluna não tiver um formato de número específico, o formato de qualquer célula existente naquela posição de linha e coluna será usado.

Próximas etapas

Após configurar uma atividade Insert Rows do Microsoft Excel v3 (Beta), conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos diferentes.

As ações de menu para uma atividade podem ser acessadas no painel do projeto e na tela de design. Para obter detalhes, consulte Menu de ações da atividade em Noções básicas de conectores.

As atividades Insert Rows do Microsoft Excel v3 (Beta) podem ser usadas como um destino com estes padrões de operação:

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.