CRMCustomerAddress.Create Method
The Create method creates a customer address.
Syntax
[Visual Basic .NET]
Public Function Create(
ByVal Caller As CUserAuth,
ByVal EntityXML As String
) As String
[C#]
public string Create(
CUserAuth Caller,
string EntityXML
);
[C++]
public: String* Create(
CUserAuth* Caller,
String* EntityXML
);
Parameters
Caller
Specifies the identity of the caller. See CUserAuth.
EntityXML
Specifies the XML string containing the customer address information. The XML schema is described by customeraddress.xsd.
Return Value
Returns a String type that specifies the ID of the newly created customer address.
Remarks
If there is an error, SOAP throws an exception and the error message is reported in System.Web.Services.Protocols.SoapException.Detail.OuterXml.
All IDs passed to the platform are GUIDs wrapped in braces. For example: {6522D89A-A752-4455-A2B0-51494C6957C3}
Example
[C#]
// strServer should be set with the name of the platform Web server
string strServer = "myservername";
// virtualDirectory should be set with the name of the Microsoft CRM
// virtual directory on the platform Web server
string virtualDirectory = "mscrmservices";
string strDir = "https://" + strServer + "/" + virtualDirectory + "/";
// BizUser proxy object
Microsoft.Crm.Platform.Proxy.BizUser bizUser = new Microsoft.Crm.Platform.Proxy.BizUser ();
bizUser.Credentials = System.Net.CredentialCache.DefaultCredentials;
bizUser.Url = strDir + "BizUser.srf";
// CRMCustomerAddress proxy object
Microsoft.Crm.Platform.Proxy.CRMCustomerAddress customeraddress = new Microsoft.Crm.Platform.Proxy.CRMCustomerAddress ();
customeraddress.Credentials = System.Net.CredentialCache.DefaultCredentials;
customeraddress.Url = strDir + "CRMCustomerAddress.srf";
string strErrorMsg;
string strAccountId = "{3E24E79C-7EC5-4473-95FF-7E46FEBB534B}";
try
{
Microsoft.Crm.Platform.Proxy.CUserAuth userAuth = bizUser.WhoAmI();
// Set up the XML string for a new customer address
string strCustomerAddressXML = "<customeraddress><name>Customer name 1</name> ";
strCustomerAddressXML += "<parentid>" + strAccountId + "</parentid>";
strCustomerAddressXML += "<addressnumber>0</addressnumber>";
strCustomerAddressXML += "<objecttypecode>" + Microsoft.Crm.Platform.Types.CUSTOMER_ADDRESS_TYPE.CAT_ACCOUNT + "</objecttypecode>";
strCustomerAddressXML += "</customeraddress>";
// Now create customer address
string strCustomerAddressId = customeraddress.Create(userAuth, strCustomerAddressXML);
}
catch (System.Web.Services.Protocols.SoapException err)
{
// Process the platform error here
strErrorMsg = ("ErrorMessage: " + err.Message + " " + err.Detail.OuterXml + " Source: " + err.Source );
}
catch (Exception err)
{
// Process other errors here
strErrorMsg = ("ErrorMessage: " + err.Message );
}
Requirements
Namespace: Microsoft.Crm.Platform.Proxy
Assembly: Microsoft.Crm.Platform.Proxy.dll
See Also