Microsoft BizTalk Adapter para Microsoft Dynamics crm 0 Guía de instalación y uso



Descargar 70.07 Kb.
Fecha de conversión28.12.2018
Tamaño70.07 Kb.
Microsoft BizTalk Adapter para Microsoft Dynamics CRM 4.0

Guía de instalación y uso


Agosto de 2009La información contenida en este documento, incluidas las direcciones URL y otras referencias a sitios web de Internet, está sujeta a modificaciones sin previo aviso. A menos que se indique lo contrario, las empresas, organizaciones, productos, nombres de dominio, direcciones de correo electrónico, logotipos, personas, lugares y eventos de ejemplo aquí mencionados son ficticios. No se pretende indicar ni debe deducirse ninguna asociación con compañías, organizaciones, productos, nombres de dominio, direcciones de correo electrónico, logotipos, personas, lugares y eventos reales. Es responsabilidad del usuario el cumplimiento de todas las leyes de derechos de autor aplicables. Sin que por ello queden limitados los derechos de autor, ninguna parte de este documento puede ser reproducida, almacenada o introducida en un sistema de recuperación, o transmitida de ninguna forma, ni por ningún medio (ya sea electrónico, mecánico, por fotocopia, grabación o de otra manera) con ningún propósito, sin la previa autorización por escrito de Microsoft Corporation.
Microsoft puede ser titular de patentes, solicitudes de patentes, marcas registradas, derechos de autor u otros tipos de derechos de propiedad intelectual sobre los contenidos de este documento. El suministro de este documento no le otorga ninguna licencia sobre estas patentes, marcas registradas, derechos de autor u otros derechos de propiedad intelectual, a menos que ello se prevea en un contrato por escrito de licencia de Microsoft.
 2009 Microsoft Corporation. Reservados todos los derechos.
Microsoft, MS-DOS, Windows, Windows Server, Windows Vista, BizTalk, Great Plains, Microsoft Dynamics y Visual Studio son marcas registradas o marcas comerciales de Microsoft Corporation en Estados Unidos y otros países.
Todas las demás marcas comerciales son propiedad de sus respectivos propietarios.

Contenido


Introducción 4

Información general del producto 4

Soporte técnico 4

Instalación 5

Local: creación de un puerto de envío cuando el usuario de proceso de BizTalk Server es también el usuario con acceso a Microsoft Dynamics CRM 6

Local: creación de un puerto de envío cuando el usuario de proceso de BizTalk Server y el usuario con acceso a Microsoft Dynamics CRM son distintos 8

Creación del host 8

1.Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y expanda Configuración de plataforma. 8

2.Haga clic con el botón secundario en Hosts, seleccione Nuevo y, a continuación, seleccione Host.
Se abre el cuadro de diálogo Propiedades de host, como se muestra en la figura 3. 8

3.En el cuadro Nombre, escriba un nombre de host. 8

4.En la lista Tipo, seleccione En curso. 8

5.En el cuadro Grupo de Windows, escriba el nombre del grupo Usuarios de aplicación de BizTalk o Administradores de servidor de BizTalk Server y, a continuación, haga clic en Aceptar. 8

Creación de la instancia de host 9

1.Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y expanda Configuración de plataforma. 9

2.Haga clic con el botón secundario en Instancias de host, seleccione Nueva y, a continuación, haga clic en Instancia de host. Se abre el cuadro de diálogo de propiedades de instancia de host, como se muestra en la figura 4. 9

3.En la lista Nombre de host, seleccione un nombre. 9

4.En la lista Servidor, seleccione un servidor. 9

5.Haga clic en Configurar. Se abre el cuadro de diálogo Credenciales de inicio de sesión. 9

6.En los cuadros Inicio de sesión y Contraseña, escriba el nombre de inicio de sesión del dominio y la contraseña del usuario con acceso a Microsoft Dynamics CRM. Éstas son las credenciales que se usan para ejecutar la instancia de host y crear el controlador de envío (como se explica en el siguiente procedimiento) para el adaptador de Microsoft Dynamics CRM en este host. Compruebe que este usuario forma parte del grupo Usuarios de aplicación de BizTalk. 9

7.Haga clic en Aceptar. 9

Creación del nuevo controlador de envío para el adaptador 10

1.Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y, a continuación, expanda Configuración de plataforma. 10

2.Expanda el nodo Adaptadores y, a continuación, seleccione Microsoft Dynamics CRM. 10

3.Haga clic con el botón secundario en Microsoft Dynamics CRM 4.0, seleccione Nuevo y, a continuación, haga clic en Controlador de envío. Se abre el cuadro de diálogo Microsoft Dynamics CRM – Propiedades de controlador de adaptador, como se muestra en la figura 5. 10

