Actualizar código AIF

Se aplica a: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

Application Integration Framework (AIF) se usa para intercambiar datos entre Microsoft Dynamics AX y sistemas externos. Durante el proceso de actualización, la Lista de comprobación de actualización de datos incluye un paso para la actualización del código AIF. Este tema describe el paso de la Lista de comprobación de actualización de datos.

Haga clic en Administración del sistema > Configurar > Listas de comprobación > Lista de comprobación de actualización de datos. Luego, en el panel de la lista de comprobación, expanda Finalizar actualización. Haga clic en Actualizar código AIF. Este paso puede tardar tiempo. Cuando se complete, compruebe en el Registro de información que no se hayan producido errores. Este paso incluye los dos procesos siguientes:

• Actualización de código: este proceso crea nuevas clases de servicio, clases de datos y nodos de servicio en el árbol de objetos de aplicación (AOT).

• Actualización de datos: este proceso actualiza todos los registros relacionados con AIF de la base de datos.

  Importante

  La actualización de datos y del código AIF es un proceso de dos pasos. Debe actualizar correctamente el código AIF antes de poder actualizar los datos AIF. Para obtener más información, consulte Upgrade additional features.

Antes de realizar la actualización

Antes de la actualización, debe familiarizarse con los servicios y AIF. Para obtener más información, vea Services and Application Integration Framework (AIF).

Revise las secciones siguientes antes de empezar el proceso de actualización.

Mensajes del proceso en el sistema de origen

Antes de ejecutar el proceso de actualización, asegúrese de que todos los mensajes de AIF se han procesado en el sistema que se actualiza. Compruebe que se han procesado todos los mensajes en las siguientes ubicaciones:

• Todas las ubicaciones de mensajes de entrada: estas ubicaciones incluyen los directorios del sistema de archivos, las colas de mensajes y cualquier ubicación en la que AIF reciba mensajes entrantes.

• Gestor de colas: todos los mensajes del gestor de colas están sin procesar y deben eliminarse. Haga clic en Administración del sistema > Periódico > Services and Application Integration Framework > Gestor de colas.

Consideraciones sobre la actualización

Las mejoras de los servicios y AIF en Microsoft Dynamics AX 2012 producen cambios importantes en la funcionalidad, la configuración, los esquemas de bases de datos y los esquemas de documentos, o archivos .xsd. Cuando planee la actualización de una versión anterior de Microsoft Dynamics AX, tenga en cuenta las directrices siguientes:

• Debe volver a compilar y probar todas las interfaces que usaban la versión anterior de Microsoft Dynamics AX para asegurarse de que funcionan con los servicios de Microsoft Dynamics AX 2012.

• En Microsoft Dynamics AX 2012, los adaptadores de MSMQ y BizTalk se sustituyen por una funcionalidad equivalente proporcionada por Windows Communication Foundation (WCF). Debe volver a compilar cualquier proceso de integración automatizada que usase estos adaptadores como, por ejemplo, la orquestación de Microsoft BizTalk Server.

• El marco de la actualización cambia los extremos de AIF y las configuraciones relacionadas para los puertos de integración en Microsoft Dynamics AX 2012. Cuando el proceso de actualización se complete, deberá configurar estos puertos de integración antes de poder usar la funcionalidad de AIF y los servicios de Microsoft Dynamics AX 2012.

Actualización del código AIF

Esta sección describe el proceso que Microsoft Dynamics AX 2012 usa para actualizar el código AIF.

Actualización de código

El paso de actualización del código AIF actualiza las clases y los métodos Axd <Documento> existentes. Durante la actualización del código, también se actualizan las clases siguientes:

• Las clases Axd <Documento> que se incluyen con Microsoft Dynamics AX.

• Clases Axd <Documento> personalizadas

• Clases personalizadas que implementan la interfaz AifServicable

Actualización de datos

Durante el proceso de actualización de datos, se actualizan los datos AIF de la base de datos de Microsoft Dynamics AX. Las opciones de configuración para los extremos de AIF se copian en las opciones de configuración para los puertos de integración.

Después de la actualización

La tabla siguiente describe cómo cambian los conceptos clave y las opciones de configuración cuando se actualiza Microsoft Dynamics AX 2009 a Microsoft Dynamics AX 2012.

