AS1Receiver Module

Properties   Methods   Events   Config Settings   Errors  

The AS1Receiver module is used to process AS1 messages and generate receipts.

Syntax

IPWorksEDI.As1receiver

Remarks

The AS1Receiver class allows you to receive AS1 messages as specified in RFC 3335. The class can act as an email client, decrypt and verify incoming messages, generate receipts including Message Disposition Notifications (MDNs), and send them over SMTP/S.

Basic Operation

You should first log in to your mail server by setting MailServer, User, and Password, and invoking Connect. You may then navigate your mail inbox by setting MailMessageNumber, and inspecting properties such as MailMessageFrom, etc. When you find the desired file you may download it by invoking ReadRequest. Alternatively, you may acquire the AS1 data by other means and directly set Request and RequestHeaders.

ReadRequest (or ParseHeaders) will determine information such as From and SendTo, which will allow you to set the appropriate certificates. You may specify your certificate with the Certificate property, and your trading partner's (signing) certificate with the SignerCert property.

Then, invoke ProcessRequest to process the request and generate the MDN receipt as specified in RFC 3335. If the request was processed successfully, EDIData will contain the transmitted EDI data. If a problem occurred, EDIData will not be populated and an exception will be thrown. In either case MDNReceipt will contain the RFC-compliant receipt, which should be returned to the client.

The MDNReceipt may be returned over SMTP/S by invoking SendResponse. In case the server address for incoming mail is different than that for outgoing mail you should use Config to configure this.

To create log files, set LogDirectory prior to invoking ProcessRequest. This will log all incoming and outgoing data, and will also write the received EDI files to disk.

Example AS1Receiver1.User = "myusername" AS1Receiver1.Password = "mypassword" AS1Receiver1.MailServer = "1.2.3.4" AS1Receiver1.Connect() // You may need to search the server for received files at this point AS1Receiver1.MessageNumber = 1; // You may check properties such as MailMessageFrom, etc. AS1Receiver1.ReadRequest() AS1Receiver1.Certificate = new Certificate(CertStoreTypes.cstPFXFile, "\\my_server_directory\\my_pfx_file.pfx", "my password", "CN=Me"); AS1Receiver1.SignerCert = (base 64 encoded certificate); AS1Receiver1.LogDirectory = "c:\\my_server_directory\\my_log_directory"; AS1Receiver1.ProcessRequest(); AS1Receiver1.SendResponse(); AS1Receiver1.Disconnect(); Additional functionality allows the user to examine details of the client's request, to permit certain types of errors, or to customize the outgoing MDN. See the property and method list for details.

Property List

The following is the full list of the properties of the module with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the module with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the module with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the module with short descriptions. Click on the links for further details.

Attachments Property (AS1Receiver Module)

Collection of files attached to the current message.

Syntax

• Swift
• Objective-C

public var attachments: Array<EDIAttachment> {
  get {...}
}

@property (nonatomic,readonly,assign,getter=attachmentCount) int attachmentCount;

- (int)attachmentCount;

- (NSString*)attachmentContentType:(int)attachmentIndex;

- (NSString*)attachmentData:(int)attachmentIndex;

- (NSData*)attachmentDataB:(int)attachmentIndex;
- (NSString*)attachmentFilename:(int)attachmentIndex;

- (NSString*)attachmentHeaders:(int)attachmentIndex;

- (NSString*)attachmentName:(int)attachmentIndex;

 

Default Value

""

Remarks

The username for your incoming mail server. Set this before invoking Connect.

CertEncoded Property (AS1Receiver Module)

This is the certificate (PEM/base64 encoded).

Syntax

• Swift
• Objective-C

public var certEncoded: String {
  get {...}
  set {...}
}

public var certEncodedB: Data {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=certEncoded,setter=setCertEncoded:) NSString* certEncoded;

- (NSString*)certEncoded;
- (void)setCertEncoded :(NSString*)newCertEncoded;

@property (nonatomic,readwrite,assign,getter=certEncodedB,setter=setCertEncodedB:) NSData* certEncodedB;

- (NSData*)certEncodedB;
- (void)setCertEncodedB :(NSData*)newCertEncoded;

Default Value

""

Remarks

This is the certificate (PEM/base64 encoded). This property is used to assign a specific certificate. The CertStore and CertSubject properties also may be used to specify a certificate.