4.En la lista Nombre de host, seleccione el host creado en el procedimiento anterior y, a continuación, haga clic en Aceptar. 10

5.Para iniciar (o reiniciar) la instancia de host, haga clic con el botón secundario en la instancia de host y seleccione Iniciar (o Reiniciar). 10

Creación del puerto de envío con el nuevo controlador de envío 11

IFD: creación de un puerto de envío 12

Captura de esquemas 13

1.Haga clic en Inicio, seleccione Programas y Microsoft Visual Studio .NET y, a continuación, haga clic en Microsoft Visual Studio .NET. 13

2.En Visual Studio .NET, en el menú Archivo, seleccione Nuevo y, a continuación, haga clic en Proyecto.
Se abre el cuadro de diálogo Nuevo proyecto, como se muestra en la figura 7. 13

Comportamiento en tiempo de ejecución 20

Creación de un directorio de ruta de acceso de registro seguro 21

Problemas conocidos 22




Introducción


En este documento se proporciona información general acerca del producto y se describe la instalación y el uso de Microsoft® BizTalk® Server Adapter para Microsoft Dynamics® CRM 4.0.
Asimismo, se indica cómo crear un puerto de envío para este adaptador y cómo capturar un esquema de Microsoft Dynamics CRM.
Esta guía está dirigida a usuarios con conocimientos básicos de Microsoft BizTalk Server y Microsoft Visual Studio®.

Información general del producto



Objetivo de la versión
Permitir la integración entre Microsoft Dynamics CRM y aplicaciones empresariales externas.
Ámbito del producto
Microsoft® BizTalk® Server Adapter para Microsoft Dynamics® CRM 4.0 permite realizar las siguientes operaciones.



  1. Disponibilidad de Microsoft Dynamics CRM como adaptador de envío.

  2. Detección y uso de esquemas de acciones y entidades para distintas organizaciones de Microsoft Dynamics CRM.

El usuario puede usar estas capacidades del adaptador para conectar Microsoft Dynamics CRM con otras aplicaciones a través del servidor BizTalk mediante sus capacidades de orquestación y asignación.



Soporte técnico


El soporte para Microsoft® BizTalk® Server Adapter para Microsoft Dynamics™ CRM 4.0 se limita a las áreas descritas en esta Guía de instalación y uso. Estas áreas son:

  • Instalación

  • Creación de puertos de envío

  • Captura de esquemas de Microsoft CRM



Instalación


Requisitos previos para la instalación

Los siguientes requisitos previos deben cumplirse para poder instalar Microsoft BizTalk Adapter para Microsoft Dynamics CRM 4.0.



  1. Se ha instalado y configurado una de las siguientes versiones compatibles de BizTalk Server y sus requisitos previos:

    1. BizTalk Server 2009

    2. BizTalk Server 2006 R2

    3. BizTalk Server 2006

  2. Se ha instalado una versión compatible de Visual Studio.

    1. BizTalk Server 2009 requiere Visual Studio 2008 SP1

    2. BizTalk Server 2006 y 2006 R2 requieren Visual Studio 2005

Para obtener más información acerca de los requisitos previos de BizTalk Server, revise la página de requisitos del sistema de BizTalk Server en el sitio de BizTalk Server. Tenga en cuenta que el soporte para estos requisitos previos no se incluye en el soporte para la instalación del adaptador.

Instrucciones de instalación

  1. Descargue el archivo .exe desde el Centro de descarga de Microsoft.

  2. Haga doble clic en el archivo .exe. Se abre el Asistente para instalación, que le guiará durante la instalación.

  3. Cuando la instalación finalice, Microsoft Dynamics CRM 4.0 aparecerá en la lista de adaptadores de la Consola de administración de BizTalk Server, tal como se muestra en la Figura 1. La Consola de administración de BizTalk Server se instala con Microsoft BizTalk Server.

  4. El usuario debe ser administrador local o miembro del grupo "Administradores de SSO" para realizar la instalación.



Figura 1


Local: creación de un puerto de envío cuando el usuario de proceso de BizTalk Server es también el usuario con acceso a Microsoft Dynamics CRM


