...
Enfin l'application métier pourra supprimer le document en faisant une requete DELETE sur l'adresse /ws/signrequests/{id}. Les éléments de vérification de la signature sont conservés dans esup-signature.
...
Le paramètre stepsJsonString
Depuis la version 1.28 vous pouvez passer une liste de "WorkflowStepDto" (https://github.com/EsupPortail/esup-signature/blob/master/src/main/java/org/esupportail/esupsignature/dto/WorkflowStepDto.java), dans tous les web services de création, pour configurer vos étapes. Cela remplace les paramètres recipientEmails, signTypes, allSignToCompletes, etc., mais la rétrocompatibilité est maintenue.
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
[
{
"title": "string",
"workflowId": 0,
"stepNumber": 0,
"description": "string",
"recipientsCCEmails": [
"string"
],
"recipients": [
{
"step": 0,
"email": "string",
"phone": "string",
"name": "string",
"firstName": "string",
"forceSms": true
}
],
"changeable": true,
"signLevel": 0,
"signType": "hiddenVisa",
"repeatable": true,
"repeatableSignType": "hiddenVisa",
"allSignToComplete": true,
"userSignFirst": true,
"multiSign": true,
"autoSign": true,
"forceAllSign": true,
"comment": "string",
"attachmentRequire": true,
"maxRecipients": 0
}
] |
...
Exemples
Démarrer un formulaire
...
| Attribut | Description | |||||
|---|---|---|---|---|---|---|
createByEppn | eppn du propriétaire du futur document | recipientEmails|||||
| stepsJsonString | Si les participants de certaines étapes sont configurables, il faut saisir un tableau de | StringWorkflowStepDto[]. Ex : [ | "2*toto@univ{"signType":"pdfImageStamp", "recipients": [{"email": "test.test@univ-ville.fr"}, | "2*tata@univ-rouen{"email": "test2.test2@univ-ville.fr"}] | , ici les deux participants seront affectés à l'étape 2 (suivant le pattern étape*email)allSignToCompletes | Pour chaque étape, il est possible de forcer le fait que tous les participants de l'étapes doivent signer. Il faut transmettre un tableau de String comportant les numéros des étapes pour lesquelles tous les participants doivent signer.}, {"signType":"certSign", "recipients": [{"email": "test.test@univ-ville.fr"}, {"email": "test2.test2@univ-ville.fr"}]}] |
| targetEmails | Pour que la demande soit transmise par à la fin du circuit, il est possible, d'envoyer un tableau de String contenant la liste des destinataires finaux | |||||
| targetUrl | url pour la destination finale des formulaire terminés. Ex : smb://stockage.univ-ville.fr/form |
Exemple de commande curl :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
curl -X 'POST' \ 'https-location --request POST 'http://esupdsi-signature7.univ-villerouen.fr/ws/forms/99999/new?eppn=esupd@univ-ville.fr&recipientEmails=2*toto@univ-ville.fr&recipientEmails=2*tata@univ-ville.fr&targetEmails=1*titi@univ-rouen.fr' \ -H 'accept: */*' \ -d ''signrequests/new' \ --form 'multipartFiles=@"/home/lemaida3/Documents/sample.pdf"' \ --form 'createByEppn="test@univ-ville.fr"' \ --form 'stepsJsonString="[{\"signType\":\"pdfImageStamp\", \"recipients\": [{\"email\": \"david.lemaignent@univ-rouen.fr\"}, {\"email\": \"demo.esup@inv.univ-rouen.fr\"}]}, {\"recipients\": [{\"email\": \"david.lemaignent@univ-rouen.fr\"}, {\"email\": \"demo.esup@inv.univ-rouen.fr\"}]}]"' |
Envoyer un document dans un circuit existant
...
| Attribut | Description | ||
|---|---|---|---|
| multipartFile (obligatoire) | Multipart stream du fichier à signer | ||
| createByEppn (obligatoire) | eppn du propriétaire du futur document | ||
| recipientEmailsstepsJsonString | Si les participants de certaines étapes sont configurables, il faut saisir un tableau de StringWorkflowStepDto[]. Ex : [{"signType":"pdfImageStamp", "recipients": [ "2*toto@{"email": "test.test@univ-ville.fr"}, "2*tata@{"email": "test2.test2@univ- rouenville.fr"}] , ici les deux participants seront affectés à l'étape 2 (suivant le pattern étape*email) | allSignToCompletes | }, {"signType":"certSign", "recipients": [{"email": "test.test@univ-ville.fr"}, {"email": "test2.test2@univ-ville.fr"}]}] Pour chaque étape, il est possible de forcer le fait que tous les participants de l'étapes doivent signer. Il faut transmettre un tableau de String comportant les numéros des étapes pour lesquelles tous les participants doivent signer. |
| targetEmails | Pour que la demande soit transmise par à la fin du circuit, il est possible, d'envoyer un tableau de String contenant la liste des destinataires finaux | ||
| targetUrl | url pour la destination finale des formulaire terminés. Ex : smb://stockage.univ-ville.fr/form |
...
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
curl -v-location -i -Xrequest POST 'https://esup-signature.univ-rouen.fr/ws/workflows/999999/new' \ --Hform 'content-type: multipart/form-data;createByEppn="test@univ-rouen.fr"' \ --form 'title="TITRE"' \ --Fform 'multipartFiles=@Document@"/home/lemaida3/Documents/esup-signature/sample.pdf"' \ 'https://esup-signature.univ-ville.fr/ws/workflows/99999/new?createByEppn=esup@univ-ville.fr&title=test--form 'recipientsJsonString="[{\"signType\":\"pdfImageStamp\", \"recipients\": [{\"email\": \"test.test@univ-ville.fr\"}, {\"email\": \"test2.test2@univ-ville.fr\"}]}, {\"signType\":\"certSign\", \"recipients\": [{\"email\": \"test.test@univ-ville.fr\"}, {\"email\": \"test2.test2@univ-ville.fr\"}]}]";type=application/json' |