Tutorial: registrar un complemento mediante la herramienta de registro de complementos

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este recorrido muestra cómo registrar un complemento mediante la herramienta Plug-in Registration que se proporciona en el SDK. El complemento que se va a registrar es FollowupPlugin del tema Ejemplo: Crear un complemento básico .

El complemento debe estar registrado de la entidad de account , el mensaje CreateRequest , en un evento posterior y en el espacio asilado. El complemento se puede registrar en una implementación de Microsoft Dynamics 365 (en línea y local) si la cuenta de usuario tiene el rol de personalizador del sistema o administrador del sistema.

Los siguientes requisitos previos se deben rellenar antes de iniciar este recorrido:

• Obtenga la herramienta PluginRegistration.exe, ubicada en la carpeta del SDK Tools\PluginRegistration.Descargue el paquete de SDK de Microsoft Dynamics CRM.

• Obtenga una cuenta de usuario del sistema en un servidor de Microsoft Dynamics 365 .

• La cuenta de usuario debe tener el rol de administrador del sistema o personalizador del sistema. Vea Cómo se puede usar la seguridad basada en roles para controlar el acceso a las entidades de Microsoft Dynamics 365.

Conectar al servidor de Microsoft Dynamics 365

1. Ejecute la herramienta Plug-in Registration.

2. Haga clic en CREAR NUEVA CONEXIÓN.

3. En el diálogo Iniciar sesión , seleccione el botón de opción de tipo de implementación correspondiente al servidor de Microsoft Dynamics 365 en el que quiera registrar los complementos. El botón de opción Local incluye una implementación de IFD, el botón Online es para el proveedor Windows Live de Microsoft Dynamics 365 (online) y el botón Office 365 es para el proveedor de Microsoft Online Services de Microsoft Dynamics 365 (online).

   Ventana de inicio de sesión para una implementación en línea

   Ventana de inicio de sesión para una implementación local

4. Si selecciona Mostrar siempre la lista de organizaciones disponibles, se le presentará una lista de las organizaciones a las que pertenece tras hacer clic en Iniciar sesión. Esto le permite elegir la organización en la que desea registrar el complemento. De lo contrario, se usa la organización predeterminada.

5. Especifique la información indicada acerca de la cuenta de servidor y de inicio de sesión y, a continuación, haga clic en Iniciar sesión.

Debe ver una lista contraída de ensamblados de actividades de flujo de trabajo personalizadas o complementos registrados y extremos de servicio. Se necesitan fuentes de actividades y ensamblados de Microsoft.Crm.ObjectModel para que Microsoft Dynamics 365 funcione correctamente y la herramienta le impida modificarlos. La selección de un elemento de la lista conduce a que los resultados de los paneles de pestañas Propiedades y Detalles muestren información sobre dicho elemento de lista.

Ventana principal de la aplicación

Registrar un ensamblado de complementos

1. Seleccione una pestaña de la organización para que pase a estar activa.

2. En la barra de herramientas de la pestaña, haga clic en Registrar y luego en Registrar nuevo ensamblado.

3. En el cuadro de diálogo Registrar nuevo ensamblado, haga clic en el botón de puntos suspensivos […] a la derecha del campo Step#1 .

4. En el cuadro de diálogo Abrir, vaya a la ubicación del ensamblado SamplePlugin.dll compilado. La ubicación predeterminada es SDK\SampleCode\CS\Plug-ins\bin\Debug. Seleccione el ensamblado y, a continuación, haga clic en Abrir.

5. En la sección Step#2, expanda el ensamblado SamplePlugins para visualizar todos los complementos de dicho ensamblado. Seleccione (marque) solo el complemento Microsoft.Crm.Sdk.Samples.FollowupPlugin .

6. En la sección Step#3, seleccione la opción Espacio aislado .

7. En la sección Step#4, seleccione la opción Base de datos .

   

   Diálogo para registrar un ensamblado

8. Haga clic en Registrar complementos seleccionados. Puede cerrar los cuadros de diálogo abiertos.

   

   Un complemento registrado mostrado en la vista de árbol

   Sugerencia

   ¿Ve un error en el área Registro y el registro contiene el siguiente mensaje?

   <Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

   Si es así, debe habilitar el código personalizado en el servidor e intentarlo de nuevo. Para obtener más información, vea Habilitar o deshabilitar la ejecución de código personalizado.

