MIME Service

1. Use the pre-configured MIME service or create your own MIME service instance.
2. Create a business process that does the following:
   1. Uses the File System adapter to read in the documents that need to be encoded.
   2. Sets up an XML representation of the MIME message in the process data of the business process and adds the documents to the XML in process data. For more information, see Process Data Prerequisites.
   3. The MIME service encodes the documents and assigns the MIME-encoded document as the primary document.
   4. Sends the MIME-encoded document to the trading partner using the SMTP Send adapter. For more information, see SMTP Send Adapter.
      Note: The example in this section focuses only on the MIME service functionality.

• mime:message – This element is the root node for the MIME part.
• mime:header – This element creates the specific header for the MIME part.
• mime:body – This element creates the content of the MIME part.

<process name="ExampleMimeEncoding2Documents">
	<sequence>
		<operation name="Read In First Document">
			<participant name="FileSystemAdapterReadFiles"/>
			<output message="FileSystemInputMessage">
				<assign to="Action">FS_COLLECT</assign>
				<assign to="collectionFolder" from="'/server1/user/temp'"/>
				<assign to="deleteAfterCollect">false</assign>
				<assign to="filter" from="'WordDoc'"/>
				<assign to="useSubFolders">false</assign>
				<assign t="." from="*"/>
				</output>
			<input message="FileSystemOutputMessage">
				<assign to="." from="*"/>
			</input>
		</operation>
		<assign to="Doc1" from="PrimaryDocument/@*"/>
		<operation name="Read In Second Document">
			<participant name="FileSystemAdapterReadFiles"/>
			<output message="FileSystemInputMessage">
				<assign to="Action">FS_COLLECT</assign>
				<assign to="collectionFolder" from="'/server1/user/temp'"/>
				<assign to="filter" from="'Text'"/>
				<assign to="useSubFolders">false</assign>
				<assign to="bootstrap">false</assign>
				<assign to="deleteAfterCollect">false</assign>
				<assign to="." from="*"/>
			</output>
			<input message="FileSystemOutputMessage">
				<assign to="." from="*"/>
			</input>
		</operation>
				<assign to="Doc2" from="PrimaryDocument/@*"/>
				<assign to="mimeDoc/mime:message/mime:header" from="'multipart/form-data'"/>
	append="true"/>
				<assign to="mimeDoc/mime:message/mime:header/@name" from="'Content-Type'"/>
				<operation name="Assign Document ID for Doc1">
				<participant name="This"/>
				<output message="giveDocumentRequest">
					<assign to="." from="*"/>
					<assign to="documentKey" from="'Doc1'"/>
				</output>
				<input message="giveDocumentResponse">
					<assign to="Doc1/doc:document-id" from="documentId/text()"
	append="true"/>
				</input>
		</operation>
			<assign to="MIMEtemp1/mime:message/mime:header" from="'111'" append="true"/>
			<assign to="MIMEtemp1/mime:message/mime:header/@name" from="'Content-ID'"
	append="true"/>
			<assign to="MIMEtemp1/mime:message/mime:header" from="'application/EDI-X12'"
	append="true"/>
			<assign to="MIMEtemp1/mime:message/mime:header/@name" from="'Content-Type'"
	append="true"/>
			<assign to="MIMEtemp1/mime:message/mime:body" from="Doc1/doc:document-id"/>
			<assign to="mimeDoc/mime:message/mime:body/mime:message" from="MIMEtemp1/mime:message/node()" append="true"/>
			<operation name="Assign Document ID for Doc2">
				<participant name="This"/>
				<output message="giveDocumentRequest">
					<assign to="." from="*"/>
					<assign to="documentKey" from="documentId/text()"
	append="true"/>
				</input>
			</operation>
			<assign to="MIMEtemp2/mime:message/mime:header" from="'112'" append="true"/>
			<assign to="MIMEtemp2/mime:message/mime:header/@name" from="'Content-ID'"
	append="true"/>
			assign to="MIMEtemp2/mime:message/mime:header" from="'text/xml'"
	append="true"/>
			assign to="MIMEtemp2/mime:message/mime:header/@name" from="'Content-Type'"
	append="true"/>
			assign to="MIMEtemp2/mime:message/mime:body" from="Doc2/doc:document-id"/>
			assign to="mimeDoc/mime:message/mime:body/mime:message" from="MIMEtemp2/mime:message/node()" append="true"/>
			<operation name="MIME encode both documents">
				participant name="MIME"/>
				<output message="packRequest">
					<assign to="mime-document" from="mimeDoc/mime:message"/>
				</output>
				<input message="packResponse">
					<assign to="." from="*" append="true"/>
				</input>
			</operation>
			<assign to="PrimaryDocument" from="mime-document/@*"></assign>
			<operation name="Email MIME Message">
				<participant name="SMTP_SEND_ADAPTER"/>
				<output message="Xout">
					<assign to="." from="*"/>
					<assign to="xport-smtp-mailhost">00.000.00.00</assign>
					<assign to="xport-smtpmailport">25</assign>
					<assign to="xport-smtp-mailfrom">stest1@co.com</assign>
					<assign to="xport-smtp-mailto">stest22co.com</assign>
					<assign to="xport-smtp-mailsubject">This is the subject</assign>
					<assign to="b2b-raw-message">false</assign>
				</output>
				<input message="Xin">
					<assign to="." from="*"/>
				</input>
		</operation>
	</sequence>
