Configurar Serviço: Guia Gerenciamento do Host de Fluxo de Trabalho

Use a guia Gerenciamento do Host de Fluxo de Trabalho na caixa de diálogo Configurar Serviço para configurar os seguintes recursos de hospedagem para um serviço.

Importante

Essa guia está disponível apenas para os serviços de fluxo de trabalho (WF); não está disponível para serviços baseados em código WCF.

Campos de Diálogo

Campo	Descrição
Habilitar controle de instância	Selecione essa caixa de seleção para Habilitar controle de instâncias desse serviço. Se você não tiver o protocolo net.pipe habilitado para o aplicativo que contém o serviço, verá a seguinte mensagem de aviso na parte superior da guia. Aviso “O controle de instância não está funcional porque o protocolo net.pipe está ausente da lista de protocolos habilitados do aplicativo” Você verá também uma caixa de mensagem com o texto a seguir ao selecionar a opção Habilitar controle de instância e o protocolo net.pipe não estiver habilitado no aplicativo que contém o serviço. Aviso O controle de instância requer que o protocolo net.pipe esteja habilitado no aplicativo. Deseja habilitar o net.pipe ao aplicar as alterações? Se você clicar em Sim e aplicar as configurações, o protocolo net.pipe será habilitado no aplicativo. Como alternativa, é possível habilitar manualmente o protocolo net.pipe para o aplicativo seguindo as etapas descritas abaixo. No Gerenciador do IIS, clique com o botão direito do mouse no nome do aplicativo que contém o serviço. Aponte para Gerenciar Aplicativo e clique em Configurações Avançadas para iniciar. Na caixa de diálogo Configurações Avançadas adicione um caractere de , (vírgula) seguido por net.pipe ao valor do campo Protocolos Habilitados. Clique em OK para fechar a caixa de diálogo Configurações Avançadas e clique em Fechar para fechar a caixa de diálogo Associações do Site. Também é necessário ter a associação net.pipe habilitada para o site que contém o serviço. Para habilitar a associação net.pipe no nível de site: Clique com o botão direito do mouse no nome do site no Gerenciador do IIS e clique em Editar Associações para iniciar a caixa de diálogo Associações do Site. Se você não vir a associação net.pipe na caixa de diálogo Associações do Site, clique em Adicionar para iniciar a caixa de diálogo Adicionar Associação do Site. Na caixa de diálogo Adicionar Associação do Site, selecione net.pipe para o campo Tipo e digite * para o campo Associação. Clique em OK para fechar a caixa de diálogo Adicionar Associação do Site e clique em Fechar para fechar a caixa de diálogo Associações do Site.
Descarregar as instâncias quando ocioso	Selecione esta caixa de seleção para que as instâncias de serviço de fluxo de trabalho que estiverem ociosas por um determinado período de tempo sejam descarregadas da memória e para serem mantidas no banco de dados de persistência.
Tempo limite de descarregamento (em segundos)	Especifique quanto tempo uma instância de serviço de fluxo de trabalho pode permanecer em estado ocioso antes de o host descarregá-la da memória e manter as informações de estado da instância no banco de dados de persistência. O valor padrão para este parâmetro é de 60 segundos. Se o valor for definido como 0, o host persiste radicalmente e descarrega uma instância assim que a instância se tornar ociosa. O valor máximo permitido é TimeSpan.MaxValue.
Persistir as instâncias quando ocioso	Selecione esta caixa de seleção para que as informações de estado das instâncias de serviço de fluxo de trabalho que estiverem ociosas por um determinado período de tempo sejam mantidas no banco de dados de persistência. As instâncias não são descarregadas da memória neste cenário. O valor padrão para essa propriedade é TimeSpan.MaxValue.
Tempo limite de persistência (em segundos)	Especifique quanto tempo uma instância de serviço de fluxo de trabalho pode permanecer em estado ocioso antes de o host torná-la persistente no banco de dados de persistência. É possível especificar um valor para este campo somente se a opção Persistir quando ocioso estiver marcada. O valor padrão para esse parâmetro é de TimeSpan.MaxValue segundos. Quando o valor desse parâmetro é configurado para TimeSpan.MaxValue, o tempo de execução nunca persiste instâncias de fluxo de trabalho quando elas estão ociosas. Se o valor é definido como 0, o host persiste radicalmente uma instância assim que a instância se tornar ociosa. Da mesma forma, se ambos Persistir quando ocioso e Descarregar quando ocioso estiverem selecionados, o valor de Tempo limite de persistência deverá ser menor que o valor de Tempo limite de descarregamento, ou a instância não persistirá.
Ação em exceção sem tratamento	Especifique qual ação o host deve tomar quando uma instância tem uma exceção sem tratamento. Os valores permitidos são: Abandonar, Abandonar e Suspender, Terminar e Cancelar. O valor padrão é Abandonar. A lista a seguir fornece as descrições destas opções. Abandonar. O host de serviço anula a instância de serviço do fluxo de trabalho na memória. O estado da instância no banco de dados permanece “Ativo”. O Serviço de Gerenciamento de Fluxo de Trabalho recupera a instância de fluxo de trabalho abandonada a partir do último ponto de persistência no banco de dados de persistência. Abandonar e Suspender. O host de serviço anula a instância de serviço do fluxo de trabalho na memória e define o estado da instância no banco de dados de persistência para “Suspenso”. Uma instância suspensa pode ser continuada ou encerrada posteriormente usando o Gerenciador do IIS. Essas instâncias não são recuperadas automaticamente pelo Serviço de Gerenciamento de Fluxo de Trabalho. Terminar. O host de serviço anula a instância de serviço do fluxo de trabalho na memória e configura o estado da instância no banco de dados de persistência para “Concluído (Terminado)”. Uma instância terminada não pode ser continuada posteriormente. Cancelar. O host de serviço cancela a instância de serviço do fluxo de trabalho causando a chamada de todos os manipuladores de cancelamento de forma que um fluxo de trabalho termine de forma correta e define o estado da instância no banco de dados de persistência como “Concluído (Cancelado)”.

