Partager via

Mettre à niveau SharePoint 2016 vers SharePoint 2019 à l’aide du Gestionnaire de workflow

S’APPLIQUE À :no-img-132013 oui-img-162016 oui-img-192019 no-img-seÉdition d’abonnement no-img-sopSharePoint dans Microsoft 365

Résumé

Lorsque vous mettez à niveau Microsoft SharePoint Server 2016 vers Microsoft SharePoint Server 2019, vous n’avez pas besoin de créer une installation Gestionnaire de flux de travail. Vous pouvez utiliser la même installation que celle utilisée par la batterie de serveurs SharePoint 2016 dans la nouvelle batterie de serveurs SharePoint Server 2016. Toutefois, vous devrez peut-être créer une nouvelle installation de Gestionnaire de flux de travail dans certaines circonstances. Par exemple, si vous souhaitez déplacer Gestionnaire de flux de travail vers un autre système d’exploitation Windows, ou si le serveur de base de données principal est désactivé. Dans ce cas, suivez les étapes décrites dans Gestionnaire de flux de travail récupération d’urgence pour créer la nouvelle installation Gestionnaire de flux de travail à l’aide des anciennes bases de données. Veillez à utiliser la copie la plus récente des bases de données Gestionnaire de flux de travail.

Arrière-plan

Lorsque vous utilisez SharePoint Server avec Gestionnaire de flux de travail, Gestionnaire de flux de travail conserve un enregistrement des sites SharePoint qui ont publié des flux de travail. Chaque site est représenté dans Gestionnaire de flux de travail en tant qu’étendue. Gestionnaire de flux de travail stocke également les définitions de flux de travail, toutes les instances de workflow et leurs états.

SharePoint stocke l’historique des flux de travail et les informations sur les tâches de flux de travail pour les flux de travail SharePoint. Lorsque la page de status de flux de travail est chargée, SharePoint effectue d’abord un appel à Gestionnaire de flux de travail pour voir si le flux de travail existe. Pour ce faire, il utilise l’ID de instance de flux de travail. Ensuite, SharePoint charge le reste des informations de flux de travail. Si l’ID de instance de flux de travail est manquant dans Gestionnaire de flux de travail, ou si une erreur se produit lors de la communication avec Gestionnaire de flux de travail, vous recevez un message d’erreur.

Comment mettre à niveau SharePoint Server 2016 vers SharePoint Server 2019 à l’aide de Gestionnaire de flux de travail

Configuration requise

Les préquisites suivants doivent être effectués pour installer cette mise à niveau :

  • Installez la dernière mise à jour cumulative pour Gestionnaire de flux de travail à l’aide de Web Platform Installer (Web PI).

  • Installez la dernière version de Gestionnaire de flux de travail Client sur les serveurs SharePoint 2016 et assurez-vous que tous les flux de travail sont fonctionnels.

  • Installez la batterie de SharePoint Server 2019 et mettez à niveau toutes les applications de service et bases de données de contenu.

  • Sur tous les serveurs SharePoint Server 2019 batterie de serveurs, installez la dernière version de Gestionnaire de flux de travail Client à l’aide de Web PI.

Inscrire Gestionnaire de flux de travail avec SharePoint Server 2019

Procédez comme suit pour inscrire Gestionnaire de flux de travail auprès de SharePoint Server 2019 :

  1. Dans la batterie de serveurs SharePoint 2016, sur le site web Administration centrale, cliquez sur Gestion des applications, cliquez sur Gérer les applications de service, puis supprimez le proxy d’application du service de flux de travail.

  2. Dans la batterie de SharePoint Server 2019, exécutez l’applet de commande Microsoft PowerShell suivante pour associer SharePoint 2016 à la même installation Gestionnaire de flux de travail :

   Register-SPWorkflowService -SPSite <SharePoint site URL> -
   WorkflowHostUri <Workflow service endpoint URL> -force

Problèmes courants que vous pouvez rencontrer après la mise à niveau

Problème 1 : L’URL du site est modifiée

Si l’URL de votre site est modifiée dans SharePoint 2016 mais que l’ID de site reste le même, vous devez republier un flux de travail à partir du site concerné à l’aide de SharePoint Designer.

Problème 2 : Les flux de travail ne démarrent pas sur certains sites

Si les flux de travail ne démarrent pas sur certains sites, republiez les flux de travail à partir du site affecté. Vous pouvez également exécuter le travail d’actualisation du flux de métadonnées des services de jetons de sécurité approuvés .

Problème 3 : Les flux de travail échouent et retournent l’erreur « Impossible d’obtenir les informations d’autorisation du principal d’application »

Prenons l’exemple du scénario suivant :

  • Vous avez des flux de travail et des Gestionnaire de flux de travail SharePoint 2016 configurés dans votre batterie de serveurs.

  • Vous avez récemment connecté des sites dans la batterie à un instance de Gestionnaire de flux de travail existant.

Dans ce scénario, les workflows créés une fois que vous vous êtes connecté à l’Gestionnaire de flux de travail’installation se terminent correctement. Toutefois, les flux de travail créés avant la connexion à Gestionnaire de flux de travail ne se terminent pas. Au lieu de cela, ils sont bloqués quand ils essaient de terminer ou ils restent dans un état suspendu. Pour les flux de travail qui restent suspendus, vous recevez une erreur HTTP 500. En outre, l’entrée suivante est enregistrée dans le journal ULS : Impossible d’obtenir les informations d’autorisation du principal de l’application.

