Instalar e configurar o fluxo de trabalho para o SharePoint Server

APLICA-SE A:2013 2019 Subscription Edition SharePoint no Microsoft 365

Este artigo contém as informações e os procedimentos necessários para configurar o SharePoint Gerenciador de Fluxos de Trabalho (SPWFM) para o SharePoint Server.

Observação

Há dois produtos separados do mecanismo de fluxo de trabalho que alimentam a plataforma de fluxo de trabalho do SharePoint 2013: Microsoft Gerenciador de Fluxos de Trabalho ("Classic WFM") e SharePoint Gerenciador de Fluxos de Trabalho (SPWFM). O Microsoft Gerenciador de Fluxos de Trabalho não está mais disponível para ser instalado, enquanto o Gerenciador de Fluxos de Trabalho do SharePoint foi lançado para substituí-lo. Portanto, as instruções descritas neste documento explicam como instalar o SharePoint Gerenciador de Fluxos de Trabalho.

Visão Geral

Existe uma nova opção ao criar um fluxo de trabalho para o SharePoint Server. Essa opção é chamada Tipo de Plataforma. A figura mostra a opção Tipo de Plataforma ao criar um novo fluxo de trabalho usando o SharePoint Designer 2013.

Figura: o SharePoint Server inclui três opções de plataforma de fluxo de trabalho.

A única plataforma disponível quando você instala o SharePoint Server pela primeira vez é a plataforma de fluxo de trabalho do SharePoint 2010. A plataforma de fluxo de trabalho do SharePoint 2013 e a plataforma do Project Server exigem mais etapas. As três plataformas do fluxo de trabalho são descritas na tabela a seguir.

Plataforma de Fluxos de Trabalho tipos disponíveis no SharePoint Server

Tipo de plataforma	Estrutura da plataforma	Requisitos
Fluxo de trabalho do SharePoint 2010	Windows Workflow Foundation 3	Instala-se automaticamente com o SharePoint Server.
Fluxo de trabalho do SharePoint 2013	Windows Workflow Foundation 4	Requer Gerenciador de Fluxos de Trabalho do SharePoint ou microsoft Gerenciador de Fluxos de Trabalho e SharePoint Server.
Fluxo de trabalho do SharePoint 2013 - Project Server	Windows Workflow Foundation 4	Requer Gerenciador de Fluxos de Trabalho do SharePoint ou microsoft Gerenciador de Fluxos de Trabalho e servidor project.

Observação

O Gerenciador de Fluxos de Trabalho do SharePoint deve ser baixado e instalado separadamente do SharePoint Server. Ele não é instalado automaticamente quando você instala o SharePoint Server.

Nova instalação do SharePoint Gerenciador de Fluxos de Trabalho

Os Gerenciador de Fluxos de Trabalho do SharePoint podem ser instalados nos mesmos servidores que o SharePoint ou em servidores separados e dedicados. É recomendável que o SharePoint Gerenciador de Fluxos de Trabalho seja instalado em seus próprios servidores dedicados por motivos de desempenho e confiabilidade.

Observação

O SharePoint Gerenciador de Fluxos de Trabalho tem suporte em fazendas com um número ímpar de hosts, por exemplo, 1, 3 ou 5. Não há suporte para um farm com 2 ou 4 hosts do SharePoint Gerenciador de Fluxos de Trabalho.

Pré-requisitos

O SharePoint Gerenciador de Fluxos de Trabalho requer a função de servidor do Web Server (IIS). Se você estiver instalando o SharePoint Gerenciador de Fluxos de Trabalho em um servidor sem a função do servidor IIS instalada, o Assistente de Configuração Gerenciador de Fluxos de Trabalho falhará com uma mensagem como Não foi possível carregar arquivo ou assembly 'Microsoft.Web.Administration'. Além dos recursos instalados por padrão com a função do Servidor Web, o SharePoint Gerenciador de Fluxos de Trabalho requer os seguintes recursos do Web Server:

• Autenticação do Windows (em Segurança)
• Extensibilidade do .NET 4.7 (em Desenvolvimento de Aplicativos)
• ASP.NET 4.7 (em Desenvolvimento de Aplicativos)

Observação

O SharePoint Gerenciador de Fluxos de Trabalho pode não ser instalado e configurado corretamente com apenas RODCs (controladores de domínio somente leitura) disponíveis no ambiente de rede. Ele requer um RWDC (controlador de domínio de leitura/gravação). O SharePoint Gerenciador de Fluxos de Trabalho requer o Azure Service Fabric, que deve ser instalado antes de executar a instalação do SharePoint Gerenciador de Fluxos de Trabalho. Se o Azure Service Fabric Runtime ainda não estiver instalado, siga estas etapas abaixo para instalá-lo:

