Webservice: Form

forms handling [Commercial editions only]

Index Method Request(s) Response Description
1 delete sid
formId
deletes an existing form
2 list sid
forms lists all the available froms in the tenant
3 store sid
form
form creates/updates a form; returns the newlt created/updated form
4 getForm sid
formId
form gets an existing form
5 createDocument sid
formId
doc
document creates a new document rendered with the given form; returns the newly created document

Method #1: delete

deletes an existing form

Request

Name Type Required Multiple Description
     sid
String Y
     formId
Long Y

Method #2: list

lists all the available froms in the tenant

Request

Name Type Required Multiple Description
     sid
String Y

Response

Name Type Required Multiple Description
     forms
WSForm Y Y
          id
Long Y unique identifier
          templateId
Long Y identifier of the document template assigned to this form
          name
String Y name of the form, it must be unique
          content
String Y body of the form in HTML format

Method #3: store

creates/updates a form; returns the newlt created/updated form

Request

Name Type Required Multiple Description
     sid
String Y
     form
WSForm Y
          id
Long Y unique identifier
          templateId
Long Y identifier of the document template assigned to this form
          name
String Y name of the form, it must be unique
          content
String Y body of the form in HTML format

Response

Name Type Required Multiple Description
     form
WSForm Y
          id
Long Y unique identifier
          templateId
Long Y identifier of the document template assigned to this form
          name
String Y name of the form, it must be unique
          content
String Y body of the form in HTML format

Method #4: getForm

gets an existing form

Request

Name Type Required Multiple Description
     sid
String Y
     formId
Long Y

Response

Name Type Required Multiple Description
     form
WSForm Y
          id
Long Y unique identifier
          templateId
Long Y identifier of the document template assigned to this form
          name
String Y name of the form, it must be unique
          content
String Y body of the form in HTML format

Method #5: createDocument

creates a new document rendered with the given form; returns the newly created document

Request

Name Type Required Multiple Description
     sid
String Y
     formId
Long Y
     doc
WSDocument Y the matadata for the creation, please populate the title, the folderId and all the needed attributes specified in the form
          id
Long Y unique identifier
          fileSize
Long Y
          status
Int 0 = unlocked, 1 = checked out, 2 = locked
          exportStatus
Int
          version
String
          fileVersion
String
          date
String Y last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          publisher
String
          publisherId
Long
          creator
String
          creatorId
Long
          type
String Y
          lockUserId
Long
          creation
String the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          fileName
String Y
          indexed
Int 0 = to index, 1 = indexed, 2 = skip indexing
          signed
Int
          stamped
Int 1 if the document contains at least one stamp
          tags
String Y tags applied to the document
          folderId
Long Y parent folder
          templateId
Long id of the template assigned to the document
          customId
String unique custom identifier
          immutable
Int 0 = not immutable, 1 = immutable
          digest
String
          exportName
String
          exportId
Long
          docRef
Long used for aliases, refers to another document
          docRefType
String if used, defines the reference type (use pdf for the PDF Conversion)
          deleteUserId
Long user that has deleted the document
          attributes
WSAttribute Y array of attributes
               name
String Y name of the attribute
               stringValue
String
               intValue
Long
               doubleValue
Double
               dateValue
String
               type
Int Y 0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1)
               mandatory
Int Y
               position
Int
               label
String
               editor
Int Y 0 = free, 1 = preset
               setId
Long Id of the attribute set
          language
String language of the document; See specification
          summary
String contains the snippet search text
          score
Integer full text search score
          icon
String
          path
String
          comment
String
          lastModified
String
          rating
Integer
          workflowStatus
String Current workflow's status where the document is in
          published
Int If it is not set to 1, the document is marked as not published
          startPublishing
String
          stopPublishing
String
          pages
Int number of pages (default -1)
          nature
Int 0 = document, 1 = form
          formId
Long the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          passwordProtected
Integer indicates whether the document is protected by a password

Response

Name Type Required Multiple Description
     document
WSDocument Y
          id
Long Y unique identifier
          fileSize
Long Y
          status
Int 0 = unlocked, 1 = checked out, 2 = locked
          exportStatus
Int
          version
String
          fileVersion
String
          date
String Y last publication date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          publisher
String
          publisherId
Long
          creator
String
          creatorId
Long
          type
String Y
          lockUserId
Long
          creation
String the date when the document was created; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          fileName
String Y
          indexed
Int 0 = to index, 1 = indexed, 2 = skip indexing
          signed
Int
          stamped
Int 1 if the document contains at least one stamp
          tags
String Y tags applied to the document
          folderId
Long Y parent folder
          templateId
Long id of the template assigned to the document
          customId
String unique custom identifier
          immutable
Int 0 = not immutable, 1 = immutable
          digest
String
          exportName
String
          exportId
Long
          docRef
Long used for aliases, refers to another document
          docRefType
String if used, defines the reference type (use pdf for the PDF Conversion)
          deleteUserId
Long user that has deleted the document
          attributes
WSAttribute Y array of attributes
               name
String Y name of the attribute
               stringValue
String
               intValue
Long
               doubleValue
Double
               dateValue
String
               type
Int Y 0 = String, 1 = int, 2 = double, 3 = date, 4 = user (intValue represents the user's id), 5 = boolean (intValue must be 0 or 1)
               mandatory
Int Y
               position
Int
               label
String
               editor
Int Y 0 = free, 1 = preset
               setId
Long Id of the attribute set
          language
String language of the document; See specification
          summary
String contains the snippet search text
          score
Integer full text search score
          icon
String
          path
String
          comment
String
          lastModified
String
          rating
Integer
          workflowStatus
String Current workflow's status where the document is in
          published
Int If it is not set to 1, the document is marked as not published
          startPublishing
String
          stopPublishing
String
          pages
Int number of pages (default -1)
          nature
Int 0 = document, 1 = form
          formId
Long the last modified date; format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          passwordProtected
Integer indicates whether the document is protected by a password