Atividades do pacote de integração FTPFTP Integration Pack Activities

Importante

Esta versão do Orchestrator atingiu o fim do suporte, recomendamos que você atualize para o orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

As instruções de configuração a seguir se aplicam a todas as atividades neste pacote de integração.The following configuration instructions apply to all activities in this integration pack. Os links para esta seção estão incluídos nas instruções de configuração para cada atividade.Links to this section are included in the configuration instructions for each activity.

Os procedimentos neste tópico são executados em uma atividade que foi colocada na janela de runbook da Runbook Designer do Orchestrator.The procedures in this topic are performed on an activity that has been placed in the runbook window of the Orchestrator Runbook Designer.

Propriedades da atividadeActivity Properties

Cada atividade tem um conjunto de propriedades obrigatórias ou opcionais que definem a configuração dessa atividade.Each activity has a set of required or optional properties that define the configuration of that activity. Isso inclui como ele se conecta a outras atividades ou como a atividade executa suas ações.This includes how it connects to other activities or how the activity performs its actions. Você pode exibir ou modificar as propriedades da atividade quando a atividade é colocada na janela do runbook.You can view or modify activity properties when the activity is placed in the runbook window.

Para exibir e configurar as propriedades de uma atividadeTo view and configure the properties for an activity

  1. Clique duas vezes na atividade.Double-click the activity. Como alternativa, você pode clicar com o botão direito do mouse na atividade e clicar em Propriedades.Alternatively, you can right-click the activity, and then click Properties.
  2. Para salvar suas entradas de configuração, clique em concluir.To save your configuration entries, click Finish.

Na caixa de diálogo Propriedades da atividade, várias guias ao lado esquerdo fornecem acesso a configurações gerais e específicas para a atividade.In the activity properties dialog box, several tabs along the left side provide access to general and specific settings for the activity. O número de guias disponíveis para propriedades de objeto difere entre atividades diferentes.The number of available tabs for object properties differs between different activities.

Guia GeralGeneral Tab

Essa guia contém as propriedades nome e Descrição da atividade.This tab contains the Name and Description properties for the activity. Por padrão, o nome da atividade é o mesmo que seu tipo de atividade e a Descrição fica em branco.By default, the Name of the activity is the same as its activity type, and the Description is blank. Você pode modificar essas propriedades para criar nomes mais descritivos ou fornecer descrições detalhadas das ações da atividade.You can modify these properties to create more descriptive names or provide detailed descriptions of the actions of the activity.

Guia PropriedadesProperties Tab

Essa guia contém propriedades que são específicas para a atividade.This tab contains properties that are specific to the activity. Todas as atividades neste pacote de integração têm a propriedade nome da configuração na parte superior da guia Propriedades ou filtros . Essa propriedade é usada para especificar a conexão com o servidor FTP.All activities in this integration pack have the Configuration Name property at the top of the Properties or Filters tab. This property is used to specify the connection to the FTP server.

Para configurar a propriedade nome da configuraçãoTo configure the Configuration Name property

  1. Clique no botão de reticências (...) ao lado do campo nome .Click the ellipsis (...) button next to the Name field.
  2. Selecione o nome de conexão aplicável.Select the applicable connection name.

Comportamento do filtroFilter Behavior

As atividades listar pastas/arquivos e sincronizar pasta/arquivo Use filtros para determinar os itens que serão listados ou sincronizados.The activities List Folders/Files and Synchronize Folder/File use filters to determine the items that will be listed or synchronized. Os valores de propriedade de candidatos potenciais são comparados aos valores dos filtros para determinar se eles atendem aos critérios.Property values of potential candidates are compared to the values of the filters to determine if they meet the criteria. Ao fazer a correspondência com os valores, você pode selecionar um dos métodos de comparação disponíveis.When matching against values, you can select one of the available methods of comparison. Uma opção é fornecida para corresponder ou não corresponder ao filtro usando cada método.An option is provided to either match or not match the filter using each method. Por exemplo, a versão "não" de um método localiza itens que não correspondem ao filtro para iniciar a atividade.For example, the "Does not" version of a method finds items that do not match the filter to start the activity. Todos os filtros de texto diferenciam maiúsculas de minúsculas.All text filters are case sensitive.

  • Equals: a propriedade da mensagem corresponde ao texto ou ao número especificado no filtro.Equals: the property of the message matches the text or number specified in the filter.
  • Não é igual: a propriedade da mensagem não corresponde ao texto ou ao número especificado no filtro.Does not equal: the property of the message does not match the text or number specified in the filter.

Guia comportamento da execuçãoRun Behavior Tab

Essa guia contém as propriedades que determinam como a atividade manipula dados publicados com vários valores e quais notificações serão enviadas se a atividade falhar ou for executada por um período de tempo excessivo.This tab contains the properties that determine how the activity handles multi-value published data and what notifications will be sent if the activity fails or runs for an excessive period of time.

Comportamento de dados publicados com vários valoresMulti-Value Published Data Behavior

As atividades Get recuperam informações de outra atividade ou de uma fonte externa e podem retornar um ou mais valores nos dados publicados.The Get activities retrieve information from another activity or outside source, and can return one or more values in the published data. Por exemplo, quando você usa a atividade listar pastas/arquivos, a saída de dados dessa atividade pode ser uma lista de computadores que pertencem à coleção especificada.For example, when you use the List Folders/Files activity, the data output from that activity could be a list of computers that belong to the specified collection.

