Share via


CRMProductPriceLevel.Create Method

The Create method creates a new product price level.

Syntax

[Visual Basic .NET]
Public Function Create(
  ByVal Caller As CUserAuth,
  ByVal ProductPriceLevelXml As String
) As String
[C#]
public string Create(
  CUserAuth  Caller,
  string  ProductPriceLevelXml
);
[C++]
public: String* Create(
  CUserAuth*  Caller,
  String*  ProductPriceLevelXml
);

Parameters

Caller

Specifies the identity of the caller. To perform this action, the caller must have the prvCreateProduct privilege. See CUserAuth.

ProductPriceLevelXml

Specifies an XML string representing a product price level. The XML schema is described by productpricelevel.xsd.

Return Value

Returns a String type that specifies the ID of the new product price level.

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";

// CRMPriceLevel proxy object
Microsoft.Crm.Platform.Proxy.CRMProductPriceLevel  productpricelevel = new Microsoft.Crm.Platform.Proxy.CRMProductPriceLevel();
productpricelevel.Credentials = System.Net.CredentialCache.DefaultCredentials;
productpricelevel.Url = strDir + "CRMProductpricelevel.srf";

string strErrorMsg;
string strProductId = "{9BA55E02-89B9-4257-B541-07F926E03B0B}";
string strPriceLevelId = "{63FE40BC-B59B-43C5-A856-82DDC400E25B}";

try
{
   Microsoft.Crm.Platform.Proxy.CUserAuth userAuth = bizUser.WhoAmI();

   // Set up the XML string for the product price level
   string strXml = "<productpricelevel>";
   strXml += "<productid>" + strProductId + "</productid>";
   strXml += "<pricelevelid>" + strPriceLevelId + "</pricelevelid>";
   strXml += "</productpricelevel>";

   // Create the product price level
   string strProductPriceLevelId = productpricelevel.Create (userAuth, strXml);
}
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

© 2005 Microsoft Corporation. All rights reserved.