Help Center > Foundation Help

S’applique à :

  • Winshuttle Foundation

Propriétés du plug-in Définir une colonne

« Retour au tableau des plug-ins

Rubriques connexes

Le plug-in Définit une colonne permet de définir des valeurs dans une ou plusieurs colonnes d’une liste SharePoint.

Dans cette page

Tableau des paramètres du plug-in Définir une colonne

Retour au début

Paires de valeurs

Les paramètres de paire de valeurs sont corrélés aux colonnes dans la liste SharePoint. Lorsqu’un formulaire est publié, une liste SharePoint correspondante est créée. Cette nouvelle liste contient des colonnes basées sur des champs dans le formulaire, exportées comme colonnes de bibliothèque dans les sites FormEx. Dans les sites DocEx, l’utilisateur doit définir des colonnes de liste SharePoint.

REMARQUE : Pour les paramètres site et list, entrez le premier site ; la liste sera remplie dans la liste déroulante.

Paire de valeurs

Description

list

Nom de la liste SharePoint dans laquelle vous voulez définir la colonne.

site

Site SharePoint qui contient la liste dans laquelle vous voulez définir la colonne.

column

Nom de la colonne dont vous voulez mettre à jour la valeur. Ajoutez ce paramètre pour chaque colonne à mettre à jour.

query

Paramètres de requête pour rechercher la liste SharePoint dans une liste d’enregistrements. Seul le premier enregistrement dans les résultats de la requête est mis à jour.

Notez que le paramètre Query ne fonctionne pas avec les valeurs de champ de formulaire. En d’autres termes, vous ne pouvez pas définir un Xpath dans la partie droite de la requête. Par exemple, [Title] == @[//my:myFields/my:field1] will not work.

expression

Paramètre Expression utilisé pour définir la valeur pour router automatiquement le formulaire.

autocheckout

Pour les éléments SharePoint configurés pour être extraits pour l’édition (par défaut), il est nécessaire d’affecter la valeur True à un paramètre d’extraction automatique lorsque la propriété est modifiée en utilisant Workflow.
UseLinkedDocument

Yes : Si UseLinkedDocument a la valeur Yes, la valeur est définie dans la colonne spécifiée pour le document lié dans la bibliothèque de fichiers de données. Les paramètres Site, List ou Query (si définis) sont ignorés.

No : Si UseLinkedDocument a la valeur No, son comportement est le suivant :

  • Si Site, List et Query sont définis, la valeur de colonne est définie pour la liste spécifiée.
  • Si Site, List et Query ne sont pas définis, la valeur de colonne est définie pour l’élément Liste de processus Workflow actuel.

Création d’une opération exécutée manuellement

Retour au début

  1. Affectez à Uselinkeddocument la valeur Yes
  2. Cliquez sur Ajouter.
  3. Le paramètre Runner doit être désormais visible dans l’éditeur des arguments de plug-in. Définissez le nom de l’exécuteur dans ce paramètre. (Pour SharePoint 2010, utilisez le format de non-revendication, et le format de revendication pour SharePoint 2013.)
  4. Lorsque l’exécuteur défini ouvre le fichier de données dans le complément Excel, le bouton Exécuter doit être visible. S’il clique dessus, il exécute manuellement l’opération.

Remarque : Dans certains cas, les éléments SharePoint sont configurés pour être extraits pour l’édition. Dans ce cas, si le workflow met à jour une colonne SharePoint, le paramètre autocheckout doit avoir la valeur true.

Tableau de liste des fonctions du plug-in Définir une colonne

Retour au début

Fonction

Description

$Date

Définit une valeur de date relative à la date en cours. L’argument spécifie le nombre de jours à ajouter à la date en cours.

$Format

Permet de formater une valeur de colonne avec une chaîne de format .NET standard. Les chaînes de formatage .NET sont décrites dans la documentation Microsoft. Le premier argument est la chaîne de formatage, et le second, le nom de la colonne à formater.

$Expression

Peut avoir la valeur « True » ou « False ». La valeur par défaut est False.

Exemple : Si la colonne doit avoir la valeur 2+3 :

Si le paramètre Expression n’est pas défini ou qu’il est affecté de la valeur False (valeur par défaut), la colonne de destination a la valeur « 2+3 » comme chaîne.

Si le paramètre Expression a la valeur True, la colonne de destination a la valeur 5 (à savoir, l’expression utilisée dans la valeur est évaluée).

$ListFields

Ce paramètre définit une valeur dans une colonne Sharepoint.

$Name

Appelle un modèle de nom et remplace la colonne cible par le nom résultant. La valeur initiale dans ce cas est conservée avec le modèle de nom.

$RegExpExtract

Permet aux plug-in Définir une colonne d’extraire les informations d’une valeur de colonne et de la placer dans une autre colonne. Le premier argument dans la fonction est l’expression régulière entre guillemets, et le second, le nom du champ auquel elle doit être appliquée. L’expression régulière s’exécute sur la valeur. La première référence arrière est extraite, puis placée dans la colonne SharePoint cible.

$Revision

Appelle un modèle de nom et remplace la colonne cible par le nom résultant. La valeur initiale dans ce cas provient d’une colonne SharePoint dans un élément.

Exemples de fonctions du plug-in Définir une colonne

Retour au début

Fonction

Description

$Date(-2)

Cet exemple définit la colonne cible sur deux jours avant la date en cours.

$Format('D', [MyDate])

Cet exemple formate la colonne MyDate dans le format de date long. Par exemple, 12/31/2010 1:45:30 PM.

$Name([SelectedTemplate])

Cet exemple définit la colonne cible sur la valeur de nom de modèle suivante définie par le contenu de la colonne SelectedTemplate. Si la colonne SelectedTemplate contient la valeur Modèle Projet A, elle sera utilisée comme modèle de nom utilisé pour générer la valeur.

  • Pour utiliser le modèle de nom au niveau global (portant le nom ’MyGlobalNameTemplate’), fournissez une entrée au format $Name(MyGlobalNameTemplate)
  • Pour utiliser un modèle de nom de solution (portant le nom « MySolutionNameTemplate » publié avec le nom de solution « MySolution »), vous devez fournir l’entrée au format $Name(MySolution:MySolutionNameTemplate)

$RegExpExtract('(\d{10}).*',[MyField])

$RegExpExtract(".*Document+([0-9]+).*",[MyField])

Cet exemple extrait le premier ensemble de dix chiffres contigus du champ MyField.

Cet exemple extrait le nombre (d’une quelconque longueur) après le mot « Document » du champ MyField.

$Revision(MyTemplate:TemplateSeed)

Cet exemple génère un nouveau nom avec le modèle de nom MyTemplate avec la valeur initiale dans la colonne TemplateSeed SharePoint.

[Review] – off

Cet exemple affecte la valeur off à la colonne Examen SharePoint.

Exemple

  • site – http://acme.com/sv/FormEx
  • list – Employee
  • query – [Employee Name] == ‘Testuser’
  • [SharePointColumn1] - Value1
  • [SharePointColumn2] - Value2

Cet exemple interroge la liste Employee sur le site http://acme.com/sv/FormEx pour la ligne dans laquelle la colonne Employee Name correspond à « Testuser ».

Si des lignes sont retournées, il affecte à la colonne SharePointColumn1 la valeur value1, et à la colonne SharePointColumn2 la valeur value2 à la première ligne des champs SharePoint dans l’ensemble de résultats.