RNIFSender Module

Properties   Methods   Events   Config Settings   Errors  

The RNIFSender module implements a RosettaNet Implementation Framework (RNIF) client.

Syntax

IPWorksEDI.Rnifsender

Remarks

The RNIFSender component may be used to send RosettaNet Implementation Framework (RNIF) messages over the TLS/SSL-secured HTTPS transport protocol. RosettaNet is used in a variety of industries including Semiconductor Manufacturing, Electronic Components, Telecommunications, Logistics, the Chemical Industry (through CIDX), and more.

A typical RosettaNet transaction is as follows:

1. The RNIF client creates a RosettaNet message and uploads it to the receiver over HTTPS. The contents and structures of these messages are defined by the RosettaNet community in the form of standardized Partner Interface Processes (PIPs). Due to the sensitive nature of most business documents, such messages will usually be encrypted and wrapped in an S/MIME entity along with a digital signature.
2. Upon receipt of the message, the receiver will verify the transport headers, then will attempt to decrypt the message and verify the digital signature.
3. Once these steps have been completed, the receiving application can process the PIP instance, and either send an acknowledgement of receipt or a reply in the form of another RosettaNet message back to the sender, depending upon the requirements of the particular PIP.

When sending a RosettaNet message, the client, at minimum, must specify the StandardName and StandardVersion of the message being sent in the preamble header. In the delivery header, the client must specify the SecureTransportRequired, MessageDateTime, MessageReceiverId, MessageSenderId, and MessageTrackingId properties. For the service header, all properties that are relevant to the action, reply, or signal must be specified. The client, after setting all appropriate header properties, must then set the content of the RosettaNet message body by setting the ServiceContent property.

Attachments may be added to the RosettaNet message. Attachments are arbitrary files allowed by specific PIPs, and may be simple text documents or pictures of products. Attachments are added to the RosettaNet message by adding instances of RNIFAttachment to the Attachments collection.

To secure the RosettaNet message, the message may be signed and/or encrypted by setting the appropriate certificates. By default, the component will apply the highest level of message security if the appropriate certificates are specified. To sign the data, set Certificate. To encrypt, set RecipientCert. To change which parts of the message, if any, are to be encrypted, set the EncryptionType property.

The final property to be set is the URL to which the client is posting the request. Once this is done, a call to the Post method causes the class to generate, sign, and encrypt the RosettaNet business document and upload it to the server.

NOTE: when the Post method is called, the class will perform a minimal set of checks on the various RosettaNet message headers to ensure that an invalid business message is not sent. If any values in the header are missing or are in conflict, the message cannot be processed by the receiving entity. To avoid a round trip, the class with a description of which header field is in error.

The response, may be sent synchronously or asynchronously, whether it is a complete business reply or a simple receipt acknowledgement. To change whether a synchronous or asynchronous response is desired, set the ResponseType before calling Post. If a synchronous response is received after the HTTPS post, ReplyHeaders and ReplyData will be populated appropriately.

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.

ActionCode Property (RNIFSender Module)

The code for this action.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=actionCode,setter=setActionCode:) NSString* actionCode;

- (NSString*)actionCode;
- (void)setActionCode :(NSString*)newActionCode;

Default Value

""

Remarks

This property is a string which denotes the type of action for the current RosettaNet message, if it is an action. If it is a reply, then the ActionCode describes the type of action that the message is in reply to. An example is a "Purchase Order Request Action."

This property is a field of the service header.

ActionMessage Property (RNIFSender Module)

Whether or not this message is an action message.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=actionMessage,setter=setActionMessage:) BOOL actionMessage;

- (BOOL)actionMessage;
- (void)setActionMessage :(BOOL)newActionMessage;

Default Value

False

Remarks

This property indicates whether or not the message is an action message. A RosettaNet action is defined as a message which requires or requests a business activity. A "PurchaseOrderRequestMessage" is a valid Business Action message, as is the corresponding "PurchaseOrderConfirmMessage". The latter, however, is also a reply to the original action request.

Receipt acknowledgments are considered Signals, and not Business Action messages, even though they contain all of the properties of a valid Business Action message.

This property is a field of the service header.

ActionMessageStandardName Property (RNIFSender Module)

The name of the standard used to create this action.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=actionMessageStandardName,setter=setActionMessageStandardName:) NSString* actionMessageStandardName;

- (NSString*)actionMessageStandardName;
- (void)setActionMessageStandardName :(NSString*)newActionMessageStandardName;

Default Value

""

Remarks

While the RosettaNet community has a set of widely adopted, pre-defined and standardized message templates, it also allows for business partners to agree on specification geared more toward their particular needs. If a special, non-RosettaNet standard is to be used to create the action message, the name of the standard must be reported in ActionMessageStandardName and the version in ActionMessageStandardVersion. This way, the receiving entity can know how to process and interpret the incoming business message.

Since replies may sent in response to a message created using such a specialized standard, the standard used to create the original message should be referenced using the OriginalMessageStandardName and OriginalMessageStandardVersion when creating or processing replies.

This property is a field of the service header.

ActionMessageStandardVersion Property (RNIFSender Module)

The version of the standard used to create this action.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=actionMessageStandardVersion,setter=setActionMessageStandardVersion:) NSString* actionMessageStandardVersion;

- (NSString*)actionMessageStandardVersion;
- (void)setActionMessageStandardVersion :(NSString*)newActionMessageStandardVersion;

Default Value

""

Remarks

While the RosettaNet community has a set of widely adopted, pre-defined and standardized message templates, it also allows for business partners to agree on specification geared more toward their particular needs. If a special, non-RosettaNet standard is to be used to create the action message, the name of the standard must be reported in ActionMessageStandardName and the version in ActionMessageStandardVersion. This way, the receiving entity can know how to process and interpret the incoming business message.

Since replies may sent in response to a message created using such a specialized standard, the standard used to create the original message should be referenced using the OriginalMessageStandardName and OriginalMessageStandardVersion when creating or processing replies.

This property is a field of the service header.

Attachments Property (RNIFSender Module)

A collection of files attached to the current RNIF message.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=attachmentCount,setter=setAttachmentCount:) int attachmentCount;

- (int)attachmentCount;
- (void)setAttachmentCount :(int)newAttachmentCount;

- (NSString*)attachmentData:(int)attachmentIndex;
- (void)setAttachmentData:(int)attachmentIndex :(NSString*)newAttachmentData;

- (NSData*)attachmentDataB:(int)attachmentIndex;
- (void)setAttachmentDataB:(int)attachmentIndex :(NSData*)newAttachmentData;
- (NSString*)attachmentDescription:(int)attachmentIndex;
- (void)setAttachmentDescription:(int)attachmentIndex :(NSString*)newAttachmentDescription;

- (NSString*)attachmentFilename:(int)attachmentIndex;
- (void)setAttachmentFilename:(int)attachmentIndex :(NSString*)newAttachmentFilename;

- (NSString*)attachmentId:(int)attachmentIndex;
- (void)setAttachmentId:(int)attachmentIndex :(NSString*)newAttachmentId;

- (NSString*)attachmentMIMEType:(int)attachmentIndex;
- (void)setAttachmentMIMEType:(int)attachmentIndex :(NSString*)newAttachmentMIMEType;

 

Default Value

""

Remarks

This property describes the URL location where the partner will receive the message being sent. This must be set before the message may be sent. It tells HTTP where to send the message. The URL of the partner process should be known by each of the processes.

BusinessActivity Property (RNIFSender Module)

This property denotes the type of business activity.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=businessActivity,setter=setBusinessActivity:) NSString* businessActivity;

- (NSString*)businessActivity;
- (void)setBusinessActivity :(NSString*)newBusinessActivity;

Default Value

""

Remarks

This property simply tells the receiver what type of business activity the RosettaNet document that is sent refers to. An example is: "Create Purchase Order".

CertEffectiveDate Property (RNIFSender Module)

This is the date on which this certificate becomes valid.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certEffectiveDate;

Default Value

""

Remarks

This is the date on which this certificate becomes valid. Before this date, it is not valid. The following example illustrates the format of an encoded date:

23-Jan-2000 15:00:00.

This property is read-only.

CertEncoded Property (RNIFSender 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

CertExpirationDate Property (RNIFSender Module)

This is the date the certificate expires.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certExpirationDate;

Default Value

""

Remarks

This is the date the certificate expires. After this date, the certificate will no longer be valid. The following example illustrates the format of an encoded date:

23-Jan-2001 15:00:00.

This property is read-only.

CertExtendedKeyUsage Property (RNIFSender Module)

This is a comma-delimited list of extended key usage identifiers.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=certExtendedKeyUsage,setter=setCertExtendedKeyUsage:) NSString* certExtendedKeyUsage;

- (NSString*)certExtendedKeyUsage;
- (void)setCertExtendedKeyUsage :(NSString*)newCertExtendedKeyUsage;

Default Value

""

Remarks

This is a comma-delimited list of extended key usage identifiers. These are the same as ASN.1 object identifiers (OIDs).

CertFingerprint Property (RNIFSender Module)

This is the hex-encoded, 16-byte MD5 fingerprint of the certificate.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certFingerprint;