When CertEncoded is set, a search is initiated in the current CertStore for the private key of the certificate. If the key is found, CertSubject is updated to reflect the full subject of the selected certificate; otherwise, CertSubject is set to an empty string.

If an error occurs when setting this property an error will not be thrown. This property has a related method which will throw an error:

public func setCertEncodedB(certEncoded: Data) throws
public func setCertEncoded(certEncoded: String) throws

CertStore Property (AS1Receiver Module)

This is the name of the certificate store for the client certificate.

Syntax

• Swift
• Objective-C

public var certStore: String {
  get {...}
  set {...}
}

public var certStoreB: Data {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=certStore,setter=setCertStore:) NSString* certStore;

- (NSString*)certStore;
- (void)setCertStore :(NSString*)newCertStore;

@property (nonatomic,readwrite,assign,getter=certStoreB,setter=setCertStoreB:) NSData* certStoreB;

- (NSData*)certStoreB;
- (void)setCertStoreB :(NSData*)newCertStore;

Default Value

"MY"

Remarks

This is the name of the certificate store for the client certificate.

The CertStoreType property denotes the type of the certificate store specified by CertStore. If the store is password protected, specify the password in CertStorePassword.

CertStore is used in conjunction with the CertSubject property to specify client certificates. If CertStore has a value, and CertSubject or CertEncoded is set, a search for a certificate is initiated. Please see the CertSubject property for details.

Designations of certificate stores are platform-dependent.

The following are designations of the most common User and Machine certificate stores in Windows:

When the certificate store type is PFXFile, this property must be set to the name of the file. When the type is PFXBlob, the property must be set to the binary contents of a PFX file (i.e. PKCS12 certificate store).

CertStorePassword Property (AS1Receiver Module)

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

Syntax

• Swift
• Objective-C

public var certStorePassword: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=certStorePassword,setter=setCertStorePassword:) NSString* certStorePassword;

- (NSString*)certStorePassword;
- (void)setCertStorePassword :(NSString*)newCertStorePassword;

Default Value

""

Remarks

If the type of certificate store requires a password, this property is used to specify the password needed to open the certificate store.

CertStoreType Property (AS1Receiver Module)

This is the type of certificate store for this certificate.

Syntax

• Swift
• Objective-C

public var certStoreType: As1receiverCertStoreTypes {
  get {...}
  set {...}
}

public enum As1receiverCertStoreTypes: Int32 {
  case cstUser = 0
  case cstMachine = 1
  case cstPFXFile = 2
  case cstPFXBlob = 3
  case cstJKSFile = 4
  case cstJKSBlob = 5
  case cstPEMKeyFile = 6
  case cstPEMKeyBlob = 7
  case cstPublicKeyFile = 8
  case cstPublicKeyBlob = 9
  case cstSSHPublicKeyBlob = 10
  case cstP7BFile = 11
  case cstP7BBlob = 12
  case cstSSHPublicKeyFile = 13
  case cstPPKFile = 14
  case cstPPKBlob = 15
  case cstXMLFile = 16
  case cstXMLBlob = 17
  case cstJWKFile = 18
  case cstJWKBlob = 19
  case cstSecurityKey = 20
  case cstBCFKSFile = 21
  case cstBCFKSBlob = 22
  case cstAuto = 99
}

@property (nonatomic,readwrite,assign,getter=certStoreType,setter=setCertStoreType:) int certStoreType;

- (int)certStoreType;
- (void)setCertStoreType :(int)newCertStoreType;

Default Value

0

Remarks

This is the type of certificate store for this certificate.

The class supports both public and private keys in a variety of formats. When the cstAuto value is used the class will automatically determine the type. This property can take one of the following values:

CertSubject Property (AS1Receiver Module)

This is the subject of the certificate used for client authentication.

Syntax

• Swift
• Objective-C

public var certSubject: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=certSubject,setter=setCertSubject:) NSString* certSubject;

- (NSString*)certSubject;
- (void)setCertSubject :(NSString*)newCertSubject;

Default Value

""

Remarks

This is the subject of the certificate used for client authentication.

This property must be set after all other certificate properites are set. When this property is set, a search is performed in the current certificate store certificate with matching subject.