Siga estos pasos para crear el puerto de envío cuando el proceso de BizTalk Server se ejecuta con las credenciales de un usuario con acceso a Microsoft Dynamics CRM.
Nota: los pasos indicados a continuación son para Microsoft BizTalk Server 2006. Estos mismos pasos pueden usarse para BizTalk Server 2009 mediante los correspondientes vínculos de aplicaciones en la carpeta Microsoft BizTalk Server 2009 del menú Inicio.


  1. Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y expanda Aplicaciones; a continuación, expanda la aplicación 1 de BizTalk.

  2. Haga clic con el botón secundario en Puertos de envío, seleccione Nuevo y, a continuación, seleccione el tipo de puerto que desee.

  3. Si el tipo de puerto seleccionado es estático, siga los pasos del 5 al 9 para especificar el controlador de envío.

  4. Si el tipo de puerto es dinámico, no es necesario crear un controlador de envío, ya que el puerto dinámico usará el controlador de envío predeterminado.

  5. Se abre el cuadro de diálogo Propiedades de puerto de envío, como se muestra en la figura 2.

  6. En el cuadro Nombre, escriba el nombre del puerto de envío.

  7. En la lista Tipo, seleccione Microsoft Dynamics CRM. Haga clic en Configurar para proporcionar la dirección URL de Microsoft Dynamics CRM, seleccione Autenticación de Active Directory y elija entre las organizaciones que aparecen.

  8. En la lista Controlador de envío, confirme la selección de la aplicación BizTalkServerApplication predeterminada.

  9. En la lista Canalización de envío, seleccione XMLTransmit o, si está usando un puerto de petición-respuesta bidireccional, seleccione XMLReceive por canalización de respuesta.

  10. Haga clic en Aceptar.


Figura 2

Local: creación de un puerto de envío cuando el usuario de proceso de BizTalk Server y el usuario con acceso a Microsoft Dynamics CRM son distintos

Siga estos pasos para crear un puerto de envío cuando el usuario con acceso a Microsoft Dynamics CRM tenga credenciales distintas a las del usuario de proceso de BizTalk Server, o si va a configurar varios puertos de envío para varios servidores de Microsoft Dynamics CRM.
Este escenario consta de los siguientes pasos:


  1. Creación del host.

  2. Creación de la instancia de host.

  3. Creación del nuevo controlador de envío para el adaptador de Microsoft Dynamics CRM.

  4. Creación del puerto de envío con el nuevo controlador de envío.


Nota: los pasos indicados a continuación son para Microsoft BizTalk Server 2006. Estos mismos pasos pueden usarse para BizTalk Server 2009 mediante los correspondientes vínculos de aplicaciones en la carpeta Microsoft BizTalk Server 2009 del menú Inicio.

Creación del host


  1. Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y expanda Configuración de plataforma.

  2. Haga clic con el botón secundario en Hosts, seleccione Nuevo y, a continuación, seleccione Host.
    Se abre el cuadro de diálogo Propiedades de host, como se muestra en la figura 3.

  3. En el cuadro Nombre, escriba un nombre de host.

  4. En la lista Tipo, seleccione En curso.

  5. En el cuadro Grupo de Windows, escriba el nombre del grupo Usuarios de aplicación de BizTalk o Administradores de servidor de BizTalk Server y, a continuación, haga clic en Aceptar.


Figura 3



Creación de la instancia de host


  1. Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y expanda Configuración de plataforma.

  2. Haga clic con el botón secundario en Instancias de host, seleccione Nueva y, a continuación, haga clic en Instancia de host. Se abre el cuadro de diálogo de propiedades de instancia de host, como se muestra en la figura 4.

  3. En la lista Nombre de host, seleccione un nombre.

  4. En la lista Servidor, seleccione un servidor.

  5. Haga clic en Configurar. Se abre el cuadro de diálogo Credenciales de inicio de sesión.

  6. En los cuadros Inicio de sesión y Contraseña, escriba el nombre de inicio de sesión del dominio y la contraseña del usuario con acceso a Microsoft Dynamics CRM. Éstas son las credenciales que se usan para ejecutar la instancia de host y crear el controlador de envío (como se explica en el siguiente procedimiento) para el adaptador de Microsoft Dynamics CRM en este host. Compruebe que este usuario forma parte del grupo Usuarios de aplicación de BizTalk.

  7. Haga clic en Aceptar.


Figura 4


Creación del nuevo controlador de envío para el adaptador


  1. Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y, a continuación, expanda Configuración de plataforma.

  2. Expanda el nodo Adaptadores y, a continuación, seleccione Microsoft Dynamics CRM.

  3. Haga clic con el botón secundario en Microsoft Dynamics CRM 4.0, seleccione Nuevo y, a continuación, haga clic en Controlador de envío. Se abre el cuadro de diálogo Microsoft Dynamics CRM – Propiedades de controlador de adaptador, como se muestra en la figura 5.

  4. En la lista Nombre de host, seleccione el host creado en el procedimiento anterior y, a continuación, haga clic en Aceptar.

  5. Para iniciar (o reiniciar) la instancia de host, haga clic con el botón secundario en la instancia de host y seleccione Iniciar (o Reiniciar).