1. A versão mínima do Azure Service Fabric Runtime compatível com o SharePoint Gerenciador de Fluxos de Trabalho é 9.1.1583.9590 e você pode baixá-lo no Azure Service Fabric Runtime. Ou você pode encontrar e baixar qualquer versão mais alta do instalador do Windows a partir daqui.

2. Abra um console do PowerShell como um administrador elevado e execute o seguinte comando:

   .\MicrosoftServiceFabric.9.1.1583.9590.exe /accepteula

3. Para verificar se o Azure Service Fabric está instalado, você deve ser capaz de encontrá-lo nos programas e recursos do Painel de Controle.

Observação

O SharePoint Gerenciador de Fluxos de Trabalho dá suporte à versão 9.1 CU2 (9.1.1583.9590) do Azure Service Fabric e versões mais altas.

Se Windows Fabric já estiver instalado em seu computador, você deverá desinstalá-lo antes de instalar o Azure Service Fabric.

Foi relatado que o Azure Service Fabric pode gerar um grande número de logs, reduzindo o espaço em disco. Isso pode ocorrer independentemente da carga de trabalho Gerenciador de Fluxos de Trabalho do SharePoint. Você pode identificar esse problema examinando os arquivos gerados no %ProgramData%\Microsoft Service Fabric\Log\Traces diretório. Você não pode controlar o tamanho do log por meio da configuração do cluster, com apenas o Azure Service Fabric Runtime instalado. Talvez seja necessário excluir logs expirados manualmente ou, por exemplo, criar uma tarefa periódica por meio do Agendador de Tarefas do Windows para fazê-lo.

Instalar o Gerenciador de Fluxos de Trabalho do SharePoint

SharePoint Gerenciador de Fluxos de Trabalho e SharePoint Gerenciador de Fluxos de Trabalho Client podem ser baixados aqui. Os requisitos do sistema também podem ser encontrados nessa página.

Instale o SharePoint Gerenciador de Fluxos de Trabalho e o SharePoint Gerenciador de Fluxos de Trabalho Client em todos os servidores do farm Gerenciador de Fluxos de Trabalho.

Instale apenas o SharePoint Gerenciador de Fluxos de Trabalho Client em todos os servidores no farm do SharePoint Server.

Observação

Embora tenha suporte para instalar o SharePoint Gerenciador de Fluxos de Trabalho em servidores que executam o SharePoint Server, é recomendável que o SharePoint Gerenciador de Fluxos de Trabalho esteja instalado em seus próprios servidores dedicados por motivos de desempenho e confiabilidade.

Configurar o farm de Gerenciador de Fluxos de Trabalho do SharePoint

Para criar um farm do SharePoint Gerenciador de Fluxos de Trabalho e ingressar seus servidores no farm, você pode configurar o SharePoint Gerenciador de Fluxos de Trabalho por meio do Assistente de Configuração Gerenciador de Fluxos de Trabalho.

Logon no servidor Gerenciador de Fluxos de Trabalho do SharePoint, clique em "Configuração de Gerenciador de Fluxos de Trabalho" e clique em "Configurar Gerenciador de Fluxos de Trabalho com configurações padrão" ou "Configurar Gerenciador de Fluxos de Trabalho com Configurações Personalizadas", dependendo dos requisitos. Se você quiser usar portas diferentes, certificados personalizados ou nomes de banco de dados personalizados, você deseja usar a opção "Configurar Gerenciador de Fluxos de Trabalho com Configurações Personalizadas".

Neste exemplo, usaremos a opção Configurações Padrão.

Observação

Por padrão, apenas a porta HTTPS (TLS/SSL) 12290 está configurada para o site gerenciamento de fluxo de trabalho. Se você também quiser permitir a comunicação por meio da porta HTTP não criptografada 12291, selecione a caixa marcar "Permitir Gerenciamento de Fluxo de Trabalho por HTTP neste computador". Esse é um fator ao executar o cmdlet Register-SPWorkflowService posteriormente. Forneça os detalhes necessários da SQL Server e da conta de serviço no assistente de fluxo de trabalho.

O assistente de configuração fornecerá um resumo de suas escolhas antes de serem confirmadas.

Observação

Alguns dos valores são selecionados para você quando você usa a opção "Configurar Gerenciador de Fluxos de Trabalho com configurações padrão". Se eles não estiverem corretos para seu ambiente, talvez seja necessário iniciar o assistente e escolher "Configurar Gerenciador de Fluxos de Trabalho com Configurações Personalizadas".