Por padrão, os dados da atividade listar pastas/arquivos serão passados como várias saídas individuais.By default, the data from the List Folders/Files activity will be passed on as multiple individual outputs. Isso invoca a próxima atividade quantas vezes houver itens na saída.This invokes the next activity as many times as there are items in the output. Como alternativa, você pode fornecer uma única saída para a atividade habilitando a opção achatar .Alternatively, you can provide a single output for the activity by enabling the Flatten option. Ao habilitar essa opção, você deve escolher uma opção de formatação:When you enable this option, you must choose a formatting option:

  • Separar com quebras de linha.Separate with line breaks. Cada item está em uma nova linha.Each item is on a new line. Esse formato é útil para criar arquivos de texto legíveis para a saída.This format is useful for creating human-readable text files for the output.
  • Separe com.Separate with. Cada item é separado por um ou mais caracteres de sua escolha.Each item is separated by one or more characters of your choice.
  • Use o formato CSV.Use CSV format. Todos os itens estão no formato CSV (valores separados por vírgula).All items are in CSV (comma-separated value) format. Esse formato é útil para importar dados em planilhas ou em outros aplicativos.This format is useful for importing data into spreadsheets or other applications.

A atividade produzirá um novo conjunto de dados toda vez que ele for executado.The activity will produce a new set of data every time it runs. O recurso nivelar não mescla dados entre várias instâncias da mesma atividade.The Flatten feature does not flatten data across multiple instances of the same activity.

Notificações de eventosEvent Notifications

Espera-se que algumas atividades demorem um período limitado de tempo para serem concluídas.Some activities are expected to take a limited amount of time to complete. Se eles não forem concluídos dentro desse período, eles poderão estar paralisados ou pode haver outro problema, impedindo que eles sejam concluídos.If they do not complete within that time they may be stalled or there may be another issue preventing them from completing. Você pode definir o número de segundos para aguardar a conclusão da ação.You can define the number of seconds to wait for completion of the action. Após esse período, um evento de plataforma será enviado e o problema será relatado.After this period a platform event will be sent and the issue will be reported. Você também pode escolher se deseja gerar um evento de plataforma se a atividade retornar uma falha.You can also choose whether to generate a platform event if the activity returns a failure.

Para ser notificado quando a atividade demorar mais do que um tempo especificado para ser executada ou falhar na execuçãoTo be notified when the activity takes longer than a specified time to run or fails to run

  1. Na caixa notificações de eventos , insira o número de segundos de tempo de execução antes que uma notificação seja gerada.In the Event Notifications box, enter the number of seconds of run time before a notification is generated.
  2. Selecione relatório se a atividade não for executada para gerar notificações de falha de execução.Select Report if activity fails to run to generate run failure notifications.

Dados publicadosPublished Data

Os dados publicados são a base de um runbook de trabalho.Published data is the foundation of a working runbook. São os dados produzidos como resultado das ações de uma atividade.It is the data produced as a result of the actions of an activity. Esses dados são publicados em um barramento de dados interno que é exclusivo para cada runbook.This data is published to an internal data bus that is unique for each runbook. As atividades subsequentes no runbook podem assinar esses dados e usá-los em sua configuração.Subsequent activities in the runbook can subscribe to this data and use it in their configuration. As condições de link também usam essas informações para adicionar recursos de tomada de decisão a runbooks.Link conditions also use this information to add decision-making capabilities to runbooks.

Uma atividade pode assinar somente os dados das atividades que estão vinculadas antes dela no runbook.An activity can subscribe only to data from the activities that are linked before it in the runbook. Você pode usar dados publicados para preencher automaticamente os valores de propriedade necessários pelas atividades.You can use published data to automatically populate the property values needed by activities.

Para usar dados publicadosTo use published data

  1. Clique com o botão direito do mouse na caixa valor da propriedade, clique em assinare, em seguida, clique em dados publicados.Right-click the property value box, click Subscribe, and then click Published Data.
  2. Clique na caixa suspensa atividade e selecione a atividade da qual você deseja obter os dados.Click the Activity drop-down box and select the activity from which you want to obtain the data. Para exibir elementos de dados adicionais comuns a todos os runbooks, selecione Mostrar dados publicados comuns.To view additional data elements common to all runbooks, select Show Common Published Data.
  3. Clique no elemento de dados publicados que você deseja usar e, em seguida, clique em OK.Click the published data element that you want to use, and then click OK.

Para obter uma lista dos elementos de dados publicados por cada atividade, consulte a tabela de dados publicados no tópico atividade.For a list of the data elements published by each activity, see the Published Data table in the activity topic. Para obter informações sobre os itens de dados publicados comuns, consulte dados publicados comuns.For information about the common published data items, see Common Published Data.

AtividadesActivities

Este pacote de integração adiciona a categoria FTP ao painel atividade na runbook designer.This integration pack adds the FTP category to the Activity pane in the Runbook Designer. Essa categoria contém as seguintes atividades:This category contains the following activities:

Criar pastaCreate Folder
Excluir arquivoDelete File
Excluir PastaDelete Folder
Baixar arquivoDownload File
Listar pastas/arquivosList Folders/Files
Renomear arquivo/pastaRename File/Folder
Retomar download de arquivoResume File Download
Sincronizar pasta/arquivoSynchronize Folder/File
Carregar arquivoUpload File