« Retour au tableau des modules logiciels enfichables
Rubrique connexe : Noeud Action de module logiciel enfichable - Propriétés et paramètres généraux
Le plug-in Add Attachment vous permet de joindre automatiquement un document au contrôle de pièce jointe à un moment donné d’un workflow.
Le document joint peut se trouver à n’importe lequel des trois emplacements suivants :
- Dans un dossier du serveur (les paramètres File et ControlBinding sont obligatoires)
- Sur un formulaire d’un autre processus (les paramètres SourceBinding, SourceProcessID et ControlBinding sont obligatoires)
- Dans une bibliothèque de fichiers (les paramètres Folder, FileName et ControlBinding sont obligatoires)
Propriétés
| Nom | Description | Obligatoire | Nom du groupe | Modes |
|---|---|---|---|---|
| file |
Emplacement d’un fichier joint. Ce doit être le chemin d’accès au fichier complet à partir du système de fichiers du serveur. Exemple : Valeur directe : D:\Files\Public\Users\Daily Records.xlsx Valeur provenant du champ formulaire : [/my:myFields/my:field2] Valeur provenant du champ solution : [field1] |
Voir la section ci-dessous où les documents sont disponibles. | Source de pièce jointe | Fichiers |
| param_selector(Ajouter une pièce jointe) | Paramètre de plug-in permanent permettant à l’interface utilisateur de sélectionner la source du résolveur de pièce jointe. La source peut être des fichiers (provenant du serveur), un processus de formulaire et une bibliothèque de fichiers. | Tout | ||
| controlbinding | La liaison de contrôle de pièce jointe à laquelle la pièce jointe est ajoutée. | Oui | À partir du contrôle | Tout |
| sourcebinding |
La liaison de contrôle de pièce jointe du processus définie dans le paramètre sourceprocessid. Exemple : Valeur directe : Attachment_1, où Attachment_1, est le nom de la liaison Valeur provenant du champ formulaire : [/my:myFields/my:field2] Valeur provenant du champ solution : [field1] |
Voir la section ci-dessous où les documents sont disponibles. | Source de pièce jointe | Processus du formulaire |
| sourceprocessid |
L'ID de processus avec laquelle la « pièce jointe extraite » est jointe au contrôle de pièce jointe. Le statut du processus spécifié doit être « en cours d’exécution ». Spécifiez le paramètre sourcebinding pour définir la liaison de contrôle de pièce jointe. Exemple : Valeur directe : 5CE7CE49-6A9E-4300-B20D-0DCA2DCA1ABB Valeur provenant du champ formulaire : [/my:myFields/my:field2] Valeur provenant du champ solution : [field1] |
Voir la section ci-dessous où les documents sont disponibles. | Source de pièce jointe | Processus du formulaire |
| folder | Nom de dossier pour la bibliothèque de fichiers qui contient le fichier joint. | Voir la section ci-dessous où les documents sont disponibles. | Source de pièce jointe | Bibliothèque de fichiers |
| filename |
Le fichier portant le même nom que le dossier. Exemple : Valeur directe : Daily-Records.xlsx Valeur provenant du champ formulaire : [/my:myFields/my:field2] Valeur provenant du champ solution : [field1] |
Voir la section ci-dessous où les documents sont disponibles. | Source de pièce jointe | Bibliothèque de fichiers |
Vous pouvez utiliser le plug-in Add Attachment pour joindre un curriculum vitæ à un formulaire quand, par exemple, vous recrutez un nouvel employé. Le plug-in est également généralement utilisé pour joindre des fichiers PDF ou d’autres documents connexes à un formulaire, (tels qu’une facture qui passe par une série d’approbations).
Si le Fichier (ou le nom de fichier) et le Nom de dossier (ou le paramètre SourceProcessID et le paramètre SourceBinding) sont fournis, le fichier sera validé et joint.
Si le nom de fichier/chemin d’accès/liaison est non valide, une erreur sera lancée à l’exécution du paramètre SourceBinding. Si le paramètre SourceBinding est laissé vide ou s'il n’y a aucune pièce jointe au paramètre SourceProcessID, aucune erreur ne sera constatée.
Si vous laissez ces paramètres vierges sans la valeur du champ formulaire, aucune erreur ne sera constatée.
Chargement de préférence de fichier
Si un utilisateur spécifie des paramètres multiples, la pièce jointe est ajoutée conformément à la priorité ci-dessous :
- Paramètre de fichier
- Les deux paramètres sourcebinding et sourceprocessid
- Le dossier ou le nom de fichier
Ainsi, si toutes ces variations sont indiquées (par exemple « paramètre de fichier », paramètres « sourcebinding » et « sourceprocessid », et « dossier et nom de fichier »), la pièce jointe est sélectionnée à partir de « paramètre de fichier ». Si deux paramètres sont fournis (par exemple « sourcebinding » et « sourceprocessid » et « Dossier et nom de fichier »), la pièce jointe est sélectionnée à partir de « sourcebinding » et « sourceprocessid ».