Atividade Read Rows do Microsoft Excel v3 (Beta) no Jitterbit Studio
Introdução
Uma atividade Read Rows do Microsoft Excel v3 (Beta), usando sua conexão Microsoft Excel v3 (Beta), lê linhas de uma planilha e destina-se a ser usada como uma fonte para fornecer dados em uma operação.
Nota
Este conector está atualmente em beta. Para fornecer feedback, entre em contato com o Jitterbit Product Team.
Criar uma atividade Read Rows do Microsoft Excel v3 (Beta)
Uma instância de uma atividade Read Rows do Microsoft Excel v3 (Beta) é criada a partir de uma conexão Microsoft Excel v3 (Beta) usando seu tipo de atividade Read 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 Criando uma instância de atividade em Reutilização de componentes.
Uma atividade Read Rows do Microsoft Excel v3 (Beta) existente pode ser editada a partir desses locais:
- A tela de design (consulte Menu de ações de componentes em Tela de design).
- A aba Componentes do painel do projeto (consulte Menu de ações de componentes em Aba Componentes do painel do projeto).
Configurar uma atividade Read Rows do Microsoft Excel v3 (Beta)
Siga estas etapas para configurar uma atividade Read Rows do Microsoft Excel v3 (Beta):
-
Etapa 1: Insira um nome e selecione a pasta de trabalho
Forneça um nome para a atividade e selecione a pasta de trabalho para leitura. -
Etapa 2: Selecione a planilha
Selecione a planilha dentro da pasta de trabalho e especifique o comportamento da linha de cabeçalho. -
Etapa 3: Defina as opções de leitura
Especifique quais linhas ler e como linhas em branco e metadados de célula são tratados. -
Etapa 4: Revise os esquemas de dados
Todos os esquemas de solicitação ou resposta são exibidos.
Etapa 1: Insira um nome e selecione a pasta de trabalho
Nesta etapa, forneça um nome para a atividade e selecione a pasta de trabalho para leitura. Cada elemento da interface do usuário desta etapa é descrito abaixo.
-
Menu Endpoint: Se você tem 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: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Read Rows do Microsoft Excel v3 (Beta) e não deve conter barras
/ou dois-pontos:. -
Selecionar uma pasta de trabalho: Esta seção exibe os arquivos de pasta de trabalho disponíveis na pasta configurada do endpoint.
-
Pasta de trabalho selecionada: Após uma pasta de trabalho ser selecionada, ela é listada aqui.
-
Pesquisa: Insira 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 arquivos de pasta de trabalho já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar arquivos de pasta de trabalho do endpoint durante a pesquisa, insira critérios de pesquisa e 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.
-
-
Selecionar uma pasta de trabalho: Na 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 for preenchida com os arquivos de pasta de trabalho disponíveis, a conexão pode não ter sido bem-sucedida. Garanta que está conectado reabrindo a conexão e testando novamente.
-
Salvar e sair: Se habilitado, 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é clicar 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 confirmação de 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.
-
Pesquisar: 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 digitação. Para recarregar planilhas do endpoint ao pesquisar, digite os critérios de pesquisa e 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 criar a tabela de planilhas exibida na configuração.
-
Selecionar uma planilha: Na 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 possui uma linha de cabeçalho. Selecionado por padrão.
-
Número da linha de cabeçalho: Digite o número da linha de cabeçalho. Aceita apenas valores numéricos. 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é clicar 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 confirmação de que deseja descartar as alterações.
Etapa 3: Definir opções de leitura
Nesta etapa, especifique quais linhas ler e como linhas em branco e metadados de célula são manipulados. Cada elemento da interface do usuário desta etapa é descrito abaixo.
-
Ler por: Selecione como determinar quais linhas são lidas:
- Definir limite de linhas: (Padrão.) Lê um intervalo delimitado de linhas completas, definido usando os campos De e Até.
- Definir intervalo do Excel: Lê o intervalo específico do Excel digitado no campo Intervalo.
-
Intervalo: Digite o intervalo do Excel para ler, por exemplo
A1:D100. Disponível apenas quando Ler por está definido como Definir intervalo do Excel. -
De: Digite o número da primeira linha para ler. Padrão é
1. Disponível apenas quando Ler por está definido como Definir limite de linhas. -
Até: Digite o número da última linha para ler. Padrão é
100. Disponível apenas quando Ler por está definido como Definir limite de linhas. -
Não ler linhas em branco: Selecione para excluir linhas em branco das linhas lidas. Não selecionado por padrão.
-
Incluir metadados da célula: Selecione para incluir metadados da célula. Não selecionado por padrão.
-
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 4: Revisar os esquemas de dados
Todos os esquemas de solicitação ou resposta são exibidos. 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
rangeou camposrowFromerowTo, correspondendo à seleção de Ler por na Etapa 3, junto com um campoincludeMetadata. O esquema de dados de resposta retorna, para cada linha lida, orowNumberjuntamente com um campo para cada coluna na planilha selecionada (derivado da linha de cabeçalho).Este esquema de dados é herdado pelas transformações adjacentes e é exibido novamente durante o mapeamento de transformação.
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. Esta 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.
Próximas etapas
Após configurar uma atividade Ler Linhas 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. Também é possível 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 de trabalho diferentes.
As ações de menu de uma atividade são acessíveis pelo painel do projeto e pela tela de design. Para detalhes, consulte Menu de ações de atividade em Noções básicas do conector.
As atividades Ler Linhas do Microsoft Excel v3 (Beta) podem ser usadas como uma origem com estes padrões de operação:
- Padrão de transformação
- Padrão de arquivo com dois destinos (apenas como primeira origem)
- Padrão de arquivo HTTP com dois destinos (apenas como primeira origem)
- Padrão com duas transformações (como primeira ou segunda origem)
Para usar a atividade com funções de script, escreva os dados em um local temporário e depois use esse local temporário na função de script.
Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os registros da operação.