O assistente de configuração deve ser concluído com êxito. Se falhar, selecione o link "Exibir Log", localize o problema e corrija-o antes de executar o assistente novamente.

Se você estiver criando um farm de Gerenciador de Fluxos de Trabalho do SharePoint de vários servidores, deverá executar o assistente de configuração do fluxo de trabalho nos outros nós e escolheu a opção "Ingressar em um Farm de Gerenciador de Fluxos de Trabalho existente".

Configurar serviços de Configurações de Gerenciamento de Aplicativos e Assinaturas no farm do SharePoint

Os serviços de Gerenciamento de Aplicativos e Configurações de Assinatura são necessários no farm do SharePoint para que os fluxos de trabalho da plataforma do SharePoint 2013 funcionem. Se ainda não estiver configurado no farm do SharePoint, no servidor do SharePoint, configure serviços de Gerenciamento de Aplicativos e Configurações de Assinatura, aplicativos de serviço e proxies de aplicativo de serviço.

O serviço de Gerenciamento de Aplicativos pode ser criado usando a Administração Central.

Você pode usar o PowerShell para criar um aplicativo do Serviço de Configurações de Assinatura:

$sa = New-SPSubscriptionSettingsServiceApplication -ApplicationPool 'SharePoint Web Services Default' -Name 'Subscriptions Settings Service Application' -DatabaseName 'Subscription'

New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $sa

Configurar a Gerenciador de Fluxos de Trabalho do SharePoint para trabalhar com o farm do SharePoint Server

Considere os seguintes fatores-chave antes de configurar o SharePoint Gerenciador de Fluxos de Trabalho trabalhar com o SharePoint Server.

• A comunicação entre o SharePoint Gerenciador de Fluxos de Trabalho e o SharePoint Server usará HTTP ou HTTPS?

Observação

[!OBSERVAçãO] Por motivos de segurança, recomendamos usar HTTPS para um ambiente de produção.

Para configurar o SharePoint Gerenciador de Fluxos de Trabalho em um ambiente em que a comunicação ocorre usando HTTP

Observação

Por padrão, apenas a porta HTTPS (TLS/SSL) 12290 está configurada para o site gerenciamento de fluxo de trabalho. Para configurar o uso de HTTP, a caixa de marcar "Permitir Gerenciamento de Fluxo de Trabalho por HTTP neste computador" deveria ter sido selecionada ao executar o assistente "Configuração Gerenciador de Fluxos de Trabalho" em uma etapa anterior.

1. Entre em cada servidor no farm do SharePoint Server.

2. Instale o SharePoint Gerenciador de Fluxos de Trabalho Client em cada servidor no farm do SharePoint.

   Importante

   Você deve instalar o SharePoint Gerenciador de Fluxos de Trabalho Client em cada servidor no farm do SharePoint antes de executar o cmdlet Register-SPWorkflowService.

3. Em um servidor do SharePoint, abra o Shell de Gerenciamento do SharePoint como administrador clicando com o botão direito do mouse no comando Shell de Gerenciamento do SharePoint e escolhendo Executar como administrador.

4. Execute o cmdlet Register-SPWorkflowService para conectar o farm do SharePoint com o farm Gerenciador de Fluxos de Trabalho do SharePoint. O cmdlet deve ser executado apenas uma vez e pode ser executado a partir de qualquer servidor no farm do SharePoint.

   Observação

   O valor do parâmetro -SPSite pode ser qualquer coleção de sites válida no farm do SharePoint. O valor correto para o parâmetro -WorkflowHostUri pode ser encontrado executando o PowerShell Get-WFFarm | select endpoints no servidor Gerenciador de Fluxos de Trabalho do SharePoint.

   Exemplo:

   Register-SPWorkflowService -SPSite "http://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -AllowOAuthHttp
   

Para configurar o SharePoint Gerenciador de Fluxos de Trabalho em um ambiente em que a comunicação ocorre usando HTTPS

1. Determine se você precisa instalar certificados de Gerenciador de Fluxos de Trabalho do SharePoint nos servidores do SharePoint.

   Em algumas circunstâncias, você deve obter e instalar certificados de Gerenciador de Fluxos de Trabalho do SharePoint. Se sua instalação exige que você obtenha e instale esses certificados, é necessário concluir essa etapa antes de prosseguir. Para saber se é necessário instalar certificados, e obter instruções, consulte Instalar certificados do Gerenciador de Fluxo de Trabalho no SharePoint Server 2013.

2. Entre em cada servidor no farm do SharePoint Server.

3. Instale o SharePoint Gerenciador de Fluxos de Trabalho Client em cada servidor no farm do SharePoint.

   Importante

   Você deve instalar o SharePoint Gerenciador de Fluxos de Trabalho Client em cada servidor no farm do SharePoint antes de executar o cmdlet Register-SPWorkflowService.

