Atividade SMB Update File no Jitterbit Studio
Introdução
Uma atividade SMB Update file, usando sua conexão SMB, atualiza arquivos em um servidor SMB e é destinada a ser usada como um destino para consumir dados em uma operação.
Criar uma atividade SMB Update File
Uma instância de uma atividade SMB Update file é criada a partir de uma conexão SMB usando seu tipo de atividade Update file.
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 detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.
Uma atividade SMB Update file existente pode ser editada a partir destes locais:
- A tela de design (consulte Menu de ações de componentes em Tela de design).
- A aba Components do painel de projeto (consulte Menu de ações de componentes em Aba Components do painel de projeto).
Configurar uma atividade SMB Update File
Siga estas etapas para configurar uma atividade SMB Update file:
-
Etapa 1: Insira um nome e especifique as configurações
Forneça um nome para a atividade e especifique as configurações. -
Etapa 2: Revise os esquemas de dados
Todos os esquemas de solicitação ou resposta são exibidos.
Etapa 1: Insira um nome e especifique as configurações
Nesta etapa, forneça um nome para a atividade e especifique as configurações.
A interface usada nesta etapa da configuração de uma atividade SMB Update file depende da opção Choose folder selecionada:
-
Selecionar pasta existente: Esta opção preencherá uma lista de pastas existentes para escolher. Para usar esta opção, o domínio (especificado durante a configuração da conexão) deve ter acesso às pastas.
-
Fornecer nome da pasta manualmente: Para esta opção, você inserirá manualmente o caminho da pasta.
Selecionar pasta existente
Se Select existent folder for selecionado para Choose folder, a interface descrita abaixo será apresentada.
-
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 mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.
- Edit 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.
-
Name: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade SMB Update file e não deve conter barras
/ou dois-pontos:. -
Operation Type: Selecione um tipo de operação no menu, sendo Define with Schema, Move File, Rename File ou Update file:
-
Define with Schema: Quando selecionado, o tipo de operação é fornecido no esquema de solicitação.
-
Move File: Move o arquivo para outro local.
-
Rename File: Renomeia o arquivo.
-
Update file: Atualiza o conteúdo do arquivo.
-
-
Choose folder: Especifique o método para fornecer o caminho da pasta, sendo Select existent folder ou Provide folder name manually:
-
Selecionar pasta existente: Selecione para escolher em uma lista de pastas preenchida. Para usar essa opção, o domínio (especificado durante a configuração de conexão) deve ter acesso às pastas.
-
Fornecer nome da pasta manualmente: Selecione para inserir manualmente o caminho da pasta.
-
Selecionar uma pasta: Esta seção exibe as pastas disponíveis na pasta SMB especificada na conexão.
- Pasta selecionada: Após selecionar uma pasta, ela é listada aqui.
-
Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de pastas. A pesquisa não diferencia maiúsculas de minúsculas. Se as pastas já estiverem exibidas na tabela, os resultados da tabela serão filtrados em tempo real a cada digitação. Para recarregar pastas do endpoint ao pesquisar, insira os critérios de pesquisa e depois atualize, conforme descrito abaixo.
-
Atualizar elementos raiz: Clique no ícone de atualização ou na palavra Refresh root elements para recarregar as pastas do endpoint SMB. Isso pode ser útil se pastas foram adicionadas ao servidor SMB. Esta ação atualiza todos os metadados usados para construir a tabela de pastas exibida na configuração.
-
Selecionar uma pasta: Na tabela, clique no nome da pasta para selecioná-la. Apenas uma pasta pode ser selecionada.
- Atualizar: Ao passar o mouse sobre um nome de pasta, você pode clicar no ícone de atualização ou na palavra Refresh para carregar as subpastas dessa pasta. Após as subpastas serem preenchidas, elas podem ser selecionadas para uso na atividade.
Dica
Se a tabela não for preenchida com as pastas disponíveis, a conexão SMB pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.
-
Configurações opcionais: Quando Atualizar arquivo é selecionado como o Tipo de operação, esta configuração opcional está disponível:
- Anexar conteúdo: Quando selecionada, esta opção anexa o conteúdo fornecido na solicitação ao final do conteúdo do arquivo. Quando desmarcada, o conteúdo na solicitação substituirá o conteúdo atual.
-
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 será 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.
Fornecer nome da pasta manualmente
Se Fornecer nome da pasta manualmente for selecionado para Escolher pasta, a interface descrita abaixo será apresentada.
Dica
Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.
-
Menu de 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 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 no momento.
-
Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade SMB Atualizar arquivo e não deve conter barras
/ou dois-pontos:. -
Tipo de Operação: Selecione um tipo de operação no menu, entre Definir com Schema, Mover Arquivo, Renomear Arquivo ou Atualizar arquivo:
-
Definir com Schema: Quando selecionado, o tipo de operação é fornecido no schema da solicitação.
-
Mover Arquivo: Move o arquivo para outro local.
-
Renomear Arquivo: Renomeia o arquivo.
-
Atualizar arquivo: Atualiza o conteúdo do arquivo.
-
-
Escolher pasta: Especifique o método para fornecer a pasta, entre Selecionar pasta existente ou Fornecer nome da pasta manualmente:
-
Selecionar pasta existente: Selecione para escolher em uma lista preenchida de pastas.
-
Fornecer nome da pasta manualmente: Selecione para inserir manualmente o caminho da pasta.
-
-
Endereço do caminho: Digite o caminho da pasta a ser pesquisada. O caminho deve ser inserido neste formato:
example-folder-1/example-sub-folder-13. -
Configurações opcionais: Quando Atualizar arquivo é selecionado como Tipo de Operação, esta configuração opcional fica disponível:
- Anexar Conteúdo: Quando selecionado, esta opção anexa o conteúdo fornecido na solicitação ao final do conteúdo do arquivo. Quando desmarcado, o conteúdo na solicitação substituirá o conteúdo atual.
-
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 será 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: Revisar os schemas de dados
Todos os schemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.
-
Schemas de Dados: Estes schemas de dados são herdados por transformações adjacentes e são exibidos novamente durante mapeamento de dados.
Nota
Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.
Os schemas de dados de solicitação e resposta consistem nestes nós e campos:
Nó/Campo do Schema de Solicitação Descrição rootNó representando a raiz itemNó representando o arquivo sendo atualizado contentBase64String contendo o conteúdo codificado em base64 para o arquivo sendo atualizado nameString contendo o nome do arquivo sendo atualizado appendContentQuando definido como trueo conteúdo fornecido é anexado ao final do arquivo, quando definido comofalseo conteúdo fornecido substitui o conteúdo atualNó/Campo do Schema de Resposta Descrição rootNó representando a raiz itemNó representando o arquivo error_messageString contendo a mensagem de erro, se aplicável responseString contendo a resposta indexString contendo o índice do dialeto usado -
Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas do endpoint SMB. 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 SMB Atualizar arquivo, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas 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 nos mesmos fluxos de trabalho ou em fluxos diferentes.
As ações de menu de uma atividade são acessíveis no painel do projeto e na tela de design. Para obter detalhes, consulte Menu de ações da atividade em Noções básicas do conector.
As atividades SMB Atualizar arquivo podem ser usadas como destino com estes 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 da operação.