If a matching certificate is found, the property is set to the full subject of the matching certificate.

If an exact match is not found, the store is searched for subjects containing the value of the property.

If a match is still not found, the property is set to an empty string, and no certificate is selected.

The special value "*" picks a random certificate in the certificate store.

The certificate subject is a comma separated list of distinguished name fields and values. For instance "CN=www.server.com, OU=test, C=US, E=support@nsoftware.com". Common fields and their meanings are displayed below.

If a field value contains a comma it must be quoted.

If an error occurs when setting this property an error will not be thrown. This property has a related method which will throw an error:

public func setCertSubject(certSubject: String) throws

CompressionFormat Property (AS1Receiver Module)

The compression format used on the incoming message.

Syntax

• Swift
• Objective-C

public var compressionFormat: As1receiverCompressionFormats {
  get {...}
}

public enum As1receiverCompressionFormats: Int32 {
  case cfNone = 0
  case cfZLIB = 1
}

@property (nonatomic,readonly,assign,getter=compressionFormat) int compressionFormat;

- (int)compressionFormat;

Default Value

0

Remarks

The compression format used on the incoming message, if any. Compressed messages will automatically be decompressed by the class.

This property is read-only.

Connected Property (AS1Receiver Module)

This shows whether the module is connected.

Syntax

• Swift
• Objective-C

public var connected: Bool {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=connected,setter=setConnected:) BOOL connected;

- (BOOL)connected;
- (void)setConnected :(BOOL)newConnected;

Default Value

False

Remarks

This property is used to determine whether or not the class is connected to the remote host.

Note: It is recommended to use the Connect or Disconnect method instead of setting this property.

EDIData Property (AS1Receiver Module)

The EDI data sent in Request .

Syntax

• Swift
• Objective-C

public var ediData: EDIData {
  get {...}
}

@property (nonatomic,readonly,assign,getter=EDIData) NSString* EDIData;

- (NSString*)EDIData;

@property (nonatomic,readonly,assign,getter=EDIDataB) NSData* EDIDataB;

- (NSData*)EDIDataB;
@property (nonatomic,readonly,assign,getter=EDIType) NSString* EDIType;

- (NSString*)EDIType;

@property (nonatomic,readonly,assign,getter=EDIFilename) NSString* EDIFilename;

- (NSString*)EDIFilename;

@property (nonatomic,readonly,assign,getter=EDIName) NSString* EDIName;

- (NSString*)EDIName;

 

Default Value

""

Remarks

The username for your incoming mail server. Set this before invoking Connect.

Firewall Property (AS1Receiver Module)

A set of properties related to firewall access.

Syntax

• Swift
• Objective-C

public var firewall: Firewall {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=firewallAutoDetect,setter=setFirewallAutoDetect:) BOOL firewallAutoDetect;

- (BOOL)firewallAutoDetect;
- (void)setFirewallAutoDetect :(BOOL)newFirewallAutoDetect;

@property (nonatomic,readwrite,assign,getter=firewallType,setter=setFirewallType:) int firewallType;

- (int)firewallType;
- (void)setFirewallType :(int)newFirewallType;

@property (nonatomic,readwrite,assign,getter=firewallHost,setter=setFirewallHost:) NSString* firewallHost;

- (NSString*)firewallHost;
- (void)setFirewallHost :(NSString*)newFirewallHost;

@property (nonatomic,readwrite,assign,getter=firewallPassword,setter=setFirewallPassword:) NSString* firewallPassword;

- (NSString*)firewallPassword;
- (void)setFirewallPassword :(NSString*)newFirewallPassword;

@property (nonatomic,readwrite,assign,getter=firewallPort,setter=setFirewallPort:) int firewallPort;

- (int)firewallPort;
- (void)setFirewallPort :(int)newFirewallPort;

@property (nonatomic,readwrite,assign,getter=firewallUser,setter=setFirewallUser:) NSString* firewallUser;

- (NSString*)firewallUser;
- (void)setFirewallUser :(NSString*)newFirewallUser;

 

Default Value

""

Remarks

The username for your incoming mail server. Set this before invoking Connect.

From Property (AS1Receiver Module)

The sender of the original message.

Syntax

• Swift
• Objective-C

public var from: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=from,setter=setFrom:) NSString* from;