Cause

Gestionnaire de flux de travail dispose déjà d’une étendue pour le site sur lequel les workflows s’exécutent. Étant donné que l’étendue a une valeur SPAuthenticationRealm incorrecte dans le champ ApplicationID de l’étendue, il n’existe aucune classe SPAppPrincipal sur l’objet SPWeb qui correspond à la valeur ApplicationID de l’étendue. Par conséquent, les workflows échouent et retournent un message d’erreur.

Résolution

Pour résoudre ce problème, utilisez les commandes PowerShell suivantes pour inscrire le nouvel objet SPAppPrincipal . Vous effectuez cette opération sur l’objet SPWeb dont l’ID correspond à la valeur ApplicationID stockée dans l’étendue de l’objet SPWeb dans Gestionnaire de flux de travail.

   #Variables
   $webUrl = "http://sp.contoso.com/sites/teamsite/teamweb"
   $oldAuthRealm = "58a2b173-0f88-4bff-935b-bf3778cd0524" #authentication realm expected by Workflow Manager
   $newAuthRealm = "48834d17-d729-471e-b0d0-a0ec83b49de0" #authentication realm of current farm
   #Get the SPWeb and SPSite objects, and the id of the web
   $web = Get-SPWeb $webUrl
   $site = $web.site
   $clientId = $web.Id
   #Create the old and new app principal ids
   $oldAppId = "$clientId@$oldAuthRealm"
   $newAppId = "$clientId@$newAuthRealm"
   #Register the app principal with the old authentication realm
   Register-SPAppPrincipal -DisplayName "Old Workflow" -Site $web -NameIdentifier $oldAppId
   #Set permissions for the app principal
   #If app-only permissions are used in old environment, you must use the -EnableAppOnlyPolicy parameter to pass to the cmdlet for app steps to succeed
   $oldAppPrincipal = Get-SPAppPrincipal -Site $web -NameIdentifier $oldAppId
   Set-SPAppPrincipalPermission -Site $web -AppPrincipal $oldAppPrincipal -Scope SiteCollection -Right FullControl
   Set-SPAppPrincipalPermission -Site $web -AppPrincipal $oldAppPrincipal -Scope Site -Right FullControl
   #List the app principals with the old and new authentication realms in the ids
   Get-SPAppPrincipal -Site $web -NameIdentifier $oldAppId | fl
   Get-SPAppPrincipal -Site $web -NameIdentifier $newAppId | fl

Plus d’informations

Pour obtenir la valeur SPAuthenticationRealm d’ApplicationID stockée dans l’étendue, procédez comme suit :

  1. Exécutez la requête SQL suivante :

    SELECT *
FROM [WFResourceManagementDB].[dbo].[Scopes] WITH (NOLOCK)
WHERE Description like '%<WebID>%'

    Où <WebID> est l’espace réservé pour l’ID de l’objet SPWeb.

  2. Dans le résultat de la requête, cliquez sur la valeur dans la colonne SecuritySettings pour ouvrir le code XML sous un onglet distinct dans SQL Server Management Studio.

  3. Dans le fichier XML, vous avez localisé l’élément ApplicationID qui contient la valeur . Par exemple, recherchez l’élément suivant :

    <ApplicationId>SPWeb_object_ID@SPAuthenticationRealm</ApplicationId>`

    Remarque

    Le GUID qui apparaît avant le signe at (@) est l’ID de l’objet SPWeb, et le GUID qui apparaît après le signe at est la valeur SPAuthenticationRealm.

Vous pouvez également trouver la valeur SPAuthenticationRealm dans le journal ULS, comme dans l’exemple d’entrée de journal suivant :

03/11/2017 12:13:16.72 w3wp.exe (SPWFE01:0x51FC) 0x1298 Autorisation d’authentification SharePoint Foundation an3eg Moyen impossible d’obtenir les informations d’autorisation du principal de l’application. AppId=i :0i.t|ms.sp.ext|<ID d’objet> SPWeb@<SPAuthenticationRealm>

03/11/2017 12:13:16.72 w3wp.exe (SPWFE01:0x51FC) 0x1298 Erreur d’application moyenne Générale 8nca SharePoint Foundation lors de l’accès à /site/teamsite/teamweb/_vti_bin/client.svc, Error=Object reference not set to an instance of an object. sur Microsoft.SharePoint.SPAppRequestContext.EnsureTenantPermissions(SPServiceContext serviceContext, Boolean throwIfAppNotExits, Boolean allowFullReset) sur Microsoft.SharePoint.SPAppRequestContext.InitCurrent(HttpContext context) à l’adresse Microsoft.SharePoint.ApplicationRuntime.SPRequestModule.InitCurrentAppPrincipalToken(HttpContext context) à l’adresse Microsoft.SharePoint.ApplicationRuntime.SPRequestModule.PostAuthenticateRequestHandler(Object oSender, EventArgs ea) à l’adresse System.Web.HttpApplication.SyncEventExecutionStep.System.Web.HttpApplication.IExecutionStep.Execute() sur System.Web.HttpApplication.ExecuteStep(IExecutionStep step, Boolean& completedSynchronously)