Elija su estilo de desarrollo para Dynamics 365 Customer Engagement (on-premises)
El SDK proporciona diversos métodos y tecnologías para usar al escribir un código acceder a los servicios web de Dynamics 365 for Customer Engagement o para ampliar la aplicación. Este tema proporciona instrucciones sobre el estilo de desarrollo a elegir en función del área de tecnología.
Desarrollo .NET y no .NET
Lo primero que debe tener en cuenta al escribir código para ampliar aplicaciones Dynamics 365 Customer Engagement (on-premises) es si el código se escribe mediante .NET Framework.
Si el código se escribe mediante .NET Framework, considere la posibilidad de utilizar una de las siguientes opciones según lo que está creando:
Si va a crear complementos, actividades de flujo de trabajo personalizadas o flujos de trabajo XAML personalizados, utilice los ensamblados SDK, Más información: Desarrollo de .NET: use ensamblados de aplicaciones Dynamics 365 Customer Engagement
Si está creando aplicaciones para Windows para Dynamics 365 Customer Engagement (on-premises), use los ensamblados de útiles de XRM. Más información: Desarrollo de .NET: use ensamblados de útiles de XRM
Si está creando aplicaciones no Windows para Dynamics 365, use la API web. Más información: Usar la API web de Dynamics 365 Customer Engagement
Si el código no se escribe utilizando .NET Framework, use la API web. Más información: Usar la API web de Dynamics 365 Customer Engagement
El diagrama de flujo siguiente ilustra qué estilo de desarrollo elegir al desarrollar para Dynamics 365 Customer Engagement (on-premises):
Desarrollo de .NET: use ensamblados de SDK
Los ensamblados del SDK proporcionan las clases que puede usar para conectarse a servicios web de Dynamics 365 Customer Engagement (on-premises) para identificar a la organización y realizar operaciones empresariales comunes como crear o recuperar. actualice y elimine datos de Dynamics 365 Customer Engagement (on-premises). Los ensamblados de SDK están disponibles como paquetes NuGet. Más información: Suscribirse a las actualizaciones de ensamblados de SDK mediante NuGet.
Importante
Debe usar la versión más reciente de los ensamblados del SDK para crear los complementos, actividades de flujo de trabajo personalizadas, o flujos de trabajo de XAML. A partir de la versión 9.x debe usar la versión 4.6.2 de .NET Framework.
No obstante, si usa .NET Framework 4 y usa la clase CrmConnection de extensiones del SDK (obsoleto) to connect to Dynamics CRM 2016 Service Pack 1 On-Premises (local) y CRM Online 2016 Update 1 (versión 8.1.0) o posterior, necesitará usar la versión 6.1.2 de los ensamblados. En caso contrario no podrá conectarse. Para obtener más información acerca de compatibilidad con versiones anteriores, consulte Blog: Compatibilidad con versiones anteriores del SDK Dynamics 365 Customer Engagement (on-premises)
Cuando usa los ensamblados del SDK para escribir código, trabaja con el servicio web de organización para conectarse a una instancia de Dynamics 365 Customer Engagement (on-premises), y realizar las operaciones de servicio web admitidas. Más información: Utilizar el servicio de organización del servicio Dynamics 365 Customer Engagement
Nota
Los ensamblados del SDK migrarán eventualmente para usar internamente la API web en lugar del punto de conexión de 2011 SOAP en desuso. Cuando esto ocurre, el código escrito mediante los ensamblados del SDK seguirá siendo admitido ya que se transferirá automáticamente del extremo de 2011 SOAP para usar la API web. Esta actualización será en su mayoría transparente para usted y solo requerirá que reemplace los ensamblajes SDK de la carpeta en tiempo de ejecución de su aplicación con ensamblajes revisados. Para obtener detalles adicionales e información nueva sobre el desarrollo de .NET Core, consulte Aplicaciones de transición a Dataverse ServiceClient.
Crear e implementar complementos o actividades personalizadas del flujo de trabajo: Las clases de complementos y de actividades de flujo de trabajo personalizadas le permiten crear controladores de eventos para realizar la lógica empresarial personalizada que puede integrar con Dynamics 365 Customer Engagement (on-premises) para modificar o aumentar el comportamiento estándar de plataforma.
Si escribe complementos y actividades de flujo de trabajo personalizadas desde el comienzo, debe usar la herramienta de registro de complementos de registrarlas. Esta herramienta proporciona una interfaz gráfica de usuario y admite el registro de complementos y actividades de flujo de trabajo personalizadas con Dynamics 365 Customer Engagement (on-premises). Más información: Desarrollo de complementos y Actividades de flujo de trabajo personalizadas (ensamblados de flujo de trabajo)
Crear e implementar flujos de trabajo XAML personalizados: Dynamics 365 Customer Engagement (on-premises) e IFD admite la capacidad de crear flujos de trabajo XAML personalizados. Mediante el diseñador de flujo de trabajo de Microsoft Visual Studio, puede crear flujos de trabajo XAML personalizados, también denominados flujos de trabajo declarativos, al arrastrar actividades de flujo de trabajo desde el cuadro de herramientas situado sobre la superficie de diseño, crear variables y establecer propiedades de estas actividades para implementar la funcionalidad de flujo de trabajo. Puede usar las actividades de Windows Workflow Foundation integradas o las actividades de proceso que son específicas de Dynamics 365 Customer Engagement (on-premises). Más información: Flujos de trabajo de XAML
Modelos de programación en tiempo de compilación y tiempo de ejecución para entidades de Dynamics 365 Customer Engagement (on-premises): Cuando usa los ensamblados del SDK, puede elegir entre dos modelos de programación:
Enlace en tiempo de compilación Enlace en tiempo de ejecución Use la herramienta de generación de códigos (CrmSvcUtil) para crear clases de entidad de enlace en tiempo de compilación desde la clases de Entity, que pueden usarse para tener acceso a los datos profesionales en Dynamics 365 Customer Engagement. Estas clases incluyen una clase para cada entidad en su instalación, incluidas las entidades personalizadas. Más información: Usar las clases de entidad con enlace en tiempo de compilación en código La clase Entity contiene el nombre lógico de una entidad y de una matriz de bolsa de propiedades de los atributos de una entidad. Esto le permite usar enlaces de tiempo de ejecución a fin de que pueda trabajar con tipos como entidades y atributos personalizados que no estaban presentes en que la aplicación compilada. Más información: Usar la clase de entidad con enlace en tiempo de ejecución en código Consulta de datos en Dynamics 365 Customer Engagement (on-premises): Existen tres formas en las que puede recuperar o consultar datos de Dynamics 365 Customer Engagement (on-premises) mediante ensamblados del SDK: FetchXML, QueryExpression, y .NET LINQ. Más información: Recuperar datos con consultas mediante ensamblados de SDK
Desarrollo de .NET: use ensamblados de útiles de XRM
Los ensamblados de útiles de XRM aprovechan las API de ensamblado del SDK (servicio de organización y IDiscoveryService) para proporcionar un soporte de autenticación sencillo con menos líneas de código y a través de cmdlets de Windows PowerShell. Todas las llamadas de función en estas clases brindan la seguridad de hilo para las acciones realizadas en Customer Engagement en un entorno multiproceso. Los útiles de XRM proporcionan un control de inicio de sesión común con lógica de autenticación integrada y una posibilidad para asegurar y volver a usar de manera segura la información de autenticación a fin de brindar una experiencia de inicio de sesión uniforme e integrada a Customer Engagement desde las aplicaciones cliente de Windows. Más información: Crear aplicaciones cliente de Windows mediante las herramientas XRM
Los ensamblados de útiles de XRM están disponibles como paquetes NuGet; los paquetes se encuentran en el perfil crmsdk. Seleccione cualquier paquete de la lista con "Útiles de Xrm" para navegar hasta la página de detalles del paquete.
Con la compatibilidad de cadenas de conexión disponible en útiles de XRM y la obsolescencia de las extensiones del SDK para Customer Engagement, debe usar los ensamblados de útiles de XRM en lugar de la clase CrmConnection para conectarse a Dynamics 365 Customer Engagement (on-premises). Más información: Usar cadenas de conexión en útiles de XRM para conectarse a Dynamics 365 Customer Engagement (on-premises) y Ejemplo: Tutorial de conexión simplificada con Dynamics 365 Customer Engagement (on-premises)
Seleccione cómo conectarse a Dynamics 365 Customer Engagement (on-premises)
Dependiendo de su estilo de desarrollo (.NET o no .NET), seleccionará cómo el código autentica usuarios en Dynamics 365 Customer Engagement (on-premises). En la siguiente tabla se proporciona información sobre breve el modelo de autenticación que debe tener en cuenta en función del estilo de desarrollo:
Estilo de desarrollo | Descripción |
---|---|
.NET: Ensamblados de SDK | Los ensamblados del SDK usan la tecnología Windows Communication Foundation (WCF) para establecer este canal de comunicaciones con los servicios web de Dynamics 365 Customer Engagement (on-premises). El SDK simplifica el uso de la tecnología WCF proporcionando clases de proxy auxiliares que facilitan la creación de aplicaciones que se conectan y autentican con los servicios web de Dynamics 365 Customer Engagement (on-premises). Más información: Ejemplo: autenticar usuarios con los servicios web de Dynamics 365 |
.NET: Ensamblados de útiles de XRM | Use la cadena de conexión, la clase CrmServiceClient o cmdlets PowerShell de útiles de XRM para conectarse a Dynamics 365 Customer Engagement (on-premises). Más información: Utilizar cadenas de conexión en herramientas XRM para conectarse a Dynamics 365 Customer Engagement (on-premises), Utilizar constructores CrmServiceClient para conectarse a Dynamics 365 Customer Engagement, Usar cmdlets de PowerShell para herramientas XRM para conectarse a Dynamics 365 Customer Engagement (on-premises) |
API web de Dynamics 365 Customer Engagement (on-premises) | Más información: Autenticar en Dynamics 365 Customer Engagement con la API web |
Para obtener información detallada sobre autenticar los usuarios para conectarse a Dynamics 365 Customer Engagement (on-premises), consulte Autenticar usuarios en Dynamics 365 Customer Engagement (on-premises)
Vea también
Autenticar usuarios en Dynamics 365 Customer Engagement (on-premises)
Tutoriales para obtener más información acerca de Dynamics 365 Customer Engagement (on-premises)
Escribir código de Dynamics 365 Customer Engagement 2011 y Dynamics 365 Customer Engagement (servicios web, JavaScript)
Introducción a modelos de programación para Dynamics 365 Customer Engagement (on-premises)