ÍNDICE
- Visão Geral
- Exemplo de utilização
- Como utilizar a atividade "Para cada iteração" para executar em uma API
01. VISÃO GERAL
O objetivo deste documento é mostrar como deve ser utilizada a atividade "Para cada Iteração" de uma Fórmula Visual. Essa atividade cria um foreach na Fórmula Visual, percorrendo todos os registros.
02. EXEMPLO DE UTILIZAÇÃO
Para nosso exemplo, vamos utilizar as seguintes atividades:
- Criar Coluna na Tabela
- Consulta SQL
- Para cada Iteração
- Sequência
- Localizar Registro na Tabela
- Expressão
Essa Fórmula Visual adicionará uma coluna no grid da tela de Coligadas, chamada de 'Coluna_Teste' e em cada linha terá a palavra 'Teste' antes do Nome da Coligada.
| Informações |
|---|
|
| Deck of Cards |
|---|
| id | Configurando o Aplicativo Confiável no ADFS |
|---|
| | Card |
|---|
| Primeiramente, é necessário arrastar a atividade "Criar Coluna na Tabela" para o "fluxo de trabalho" sequencial em sua fórmula visual. Em seguida, preencha as propriedades como Nome da Coluna, que será o nome exibido no grid e a Tabela, que nesse exemplo será um DataTable.  Image Added
|
| Card |
|---|
| Depois, adicione uma atividade "Consulta SQL". Clique com o Botão direito do mouse na atividade e selecione uma consulta SQL e localize a Consulta criada. Neste exemplo foi criada a consulta 'TesteColunaFV', com a seguinte query: "select codcoligada, nome from gcoligada (NOLOCK)".  Image Added
Atividade de Consulta SQL na FV:  Image Added
|
| Card |
|---|
| Adicione a atividade 'Para cada Iteração'. Essa atividade permite fazer um fluxo de tarefas para cada item da coleção informada. Neste exemplo, vamos usar a coluna criada na primeira atividade e percorrer suas linhas.  Image Added
Propriedades - Nome: Nome da Atividade
- Descrição: Descrição da Atividade
- Habilitado: Opção de habilitar ou desabilitar a atividade
- Campos:
- Item Atual:
- Iterating:
- Linha Atual:
- Lista de Itens: Deve ser informado onde está a listagem que será percorrida no Foreach.
|
|---|
|
| Card |
|---|
| Adicione a atividade de sequência, para informar as atividades que serão feitas para cada item do foreach.  Image Added
|
| Card |
|---|
| A seguir, basta adicionar as atividades que serão executadas para cada linha. Neste exemplo, com a atividade 'Localizar Registro na Tabela', vamos associar o registro da nova coluna com os resultados retornados na consulta SQL, por meio da PK, que é a CODCOLIGADA.  Image Added
|
| Card |
|---|
| E por fim, com a atividade de 'Expressão', vamos alterar o texto que será inserido em cada linha da nova coluna. Neste exemplo usaremos a string 'Teste' + nome da Coligada:  Image Added
|
| Card |
|---|
| salve a Fórmula Visual. Neste exemplo utilizamos o gatilho 'Após a Leitura da Visão' para o DataServer de Coligada. Após abrir a tela de Coligada, foi exibida a coluna criada, como esperado.  Image Added
|
|
|
03. COMO UTILIZAR A ATIVIDADE DE "PARA CADA ITERAÇÃO" PARA EXECUTAR EM UMA API
Em execuções em API, a atividade de foreach tem o mesmo comportamento do descrito acima. Mas é necessário utilizar a atividade 'Para Cada Iteração (API)'.
No exemplo abaixo vamos mostrar como referenciar um campo da API como Lista de Itens do Foreach. Vamos considerar que o contexto de Coligada (CompanyCrudserver) já esteja selecionado. Leia mais sobre Fórmula Visual em API.
Assim como as outras atividades em uma FV para API, após selecionar o Contexto e clicar em 'Ligações', serão listadas as propriedades da API do contexto para facilitar o uso da atividade.
Image Added
| Informações |
|---|
|
- Lembre-se de que deve ser selecionado o objeto a ser percorrido. Nesse caso, nunca selecione o tipo, pois a tipagem não deve ser parte da estrutura de repetição
|
Produto | : | TOTVS Framework |
Processo | : | Fórmula Visual |
Subprocesso | : | Utilizando a atividade "Para cada Iteração" |
Data da publicação | : | 21/07/2014 |
| Informações |
|---|
| title | Para maiores informações: |
|---|
|
Consulte o WikiHelp TOTVS  Image Removed COMUNIDADE @FRAMEWORK
Canais de Atendimento:
Chamado: Através do Portal Totvs www.suporte.totvs.com.br Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 4 – (BI) e 3 – (Gerador de Relatórios e Planilha) |
