Configurar o WCF e o WF para o Servidor, Site, Aplicativo ou Diretório Virtual: Guia Gerenciamento do Host de Fluxo de Trabalho

Use a guia Gerenciamento de Host de Fluxo de Trabalho das caixas de diálogo Configurar o WCF e o WF para o Servidor, Configurar o WCF e o WF para o Site, Configurar o WCF e o WF para o Aplicativo e Configurar o WCF e o WF para o Diretório para configurar os seguintes recursos de hospedagem para um serviço.

Campos da caixa de diálogo

Campo	Descrição
Habilitar controle de instância	Marque essa caixa de seleção para Habilitar controle de instâncias desse serviço. Se o protocolo net.pipe não estiver habilitado para o aplicativo que contém o serviço, você verá a seguinte mensagem de aviso na parte superior da guia se a configuração for para os níveis de aplicativo ou de diretório virtual. Aviso “O controle de instâncias não é funcional porque o protocolo net.pipe está ausente na lista de protocolos habilitados do aplicativo.” Você também verá uma caixa de mensagem com o seguinte texto se 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 exige que o protocolo net.pipe esteja habilitado no aplicativo. Deseja habilitar o protocolo net.pipe quando as alterações forem aplicadas? Se você clicar em Sim e aplicar as configurações, o protocolo net.pipe será habilitado no aplicativo. Você também pode habilitar manualmente o protocolo net.pipe para o aplicativo executando as etapas descritas a seguir. 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 para o valor do campo Protocolos Habilitados. Clique em OK para fechar a caixa de diálogo Configurações Avançadas e, em seguida, clique em Fechar para fechar a caixa de diálogo associações do Site. A associação do net.pipe também deve estar habilitada para o site que contém o serviço. Para habilitar a associação do net.pipe no nível de um site: Clique com o botão direito do mouse no nome do site no Gerenciador do IIS e clique em Editar associações para abrir a caixa de diálogo associações do Site. Se você não visualizar a associação do net.pipe na caixa de diálogo associações do Site, clique em Adicionar para abrir 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 * no 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. Você verá a seguinte mensagem de aviso no nível de um site se a associação de net.pipe não estiver habilitada no site. Aviso O controle de instâncias não é funcional porque a associação do net.pipe não está habilitada para esse site. Além disso, você sempre verá a seguinte mensagem de aviso no nível do servidor. Você não verá essa mensagem no nível do site. No entanto, no nível do site, como mencionado anteriormente neste tópico, você verá uma mensagem de aviso quando a ligação do net.pipe não estiver habilitada para o site. Aviso O Controle de Instância pode não ser funcional. Para os aplicativos que exigem o controle de instâncias, verifique se o protocolo net.pipe está incluído na lista de protocolos habilitados e se a associação do net.pipe está incluída na lista de associações no site.
Descarregar instâncias quando ocioso	Marque essa caixa de seleção para que as instâncias de serviço de fluxo de trabalho que estiverem ociosas por um determinado período sejam descarregadas da memória e sejam persistentes no banco de dados de persistência.
Tempo limite de descarregamento (em segundos)	Especifique por quanto tempo uma instância de serviço de fluxo de trabalho pode ficar no estado ocioso antes de o host descarregá-la da memória e persistir as informações de estado da instância no banco de dados de persistência. O valor padrão para esse parâmetro é 60 segundos. Se o valor for definido como 0, o host agressivamente persistirá e descarregará uma instância assim que ela ficar ociosa. O valor máximo permitido é TimeSpan.MaxValue.
Persistir instâncias quando ocioso	Marque essa 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 sejam persistidas no banco de dados de persistência. As instâncias não são descarregadas da memória nesse cenário. O valor padrão para essa propriedade é TimeSpan.MaxValue.
Tempo limite de persistência (em segundos)	Especifique por quanto tempo uma instância de serviço de fluxo de trabalho pode ficar no estado ocioso antes de o host persisti-la no banco de dados de persistência. Você pode especificar um valor para esse campo apenas se a opção Persistir quando ociosa estiver selecionada. O valor padrão para esse parâmetro é TimeSpan.MaxValue. Quando o valor desse parâmetro for definido como TimeSpan.MaxValue, o tempo de execução nunca persistirá as instâncias de fluxo de trabalho quando elas estiverem ociosas. Se o valor for definido como 0, o host agressivamente persistirá uma instância assim que ela ficar ociosa. Além disso, se as opções Persistir quando ociosa e Descarregar quando ociosa tiverem sido selecionadas, o valor de Tempo limite de persistência deverá ser inferior ao valor de Tempo limite de descarregamento, ou a instância não será persistida.
Ação em exceção sem tratamento	Especifique a ação que o host deve executar quando uma instância sofre uma exceção sem tratamento. Os valores permitidos são: Abandonar, Abandonar e Suspender, Terminar e Cancelar. O valor padrão é AbandonAndSuspend. A lista a seguir fornece as descrições dessas opções. Abandon. O host do serviço anula a instância de serviço de fluxo de trabalho na memória. O estado da instância no banco de dados permanece como “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 salvo no banco de dados de persistência. Abandon and suspend. O host do serviço anula a instância de serviço de fluxo de trabalho na memória e define o estado da instância como “Suspenso” no banco de dados de persistência. Uma instância suspensa pode ser retomada ou finalizada posteriormente usando o Gerenciador do IIS. Essas instâncias não são recuperadas automaticamente pelo Serviço de Gerenciamento de Fluxo de Trabalho. Terminate. O host do serviço anula a instância de serviço de fluxo de trabalho na memória e define o estado da instância como “Concluído (Terminado)” no banco de dados de persistência. Uma instância encerrada não pode ser retomada posteriormente. Cancel. O host do serviço cancela a instância de serviço de fluxo de trabalho, o que faz com que todos os manipuladores de cancelamento sejam invocados para que um fluxo de trabalho seja encerrado de maneira amigável, e define o estado da instância como “Concluído (Cancelado)” no banco de dados de persistência.

