Compartilhar via


Para cada atividade de Loop

 

Publicado: março de 2016

Aplicável a: System Center 2012 SP1 - Service Manager, System Center 2012 R2 Service Manager, System Center 2012 - Service Manager

O para cada Loop atividade utiliza como entrada uma matriz (coleção) de objetos e o conjunto de atividades dentro do loop é repetida para cada objeto na coleção. Por exemplo, se a coleção de entrada tem cinco objetos, o loop repete cinco vezes. Se a coleção estiver vazia, o loop não será iterado. Não há um limite superior ao número de objetos na coleção. O para cada Loop atividade sempre é executado no computador no qual o fluxo de trabalho é executado.

O para cada Loop atividade é uma atividade composta com dois contêineres de atividades:

  • Contêiner de entrada: esta atividade configura o loop e define a coleção de entrada. Você pode usar o obter incidente ou o obter Máquina Virtual atividade nessa função.

  • Contêiner de loop: chamado ForEachChildActivity, essa atividade contém as atividades de loop. A maioria das atividades Windows Workflow Foundation (WF) que você coloque neste contêiner têm duas propriedades adicionais: Item atual e propriedade de ligação. Para cada atividade dentro do contêiner de loop, defina essas propriedades da seguinte maneira:

    1. Definir Item atual para o Item atual propriedade o contêiner Loop atividade do ForEach atividade. Observe que, se essa atividade é a primeira atividade de Loop For Each atividade, Item atual é definida automaticamente.

    2. Defina o valor da propriedade de ligação propriedade para o valor da propriedade da atividade que usa o Item atual valor.

    Dois tipos de atividades não obter o Item atual e propriedade de ligação Propriedades e, portanto, não é possível usar os objetos na coleção de entrada:

    • Script de atividades, como o Script do Windows PowerShell atividade.

    • Atividades personalizadas ou outras atividades que não herdam o WorkflowActivityBase classe. Essas atividades incluem as atividades que se baseiam os atividade base classe, como atividades nativas do Visual Studio.

Pré-requisitos do tempo de design

nenhuma.

Pré-requisitos do tempo de execução

nenhuma.

Propriedades

O para cada Loop atividade usa as propriedades de entrada que são descritas na tabela a seguir.

Nome para exibição Nome interno Tipo Necessária Descrição
Coleção de Entrada InputCollection Matriz/Objeto N/D Uma coleção de objetos a serem passados, um de cada vez, para as atividades dentro o para cada Loop atividade. Se a atividade que reside no contêiner de entrada produz uma matriz de objetos como sua propriedade de saída, coleção entrada é definida automaticamente para essa propriedade. Para exibir o valor atual dessa propriedade, clique o contêiner de loop e, em seguida, clique em propriedades.
Item Atual CurrentItem Objeto N/D Um índice em coleção entrada que atividades dentro do loop podem usar como uma propriedade de entrada. Para a primeira atividade no contêiner de loop, essa propriedade é definida automaticamente.

Erros e exceções

O para cada Loop atividade usa o serviço de controle personalizado que é fornecido pelo Service Manager para registrar erros e exceções quando a atividade é executada. A atividade gera erros ou exceções nas seguintes condições:

  • Se ocorrer algum erro no ForEachLoop atividade e que não é com as atividades filho, o fluxo de trabalho é encerrado.

  • Se ocorrer algum erro em atividades filho, o fluxo de trabalho é encerrado, a menos que ContinueOnError= true.

  • Se qualquer uma das propriedades de entrada for nula. A atividade não é iterada.

Cada atividade dentro de para cada Loop atividade deve escrever seus próprios erros ou exceções para o serviço de controle personalizado. O para cada Loop atividade não fazê-lo em si.

Comentários

nenhuma.

Exemplo

nenhuma.

Consulte também

Excluir atividades de fluxo de controle [ SM2012_AuthoringGuide ]