Procédure pas à pas : importation d’un flux de travail réutilisable SharePoint Designer

Cette procédure pas à pas montre comment importer un flux de travail réutilisable créé dans SharePoint Designer 2010 dans un projet de flux de travail SharePoint Visual Studio.

Les flux de travail créés dans SharePoint Designer, ou flux de travail déclaratifs, se composent d’instructions XML au lieu de code. SharePoint Designer 2010 introduit des flux de travail réutilisables, qui sont des flux de travail portables et déclaratifs qui peuvent être utilisés par différentes listes dans les sites SharePoint.

Les flux de travail créés dans Visual Studio 2012, tels que les flux de travail séquentiels et les flux de travail de machine à états, sont appelés flux de travail avec code. Les flux de travail avec code se composent de fichiers XML et de modules de code où les utilisateurs peuvent personnaliser le comportement du flux de travail.

Visual Studio vous permet d'importer des flux de travail réutilisables créés dans SharePoint Designer 2010 et de les convertir sous forme de flux de travail avec code en vue de les exploiter sur vos sites SharePoint.

Cette procédure pas à pas décrit les tâches suivantes :

• Création d’un flux de travail simple et réutilisable dans SharePoint Designer.

• Exportation du flux de travail réutilisable SharePoint Designer vers un fichier .wsp et SharePoint.

• Importation du fichier .wsp dans Visual Studio à l’aide du projet Importer un flux de travail réutilisable.

• Modification du flux de travail en ajoutant du code.

• Utilisation du flux de travail importé dans un site SharePoint.

  Notes

  Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

• Éditions prises en charge de Microsoft Windows et SharePoint.

• Visual Studio.

• Microsoft Office SharePoint Designer 2010.

Créer des sous-sites SharePoint cibles

Tout d’abord, vous créez deux nouveaux sous-sites SharePoint : l’un pour héberger les flux de travail réutilisables à partir de SharePoint Designer, l’autre pour héberger les flux de travail convertis.

Pour créer des sous-sites SharePoint

1. Dans SharePoint Designer 2010, dans la barre de menus, sélectionnez Fichier>Nouveau site web vide.

2. Dans la boîte de dialogue Nouveau site web vide, naviguez jusqu’au site SharePoint où vous souhaitez créer le flux de travail, ou utilisez la valeur http://SystemName/, puis cliquez sur le bouton OK.

   La page d’accueil s’affiche.

3. Dans la section Sous-sites, cliquez sur le bouton Nouveau.

4. Dans la boîte de dialogue Nouveau, choisissez Modèles SharePoint à partir de la liste figurant dans le volet gauche, puis choisissez Site d’équipe dans la liste figurant dans le volet droit.

5. Dans la zone Spécifie l’emplacement du site web, remplacez le mot sous-site dans l’URL par SPD1, puis cliquez sur le bouton OK.

   Le nouveau sous-site s’ouvre dans SharePoint Designer. Fermez cette instance de SharePoint Designer et revenez à la première instance (le site de niveau supérieur).

6. Répétez les étapes 3 à 5 pour créer le deuxième sous-site, en remplaçant cette fois le mot sous-site dans l’URL par SPD2.

Créer un flux de travail réutilisable SharePoint Designer

Étant donné que SharePoint n’inclut pas de flux de travail réutilisables que vous pouvez utiliser pour cet exemple, vous allez en créer un. Dans ce flux de travail simple, lorsqu’un utilisateur entre une nouvelle tâche avec un titre spécifique dans la liste des tâches, la tâche est affectée à cet utilisateur.

Pour créer un flux de travail réutilisable SharePoint Designer

1. Dans la section Sous-sites, choisissez le site SPD1 pour le modifier.

2. Dans le ruban, cliquez sur le bouton Flux de travail réutilisable.

   L’assistant Création d’un flux de travail réutilisable s’affiche.

3. Dans la zone Nom, entrez le Flux de travail des tâches SPD.

4. Dans la liste Type de contenu, choisissez Tâche, puis le bouton OK.

   Le flux de travail s’ouvre dans le concepteur de flux de travail SharePoint Designer.

