Utilisation de l'activité MS SharePoint Partager des fichiers

Utilisez l'activité Partager des fichiers pour partager un fichier existant dans MS SharePoint.

Pourquoi et quand exécuter cette tâche

Cette tâche permet de partager des fichiers avec des utilisateurs internes ou externes dans l'instance MS SharePoint. L'appel de cette activité est un appel synchrone lorsque les données entrées sont envoyées à l'activité pour traitement et que la réponse est renvoyée à l'orchestration.

Procédure

  1. Cliquez avec le bouton droit sur la section Orchestrations et sélectionnez une nouvelle orchestration.
  2. Faites glisser le nouveau noeud final MS SharePoint vers l'orchestration et sélectionnez l'activité Partager des fichiers. L'activité Partager des fichiers s'ajoute à l'orchestration. Cliquez deux fois sur l'activité. La liste de contrôle de l'activité MS SharePoint Partager des fichiers s'affiche.
  3. Dans la liste de contrôle, cliquez sur Réessayer. Passez en revue les paramètres par défaut et procédez aux modifications requises.
  4. Sélectionnez Mapper les entrées dans la Liste de contrôle. Les schémas XML générés à partir de cette opération sont affichés sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers l'activité.
  5. Créez une mappe entre les variables d'orchestration et le paramètre d'entrée de l'activité.
    Zones obligatoires :
    • resourceAddress : URL complète du document à partager
    • additiveMode
    • UserRoleAssignments
      • Role : la propriété Role représente les droits d'accès que vous attribuez. 1 = View, 2 = Edit, 3 = Owner, 0 = None)
      • userId : la propriété UserId peut correspondre au nom de l'utilisateur ou à un rôle.)
    Remarque :

    AdditiveMode : Option indiquant si le paramètre de droits d'accès utilise le mode additif ou strict. Si la valeur est "true", le paramètre de droits d'accès utilise le mode additif, ce qui signifie que les droits indiqués s'ajoutent dans la liste en cours des droits de l'utilisateur, s'ils n'y figurent pas déjà ; si la valeur est "false", le paramètre de droits d'accès utilise le mode strict, ce qui signifie que les droits indiqués remplacent les droits en cours de l'utilisateur. Ce paramètre est utile lorsque vous souhaitez cesser de partager un document avec une personne ou un groupe. Dans ce cas, vous devez paramétrer AdditiveMode sur false à l'aide du rôle = 0.

    Exemple de demande d'entrée :

      <ShareFile xmlns="http://www.IBM.com/xmlns/prod/websphere/j2ca/Sharepoint/sharefile">
         <ShareFileRequestDetails xmlns="">
            <resourceAddress>/shared documents/file1.txt</resourceAddress>
            <UserRoleAssignments>
               <Role>1</Role>
               <UserId>khushbu_khatuja@persistent.com</UserId>
            </UserRoleAssignments>
            <validateExistingPermissions>true</validateExistingPermissions>
            <additiveMode>true</additiveMode>
            <sendServerManagedNotification>true</sendServerManagedNotification>
            <customMessage>hello</customMessage>
            <includeAnonymousLinksInNotification>true</includeAnonymousLinksInNotification>
         </ShareFileRequestDetails>
      </ShareFile>
    Remarque : Des valeurs doivent être fournies lors de l'exécution pour les éléments obligatoires de la structure d'entrée. Une valeur peut être indiquée en spécifiant une valeur par défaut pour l'élément ou en reliant l'élément avec un noeud d'entrée. A l'exécution, si aucune valeur n'est fournie pour un élément obligatoire, l'activité émet une exception qui est signalée par la console de gestion Web. Si aucune valeur n'est fournie au moment de l'exécution pour un paramètre d'entrée facultatif, aucune exception n'est émise lors de l'exécution.
  6. Sélectionnez Mapper les sorties dans la Liste de contrôle. Le schéma XML généré pour contenir la réponse de l'activité s'affiche sous forme de noeuds sous le paramètre de sortie de réponse dans le panneau Depuis l'activité.
  7. Créez une mappe entre les paramètres de sortie et les variables d'orchestration.

Résultats

Vous venez de configurer l'activité MS SharePoint Partager des fichiers.
Remarque :

Vous pouvez partager plusieurs fichiers en une seule fois à l'aide de cette activité dans la mesure où la variable d'entrée est sans limite.