Figura 5


Creación del puerto de envío con el nuevo controlador de envío


  1. Haga clic en Inicio, seleccione Microsoft BizTalk Server 2006, abra Administración de BizTalk y expanda Aplicaciones; a continuación, expanda la aplicación 1 de BizTalk.

  2. Haga clic con el botón secundario en Puertos de envío, seleccione Nuevo y, a continuación, seleccione Puerto unidireccional estático o Puerto de petición-respuesta estático.
    Se abre el cuadro de diálogo Propiedades de puerto de envío, como se muestra en la figura 6a.

  3. En el cuadro Nombre, escriba un nombre para el puerto de envío.

  4. En la lista Tipo, seleccione Microsoft Dynamics CRM 4.0. Haga clic en Configurar para proporcionar la dirección URL de Microsoft Dynamics CRM, seleccione Autenticación de Active Directory y elija entre las organizaciones que aparecen.

  5. En la lista Controlador de envío, seleccione el host creado en el procedimiento anterior.

  6. En la lista Canalización de envío, seleccione XMLTransmit o, si usa un puerto de petición-respuesta bidireccional, seleccione XMLReceive y, a continuación, haga clic en Aceptar.



Figura 6a


IFD: creación de un puerto de envío


El adaptador necesita las credenciales del dominio externo para comunicarse con las instalaciones IFD de Microsoft Dynamics CRM 4.0. Todos los pasos son válidos para las instalaciones locales anteriores de Microsoft Dynamics CRM 4.0, excepto que, al configurar el puerto de envío, se debe seleccionar la autenticación basada en formularios y proporcionar las credenciales IFD después de hacer clic en el botón Configurar durante la creación del puerto de envío. Consulte la figura 6b a continuación.

Figura 6b




Captura de esquemas


Siga estos pasos para capturar los esquemas de entidades o acciones de Microsoft Dynamics CRM.
Nota: los pasos indicados a continuación son para Microsoft Visual Studio 2005. Estos mismos pasos pueden usarse para Visual Studio 2008 mediante los correspondientes vínculos de aplicaciones en la carpeta Microsoft Visual Studio 2008 del menú Inicio.


  1. Haga clic en Inicio, seleccione Programas y Microsoft Visual Studio .NET y, a continuación, haga clic en Microsoft Visual Studio .NET.

  2. En Visual Studio .NET, en el menú Archivo, seleccione Nuevo y, a continuación, haga clic en Proyecto.
    Se abre el cuadro de diálogo Nuevo proyecto, como se muestra en la figura 7.

  3. En la ventana del Explorador de soluciones, haga clic con el botón secundario en la opción de proyecto de BizTalk Server, seleccione Agregar y, a continuación, haga clic en Agregar elementos generados.
    Se abre el cuadro de diálogo Agregar elementos generados, como se muestra en la figura 8.

  4. En Categorías, seleccione Agregar metadatos de adaptador y, a continuación, haga clic en Agregar.
    Se abre el Asistente para agregar adaptador, como se muestra en la figura 9.

  5. En la lista de adaptadores registrados, seleccione Microsoft Dynamics CRM 4.0.

  6. En la lista Puerto, seleccione el puerto creado en el procedimiento anterior y, a continuación, haga clic en Siguiente.
    Se abre el cuadro de diálogo Credenciales de usuario de Microsoft Dynamics CRM, como se muestra en la figura 10a (local) y 10b (IFD).

  7. En la lista desplegable Tipo de autenticación, seleccione Active Directory para local y Autenticación basada en formularios para IFD. En los cuadros de entrada de texto Nombre de usuario y Contraseña, escriba el nombre de usuario y la contraseña del usuario de Microsoft Dynamics CRM. Haga clic en Obtener organizaciones CRM, seleccione la organización y haga clic en Aceptar. Se abre el cuadro de diálogo Entidades y acciones de Microsoft Dynamics CRM, como se muestra en la figura 11.

  8. Expanda la vista de árbol que se muestra para la lista de entidades y acciones. Para ello, haga clic en el signo ‘+’. En la figura 12 se muestra una lista expandida.

  9. Seleccione las casillas de todas las entidades o acciones cuyos esquemas desee capturar y, a continuación, haga clic en Siguiente. Los esquemas capturados aparecen en la vista del Explorador de soluciones de Visual Studio, como se muestra en la figura 13.i


Figura 7



Figura 8


Figura 9