Default Value

""

Remarks

This is the hex-encoded, 16-byte MD5 fingerprint of the certificate.

The following example illustrates the format: bc:2a:72:af:fe:58:17:43:7a:5f:ba:5a:7c:90:f7:02

This property is read-only.

CertFingerprintSHA1 Property (RNIFSender Module)

This is the hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certFingerprintSHA1;

Default Value

""

Remarks

This is the hex-encoded, 20-byte SHA-1 fingerprint of the certificate.

The following example illustrates the format: 30:7b:fa:38:65:83:ff:da:b4:4e:07:3f:17:b8:a4:ed:80:be:ff:84

This property is read-only.

CertFingerprintSHA256 Property (RNIFSender Module)

This is the hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certFingerprintSHA256;

Default Value

""

Remarks

This is the hex-encoded, 32-byte SHA-256 fingerprint of the certificate.

The following example illustrates the format: 6a:80:5c:33:a9:43:ea:b0:96:12:8a:64:96:30:ef:4a:8a:96:86:ce:f4:c7:be:10:24:8e:2b:60:9e:f3:59:53

This property is read-only.

CertIssuer Property (RNIFSender Module)

This is the issuer of the certificate.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certIssuer;

Default Value

""

Remarks

This is the issuer of the certificate. This property contains a string representation of the name of the issuing authority for the certificate.

This property is read-only.

CertKeyPassword Property (RNIFSender Module)

This is the password for the certificate's private key (if any).

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=certKeyPassword,setter=setCertKeyPassword:) NSString* certKeyPassword;

- (NSString*)certKeyPassword;
- (void)setCertKeyPassword :(NSString*)newCertKeyPassword;

Default Value

""

Remarks

This is the password for the certificate's private key (if any).

Some certificate stores may individually protect certificates' private keys, separate from the standard protection offered by the CertStorePassword. CertKeyPassword. This field can be used to read such password-protected private keys.

Note: this property defaults to the value of CertStorePassword. To clear it, you must set the property to the empty string (""). It can be set at any time, but when the private key's password is different from the store's password, then it must be set before calling CertPrivateKey.

CertPrivateKey Property (RNIFSender Module)

This is the private key of the certificate (if available).

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certPrivateKey;

Default Value

""

Remarks

This is the private key of the certificate (if available). The key is provided as PEM/Base64-encoded data.

Note: The CertPrivateKey may be available but not exportable. In this case, CertPrivateKey returns an empty string.

This property is read-only.

CertPrivateKeyAvailable Property (RNIFSender Module)

This property shows whether a PrivateKey is available for the selected certificate.

Syntax

• Swift
• Objective-C

public var certPrivateKeyAvailable: Bool {
  get {...}
}

@property (nonatomic,readonly,assign,getter=certPrivateKeyAvailable) BOOL certPrivateKeyAvailable;

- (BOOL)certPrivateKeyAvailable;

Default Value

False

Remarks

This property shows whether a CertPrivateKey is available for the selected certificate. If CertPrivateKeyAvailable is True, the certificate may be used for authentication purposes (e.g., server authentication).

This property is read-only.

CertPrivateKeyContainer Property (RNIFSender Module)

This is the name of the PrivateKey container for the certificate (if available).

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certPrivateKeyContainer;

Default Value

""

Remarks

This is the name of the CertPrivateKey container for the certificate (if available). This functionality is available only on Windows platforms.

This property is read-only.

CertPublicKey Property (RNIFSender Module)

This is the public key of the certificate.

Syntax

• Swift
• Objective-C

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

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

- (NSString*)certPublicKey;

Default Value

""

Remarks

This is the public key of the certificate. The key is provided as PEM/Base64-encoded data.

This property is read-only.

CertPublicKeyAlgorithm Property (RNIFSender Module)

This property contains the textual description of the certificate's public key algorithm.

Syntax

• Swift
• Objective-C

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

@property (nonatomic,readwrite,assign,getter=certPublicKeyAlgorithm,setter=setCertPublicKeyAlgorithm:) NSString* certPublicKeyAlgorithm;

- (NSString*)certPublicKeyAlgorithm;
- (void)setCertPublicKeyAlgorithm :(NSString*)newCertPublicKeyAlgorithm;

Default Value

""

Remarks

This property contains the textual description of the certificate's public key algorithm. The property contains either the name of the algorithm (e.g., "RSA" or "RSA_DH") or an object identifier (OID) string representing the algorithm.

CertPublicKeyLength Property (RNIFSender Module)

This is the length of the certificate's public key (in bits).

Syntax

• Swift
• Objective-C