- (NSString*)from;
- (void)setFrom :(NSString*)newFrom;

Default Value

""

Remarks

The sender of the original message. The recipient is given by SendTo.

Note that From and SendTo correspond to the sender and recipient of the original message. For MDNs the roles are reversed, so that From indicates the recipient, and SendTo indicates the sender of the MDN.

LocalHost Property (AS1Receiver Module)

The name of the local host or user-assigned IP interface through which connections are initiated or accepted.

Syntax

• Swift
• Objective-C

public var localHost: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=localHost,setter=setLocalHost:) NSString* localHost;

- (NSString*)localHost;
- (void)setLocalHost :(NSString*)newLocalHost;

Default Value

""

Remarks

The LocalHost property contains the name of the local host as obtained by the gethostname() system call, or if the user has assigned an IP address, the value of that address.

In multi-homed hosts (machines with more than one IP interface) setting LocalHost to the value of an interface will make the class initiate connections (or accept in the case of server classs) only through that interface.

If the class is connected, the LocalHost property shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multi-homed hosts (machines with more than one IP interface).

NOTE: LocalHost is not persistent. You must always set it in code, and never in the property window.

LogDirectory Property (AS1Receiver Module)

The path to a directory for logging.

Syntax

• Swift
• Objective-C

public var logDirectory: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=logDirectory,setter=setLogDirectory:) NSString* logDirectory;

- (NSString*)logDirectory;
- (void)setLogDirectory :(NSString*)newLogDirectory;

Default Value

""

Remarks

Setting LogDirectory will instruct the component to log the details of each transmission to unique files in the specified directory. For each request processed, the class will log the original EDI data, the complete text of the outgoing request and the incoming response.

The class will write a file for each transmission, with extension ".log". In case of error an additional file will be written with extension ".err", and the error will be reported in both files. Raw AS1 messages created or downloaded by the class will be written with extension ".as1", and MDNs created or downloaded will be written with extension ".as1-mdn".

The filenames will be chosen automatically by the class. Each filename will be the system time, in the format YYYY-MM-DD-HH-MM-SS-MMMM, with extensions "-2", "-3", used in case files of those names already exist. After each transaction is processed LogFile will contain the name of the files just written, minus the extension ".log" or ".err".

If logs cannot be written an exception will be thrown.

LogFile Property (AS1Receiver Module)

The log file written.

Syntax

• Swift
• Objective-C

public var logFile: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=logFile) NSString* logFile;

- (NSString*)logFile;

Default Value

""

Remarks

In case LogDirectory is specified two log files will be written in the specified directory and LogFile will contain the path.

LogFile will in fact refer to several files with appropriate extensions. A diagnostic log will be written with filename LogFile + ".log", and any EDI data read will be written with filename LogFile + ".dat". Raw AS1 messages and MDNs will also be written with extensions ".as1" and ".as1-mdn".

This property is read-only.

MailMessageCc Property (AS1Receiver Module)

The value of the Cc header of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageCc: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageCc) NSString* mailMessageCc;

- (NSString*)mailMessageCc;

Default Value

""

Remarks

After calling SelectMailMessage this property will be populated with the value of the Cc header of the mail message.

This property is read-only.

MailMessageCount Property (AS1Receiver Module)

The number of messages waiting in the mailbox.

Syntax

• Swift
• Objective-C

public var mailMessageCount: Int32 {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageCount) int mailMessageCount;

- (int)mailMessageCount;

Default Value

0

Remarks

When the class is not connected to the mail server, the value of the MailMessageCount property is 0. When connected, it contains the number of messages in the mailbox. You may set MailMessageNumber to any value between 1 and MailMessageCount to inspect a given message.

This property is read-only.

MailMessageDate Property (AS1Receiver Module)

The message date for the currently selected message.

Syntax

• Swift
• Objective-C

public var mailMessageDate: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageDate) NSString* mailMessageDate;

- (NSString*)mailMessageDate;

Default Value

""

Remarks

The date will be formatted like the following example:

Wed, 29 Dec 2004 11:58:02 +0700

This property is read-only.

MailMessageFrom Property (AS1Receiver Module)

The sender of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageFrom: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageFrom) NSString* mailMessageFrom;

- (NSString*)mailMessageFrom;

