Atividade Atualizar Linhas do Microsoft Excel v3 (Beta) no Jitterbit Studio
Introdução
Uma atividade Atualizar Linhas do Microsoft Excel v3 (Beta), utilizando sua conexão do Microsoft Excel v3 (Beta), atualiza uma ou mais linhas existentes em uma planilha e é destinada a ser usada como destino para consumir dados em uma operação.
Nota
Este conector está atualmente em beta. Para enviar comentários, entre em contato com o Jitterbit Product Team.
Criar uma atividade Atualizar Linhas do Microsoft Excel v3 (Beta)
Uma instância de uma atividade Atualizar Linhas do Microsoft Excel v3 (Beta) é criada a partir de uma conexão do Microsoft Excel v3 (Beta) usando seu tipo de atividade Atualizar Linhas.
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 mais detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.
Uma atividade Atualizar Linhas do Microsoft Excel v3 (Beta) existente pode ser editada a partir destes locais:
- A tela de design (consulte Menu de ações de componente em Tela de design).
- A guia Componentes do painel do projeto (consulte Menu de ações de componente em Guia Componentes do painel do projeto).
Configurar uma atividade Atualizar Linhas do Microsoft Excel v3 (Beta)
Siga estas etapas para configurar uma atividade Atualizar Linhas do Microsoft Excel v3 (Beta):
-
Etapa 1: Digite um nome e selecione a pasta de trabalho
Forneça um nome para a atividade e selecione a pasta de trabalho a atualizar. -
Etapa 2: Selecione a planilha
Selecione a planilha dentro da pasta de trabalho e especifique o comportamento da linha de cabeçalho. -
Etapa 3: Revise os esquemas de dados
Todos os esquemas de requisição ou resposta são exibidos.
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 a atualizar. Cada elemento da interface do usuário desta etapa é descrito abaixo.
-
Menu de ponto de extremidade: Se você tiver múltiplos pontos de extremidade do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do ponto de extremidade atual. Clique no menu para alternar para um ponto de extremidade diferente. Para mais informações, consulte Alterar o ponto de extremidade atribuído em Telas de configuração.
- Editar ponto de extremidade: Aparece quando você passa o mouse sobre o nome do ponto de extremidade atual. Clique para editar a configuração de conexão do ponto de extremidade selecionado.
-
Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Atualizar Linhas do Microsoft Excel v3 (Beta) e não deve conter barras
/ou dois-pontos:. -
Selecione uma pasta de trabalho: Esta seção exibe arquivos de pasta de trabalho disponíveis na pasta configurada do ponto de extremidade.
-
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 arquivos de pasta de trabalho já forem exibidos na tabela, os resultados da tabela serão filtrados em tempo real com cada digitação. Para recarregar arquivos de pasta de trabalho do ponto de extremidade ao pesquisar, digite critérios de pesquisa e depois atualize, conforme descrito abaixo.
-
Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar arquivos de pasta de trabalho do ponto de extremidade. 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. Certifique-se de estar 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.
-
Pesquisar: Insira 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á forem exibidas na tabela, os resultados da tabela serão filtrados em tempo real com cada pressionamento de tecla. Para recarregar planilhas do endpoint ao pesquisar, insira 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.
-
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: Insira 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é 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
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
rowNumberindicando a linha a atualizar, junto com um objetocontentaninhado contendo um campo para cada coluna na planilha selecionada (derivado da linha de cabeçalho). O esquema de dados de resposta retorna, para cada linha processada, opath,sheetNameerowNumber, umstatusdesuccessouerrore, quando um erro ocorre, um objetoerrorcom camposcauseedetailedMessage.Cada campo no objeto
contentaninhado é digitado como uma string, mas o valor realmente gravado em cada célula é determinado pelo formato da célula, conforme descrito em Como os valores são gravados nas células.
Esses esquemas de dados são herdados pelas 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 pede que você confirme que deseja descartar as alterações.
Como os valores são escritos em células
Quando uma atividade Atualizar linhas do Microsoft Excel v3 (Beta) escreve 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á escrito 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
trueoufalse(sem diferenciar maiúsculas de minúsculas), ele será escrito 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 será analisado em relação a padrões comuns de data e hora (por exemplo,
yyyy-MM-ddouHH:mm:ss). Se o valor corresponder a um desses padrões, será escrito como um valor de data; caso contrário, será escrito como texto. -
Percentual: Se o formato de número da célula for um formato de percentual, o valor (com ou sem
%no final) será 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 será analisado como numerador e denominador e escrito como o número resultante. -
Número: Se o formato de número da célula for
Geralou um formato numérico e o valor puder ser analisado como um número, será escrito como um número. -
Texto: Qualquer valor que não corresponda a um dos tipos de dados acima será escrito como texto.
Nota
O formato de número da célula usado nessas verificações é o formato atual da célula que está sendo atualizada. Se essa célula ainda não tiver um valor, o formato de número da coluna da planilha será usado em seu lugar.
Próximas etapas
Após configurar uma atividade Atualizar 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. 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 de trabalho diferentes.
As ações de menu para uma atividade podem ser acessadas 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 Atualizar linhas do Microsoft Excel v3 (Beta) podem ser usadas como destino com esses padrões de operação:
- Padrão de transformação
- Padrão de duas transformações (como primeiro ou segundo destino)
Para usar a atividade com funções de script, escreva os dados em um local temporário e 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 logs de operação.