Figura 10a


Figura 10b



Figura 11




Figura 12



Figura 13




Comportamiento en tiempo de ejecución


Microsoft BizTalk Adapter para Microsoft Dynamics CRM 4.0 procesa el código XML enviado por BizTalk Server y realiza acciones de creación, actualización y eliminación de todas las entidades y todas las demás acciones posibles admitidas en Microsoft Dynamics CRM 4.0 en función de los valores presentes en el código XML entrante.
Hay un atributo llamado "crm_action" en el nodo raíz de los esquemas de entidad y acción.

A continuación se muestra el comportamiento de Microsoft BizTalk Adapter para Microsoft Dynamics CRM 4.0 cuando el código XML entrante (el XML transformado o asignado) se recibe,

si:


    • El atributo “crm_action” está vacío:

        1. Si el nodo de la clave principal de la entidad (por ejemplo, accountid para Account) no está presente en el código XML o si el nodo tiene un valor vacío, el adaptador da por supuesto que se trata de una acción de "creación".

        2. Si el nodo de la clave principal de la entidad tiene un valor GUID correcto, el adaptador da por supuesto que se trata de una acción de "actualización".

    • El atributo “crm_action” contiene algún valor:

        1. Si la acción es de "creación", "actualización" o "eliminación", se realiza la acción correspondiente.

        2. Si la acción es de "ejecución", el adaptador realiza la acción solicitada mediante el SDK de Microsoft Dynamics CRM. Algunos ejemplos de acciones son ConvertQuoteToSalesOrderRequest, ConvertProductToKitRequest y SetStateAccountRequest. Para obtener una referencia completa de todas las acciones posibles, consulte el SDK de Microsoft Dynamics CRM 4.0.


Un caso especial: si desea realizar una acción de creación en la que se especifique el GUID de la entidad. Por ejemplo, desea crear una cuenta en la que el identificador de cuenta sea “{684FD04E-E515-491f-AF25-F9258A3C9F03}”.

Solución:



      1. El código XML de entrada para el adaptador (que puede ser el resultado de una transformación de asignación) debe contener los siguientes nodos con los valores especificados.

        1. {684FD04E-E515-491f-AF25-F9258A3C9F03}

        2. crm_action=”create” [crm_action es un atributo]



Creación de un directorio de ruta de acceso de registro seguro


Puede usar una característica de depuración para comprobar si la asignación usada en la orquestación genera el código XML correcto para el SDK de Microsoft Dynamics CRM.

Esta característica se activa y desactiva mediante un valor del Registro. Cuando en el Registro Debug = true, el adaptador comprueba los valores en el código XML (resultante de una transformación o asignación en orquestación) para todos los atributos de una entidad y sus valores permitidos.


Advertencia: la modificación incorrecta del Registro puede causar problemas graves que le obliguen a reinstalar el sistema operativo. Microsoft no puede garantizar que los problemas causados por el uso incorrecto del Registro puedan resolverse. Use el Registro bajo su responsabilidad.

Si el código XML contiene valores incorrectos, se registrará un error en un archivo de registro que se crea en un directorio especificado por la clave de registro “LogPath” en la misma ruta de acceso del Registro donde se encuentra “Debug”.



Importante: la ruta de acceso del Registro es “HKEY_CLASSES_ROOT\CLSID\{D38D5DCC-2B30-43b9-9C69-3BBFD0926986}”. Este directorio debe protegerse con los permisos y las credenciales adecuados de modo que sólo un usuario con los permisos y las credenciales correspondientes pueda crear y tener acceso a los archivos de registro de este directorio.

Problemas conocidos


  1. La eliminación de entidades no devuelve el GUID en el código XML de respuesta devuelto por Microsoft Dynamics CRM.




  1. El usuario puede capturar listas de entidades y acciones mediante \ si el equipo es un controlador de dominio.




  1. La compilación del proyecto de BizTalk es incorrecta si no se realizan los siguientes pasos después de capturar el esquema. El usuario debe establecer la referencia correcta en la orquestación del esquema capturado. Siga los pasos indicados a continuación para evitar el error de compilación.

    1. Abra la orquestación.

    2. Vaya a la vista de orquestación, expanda “Tipos”, expanda “Tipos de mensajes de varias partes”, expanda el nodo y haga clic en Parámetros.

    3. En la ventana de propiedades, haga clic en la lista desplegable junto al campo “Tipo” y seleccione el esquema capturado.

    4. Guarde la orquestación y compílela.



Compartir con tus amigos:


La base de datos está protegida por derechos de autor ©bazica.org 2019
enviar mensaje

    Página principal