Default Value

""

Remarks

After calling SelectMailMessage this property will be populated. When processing AS1 transmissions, this will correspond to From. When processing MDNs, this will correspond to SendTo.

This property is read-only.

MailMessageHeaders Property (AS1Receiver Module)

The message headers for the currently selected message.

Syntax

• Swift
• Objective-C

public var mailMessageHeaders: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageHeaders) NSString* mailMessageHeaders;

- (NSString*)mailMessageHeaders;

Default Value

""

Remarks

After calling SelectMailMessage this property will contain the full headers of the mail message as reported by the mail server.

This property is read-only.

MailMessageNumber Property (AS1Receiver Module)

The message number on the incoming mail server.

Syntax

• Swift
• Objective-C

public var mailMessageNumber: Int32 {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=mailMessageNumber,setter=setMailMessageNumber:) int mailMessageNumber;

- (int)mailMessageNumber;
- (void)setMailMessageNumber :(int)newMailMessageNumber;

Default Value

0

Remarks

MailMessageNumber specifies a number between 1 and MailMessageCount, and serves as a message pointer to an incoming mail message.

Set this property before calling SelectMailMessage

MailMessageReplyTo Property (AS1Receiver Module)

The value of the ReplyTo header of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageReplyTo: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageReplyTo) NSString* mailMessageReplyTo;

- (NSString*)mailMessageReplyTo;

Default Value

""

Remarks

After calling SelectMailMessage this property will be populated with the value of the ReplyTo header of the mail message.

This property is read-only.

MailMessageSize Property (AS1Receiver Module)

The size of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageSize: Int32 {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageSize) int mailMessageSize;

- (int)mailMessageSize;

Default Value

0

Remarks

After calling QueryMessageSize this property will be populated with the the size of the mail message.

Note: It is recommended to use the QueryMessageSize method instead of getting this property.

This property is read-only.

MailMessageSubject Property (AS1Receiver Module)

The subject of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageSubject: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageSubject) NSString* mailMessageSubject;

- (NSString*)mailMessageSubject;

Default Value

""

Remarks

After calling SelectMailMessage this property will be populated with the subject of the mail message.

This property is read-only.

MailMessageText Property (AS1Receiver Module)

The text of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageText: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageText) NSString* mailMessageText;

- (NSString*)mailMessageText;

Default Value

""

Remarks

The text of the mail message identified by MailMessageNumber, if it has been downloaded from the server. To read the message, invoke ReadRequest (receiver) or ReadReceipt (sender). In case the message is not as AS1 message this will throw an exception, but you may catch it and then read the value of MailMessageText.

This property is read-only.

MailMessageTo Property (AS1Receiver Module)

The recipient of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageTo: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageTo) NSString* mailMessageTo;

- (NSString*)mailMessageTo;

Default Value

""

Remarks

After calling SelectMailMessage this property will be populated with the recipient of the mail message.

This property is read-only.

MailMessageUID Property (AS1Receiver Module)

The unique id of the mail message.

Syntax

• Swift
• Objective-C

public var mailMessageUID: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=mailMessageUID) NSString* mailMessageUID;

- (NSString*)mailMessageUID;

Default Value

""

Remarks

After calling QueryMessageUID this property will be populated with the unique id of the mail message.

Note: It is recommended to use the QueryMessageUID method instead of getting this property.

This property is read-only.

MailServer Property (AS1Receiver Module)

The address of your mail server.

Syntax

• Swift
• Objective-C

public var mailServer: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=mailServer,setter=setMailServer:) NSString* mailServer;

- (NSString*)mailServer;
- (void)setMailServer :(NSString*)newMailServer;

Default Value

""

Remarks

The address of your mail server. By default, the class will send outgoing mail via SMTP, and receive incoming mail via POP. Moreover, the class will assume that both servers are located at the address specified by MailServer.

In case you use different addresses for incoming and outgoing mail you should set the POPServer and SMTPServer configuration settings appropriately. You may also set POPPort and SMTPPort in case you use nonstandard ports.

To configure SSL you should set SSLStartMode. Note that if SSL is used for sending but not receiving, or vice versa, you should set SSLStartMode each time you send or receive a file.

MDNReceipt Property (AS1Receiver Module)