Función de Microsoft Dynamics AX 2009	Función de Microsoft Dynamics AX 2012	Descripción
Extremos de AIF	Puertos de integración	El concepto de puertos de integración reemplaza al concepto de extremos de AIF. Los formularios Puertos de entrada y Puertos de salida reemplazan a los formularios de configuración de AIF. Los extremos que exponían la funcionalidad de Microsoft Dynamics AX se han convertido en puertos de integración entrantes. Los extremos que enviaban mensajes se han convertido en puertos de integración salientes. Los extremos de AIF se convierten en puertos de integración con nombres similares. El marco de la actualización combina el nombre del extremo y el nombre de la empresa para crear el nombre del puerto de integración. Por ejemplo, un extremo de la EmpresaB que se denomina ExtremoA se convierte en el puerto de integración denominado ExtremoAEmpresaB.
Restricciones de extremos	Esta función no se convierte.	La información de las restricciones de los extremos no se copia en Microsoft Dynamics AX 2012. Debe usar el marco de valores válidos y los formularios de los puertos de integración entrantes y salientes para configurar las restricciones. Configure cada puerto de integración para aplicar las restricciones de servicios y parámetros.
Datos de extremos y directivas de acción	El esquema y las restricciones de operación se aplican a los puertos de integración.	La información sobre los datos y las directivas de acción no se copia. En Microsoft Dynamics AX 2009, los datos y las directivas de acción se aplicaban en el nivel de acción. En Microsoft Dynamics AX 2012, los datos y las directivas de acción se aplican en el nivel de puerto de integración. Por lo tanto, debe usar los formularios de los puertos de integración entrantes y salientes para definir los datos y las directivas de acción después de la actualización. Nota En versiones anteriores de Microsoft Dynamics AX, era necesario asignar directivas de datos a cada directiva de acción de extremo. En Microsoft Dynamics AX 2012, la configuración de las directivas de datos es opcional.
Adaptadores de AIF	Puertos de integración	La información sobre los adaptadores de AIF no se copia. Use los formularios de los puertos de integración para asociar los adaptadores con los puertos de integración.
Canales de AIF	Dirección de los puertos de integración	La información sobre los canales de AIF no se copia. Use los formularios de los puertos de integración entrantes y salientes para configurar la dirección y la dirección de respuesta de cada puerto de integración. En versiones anteriores de Microsoft Dynamics AX, se podía asociar un extremo con varios canales o direcciones. En Microsoft Dynamics AX 2012, cada puerto de integración tiene una dirección para los mensajes entrantes y una dirección para las respuestas.
Procesos AIF	Procesos de puertos de integración	Los procesos AIF se actualizan automáticamente a procesos de puertos de integración.
Atributos de códigos de servicio	Marco de servicios de Microsoft Dynamics AX 2012	Durante el proceso de actualización, se marca el código de servicio con los atributos adecuados, como crear, leer o buscar. Este paso permite que la función de interferencia automática de Microsoft Dynamics AX 2012 funcione con el código actualizado. Importante Debe configurar cada servicio actualizado para asignarle los atributos adecuados. Para obtener más información, consulte la fila siguiente.
La configuración siempre es específica de la empresa.	De forma predeterminada, la configuración no es específica de la empresa.	En versiones anteriores de Microsoft Dynamics AX, cada extremo de AIF estaba asociado a una empresa específica. En Microsoft Dynamics AX 2012, no es necesario que los puertos de integración estén asociados a una empresa específica. Sin embargo, puede usar los formularios de los puertos de integración entrantes y salientes para restringir las llamadas de servicio a una empresa específica. En el caso de un mensaje entrante, el marco de servicios recupera el identificador de empresa del encabezado del mensaje. Si el encabezado del mensaje no contiene un identificador de empresa, el marco de servicios usa el identificador de empresa predeterminado que está asociado al usuario que ha enviado el mensaje.
Referencia de servicio	Proyecto Microsoft Visual Studio	En Microsoft Dynamics AX 2012, las referencias a los servicios web externos ya no se agregan directamente al AOT. En cambio, estas referencias deben crearse en un proyecto Visual Studio que se pueda agregar al AOT. Es posible importar referencias de servicio en Microsoft Dynamics AX 2012 desde Microsoft Dynamics AX 2009. Si elige esta opción, es posible que se produzcan los errores siguientes durante el proceso de importación. Puede hacer caso omiso estos errores y usar la referencia de servicio: El directorio raíz de referencias Web especificado no existe. El ensamblado .NET está bloqueado por AOS. Reinicie el AOS para cargar el ensamblado nuevo.

