Usar el servicio de la organización de Common Data ServiceUse the Common Data Service Organization Service

El servicio de organización es uno de dos servicios web que puede usar para trabajar con datos y metadatos en Common Data Service.The Organization service is one of two web services you can use to work with data and metadata in Common Data Service. El otro es la API web.The other is the Web API.

El servicio de organización está optimizado para su uso con .NET Framework y los ensamblados de SDK del paquete de NuGet Microsoft.CrmSdk.CoreAssemblies proporcionan las clases para la interfaz de IOrganizationService necesarias para trabajar con datos y metadatos mediante este servicio.The organization service is optimized for use with the .NET Framework and the SDK assemblies in the Microsoft.CrmSdk.CoreAssemblies NuGet package provide the classes for the IOrganizationService interface necessary work with data and metadata using this service.

Algunas funciones de extensión, como los complementos y las extensiones de flujo de trabajo, dependen de .NET Framework y de las clases definidas en estos ensamblados, por lo que el servicio de organización es la única opción al usar estos métodos para ampliar Common Data Service.Some extension capabilities, such as plug-ins and workflow extensions, depend on the .NET Framework and classes defined in these assemblies so the organization service is the only option when using these methods to extend Common Data Service.

Ensamblados del servicio de organizaciónOrganization service assemblies

Es útil reconocer que el servicio de organización es lo que define la plataforma.It is valuable to recognize that the organization service is what defines the platform. El servicio de organización define las operaciones admitidas como mensajes.The organization service defines the supported operations as messages. Cada mensaje tiene un nombre.Each message has a name. Estos mensajes corresponden a los eventos emitidos por el marco de trabajo de eventos.These messages correspond to the events that are emitted by the event framework. Más información: Marco de trabajo de eventosMore information: Event Framework

Los ensamblados de .NET para el servicio de organización usan actualmente un extremo de SOAP.The .NET assemblies for the organization service currently use a SOAP endpoint. Los ensamblados se diseñaron de forma que estuvieran estrechamente relacionados con los servicios de plataforma subyacentes basados en la interfaz IOrganizationService.The assemblies were designed to closely model the underlying platform services based on IOrganizationService interface. Sin embargo, no son los mismos componentes y no se deben confundir.However they are not the same components and should not be confused with one another.

El extremo de SOAP para el servicio de organización se introdujo en 2011 y hemos anunciado que está en desuso.The SOAP endpoint for the organization service was introduced in 2011 and we have announced that it is deprecated. Esto significa que seguirá funcionando y recibiendo soporte hasta que lo quitemos.This means that it will continue to work and be supported until we remove it. También hemos anunciado que actualizaremos los ensamblados del SDK de .NET de modo que sigan funcionando cuando hayamos quitado el extremo de SOAP.We have also announced that we will update the .NET SDK assemblies so that they will continue to work after the SOAP endpoint is removed. Esto significa que estarán disponibles ensamblados del SDK actualizados antes de que se quite el extremo de SOAP y que en el futuro se pedirá a los desarrolladores que actualicen el código para usar estos nuevos ensamblados.This means that there will be updated SDK assemblies available before the SOAP endpoint is removed and developers will be required to update their code to use these new assemblies at some point in the future.

Usar el servicio de organización sin ensambladosUsing the organization service without assemblies

Los desarrolladores pueden usar el extremo de SOAP del servicio de organización sin usar los ensamblados del SDK de .NET, creando (por ejemplo) un proxy de servicio web mediante el WSDL expuesto por el servicio, pero la naturaleza RESTful de la API web la convierte en una alternativa superior.It is possible for developers to use the SOAP endpoint of the organization service without using the .NET SDK assemblies, for example by creating a web service proxy using the WSDL exposed by the service, but the RESTful nature of the Web API makes it a superior alternative.