Atividade de gravação de compartilhamento de arquivo
Introdução
Uma atividade de Gravação de Compartilhamento de Arquivos, usando sua conexão de Compartilhamento de Arquivos, grava dados em uma rede compartilhada e deve ser usado como um alvo para consumir dados em uma operação ou para ser chamado em um script.
Criar uma atividade de gravação de compartilhamento de arquivos
Uma instância de uma atividade de Compartilhamento de Arquivos Gravação é criada a partir de uma conexão de Compartilhamento de Arquivos usando seu tipo de atividade Write.
Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.
Uma atividade de Compartilhamento de Arquivos Gravação existente pode ser editada nestes locais:
-
A quadro de design (veja menu de ações do componente em Tela de design).
-
A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
Configurar uma atividade de gravação de compartilhamento de arquivos
Siga estas etapas para configurar uma atividade de Gravação de compartilhamento de arquivos:
Etapa 1: insira um nome, forneça um esquema de solicitação e especifique as configurações
Dica
Campos com ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [
no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.
-
Nome: Insira um nome para identificar a atividade de Gravação de Compartilhamento de Arquivos. O nome deve ser exclusivo para cada atividade de Gravação de Compartilhamento de Arquivos e não deve conter barras (
/
) ou dois pontos (:
). -
Fornecer esquema de solicitação: O esquema de solicitação define a estrutura de dados usada pela atividade de Gravação de Compartilhamento de Arquivos. A necessidade de um esquema de solicitação depende se a atividade é usada como alvo de uma transformação (consulte Uso do esquema). Para obter instruções sobre como concluir esta seção de configuração da atividade, consulte Esquemas definidos em uma atividade.
-
Nome(s) do(s) arquivo(s): Digite o nome do(s) arquivo(s) nos quais deseja gravar, dentro do(s) caminho(s) especificado(s) na Conexão de Compartilhamento de Arquivos. Qualquer uma das palavras-chave do nome do arquivo pode ser usado para gerar nomes de arquivos exclusivos (por exemplo,
result [date][tempo].[ext]
). Se especificar dados em formato ZIP, consulte as opções de Compressão descritas abaixo. -
Configurações opcionais: Clique para expandir as configurações opcionais adicionais:
-
Criar diretórios automaticamente: Mantenha esta caixa de seleção marcada para criar automaticamente quaisquer diretórios que ainda não existam no caminho de destino.
-
Não criar arquivos vazios: Marque esta caixa de seleção para pular a criação do arquivo de destino se não houver dados de destino.
-
Escrever cabeçalhos: Marque esta caixa de seleção se estiver usando um destino de texto simples e quiser escrever cabeçalhos (nomes de colunas/campos) na primeira linha.
-
Tipo de fim de linha: Especifica como escrever quebras de linha ao gravar em um destino. Observe que os caracteres de fim de linha nos próprios dados não são convertidos. As opções são as seguintes:
-
Padrão: Caracteres de fim de linha padrão para a plataforma na qual o agente está sendo executado.
-
Windows: CRLF (ASCII 13 e ASCII 10).
-
Unix: LF (ASCII 10).
-
-
Codificação de Caracteres: Especifique a codificação de caracteres para definir uma codificação de caracteres específica para o arquivo de destino. Se você deixar o campo em branco, o Harmony tentará detectar a codificação. Se desejar substituir o padrão, você pode escolher qualquer um dos tipos de codificação listados em Codificações de caracteres suportadas.
-
Compressão: Se desejar que os dados de destino sejam compactados, selecione Compactar arquivos de destino. Estas opções ficam disponíveis:
-
Formato: Use o menu suspenso para selecionar o formato de compactação. Atualmente, apenas o formato ZIP é suportado.
-
Nomes de arquivos no(s) arquivo(s): Insira o nome do(s) arquivo(s) de destino a ser(em) compactado(s) no arquivo. Qualquer uma das palavras-chave de nome de arquivo estão disponíveis para gerar nomes de arquivo exclusivos. Os arquivos são gravados automaticamente no arquivo no nível raiz.
Dica
Para manter o(s) nome(s) de arquivo(s) no arquivo igual(es) ao(s) nome(s) de arquivo(s) definido(s) no destino, digite
[file].[ext]
. -
Modo: Por padrão, o modo Sobrescrever substitui o arquivo existente. Este é o único modo disponível.
-
Senha: Para criptografar o arquivo, digite a senha desejada.
-
Modo de criptografia: Se uma senha for fornecida, use o menu suspenso para selecionar entre os dois modos de criptografia disponíveis: AES e ZIP padrão.
-
-
-
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 prosseguir para a próxima. 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.
Etapa 2: Revise os esquemas de dados
-
Esquema de Dados: Se fornecido durante a configuração da atividade, o esquema de dados da solicitação será exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente durante o mapeamento da transformação, onde você pode mapear campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e muito mais. Você também pode definir esquemas diretamente em uma transformação.
-
Adicionar plugin(s): Plugins são aplicativos Jitterbit ou fornecidos pelo usuário que estendem os recursos nativos do Harmony. Para aplicar um plugin à atividade, clique para expandir esta seção e marque a caixa de seleção ao lado do plugin a ser usado. Para obter instruções adicionais sobre o uso de plugins, incluindo detalhes sobre como definir as variáveis necessárias usadas pelo plugin, consulte Plugins adicionados a uma atividade.
-
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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.
Próximos passos
Depois de configurar uma atividade de Gravação de Compartilhamento de Arquivos, você pode usá-la em uma operação ou script, conforme descrito abaixo.
Concluir a operação
Após configurar uma atividade de Gravação de Compartilhamento de Arquivos, 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 configurações de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.
Após a criação de uma atividade de Compartilhamento de Arquivos Gravar, as ações de menu para essa atividade podem ser acessadas no painel do projeto, nas guias Workflows ou Componentes, e na quadro de design. Consulte menu de ações da atividade para mais detalhes.
As atividades de Compartilhamento de Arquivos Gravação podem ser usadas como um alvo com estes padrões de operação:
- Padrão de arquivo
- Padrão de Script
- Padrão de Transformação
- Padrão de arquivamento de dois alvos (apenas como segundo alvo)
- Padrão de arquivo HTTP de dois alvos (apenas como segundo alvo)
- Padrão de duas transformações (apenas como segundo alvo)
- Padrão de origem em massa do Salesforce
Outros padrões não são válidos usando atividades de Gravação de Compartilhamento de Arquivos. Consulte os padrões de validação em Validade da operação página.
Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs de operação.
Usar atividades de compartilhamento de arquivos em scripts
As atividades de compartilhamento de arquivos Write também podem ser referenciadas em um script para uso com funções de script que usam um targetId
como parâmetro, incluindo estes:
Funções de Jitterbit Script
ArchiveFile
FlushAllFiles
FlushFile
WriteFile
Funções Jitterbit JavaScript
Jitterbit.WriteFile
Para obter mais detalhes sobre como referenciar atividades em scripts, consulte Endpoints em Jitterbit Script ou Endpoints em JavaScript.