4. Abra o Shell de Gerenciamento do SharePoint como administrador. Isso é feito clicando com o botão direito do mouse no comando Shell de Gerenciamento do SharePoint e escolhendo Executar como administrador.

5. Execute o cmdlet Register-SPWorkflowService para conectar o farm do SharePoint com o farm Gerenciador de Fluxos de Trabalho do SharePoint. O cmdlet deve ser executado apenas uma vez e pode ser executado a partir de qualquer servidor no farm do SharePoint.

   Observação

   O valor do parâmetro -SPSite pode ser qualquer coleção de sites válida no farm do SharePoint. O valor correto para o parâmetro -WorkflowHostUri pode ser encontrado executando o PowerShell Get-WFFarm | select endpoints no servidor Gerenciador de Fluxos de Trabalho do SharePoint.

   Exemplo:

   Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "https://workflow.example.com:12290"
   

Atualizar o Microsoft Gerenciador de Fluxos de Trabalho existente

O Microsoft Gerenciador de Fluxos de Trabalho não pode ser atualizado localmente e o Gerenciador de Fluxos de Trabalho do SharePoint não pode ser colocado em cima do Microsoft Gerenciador de Fluxos de Trabalho. Para atualizar o Microsoft Gerenciador de Fluxos de Trabalho (WFM Clássico) para o SharePoint Gerenciador de Fluxos de Trabalho (SPWFM), você deve desinstalar todas as versões anteriores do Gerenciador de Fluxos de Trabalho, Gerenciador de Fluxos de Trabalho Cliente e Barramento de Serviço.

Observação

Você pode atualizar para o SharePoint Gerenciador de Fluxos de Trabalho de qualquer versão do Microsoft Gerenciador de Fluxos de Trabalho. Como você está atualizando um farm "Classic WFM" existente para o SPWFM, os bancos de dados WFM serão reutilizados e seus fluxos de trabalho e de registro existentes devem permanecer intactos.

Siga as etapas abaixo para desinstalar o Microsoft Gerenciador de Fluxos de Trabalho e instalar o SharePoint Gerenciador de Fluxos de Trabalho:

Importante

Como as etapas de atualização exigem que você desajoe e, em seguida, volte a um farm de WFM existente, você precisará do WFM "Chave de Geração de Certificado", ao voltar. Se você não tiver certeza do que é essa chave e não a documentou em algum lugar, talvez seja necessário redefinir a chave de geração de certificado antes de prosseguir. Você não poderá ingressar no farm de fluxo de trabalho existente sem uma chave de geração de certificado válida.

1. Execute o Assistente de Configuração Gerenciador de Fluxos de Trabalho.

2. Selecione Deixar Gerenciador de Fluxos de Trabalho Farm.

3. Confirme as etapas subsequentes até o final do assistente.

4. Repita esta etapa em todos os servidores do Microsoft Gerenciador de Fluxos de Trabalho no farm de fluxo de trabalho.

   Observação

   Cada banco de dados usado por Gerenciador de Fluxos de Trabalho e Barramento de Serviço precisará ser especificado ao voltar ao farm com o SharePoint Gerenciador de Fluxos de Trabalho. Por exemplo, a instância SQL Server e o nome do banco de dados para o banco de dados de gerenciamento de farm Gerenciador de Fluxos de Trabalho e o banco de dados de gerenciamento de farm do Barramento de Serviço.

5. Desinstale o Microsoft Gerenciador de Fluxos de Trabalho, Gerenciador de Fluxos de Trabalho Client, Barramento de Serviço para Windows Server e Windows Fabric se eles estiverem instalados. Você pode desinstalá-los do Painel de Controle. Se Windows Fabric estiver instalado, verifique se você instalará o Azure Service Fabric depois de desinstalar Windows Fabric.

   Importante

   Se você estiver instalando o SharePoint Gerenciador de Fluxos de Trabalho em um servidor do SharePoint, poderá ver "Windows Fabric" e "AppFabric 1.1 para Windows Server" instalados. Certifique-se de desinstalar apenas Windows Fabric. Não desinstale o AppFabric 1.1. Ele é um serviço diferente e é necessário para o Cache Distribuído do SharePoint.

6. Se as pastas "%ProgramFiles%\Gerenciador de Fluxos de Trabalho\1.0" ou "%Program Files%\Barramento de Serviço\1.0" já existirem, você deverá removê-las manualmente para que as próximas etapas sejam bem-sucedidas.

7. Reinicialize o servidor Gerenciador de Fluxos de Trabalho do SharePoint.