</process>

• To MIME-encode documents
• To MIME-decode documents

1. Collect the following information:

   For MIME-encoding:

   • The documents you want to MIME encode
   • The XML representation of the MIME message for the MIME service to use (See Setting up Process Data for MIME Encoding for more information.)

   For MIME-decoding:

   • The document ID of the MIME-encoded document
2. Create a MIME service configuration. For information, see Managing Services and Adapters.
3. Configure the MIME service. For information, see Configuring the MIME Service.
4. Use the MIME service in a business process.

• Set the Message Name (or output message) of the MIME service to packRequest when you want to MIME-encode documents.
• Set the Message Name (or output message) of the MIME service to crackRequest when you want to MIME-decode documents.

• The construction of the MIME multipart document is dependent on the structure of the XML representation of the MIME message in process data that is being passed to the service. If the service fails, it is often because the XML representation of the MIME message is invalid. See Setting up Process Data for MIME Encoding for information about setting up the XML representation.
• You must keep track of the document Ids of all the payloads you want to encode. You need to specify these document Ids in the XML representation of the MIME message.
• To enable base64 encoding of attachments, the Content-Transfer-Encoding of the attachment needs to be specified in the header. To do this, add the following line to the <mime:header> tag of the attachment:

<process name = "SetupProcessDataForMIMEencoding">
	<sequence>
		<assign to="mimeDoc/mime:message/mime:header" from="'multipart/form-data'"
append="true"/>
		<assign to="mimeDoc/mime:message/mime:header/@name" from="'Content-Type'"/>
		<operation name="Assign Document ID for Doc1">
			<participant name="This"/>
			<output message="giveDocumentRequest">
				<assign to="." from="*"/>
				<assign to="documentKey" from="'Doc1'"/>
			</output>
			<input message="giveDocumentResponse">
				<assign to="Doc1/dpc:document-id" from="documentId/text()"
append="true"/>
			</input>
		</operation>
		<assign to="MIMEtemp1/mime:message/mime:header" from"'111'" append="true"/>
		<assign to="MIMEtemp1/mime:message/mime:header/@name" from="'Content-ID'"
append="true"/>
		<assign to="MIMEtemp1/mime:message/mime:header" from="'application/EDI-X12'"
append="true"/>
		<assign to="MIMEtemp1/mime:message/mime:header/@name" from="'Content-Type'"
append="true"/>
		<assign to="MIMEtemp1/mime:message/mime:body" from="Doc1/doc:document-id"/>
		<assign to="mimeDoc/mime:message/mime:body/mime:message" from="MIMEtemp1/mime:message/node()" append="true"/>
		<operation name="Assign Document ID for DOc2">
			<participant name="This"/>
			<output message="giveDocumentRequest">
				<assign to="." from="*"/>
				<assign to="documentKey" from="'Doc2'"/>
			</output>
			<input message="giveDocumentResponse">
				<assign to="Doc2/doc:document-id" from="documentId/text()"