The MDN-based receipt generated by the module.

Syntax

• Swift
• Objective-C

public var mdnReceipt: MDNReceipt {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=MDNReceiptContent,setter=setMDNReceiptContent:) NSString* MDNReceiptContent;

- (NSString*)MDNReceiptContent;
- (void)setMDNReceiptContent :(NSString*)newMDNReceiptContent;

@property (nonatomic,readwrite,assign,getter=MDNReceiptContentB,setter=setMDNReceiptContentB:) NSData* MDNReceiptContentB;

- (NSData*)MDNReceiptContentB;
- (void)setMDNReceiptContentB :(NSData*)newMDNReceiptContent;
@property (nonatomic,readonly,assign,getter=MDNReceiptHeaderCount) int MDNReceiptHeaderCount;

- (int)MDNReceiptHeaderCount;

@property (nonatomic,readonly,assign,getter=MDNReceiptHeaderField) NSString* MDNReceiptHeaderField;

- (NSString*)MDNReceiptHeaderField;

@property (nonatomic,readwrite,assign,getter=MDNReceiptHeaderIndex,setter=setMDNReceiptHeaderIndex:) int MDNReceiptHeaderIndex;

- (int)MDNReceiptHeaderIndex;
- (void)setMDNReceiptHeaderIndex :(int)newMDNReceiptHeaderIndex;

@property (nonatomic,readwrite,assign,getter=MDNReceiptHeaders,setter=setMDNReceiptHeaders:) NSString* MDNReceiptHeaders;

- (NSString*)MDNReceiptHeaders;
- (void)setMDNReceiptHeaders :(NSString*)newMDNReceiptHeaders;

@property (nonatomic,readonly,assign,getter=MDNReceiptHeaderValue) NSString* MDNReceiptHeaderValue;

- (NSString*)MDNReceiptHeaderValue;

@property (nonatomic,readonly,assign,getter=MDNReceiptMDN) NSString* MDNReceiptMDN;

- (NSString*)MDNReceiptMDN;

@property (nonatomic,readonly,assign,getter=MDNReceiptMessage) NSString* MDNReceiptMessage;

- (NSString*)MDNReceiptMessage;

@property (nonatomic,readonly,assign,getter=MDNReceiptMICValue) NSString* MDNReceiptMICValue;

- (NSString*)MDNReceiptMICValue;

@property (nonatomic,readonly,assign,getter=MDNReceiptSigningProtocol) NSString* MDNReceiptSigningProtocol;

- (NSString*)MDNReceiptSigningProtocol;

 

Default Value

""

Remarks

The username for your incoming mail server. Set this before invoking Connect.

MDNTo Property (AS1Receiver Module)

The recipient for the Message Disposition Notification (MDN).

Syntax

• Swift
• Objective-C

public var mdnTo: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=MDNTo) NSString* MDNTo;

- (NSString*)MDNTo;

Default Value

""

Remarks

MDNTo corresponds to the Disposition-Notification-To header of RequestHeaders. If nonempty, the client has requested an MDN receipt (typically the actual value is irrelevant). This receipt will be generated in a call to ProcessRequest or CreateMDNReceipt, and may be sent by calling SendResponse.

The receipt will be contained in MDNReceipt. If ReceiptDeliveryOption is empty, the receipt should be synchronously delivered in the HTTP response; otherwise, it should be delivered asynchronously to the URL specified. In either case, SendResponse will send the response as appropriate.

According to RFC specifications, MDNReceipt must be sent if requested by the client. If MDNTo is empty the MDN may be sent or not at the option of the server.

This property is read-only.

MessageId Property (AS1Receiver Module)

The message ID of the incoming message.

Syntax

• Swift
• Objective-C

public var messageId: String {
  get {...}
}

@property (nonatomic,readonly,assign,getter=messageId) NSString* messageId;

- (NSString*)messageId;

Default Value

""

Remarks

MessageId corresponds to the Message-Id header of Request, and will be used as the Original-Message-Id header of MDNReceipt.

This property is read-only.

Password Property (AS1Receiver Module)

The password for your incoming mail server.

Syntax

• Swift
• Objective-C

public var password: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=password,setter=setPassword:) NSString* password;

- (NSString*)password;
- (void)setPassword :(NSString*)newPassword;

Default Value

