Petals BC REST

Add support of attachments on HTTP Post request:

• through a HTTP POST request with a content-type defined to 'multipart/form-data'
• attachments are put as a part 'form-data' in the HTTP request:
  • using a HTTP body type defined as 'MULTIPART_FORMDATA',
  • the name of the form field is defined in the SU JBI descriptor,
  • and initialized with a value extracted from the incoming payload through a XPath expression,
  • if the form field is defined as attachment:
    • the result of the XPath expression must the identifier of the attachment to put in the part,
    • we must be able to define an attachment name as the result of a XPath expression
  • Example:

    <jbi:jbi version="1.0" ...>
       <jbi:services binding-component="true">
          <jbi:provides interface-name="edm:EDM" service-name="edm:EDMService" endpoint-name="autogenerate">
             ...
             <rest:mapping>
                ...
                <rest:operation name="edm:archiver">
                   ...
                   <rest:http-body-type>MULTIPART_FORMDATA</rest:http-body-type>
                   ...
                   <rest:form-data name="file" as-attachment="true">
                      <rest:extracted-by-xpath>
                         substring-after(//*[local-name()='document']/*[local-name()='Include']/@href, 'cid:')
                      </rest:extracted-by-xpath>
                      <rest:attachment-name>
                         <rest:xpath>//*[local-name()='document']/*[local-name()='nom']</rest:xpath>
                      </rest:attachment-name>
                   </rest:form-data>
                   ...
                </rest:operation>
                ...
             </rest:mapping>
          </jbi:provides>
       </jbi:services>
    </jbi:jbi>