The YOUSIGNCHECK workflow application lets you verify the status of an agreement and download its associated file, which is a concatenation of attached files.
You can verify the status of an agreement and download the file from Yousign based on your status criteria.
Application logs are available. These can be specified by setting the value of the YousignCheckLogLevel
parameter in the web.config
file to 0
to deactivate logs, 1
for error logs, 2
for information logs, or 3
for debug logs; the default value is 0
.
For instructions on how to configure the the Yousign API, see the Configuring the Yousign API section in the YOUSIGNSEND Workflow Application chapter.
In the following example, the YOUSIGNSEND action is directly followed by the YOUSIGNCHECK action. This action will loop back onto itself until the status changes to done
, canceled
, expired
, deleted
, or rejected
.
If the status returned meets the condition, the document will be downloaded from Yousign.
With the system loop action function, the YOUSIGNCHECK action will be executed every x
seconds until the OUT condition is met.
Parameter
Type
Direction
Description
YOUSIGN_SIGNATURE_ID
TEXT
IN
ID of the Yousign signature to verify
Parameters
Type
Direction
Description
YOUSIGN_API_KEY
TEXT
IN
Yousign API key
By default, this value comes from the YousignApiKey
parameter in the web.config
file.
YOUSIGN_HOST_SERVER
TEXT
IN
Yousign host server (e.g.: https://api.yousign.app/v3
)
By default, this value comes from the YousignHostServer
parameter in the web.config
file.
Parameter
Type
Direction
Description
VALID_STATUS_LIST
TEXT
IN
Valid status to download the document
Possible values:
draft
ongoing
done
deleted
expired
canceled
approval
rejected
declined
Default: done,canceled,expired,deleted,rejected
YOUSIGN_DOCUMENT
FILE
OUT
Yousign document
YOUSIGN_STATUS
TEXT
OUT
Agreement status