5. Dans le concepteur de flux de travail, sélectionnez l’étape 1, puis, dans le ruban, sélectionnez le bouton Condition.

6. Dans la liste des conditions, choisissez Si le champ de l’élément actif est égal à la valeur.

   Cette étape ajoute une condition nommée Si le champ est égal à la valeur.

7. Dans la condition Si le champ est égal à la valeur, choisissez le lien champ.

8. Dans la liste de valeurs, sélectionnez Titre.

9. Dans la condition Si le champ est égal à la valeur, sélectionnez le lien valeur.

10. Dans la zone, entrez Nouvelle tâche.

    L’instruction de la condition indique maintenant Si l’élément actuel Titre est égal à la Nouvelle tâche.

11. Sélectionnez la ligne en-dessous de l’instruction de la condition, puis, dans le ruban, cliquez sur le bouton Action.

12. Dans la liste des actions, choisissez Définir le champ dans l’élément actif.

13. Dans l’action Définir la valeur du champ, choisissez le lien champ, puis, dans la liste, sélectionnez Affecté à.

14. Dans l’action Définir la valeur du champ, sélectionnez le lien valeur, puis, dans la liste des utilisateurs et groupes existants, choisissez Utilisateur qui a créé l’élément.

15. Cliquez sur le bouton Ajouter, puis sur OK.

    L’instruction d’action affiche maintenant Définir Affecté à l’élément actif CreatedBy.

Enregistrer et déployer le flux de travail réutilisable

Étant donné que Visual Studio peut importer uniquement des fichiers .wsp, vous devez enregistrer le flux de travail réutilisable en tant que fichier .wsp et le déployer sur SharePoint avant de l’importer dans Visual Studio.

Important

Si vous recevez une erreur d’exécution en effectuant la procédure suivante, vous devez effectuer la procédure sur un système qui a accès au site SharePoint.

Pour enregistrer et déployer le flux de travail réutilisable

1. Dans la partie supérieure de SharePoint Designer, cliquez sur le bouton Enregistrer pour enregistrer votre progression, puis cliquez sur le bouton Publier pour déployer le flux de travail sur le site SharePoint SPD1.

2. Dans le volet de navigation, choisissez l’objet Flux de travail.

3. Sous Flux de travail réutilisable, choisissez Flux de travail des tâches SPD.

4. Dans le ruban, cliquez sur le bouton Enregistrer comme modèle pour enregistrer le flux de travail sous la forme d’un fichier .wsp.

5. Ouvrez le site SharePoint SPD1 dans un navigateur pour afficher le fichier .wsp dans SharePoint.

6. Dans la barre de démarrage rapide, sélectionnez le lien Bibliothèques.

7. Dans la section Bibliothèques de documents, choisissez le lien Ressources du site.

   Le fichier Flux de travail des tâches SPD est répertorié avec d’autres ressources du site.

8. Dans la liste des fichiers, sélectionnez le nom de ce fichier

9. Dans la boîte de dialogue Téléchargement de fichier, cliquez sur le bouton Enregistrer pour enregistrer le fichier .wsp dans votre système local.

Importer le fichier .wsp dans Visual Studio

Importez le fichier .wsp dans Visual Studio à l’aide d’un projet Importer un flux de travail réutilisable. Ce projet convertit un flux de travail déclaratif réutilisable en un flux de travail avec code. Une fois le flux de travail converti, vous utiliserez du code pour modifier son comportement.

Pour importer un flux de travail à partir d’un fichier .wsp et le modifier

1. Dans Visual Studio, dans la barre de menus, choisissez Fichier>Nouveau>Projet.

2. Dans la boîte de dialogue Nouveau projet, développez le nœud SharePoint sous Visual C# ou Visual Basic, puis choisissez le nœud 2010.

3. Dans le volet Modèles, sélectionnez le modèle Importer le flux de travail SharePoint 2010 réutilisable, laissez WorkflowImportProject1 comme nom du projet, puis cliquez sur le bouton OK.

   L'Assistant Personnalisation de SharePoint apparaît.

