InterconnectAdd()


Create a new Interconnect Request.

Public Function InterconnectAdd(ByVal SessionID As String, _
                               
ByVal ECGridID1 As Integer, _
                                ByVal ECGridID2 As Integer, _
                                ByVal Reference As String, _
                                ByVal ContactName As String, _
                                ByVal ContactEMail As String, _
                                ByVal NotifyContact As Boolean, _
                                ByVal
Note As String) _
                                
As InterconnectIDInfo

Parameters

SessionID
String - GUID
The current session's GUID in string format. This is a 32-character hexidecimal string in the format:
00000000-0000-0000-0000-000000000000. This is the value returned by the Login() function.
ECGridID1
Integer
The ECGridID representing the Trading Partner requesting the Interconnect. See ECGridIDs.
ECGridID2
Integer
The ECGridID representing the Trading Partner being Interconnected to. See ECGridIDs.
Reference
String(0,16)
A user-defined reference number to attach to a Interconnect request.
ContactName
String(3,48)
The name of a contact person for the request.
ContactEMail
String(6,48)
The Email address of a contact person for the request.
NotifyContact
Boolean 
Indicates whether the Contact should be notified by e-mail when this Interconnect is added to the system. 
Note
String(0,250)
A free-form note to document the transaction.

Returns

InterconnectIDInfo Object

InterconnectID
Integer
The value assigned to a specific Interconnect request.
Created
Date
The date/time (UTC) the record was created.
Modified
Date
The date/time (UTC) the record was last modified.
Completed
Date
The date/time (UTC) the Interconnect was completed.
LastTraffic 
Date
The date/time (UTC) of the last traffic between these trading partners.
ContactName
String(3,48)
The name of a contact person for the request.
ContactEMail
String(6,48)
The Email address of a contact person for the request.
Status
Short - StatusInterconnect ENUM
A numeric value representing the Interconnect's status.
TP1
Object - ECGridIDInfo
An ECGridIDInfo Object for the requesting Trading Partner.
Reference1
String(0,16)
A user-defined reference number to attach to a Interconnect request for TP1.
TP2
Object - ECGridIDInfo
An ECGridIDInfo Object for the Interconnect Trading Partner.
Reference2
String(0,16)
A user-defined reference number to attach to a Interconnect request for TP2.
NetOps
UserIDInfo
The ECGrid Network Operations technician assigned to the request. This is only partially implemented for v2.0 for backwards compatibility.

Remarks

This method initiates an Interconnect Request. Based on previous requests and the type of Network that the ECGridID2 resides on, an expert system will determine if the Interconnect can be immediately activated or if it requires confirmation by the Interconnected Network.

Any Interconnects that move to a Pending status will be monitored by ECGrid NetOps until completion. To monitor the status of an Interconnect Request use InterconnectInfo() and InterconnectNoteList().

If the requested Interconnect already exists on the system, a Duplicate SOAP Exception will be returned.

Example

Visual Basic
[insert code sample]

EventID: 4001

See Also

Interconnects
InterconnectInfo()
InterconnectNoteList()


© 2008-2011, Loren Data Corp.
All rights reserved.
ECGrid is a registered service mark of Loren Data Corp.
ECGridOS is a service mark of Loren Data Corp.