append="true"/>
			</input>
		</operation>
		</assign to="MIMEtemp2/mime:message/mime:header" from="'112'" append="true"/>
		<assign to="MIMEtemp2/mime:message/mime:header/2name" from="'Content-ID'"
append="true"/>
		<assign to="MIMEtemp2/mime:message/mime:header" from="'text/xml'"
append="true"/>
		<assign to="MIMEtemp2/mime:message/mime:header/@name" from="'Content-Type'"
append="true"/>
		<assign to="MIMEtemp2/mime:message/mime:body" from="Doc2/doc:document-id"/>
		<assign to="MIMEDoc/mime:message/mime:body/mime:message" from="MIMEtemp2/mime:message/node()" append="true"/>
	<sequence>
</process>

<mimeDoc>
	<mime:message xmlns:mime="http://www.company.com/company-name/mime/v0.5">
		<mime:header name="Content-Type">multipart/form-date</mime:header>
		<mime:body>
			<mime:message>
				<mime:header name="Content-ID">111</mime:header>
				<mime:header name="Content-Type">application/EDI-X12</mime:header>
				<mime:body>
					<doc:document-id xmlns:doc="http://www.company.com/compamy-name/document-id">servername:5f6303:fb326b59ac:6f71</doc:document-id>
				</mime:body>
			</mime:message>
			<mime:message>
				<mime:header name="Content-ID">112</mime:header>
				<mime:header name="Content-Type">text/xml</mime:header>
				<mime:body>
					<doc:document-id xmlns:doc="http://www.company.com/company-name/document-id">servername:5f6303:fb326b59ac:-6f5e</doc:document-id>
				</mime:body>
			</mime:message>
		</mime:body>
	</mime:message>
<mimeDoc>

Content-Type:multipart/form-data; boundary="ServerName:5f6303:fb4edbb774:-5b83:multipart.boundary.string"
Content-Length: 19757

--serverName::5f6303:fb4edbb774:-5b83::multipart.boundary.string
Content-ID: 111
Content-Type: application/EDI-X12
_Microsoft Word Document
MSWordDic_Word.Document.89q
--serverName::5f6303:fb4edbb774:-5b83::multipart.boundary.string
Content-ID: 112
Content-Type: text/xml

<Text>
</Text>
--serverName::5f6303:fb4edbb774:-5b83::multipart.boundary.string--

<process name = "MIMEDecoding">
	<sequence>
	
		<operation>
			<participant name="GetDocumentInfoService"/>
				<output message="Xout">
					<assign to="." from="*"></assign>
				</output>
			<input message="Xin">
				<assign to="primaryDocId" from=DocumentId"></assign>
			</input>
		</operation>
		
		<operation>
			<participant name="MIME"/>
				<output message="crackRequest">
					<assign to="mime-document-id/doc:document-id"
from="(string)primaryDocId" append="true"/>
	</output>
	<input message="crackResponse">
		<assign to="decodedDocument" from="mime-document/*" append="true"/>
	</input>
		</operation>
		
	</sequence>
</process>	

<process name="ExtractDocumentsFromMIME">
	<rule name="hasMoreDocuments">
		<conditions> count(decodeDocument/mime:message/mime:body/mime:message) > 0 </
conditions>
	</rule>
	<sequence>
<assign to="index" from="'0'" />
		<choice name="GetDocuments">
			</select>
			<sequence name="ProcessDocuments">
				<assign to="index" from="index + 1" />
				<operation>
					<participant name="This"/>
						<output message="takeDocumentRequest">
							<assign to="." from="*"/>
							<assign to="documentKey" from="concat{'Document', index/text()}" />
							assign to="documentId"
								from="decodeDocument/mime:message/mime:body/mime:message[1]/mime:body/doc:document-id/text()"/>
							</output>
							<input message="takeDocumentResponse">
								<assign to="." from="*"/>
							</input>
				</operation>
				<operation>
					<participant nae="ReleaseService"/>
						<output message="releaseRequest">
							<assign to="TARGET" from="'decodeDocument/mime:message/mime:body/mime:message[1]'"/>
						</output>
						<input message="releaseResponse"/>
				</operation>
				<repeat ref="GetDocuments"/>
			</sequence>
		</choice>
	</sequence>
</process>