Después de la actualización

Tras la actualización, debe configurar el atributo SysEntryPointAttribute y validar la migración de los extremos de AIF.

Configuración de SysEntryPointAttribute

Microsoft Dynamics AX 2012 no asigna automáticamente el atributo SysEntryPointAttribute a las clases de servicio que se actualizan. Siga estos pasos para cada servicio que actualice.

1. En el AOT, expanda el nodo Servicios y busque el servicio que está actualizando. Abra el panel Propiedades, busque el nombre de clase correspondiente para el servicio y anótelo.

2. En el AOT, expanda el nodo Clases y busque la entrada para la clase que ha encontrado en el paso anterior.

3. Para cada operación de servicio de la clase, agregue un atributo SysEntryPointAttribute que use un valor de true o false. Es recomendable establecer el valor en true para que la operación del servicio acepte los permisos que le asigne el marco de seguridad basado en roles en Microsoft Dynamics AX.

   El siguiente código de ejemplo muestra el modo de agregar el atributo a la operación create de la clase SalesSalesOrderService.

    [AifDocumentCreateAttribute, SysEntryPointAttribute(true)] 
   public AifEntityKeyList create(SalesSalesOrder _salesSalesOrder) 
   { return this.createList(_salesSalesOrder); }
   

Validación de la migración de extremos de AIF

Use los formularios de los puertos de integración entrantes y salientes de Microsoft Dynamics AX 2012 para validar y configurar los extremos de AIF que ha migrado.

1. Abra el cliente Microsoft Dynamics AX.

2. Inicialice AIF para registrar los adaptadores y servicios:

   1. Haga clic en Administración del sistema > Configurar > Listas de comprobación > Lista de comprobación de inicialización.

   2. Expanda el nodo Inicializar sistema.

   3. Haga clic en Configurar Integration Application Framework.

3. Abra cada formulario para la configuración de los puertos de integración.

   1. Haga clic en Administración del sistema > Configurar > Services and Application Integration Framework > Puertos de entrada.

   2. Haga clic en Administración del sistema > Configurar > Services and Application Integration Framework > Puertos de salida.

4. Revise la lista de puertos de integración para asegurarse de que los extremos de AIF se han migrado como puertos de integración.

5. Para cada puerto de integración, valide la configuración que se ha migrado y proporcione las opciones que no se han migrado:

   1. En el grupo Dirección, seleccione un adaptador adecuado en el campo Adaptador.

   2. Haga clic en Configurar para configurar el adaptador que ha seleccionado.

   3. En el campo URI, seleccione un valor adecuado para el URI.

   4. Exponga las operaciones de servicio. Seleccione Mostrar operaciones de servicio y, a continuación, haga clic en Operaciones de servicio.

   5. Configure manualmente las directivas de datos y los valores válidos. Seleccione Personalizar documentos y, a continuación, haga clic en Directivas de datos.

   6. Use la ficha desplegable Opciones de procesamiento para configurar las opciones de procesamiento. Las opciones de procesamiento incluyen opciones que controlan el comportamiento cuando se encuentran errores en un lote. Estas opciones también controlan el preprocesamiento de solicitudes y el procesamiento posterior de respuestas.

   7. Use la ficha desplegable Solución de problemas para configurar las opciones de solución de problemas. Las opciones de solución de problemas incluyen opciones que controlan el modo de registro y la propagación de errores.

   8. Use la ficha desplegable Seguridad para configurar las opciones de seguridad. Las opciones de seguridad incluyen opciones que controlan las restricciones de usuarios autorizados y usuarios intermediarios de confianza. Estas opciones también controlan si el puerto de integración está restringido a una empresa específica.

   9. En un explorador, abra el servicio web Microsoft Dynamics AX y confirme que el servidor devuelve la página WSDL. Use la siguiente la dirección URL para abrir el servicio web:

      net.tcp:// AOS_SERVICE_HOST/DynamicsAx/Services/ServiceName?wsdl
      

      Nota

      De forma predeterminada, Microsoft Dynamics AX usa el puerto 8081.

Si desea obtener más información

Para obtener información detallada acerca de cómo configurar los puertos de integración en los servicios y AIF, vea la documentación en el sitio web TechNet.

Anuncios: Para ver los problemas ya conocidos y las revisiones recientes, use Búsqueda del problema en Servicios de ciclo de vida de Microsoft Dynamics (LCS).