Configurações Relacionadas

Os campos na guia Gerenciamento de Host de Fluxo de Trabalho correspondem aos seguintes elementos e atributos do 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 a elementos da interface do usuário dessa caixa de diálogo.

Elemento da Interface do Usuário	Atributo ou Elemento XML	Comentários
Habilitar controle de instância	Elemento workflowInstanceManagment	Quando essa opção está selecionada, o elemento workflowInstanceManagement é adicionado ao elemento de comportamento associado ao serviço se o elemento ainda não existir. Quando essa opção não está selecionada, o elemento workflowInstanceManagement é removido. Dica O atributo authorizedWindowsGroup no elemento workflowInstanceManagement é definido como grupo AS_Administrators. Nessa guia você não tem permissão para alterar 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	Quando essa opção está selecionada, o elemento workflowIdle é adicionado ao elemento de comportamento associado ao serviço se o elemento workflowIdle ainda não existir. Quando essa opção não está selecionada, o elemento workflowIdle é removido se a opção Persistir quando ociosa não tiver sido selecionada; se a opção Persistir quando ociosa tiver sido selecionada, o elemento workflowIdle será mantido e o valor do atributo timeToUnload será definido como TimeSpan.MaxValue.
Tempo limite de descarregamento (em segundos)	Atributo timeToUnload no elemento workflowIdle	O valor do atributo timeToUnload do elemento workflowIdle é definido com o valor especificado para esse campo.
Persistir instâncias quando ocioso	Elemento workflowIdle	Quando essa opção está selecionada, o elemento workflowIdle é adicionado se ainda não existir no elemento de comportamento associado ao serviço, o elemento <workflowIdle> é adicionado e o valor do atributo timeToPersist em workflowIdle é definido com o valor especificado no campo Tempo limite de persistência e o valor do atributo timeToUnload é definido como TimeSpan.MaxValue. Quando essa opção não está selecionada, o elemento workflowIdle é removido se o valor da opção unloadOnIdle não tiver sido selecionado; se a opção unloadOnIdle estiver selecionada, o elemento workflowIdle será mantido e o valor do atributo timeToPersist será definido como TimeSpan.MaxValue.
Tempo limite de persistência (em segundos)	Atributo timeToPersist no elemento workflowIdle	O valor do atributo timeToPersist do elemento workflowIdle é definido com o valor especificado para o campo Tempo limite de persistência (em segundos).
Ação em exceção sem tratamento	Atributo action no elemento workflowUnhandledException	Quando você seleciona um valor para esse campo, o elemento workflowUnhandledException é adicionado se ainda não existir no arquivo de configuração e o valor do atributo action no elemento é definido com o valor especificado por você para esse campo.

  2011-12-05