8. Se ainda não estiver instalado, use as etapas da seção Pré-requisitos acima para instalar o Azure Service Fabric.

9. Instale o SharePoint Gerenciador de Fluxos de Trabalho e o SharePoint Gerenciador de Fluxos de Trabalho Client. SharePoint Gerenciador de Fluxos de Trabalho e SharePoint Gerenciador de Fluxos de Trabalho Client podem ser baixados aqui. Os requisitos do sistema também podem ser encontrados nessa página.

10. Execute o Assistente de Configuração Gerenciador de Fluxos de Trabalho e escolha o "Ingressar em um Farm de Gerenciador de Fluxos de Trabalho Existente" para voltar ao farm anterior. Use as informações de banco de dados, conta de serviço e chave de geração de certificado usadas no farm "Classic WFM" anterior.

    Observação

    Ao atualizar, normalmente não há necessidade de excluir o Proxy de Aplicativo do Serviço de Fluxo de Trabalho existente e reconectar usando o cmdlet Register-SPWorkflowService. Se você encontrar a invalidez da Chave de Geração de Certificado para o SharePoint Gerenciador de Fluxos de Trabalho e Barramento de Serviço, talvez seja necessário redefini-la, consulte Redefinir Chave de Geração de Certificado.

11. Execute novamente o Assistente de Configuração Gerenciador de Fluxos de Trabalho, selecione Atualizar Gerenciador de Fluxos de Trabalho Farm e confirme as etapas subsequentes até o final.

    Observação

    Essa etapa deve ser executada em todos os servidores no farm Gerenciador de Fluxos de Trabalho do SharePoint. A opção "Atualizar Gerenciador de Fluxos de Trabalho Farm" sempre é apresentada no Assistente de Configuração Gerenciador de Fluxos de Trabalho, se uma atualização é necessária ou não. Não há nenhum dano em executá-lo várias vezes, ou quando não há nenhuma atualização pendente.

12. Se houver mais de um servidor em seu farm Gerenciador de Fluxos de Trabalho, repita as etapas anteriores em todos os servidores do farm de fluxo de trabalho.

13. Instale o SharePoint Gerenciador de Fluxos de Trabalho Client em cada servidor no farm do SharePoint Server depois de desinstalar todas as versões anteriores.

Validar a instalação

Siga estas etapas para validar se você instalou e configurou com êxito os componentes necessários.

Para validar a instalação

1. Adicione um usuário ao seu site do SharePoint e conceda permissões de Designer do site do usuário.
2. Instale o SharePoint Designer 2013 em um computador cliente e crie um fluxo de trabalho com base na plataforma de fluxo de trabalho do SharePoint 2013. Para saber mais, confira o artigo Criar um fluxo de trabalho usando o SharePoint Designer 2013 e a plataforma SharePoint 2013 Workflow.
3. Execute esse fluxo de trabalho a partir da interface do usuário do SharePoint

Solução de problemas

Por motivos de segurança, a conta de instalação não pode ser usada para criar um fluxo de trabalho com base na plataforma de fluxo de trabalho do SharePoint 2013. Se você tentar criar um fluxo de trabalho com base na plataforma de fluxo de trabalho do SharePoint 2013 usando o SharePoint Designer 2013, receberá um aviso de que a lista de ações de fluxo de trabalho não existe e o fluxo de trabalho não é criado.

O usuário que implanta e executa um fluxo de trabalho deve ser adicionado ao serviço de Perfil de Usuário. Verifique a página do aplicativo de serviço Perfil de Usuário na Administração Central para confirmar se o usuário que você está usando para validar a instalação do fluxo de trabalho está no serviço Perfil do Usuário.

Você pode determinar quais portas o SharePoint Server e Gerenciador de Fluxos de Trabalho estão usando para HTTP e HTTPS usando o Gerenciador do IIS, conforme mostrado na figura.

Figura: usar o IIS Manager para exibir as portas usadas pelo SharePoint Gerenciador de Fluxos de Trabalho

O SharePoint Gerenciador de Fluxos de Trabalho se comunica usando TCP/IP ou Pipes Nomeados. Verifique se o protocolo de comunicação apropriado está habilitado na instância SQL Server que hospeda os bancos de dados Gerenciador de Fluxos de Trabalho do SharePoint.

O serviço Navegador SQL deve ser executado na instância do SQL Server que hospeda o banco de dados do Gerenciador de Fluxos de Trabalho.

A Conta do Sistema não pode ser usada para desenvolver um fluxo de trabalho.

Para solucionar problemas do SharePoint Server, confira Solução de problemas do SharePoint Server.