View Source

The CREATE command is used to create an AS3 transaction or receipt.

Syntax:

Command	Keyword	Value	Developer notes
CREATE	OBJECT	*TRANSACTION	Optional. Default. Create transaction
	RECIPIENT	value	Mandatory. The identity that that will receive the receipt. This value is used in resource file lookups. Value is made up of 2 components separated by a colon, a name component and an optional private keystore password component. Example: ACME:mypassword
	SUBJECT	value	Optional. Subject.
	RECEIPTTO	value	Optional. Receipt delivery.
	RECEIPTTO	*NONE	No receipt delivery.
	RECEIPTSIGNED	*YES	Optional. Signed Receipt
	RECEIPTSIGNED	*NO	Default.
	FILE	value	Mandatory. File containing EDI content.
	NAME	value	Optional. Name of file. Default is to use the FILE name.
	CONTENT	value	Mandatory. Content type.
		*XML	application/xml
		*EDIFACT	application/edifact
		*X12	application/x12
	SIGNED	*YES	Optional. Sign content.
	SIGNED	*NO	Default.
	ENCRYPTED	*YES	Optional Encrypt content.
	ENCRYPTED	*NO	Default.
	COMPRESSED	*YES	Optional. Compress content.
	COMPRESSED	*NO	Default.
	MESSAGEID	value	Optional.

The RECIPIENT keyword value is used to obtain the signing key file, password, signing certificate and encryption certificates using a selection hierarchy of entries from the properties file.

     keystore.{recipient}= pki/filename
     keystore = pki/filename
     keystore.password.{recipient} = password
     keystore.password = password
     certificate.{recipient} = pki/filename
     certificate = pki/filename
     encryption.certificates.{recipient} = pki/filename, pki/filename, pki/filename
     as3-to.{recipient} = companyto
     as3-from.{recipient} = companyfrom
     as3-from = companyfrom
     subject.{recipient} = subject
     subject = subject
     receipt.to.{recipient}=receipt to
     receipt.to=receipt to
     receipt.signed.{recipient}=*yes | *no
     receipt.signed=*yes | *no
     messageid.suffix.{recipient} = company identifier
     messageid.suffix. = company identifier
     signed.algorithm.{recipient} = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512
     signed.algorithm = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512
     encryption.algorithm.{recipient} = *DES3 | *AES128 | *AES192 | *AES256
     encryption.algorithm = *DES3 | *AES128 | *AES192 | *AES256

Syntax:

Command	Keyword	Value	Developer notes
CREATE	OBJECT	*RECEIPT	Mandatory. Create receipt.
	RECIPIENT	value	Mandatory. The identity that receives the transaction. This value is used in resource file lookups. Value is made up of 2 components separated by a colon, a name component and an optional private keystore password component. Example: ACME:mypassword
	RECEIPTMIC	value	Mandatory. Original Message MIC.
	RECEIPTMESSAGEID	value	Mandatory. Original Message Id.
	RECEIPTSUBJECT	value	Mandatory. Original Message Subject.
	PROCESSED	value	Optional. Default is "processed".
	MODIFIER	value	Optional. Default is blank.
	AS3TO	value	Optional. AS3-To.
	AS3FROM	value	Optional. AS3-From.
	SUBJECT	value	Optional. Receipt subject.
	TEXT	value	Optional. Text.
	MESSAGEID	value	Optional.
	SIGNED	*YES	Optional. Sign receipt.
	SIGNED	*NO	Default.

The RECIPIENT keyword value is used to obtain the signing key file, password and singing certificate using a selection hierarchy of entries from the properties file.

The keystore and certificates are only used when the receipt needs to be signed.

     keystore.{recipient}= pki/filename
     keystore = pki/filename
     keystore.password.{recipient} = password
     keystore.password = password
     certificate.{recipient} = pki/filename
     certificate = pki/filename
     as3-to.{recipient} = companyto
     as3-from.{recipient} = companyfrom
     as3-from = companyfrom
     subject.{recipient} = subject
     subject = subject
     receipt.to.{recipient}=receipt to
     receipt.to=receipt to
     messageid.suffix.{recipient} = company identifier
     messageid.suffix. = company identifier
     signed.algorithm.{recipient} = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512
     signed.algorithm = *MD5 | *SHA1 | *SHA256 | *SHA384 | *SHA512

Human readable text is obtained from a file using a properties file selection hierarchy.

     receipt.message.{recipient} = system/receipt-message.txt
     receipt.message = system/receipt-message.txt

The receipt.message contains the human readable component of the receipt.

The following special merge labels are supported in the receipt.message file:

     %%COMPANYFROM%%
     %%COMPANYTO%%
     %%DATE%%
     %%SUBJECT%%
     %%TEXT%%

Sample receipt.message file content:

     The message sent to recipient <%%COMPANYTO%%> on %%DATE%% with subject "%%SUBJECT%%" has been received.