El ensamblado SamplePlugins.dll y el complemento FollowupPlugin ya están registrados e implementados en el servidor. Si usó la herramienta para registrar un ensamblado de actividades de flujo de trabajo personalizadas, no tiene que consultar la siguiente sección sobre cómo registrar un paso.

Registrar un paso de complemento para un evento

1. En la vista de árbol Complementos registrados y actividades personalizadas del flujo de trabajo, expanda el nodo (Assembly) SamplePlugins y seleccione un complemento registrado.

2. Vaya al menú Registrar de la barra de herramientas y, a continuación, haga clic en Registrar nuevo paso.

   Nota

   Los complementos se registran para ejecutarse cuando un evento se procesa en la canalización de ejecución del evento. Cada evento tiene un nombre y número de fase para indicar su ubicación en la canalización antes o después del funcionamiento de la plataforma principal. Un paso se refiere a la entidad del paso de procesamiento de mensajes del SDK que se usa para configurar cuándo y cómo se ejecuta el complemento.

3. Complete el cuadro de diálogo Registrar nuevo paso como se muestra en la siguiente ilustración.

   

   Diálogo para registrar un nuevo paso

4. Haga clic en Registrar nuevo paso.

5. Expanda el nodo (Assembly) SamplePlugins y los nodos secundarios para ver los nodos de complementos y pasos que ha creado. Ya puede cerrar la herramienta, pero es posible que desee mantenerla abierta hasta que haya probado el complemento y haya anulado el registro del ensamblado.

   Nota

   Al anular el registro del paso, complemento o ensamblado, seleccione su nodo en el árbol y haga clic en Anular registro en la barra de herramientas. Para editar un ensamblado o un registro de paso, haga doble clic en el nodo del ensamblado o el paso en la vista de árbol. Como alternativa, puede seleccionar el nodo y haga clic en Actualización en la barra de herramientas.

Ahora, el complemento está registrado para ejecutarse en el espacio asilado, con el evento de crear cuenta y tras la ejecución de la operación principal. Ha registrado el complemento para que se ejecute asincrónicamente, ya que la creación de la actividad de tarea de seguimiento no es crítica en el tiempo. Una vez creada una cuenta, el complemento se ejecutará la próxima vez que el servicio asincrónico procese la cola.

Probar el complemento

Después de registrar el complemento, puede probar su ejecución con el siguiente procedimiento.

1. Abra la aplicación web Microsoft Dynamics 365 de la misma organización donde se ha registrado el ensamblado de complementos.

2. Vaya al área de trabajo, seleccione Cuentas y haga clic en Nueva.

3. En el cuadro Nombre de cuenta, escriba un nombre de cuenta, por ejemplo, Adventure Works Cycle y haga clic en Guardar y cerrar.

4. Haga doble clic en el nombre del formulario en la cuadrícula Cuentas para abrir el formulario.

5. Haga clic en Actividades para presentar una lista de actividades relacionadas para la cuenta. Debe ver la actividad denominada “Send email to the new customer“ que el complemento ha creado.

6. Si ha registrado el complemento para que se ejecute de forma asincrónica y no ha seleccionado la opción Eliminar AsyncOperation si StatusCode = éxito en el formulario Registrar nuevo paso , aparecerá un nuevo trabajo del sistema denominado “FollowupPlugin: Create of account”. Para ver el trabajo del sistema relacionado, haga clic en Configuración y en Trabajos del sistema. Haga doble clic en el trabajo del sistema previamente mencionado.

Ahora puede anular el registro del paso, el complemento y el ensamblado, si lo desea. Puede que también desee eliminar el trabajo del sistema y la cuenta que ha creado.

Ver también

Desarrollo de complementos
Tutorial: configurar la seguridad de ensamblado para un complemento sin conexión
Registrar e implementar complementos
Canalización de ejecución del evento
Aislamiento, relacioens de confianza y estadísticas de complementos
Mensajes y entidades admitidos para complementos

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright