Atividade Colocar Arquivo de FTP
Durante o tempo de execução, a atividade Colocar Arquivo do FTP obtém dados de variáveis da orquestração, coloca os dados em um arquivo e se conecta a um Servidor FTP e coloca o arquivo no local do diretório especificado.
Para obter um exemplo de como usar a atividade Colocar Arquivo do FTP, consulte o Guia de Introdução.
Interrupção da Transferência
A transferência de arquivos feita pela atividade Colocar Arquivo do FTP durante o tempo de execução é não transacional e, portanto, não é garantida. Por exemplo, se uma atividade Colocar Arquivo do FTP transferir um arquivo do Integration Appliance para um Servidor FTP e a transferência do arquivo for interrompida porque o Integration Appliance foi reinicializado, não é garantido que o arquivo inteiro seja transferido.Link Simbólico
A atividade Colocar Arquivo do FTP suporta links simbólicos para diretórios se os links simbólicos para os diretórios são suportados pelo sistema operacional que hospeda o Servidor FTP e os links simbólicos para diretórios são suportados pelo próprio Servidor FTP. Para determinar o suporte ao link simbólico específico para um Servidor FTP específico em um sistema operacional específico, consulte a documentação de seu sistema operacional e do Servidor FTP.Incluindo uma Atividade Colocar Arquivo do FTP na Orquestração
- Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta FTP.
- Arraste a atividade Colocar Arquivo para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal FTP
- Clique na tarefa Selecionar Terminal na
Lista de Verificação e escolha uma das ações a seguir:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é
exibido.Atenção: Especificar um novo Terminal FTP com uma estrutura de diretório diferente do Terminal FTP original pode fazer com que a tarefa de orquestração falhe durante o tempo de execução. Você deve especificar um novo servidor FTP que corresponda à estrutura de diretório do servidor FTP especificado originalmente ou alterar o diretório configurado do campo No Diretório clicando em Navegar conforme descrito no procedimento Configurar a Atividade.
- Selecione um terminal existente e clique em OK. Vá para o procedimento "Configurar a Atividade".
- Selecione Procurar. O Explorador de Projetos é
exibido.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK. Atenção: Especificar um novo Terminal FTP com uma estrutura de diretório diferente do Terminal FTP original pode fazer com que a tarefa de orquestração falhe durante o tempo de execução. Você deve especificar um novo servidor FTP que corresponda à estrutura de diretório do servidor FTP especificado originalmente ou alterar o diretório configurado do campo No Diretório clicando em Navegar conforme descrito no procedimento "Configurar a Atividade".
- Clique em Editar. A área de janela Editar Terminal é exibida.
- Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
- Selecione um terminal existente:
- Crie ou edite um terminal FTP: Criando ou Editando um Terminal FTP
Especificando as Regras de Entrega
- Selecione a tarefa Regras de Entrega a partir da Lista de Verificação. A área de janela Regras de Entrega é exibida. Se a segurança não estiver ativada para o terminal FTP, as opções Transferir como Texto (ASCII) e Transferir como Binário (BINARY) serão ativadas. Se a segurança for ativada para o terminal FTP, o tipo de transferência de arquivos sempre será binário.
- Selecione o tipo de transferência de arquivos entre o Integration
Appliance e o Servidor FTP a partir de uma das opções a seguir:
- Transferir como Texto (ASCII) - Esta opção é utilizada para transferir arquivos como
HTML, XML e outros arquivos de texto. Finalizações de linha serão convertidos
conforme necessário e outras convenções do arquivo de texto serão seguidas.CUIDADO:Usar esta opção com arquivos binários pode resultar em uma perda de dados.
- Transferir como Binário (BINÁRIO) - Esta opção é utilizada para transferir arquivos binários. Utilizando esta opção, o Integration Appliance transfere dados sem conversões.
Nota: O terminal de SFTP do conector de FTP Cast Iron suporta apenas o protocolo de SFTP do lado do cliente versão 3. Consequentemente, o protocolo de SFTP não suporta transferência de arquivos de modo ASCII/texto. Certifique-se de configurar o Tipo de Transferência de Arquivos para Transferir como Binário (BINARY) nas . - Transferir como Texto (ASCII) - Esta opção é utilizada para transferir arquivos como
HTML, XML e outros arquivos de texto. Finalizações de linha serão convertidos
conforme necessário e outras convenções do arquivo de texto serão seguidas.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
- Configure os campos nesta área de janela, conforme descrito na tabela
a seguir:
Tabela 1. Campo Descrição Salvar Arquivo Nomeado Este campo não é usado para esta atividade. Especifique o nome do arquivo de saída usando o parâmetro de entrada filename da tarefa Mapear Entrada. No Diretório Especifica o diretório no servidor FTP no qual o Integration Appliance coloca o arquivo gerado nesta atividade. É possível especificar um diretório usando uma das opções a seguir: - Insira o caminho do diretório diretamente clicando no campo e
digitando um dos seguintes caminhos do diretório:
- Caminho do diretório relativo, por exemplo: /output. (Supõe que o início do FTP foi configurado para a conta do usuário que se conecta ao Servidor FTP. Consulte "Observação" para obter mais informações.)
- Caminho do diretório completo, por exemplo, em uma máquina UNIX: /home/user/output.
- Clique em Procurar... para preencher a lista suspensa de diretórios disponíveis. Selecione o diretório apropriado na lista suspensa.
Nota: UNIX: Se você especificar um caminho do diretório relativo ao se conectar a um Servidor FTP em uma máquina UNIX, verifique se o diretório inicial do FTP foi especificado corretamente no arquivo /etc/password para a conta do usuário que se conecta ao Servidor FTP.De Tipo Especifica como ler no conteúdo do arquivo - como dados binários ou texto codificado. Se a opção Texto for selecionada, configure o tipo de codificação usando uma das opções a seguir: - Na lista suspensa Codificado com, selecione um dos tipos de codificação padrão.
- Insira o tipo de codificação diretamente clicando no campo Codificado com e digitando seu tipo de codificação.
Nota: Alguns caracteres de byte duplo não são convertidos com o uso da codificação SHIFT-JIS. Para obter informações adicionais, consulte Usando a Codificação Shift-JIS.Atenção: Você deve especificar a opção Transferir como Texto (ASCII) para atividades de FTP ao recuperar arquivos de texto e colocar arquivos de texto em um Servidor FTP para Terminais que manipulam dados de texto durante a transferência de dados de/para o Terminal FTP no modo ASCII. Por exemplo, Terminais FTP de mainframe e DOS manipulam dados ASCII quando transmitem dados no modo ASCII.Por exemplo, se sua orquestração recuperar arquivos ASCII usando a atividade Pesquisar Diretório do FTP e colocar arquivos ASCII usando a atividade Colocar Arquivo do FTP em um Servidor FTP de mainframe, você deverá especificar as opções nas tarefas a seguir no Studio:- Na tarefa Configurar de uma atividade Pesquisar Diretório do FTP, para o campo Do Tipo, selecione a opção Texto.
- Na tarefa Regras de Entrega de uma atividade Pesquisar Diretório do FTP, para o campo Tipo de Transferência de Arquivos, selecione a opção Transferir como Texto (ASCII).
- Na tarefa Configurar de uma atividade Obter Arquivo do FTP, para o campo Do Tipo, selecione a opção Texto.
- Na atividade Regras de Entrega de uma atividade Colocar Arquivo do FTP, para o campo Tipo de Transferência de Arquivos, selecione a opção Transferir como Texto (ASCII).
Opções - Selecione uma das seguintes opções para definir o comportamento quando um arquivo do mesmo nome já existir no diretório de saída especificado: Sobrescrever Arquivo Existente se Nome de Arquivo Duplicado for Localizado Especifica se o arquivo já existe, destrói o conteúdo do arquivo original com novos dados retornados da atividade. Anexar no Arquivo Existente Especifica se o arquivo já existe, mantém os dados originais no arquivo e anexa os novos dados (retornados da atividade) no final do arquivo. Levantar Erro se Arquivo com Nome Duplicado for Localizado Especifica se o arquivo já existe, mantém os dados originais no arquivo, emite um erro e não faz nada com os novos dados retornados da atividade. Nota: Ao selecionar esta opção, a atividade Colocar Arquivo de FTP verificará se o arquivo existe no servidor antes de fazer o upload do arquivo. Em alguns servidores de FTP talvez você não tenha a permissão para verificar se o arquivo existe antes de fazer o upload dele. Isso é conhecido também como FTP Oculto. Em tais casos, o arquivo será sobrescrito, mesmo se a opção Criar Erro se o Arquivo com Nome Duplicado for Localizado tiver sido selecionada. - Insira o caminho do diretório diretamente clicando no campo e
digitando um dos seguintes caminhos do diretório:
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
- Configure as opções de nova tentativa para conectar-se a um Servidor
FTP. A tabela a seguir descreve as opções de nova tentativa para
conectar-se a um Servidor FTP:
Tabela 2. Campo Descrição Tentar novamente 1) Aguardar ___ segundo(s) entre cada nova tentativa. O número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o Servidor FTP. 2) Tentar se conectar ___ vezes antes de falhar. Especifica a contagem de novas tentativas - o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o Servidor FTP antes de emitir um erro e parar o processamento da tarefa de orquestração atual. Se você implementar uma orquestração que contém uma atividade Colocar Arquivo do FTP e o Integration Appliance não puder se conectar ao Servidor FTP especificado, o Integration Appliance registrará os erros de conexão como avisos nos logs do sistema e de orquestração até o valor de contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual.
Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, o segundo e o terceiro erros de conexão são mostrados no log do sistema como avisos. O Integration Appliance registra o quarto erro de conexão como um erro e para o processamento da tarefa de orquestração atual.
Mapeando a Entrada da Atividade
- Selecione a tarefa Mapear Entradas na Lista de Verificação. A área de janela Tentar Novamente é exibida. Os parâmetros de entrada da atividade são exibidos na área de janela Atividade de Destino.
- Não é necessário mapear todos os parâmetros de entrada da atividade.
Os parâmetros a seguir são os necessários:
- filename
- dados
Se o parâmetro de entrada listado na tabela a seguir não for exibido na área de janela Para Atividade da área de janela Mapear Entradas, selecione Mostrar Parâmetros Opcionais. Se a opção não for selecionável no menu da barra de ferramentas, clique em um nó na área de janela Mapear Entradas para tornar essa opção ativa.
no menu da barra de ferramentas ou clique com o botão direito do mouse na área de janela Para Atividade e selecione a opçãoÉ possível, opcionalmente, substituir as configurações que você especificou nas tarefas Configurar e Escolher Terminal da Lista de Verificação dinamicamente durante o tempo de execução, usando os parâmetros de entrada definidos na tabela a seguir.
Por exemplo, o diretório no Servidor FTP no qual o Integration Appliance coloca o arquivo gerado nesta atividade poderia ser configurado na tarefa Configurar no diretório chamado output. Durante o tempo de execução, o nome de diretório: outputXML poderia ser transmitido para a atividade usando o parâmetro de entrada directory. O nome de diretório especificado dinamicamente durante o tempo de execução substitui a configuração original especificada na área de janela Configurar. Neste exemplo, o arquivo seria colocado no diretório outputXML.
Nome do Parâmetro de Entrada/Nó | Descrição | Substitui a Configuração na Tarefa? |
---|---|---|
directory | Especifica o diretório no servidor FTP no qual o Integration Appliance coloca o arquivo gerado nesta atividade. | O parâmetro de entrada directory substitui o campo No Diretório da tarefa Configurar. |
encoding | Especifica como os dados de saída são gravados no
arquivo:
|
O parâmetro de entrada encoding substitui a codificação especificada no campo Do Tipo da tarefa Configurar mas, se a opção Binário estiver selecionada no campo Do Tipo da tarefa Configurar, a codificação especificada pelo parâmetro de entrada encoding será ignorada. |
overwrite | Especifica o comportamento quando um arquivo
existente com o mesmo nome já existe no diretório de saída especificado.
Especifique um dos valores a seguir:
|
O parâmetro de entrada overwrite substituir o campo Opções da tarefa Configurar. |
connection/timeout | Especifica o tempo limite de conexão - a quantidade de tempo em segundos antes que um tempo limite ocorra entre o Integration Appliance tentar estabelecer uma conexão com o terminal e o tempo que demora para o terminal responder à solicitação de conexão. Para a atividade Colocar Arquivo do FTP, a quantidade de vezes que o Integration Appliance tenta estabelecer uma conexão com o Servidor FTP antes de expirar. | O nó timeout do parâmetro de entrada connection substitui o campo Tempo Limite de Conexão -Expirar após ___ segundo(s) ao estabelecer uma conexão com o Terminal do terminal FTP. |
connection/host | Especifica o Nome do Host ou o endereço IP para o servidor FTP. | O nó host do parâmetro de entrada connection substitui o campo Nome do Host do terminal FTP. |
connection/port | Especifica o número da porta para o nome do host especificado. A porta padrão para o tráfego de FTP é 21. A porta padrão para o tráfego de SFTP é 22. | O nó port do parâmetro de entrada connection substitui o campo Porta do terminal FTP. |
connection/username | Especifique um nome de usuário para a conta usada para conectar-se ao Servidor FTP. | O nó username do parâmetro de entrada connection substitui o campo Nome de Usuário do terminal FTP. |
connection/password | Especifique uma senha para a conta usada para se conectar ao Servidor FTP. | O nó password do parâmetro de entrada connection substitui o campo Senha do terminal FTP. |