4. Dans la page Spécifier le site et le niveau de sécurité pour le débogage, entrez l’URL du deuxième sous-site SharePoint que vous avez créé précédemment : http://system name/SPD2.

5. Dans la section Quel est le niveau de confiance de cette solution SharePoint ?, choisissez la case de l’option Déployer en tant que solution de batterie, puis cliquez sur le bouton Suivant.

   Pour plus d’informations sur les solutions bac à sable et de batterie, consultez Considérations sur les solutions bac à sable.

6. Dans la page Spécifier la nouvelle source de projet, accédez à l’emplacement du système où vous avez enregistré le fichier .wsp précédemment, ouvrez le fichier, puis cliquez sur Suivant.

   Notes

   Cliquez sur le bouton Terminer pour importer tous les éléments disponibles dans le fichier .wsp.

   Cette opération affiche la liste des flux de travail réutilisables disponibles pour l’importation.

7. Dans la zone Sélectionner les éléments à importer, sélectionnez le flux de travail Flux de travail des tâches SPD, puis cliquez sur le bouton Terminer.

   Une fois l’opération d’importation terminée, un projet nommé WorkflowImportProject1 est créé contenant un flux de travail nommé SPD_Workflow_TestFT. Dans ce dossier se trouve le fichier de définition du flux de travail Elements.xml et le fichier designer du flux de travail (.xoml). Le concepteur contient deux fichiers : le fichier de règles (.rules) et le fichier code-behind (.cs ou .vb, selon le langage de programmation de votre projet).

8. Dans l’Explorateur de solutions, supprimez le dossier Autres fichiers importés.

9. Dans le fichier Elements.xml, supprimez InstantiationURL="_layouts/IniErkflIP.sspx".

10. Dans l’Explorateur de solutions, choisissez WorkflowImportProject1, puis, dans la barre de menus, choisissez Projet>Définir comme projet de démarrage pour définir WorkflowImportProject1 en tant qu’élément de démarrage.

    La liste s’affiche immédiatement lorsque vous déboguez le projet.

11. Étant donné que le modèle Importer le flux de travail SharePoint 2010 réutilisable n’importe pas les valeurs de propriété d’association pour le flux de travail importé, vous devez les entrer. Pour ce faire :

    1. Dans l’Explorateur de solutions, choisissez le nœud SPD_Workflow_TestFT.

    2. Choisissez le bouton de sélection () en regard de l’une des propriétés de la liste, telles que la propriété Liste cible.

    3. Remplissez les valeurs manquantes dans l’assistant de personnalisation SharePoint, puis choisissez le bouton Terminer.

12. Choisissez le fichier .xoml, puis, dans la barre de menus, cliquez sur Affichage>Concepteur pour afficher le flux de travail importé dans le concepteur de flux de travail.

13. Dans le nœud Windows Workflow v3.0 de la Boîte à outils, effectuez l’une des étapes suivantes :

    • Ouvrez le menu contextuel de l’activité Code, puis choisissez Copier. Dans le concepteur de flux de travail, ouvrez le menu contextuel de la ligne dans l’activité SequenceActivity1, puis choisissez Coller.

    • Faites glisser l’activité Code depuis la Boîte à outils vers le concepteur de flux de travail, et connectez-la à la ligne dans l’activité SequenceActivity1.

      Cette opération ajoute une activité au concepteur de flux de travail nommée CodeActivity1. Dans cette activité, vous allez ajouter une action de code qui crée une annonce dans la liste Annonces lorsque l’utilisateur démarre le flux de travail.

14. Effectuez l'un des ensembles d'étapes suivants :

    • Double-cliquez sur CodeActivity1 pour générer un gestionnaire d’événements et afficher le code.

    • Dans la fenêtre Propriétés pour CodeActivity1, affectez la valeur de la propriété ExecuteCode à codeActivity_ExecuteCode.

