CreateEntity Method

Creates a record from an eConnect XML document.

Class

Microsoft.Dynamics.GP.eConnect.eConnectMethods

Syntax

public bool CreateEntity(string connectionString, string sXML)

Parameters

Return Value

Type: boolean

The method returns a boolean value that indicates whether the XML document was successfully created. A return value of True indicates the operation succeeded.

Remarks

Use the CreateEntity method to create new data records in Microsoft Dynamics GP. For example, use CreateEntity to add a new customer or vendor.

To submit a document, create a string that represents the eConnect XML document. Use the string as the sXML parameter.

If an error occurs, the method throws an eConnectException, application exception, or exception.

Examples

The following C# code example creates a customer record from XML in a file named CustomerCreate.xml. Notice how the CreateEntity method returns a boolean value.

// Use an XML document to create a string representation of the customer
XmlDocument newCustDoc = new XmlDocument();
newCustDoc.Load("CustomerCreate.xml");
newCustomerDocument = newCustDoc.OuterXml;
// Specify the Microsoft Dynamics GP server and database in
// the connection string
sConnectionString = @"data source=MySrvr;initial catalog=TWO;
    integrated security=SSPI;persist security info=False;
    packet size=4096";
// Use the CreateEntity method
bool testResult = e.CreateEntity(sConnectionString, newCustomerDocument);

See Also

• CreateTransactionEntity Method