""

Remarks

The password for your incoming mail server. Set this before invoking Connect.

Request Property (AS1Receiver Module)

The AS1 request to be processed.

Syntax

• Swift
• Objective-C

public var request: String {
  get {...}
  set {...}
}

public var requestB: Data {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=request,setter=setRequest:) NSString* request;

- (NSString*)request;
- (void)setRequest :(NSString*)newRequest;

@property (nonatomic,readwrite,assign,getter=requestB,setter=setRequestB:) NSData* requestB;

- (NSData*)requestB;
- (void)setRequestB :(NSData*)newRequest;

Default Value

""

Remarks

You may specify the request manually, or you may load the request from the mail server by invoking ReadRequest.

The headers generally should be specified separately in RequestHeaders.

RequestHeaders Property (AS1Receiver Module)

The headers in the AS1 request.

Syntax

• Swift
• Objective-C

public var requestHeaders: Array<Header> {
  get {...}
}

@property (nonatomic,readwrite,assign,getter=requestHeaderCount,setter=setRequestHeaderCount:) int requestHeaderCount;

- (int)requestHeaderCount;
- (void)setRequestHeaderCount :(int)newRequestHeaderCount;

- (NSString*)requestHeaderField:(int)requestHeaderIndex;
- (void)setRequestHeaderField:(int)requestHeaderIndex :(NSString*)newRequestHeaderField;

- (NSString*)requestHeaderValue:(int)requestHeaderIndex;
- (void)setRequestHeaderValue:(int)requestHeaderIndex :(NSString*)newRequestHeaderValue;

 

Default Value

""

Remarks

The username for your incoming mail server. Set this before invoking Connect.

RequestHeadersString Property (AS1Receiver Module)

The headers in the AS1 request.

Syntax

• Swift
• Objective-C

public var requestHeadersString: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=requestHeadersString,setter=setRequestHeadersString:) NSString* requestHeadersString;

- (NSString*)requestHeadersString;
- (void)setRequestHeadersString :(NSString*)newRequestHeadersString;

Default Value

""

Remarks

The headers will include any and all headers attached by the mail server(s).

ScanResult Property (AS1Receiver Module)

The result of invoking ParseRequest .

Syntax

• Swift
• Objective-C

public var scanResult: Int32 {
  get {...}
}

@property (nonatomic,readonly,assign,getter=scanResult) int scanResult;

- (int)scanResult;

Default Value

0

Remarks

ScanResult will contain information about any errors that occurred while invoking ParseRequest or ProcessRequest. ScanResult will contain 0 if no errors occurred, otherwise it will contain one or more of the following errors. If multiple errors are reported the results will be OR-ed together.

This property is read-only.

SendTo Property (AS1Receiver Module)

The recipient of the original message.

Syntax

• Swift
• Objective-C

public var sendTo: String {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=sendTo,setter=setSendTo:) NSString* sendTo;

- (NSString*)sendTo;
- (void)setSendTo :(NSString*)newSendTo;

Default Value

""

Remarks

The recipient of the original message. The originator is given by From.

Note that From and SendTo correspond to the sender and recipient of the original message. For MDNs the roles are reversed, so that From indicates the recipient, and SendTo indicates the sender of the MDN.

SignerCertEncoded Property (AS1Receiver Module)

This is the certificate (PEM/base64 encoded).

Syntax

• Swift
• Objective-C

public var signerCertEncoded: String {
  get {...}
  set {...}
}

public var signerCertEncodedB: Data {
  get {...}
  set {...}
}

@property (nonatomic,readwrite,assign,getter=signerCertEncoded,setter=setSignerCertEncoded:) NSString* signerCertEncoded;

- (NSString*)signerCertEncoded;
- (void)setSignerCertEncoded :(NSString*)newSignerCertEncoded;

@property (nonatomic,readwrite,assign,getter=signerCertEncodedB,setter=setSignerCertEncodedB:) NSData* signerCertEncodedB;

- (NSData*)signerCertEncodedB;
- (void)setSignerCertEncodedB :(NSData*)newSignerCertEncoded;

Default Value

""

Remarks

This is the certificate (PEM/base64 encoded). This property is used to assign a specific certificate. The SignerCertStore and SignerCertSubject properties also may be used to specify a certificate.