Share via

CreateCustomer

Description

This method creates a new customer.

Parameters

Parameter

Type

Description

customer

Customer

The customer object being created.

context

Context

Specifies information about how the method will be called.

policy

Policy

Specifies the set of behaviors and behavior options to be applied during the operation.

Interfaces

  • Dynamics GP
  • Sales

Examples

The following C# example creates a new customer with the key value "CONTOSO". The Name property is set, and all other properties are left as default values.

Cc508425.LegacyEndpoint(en-us,MSDN.10).gif** Legacy endpoint**

using System;
using System.Collections.Generic;
using System.Text;
using System.Windows.Forms;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            Customer customer;
            CustomerKey customerKey;
            Policy customerPolicy;

            // Create an instance of the service
            DynamicsGP wsDynamicsGP = new DynamicsGP();

            // Be sure that default credentials are being used
            wsDynamicsGP.UseDefaultCredentials = true;

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create a new customer object
            customer = new Customer();

            // Create a customer key
            customerKey = new CustomerKey();
            customerKey.Id = "CONTOSO";
            customer.Key = customerKey;

            // Set properties for the new customer
            customer.Name = "Contoso, Ltd";

            // Get the create policy for the customer
            customerPolicy = wsDynamicsGP.GetPolicyByOperation("CreateCustomer", context);

            // Create the customer
            wsDynamicsGP.CreateCustomer(customer, context, customerPolicy);
        }
    }
}

Cc508425.NativeEndpoint(en-us,MSDN.10).gif** Native endpoint **

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.Windows.Forms;
using DynamicsGPWebServiceSample.DynamicsGPService;

namespace DynamicsGPWebServiceSample
{
    class Program
    {
        static void Main(string[] args)
        {
            CompanyKey companyKey;
            Context context;
            Customer customer;
            CustomerKey customerKey;
            Policy customerPolicy;

            // Create an instance of the service
            DynamicsGPClient wsDynamicsGP = new DynamicsGPClient();

            // Create a context with which to call the service
            context = new Context();

            // Specify which company to use (sample company)
            companyKey = new CompanyKey();
            companyKey.Id = (-1);

            // Set up the context
            context.OrganizationKey = (OrganizationKey)companyKey;

            // Create a new customer object
            customer = new Customer();

            // Create a customer key
            customerKey = new CustomerKey();
            customerKey.Id = "CONTOSO";
            customer.Key = customerKey;

            // Set properties for the new customer
            customer.Name = "Contoso, Ltd";

            // Get the create policy for the customer
            customerPolicy = wsDynamicsGP.GetPolicyByOperation("CreateCustomer", context);

            // Create the customer
            wsDynamicsGP.CreateCustomer(customer, context, customerPolicy);

            // Close the service
            if(wsDynamicsGP.State != CommunicationState.Faulted)
            {
                wsDynamicsGP.Close();
            }
        }
    }
}