Configurações Relacionadas

Os campos da guia Gerenciamento do Host de Fluxo de Trabalho correspondem aos seguintes elementos e atributos no arquivo de configuração.

<behaviors>
    <serviceBehaviors>
        <behavior name="TutorialServiceConfiguration">
            <workflowInstanceManagement authorizedWindowsGroup="AS_Administrators" /><workflowUnhandledException action="AbandonAndSuspend" /><workflowIdle timeToUnload="00:01:00" timeToPersist="00:00:20" />
        </behavior>
   </serviceBehaviors>
</behaviors>

A lista a seguir contém atributos ou elementos XML que são associados aos elementos da interface do usuário nessa caixa de diálogo.

Elemento da Interface do Usuário	Atributo ou Elemento XML	Comentários
Habilitar controle de instância	Elemento workflowInstanceManagment	Ao marcar esta opção, o elemento workflowInstanceManagement é adicionado ao elemento de comportamento associado ao serviço se o elemento ainda não existir. Ao desmarcar esta opção, o elemento workflowInstanceManagement é removido. Dica O atributo authorizedWindowsGroup no elemento workflowInstanceManagement é definido como o grupo AS_Administrators. Essa guia não permite que você altere o valor desse atributo. Para atribuir um grupo do Windows diferente para essa função, altere o valor desse atributo diretamente no arquivo de configuração.
Descarregar instâncias quando ocioso	Elemento workflowIdle	Ao marcar esta opção, o elemento workflowIdle é adicionado ao elemento de comportamento associado ao serviço se o elemento workflowIdle ainda não existir. Ao desmarcar esta opção, o elemento workflowIdle é removido se a opção Persistir quando ocioso estiver desmarcada; se a opção Persistir quando ocioso estiver marcada, o elemento workflowIdle é mantido e o valor do atributo timeToUnload é definido como TimeSpan.MaxValue.
Tempo limite de descarregamento (em segundos)	Atributo timeToUnload no elemento workflowIdle	O valor do atributo timeToUnload para o elemento workflowIdle é definido como o valor especificado nesse campo.
Persistir instâncias quando ocioso	Elemento workflowIdle	Ao marcar esta opção, o elemento workflowIdle é adicionado se o elemento ainda não existir no elemento de comportamento associado ao serviço, o elemento <workflowIdle> é adicionado e o valor do atributo timeToPersist no elemento workflowIdle é definido como o valor especificado para o campo Tempo limite de persistência e o valor do atributo timeToUnload é definido como TimeSpan.MaxValue. Ao desmarcar esta opção, o elemento workflowIdle é removido se o valor da opção unloadOnIdle não estiver marcado; se a opção unloadOnIdle estiver marcada, o elemento workflowIdle é mantido e o valor do atributo timeToPersist é definido como TimeSpan.MaxValue segundos.
Tempo limite de persistência (em segundos)	Atributo timeToPersist no elemento workflowIdle	O valor do atributo timeToPersist do elemento workflowIdle é definido como o valor especificado para o campo Tempo limite de persistência (em segundos).
Ação em exceção sem tratamento	atributo de ação no elemento workflowUnhandledException	Ao selecionar um valor para este campo, o elemento workflowUnhandledException é adicionado se o elemento ainda não existir no arquivo de configuração e o valor do atributo de ação no elemento é definido como o valor especificado nesse campo.

  2011-12-05