CREATE

LANSA Integrator

CREATE

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

Syntax:

Command

Keyword

Value

Developer notes for Command/Keyword/Value

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.

*NONE

No receipt delivery.

RECEIPTSIGNED

*YES

Optional. Signed Receipt

*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.

*NO

Default.

ENCRYPTED

*YES

Optional Encrypt content.

*NO

Default.

COMPRESSED

*YES

Optional. Compress content.

*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 for Command/Keyword/Value

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.

*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.