15. Ajoutez les éléments suivants sous les directives using ou Imports existantes :

    C#

    using Microsoft.SharePoint;
    using System;
    

    VB

    Imports Microsoft.SharePoint
    Imports System
    

16. Remplacez codeActivity1_ExecuteCode par ce qui suit :

    C#

    private void codeActivity1_ExecuteCode(object sender, System.EventArgs e)
    {
        
        try
        {
            // Get reference to SharePoint site.
            SPSite site = new SPSite("http://MyServer");
            SPWeb web = site.OpenWeb("SPD2/");
            // Get reference to Announcements list.
            SPList announcementsList = web.Lists["Announcements"];
    
            // Add announcement to Announcements list for the Task.
            SPListItem oListItem = announcementsList.Items.Add();
            oListItem["Title"] = "Assigned task on " + DateTime.Now.ToString();
            oListItem.Update();
        }
    
        catch (Exception err)
        {
            Console.WriteLine("Error: " + err.ToString());
        }        
    }
    

    VB

    Private Sub codeActivity1_ExecuteCode(ByVal sender As System.Object, ByVal e As System.EventArgs)
        Try
            ' Get reference to SharePoint site.
            Dim site As SPSite = New SPSite("http://MyServer")
            Dim web As SPWeb = site.OpenWeb("SPD2/")
            ' Get reference to Announcements list.
            Dim announcementsList As SPList = web.Lists("Announcements")
            ' Add announcement to Announcements list for the Task.
            Dim oListItem As SPListItem = announcementsList.Items.Add
            oListItem("Title") = ("Assigned task on " + DateTime.Now.ToString)
            oListItem.Update()
        Catch err As Exception
            Console.WriteLine(("Error: " + err.ToString))
        End Try
    End Sub
    

Déployer le projet et associer le flux de travail

Ensuite, exécutez WorkflowImportProject1 pour le déployer sur un site SharePoint, puis associez le flux de travail à la liste Tâches pour afficher et tester le flux de travail modifié et converti.

Pour déployer le projet et associer le flux de travail

1. Dans Visual Studio, choisissez la touche F5 pour exécuter et déployer le projet de flux de travail converti.

2. Dans la barre de démarrage rapide, cliquez sur le lien Tâches pour afficher la liste des tâches.

3. Sous l’onglet Outils de liste, choisissez le bouton Éléments, puis choisissez le bouton Nouvel élément.

   La boîte de dialogue Tâches : nouvel élément s’ouvre.

4. Dans la zone Titre, entrez Nouvelle tâche, puis choisissez le bouton Enregistrer.

5. Sous l’onglet Outils de liste, cliquez sur le bouton Liste, puis cliquez sur le bouton Paramètres de la liste.

   La page Paramètres de la liste s’affiche.

6. Dans la section Autorisations et gestion, cliquez sur le lien Paramètres du flux de travail.

   La page Paramètres du flux de travail s’affiche.

7. Sélectionnez le lien Ajouter un flux de travail.

8. Dans la liste Flux de travail, sélectionnez WorkflowImportProject1 : test de flux de travail SPD.

9. Dans la zone Nom, entrez Test de flux de travail SPD, puis cliquez sur le bouton OK.

10. Dans la barre de démarrage rapide, choisissez la liste Tâches.

11. Cliquez sur la flèche à côté de Nouvelle tâche, puis, dans la liste, sélectionnez Flux de travail.

12. Dans la section Démarrer un nouveau flux de travail, cliquez sur le lien Test du flux de travail SPD, puis cliquez sur le bouton Démarrer pour initialiser le flux de travail.

    Notes

    Vous pouvez également associer automatiquement un flux de travail à une liste en exécutant l’assistant Paramètres de flux de travail et en définissant le flux de travail sur l’association automatique.

    Notez que deux actions sont effectuées par le flux de travail : votre nom apparaît dans la colonne Affectée à de la tâche et une annonce apparaît dans la liste Annonces.

Contenu connexe

• Importer des éléments à partir d’un site SharePoint existant
• Développer des solutions SharePoint
• Créer des contrôles réutilisables pour des composants WebPart ou des pages d’application