Actualizar una configuración que ya existe con un archivo de enlace
La información de un archivo de enlace sustituye la información de configuración existente. Si el nombre de un artefacto en un archivo de enlace coincide con el nombre de un artefacto en la configuración existente, el artefacto del archivo de enlace actualizará el artefacto de la configuración existente al importar el archivo de enlace.
Al actualizar los artefactos existentes con los artefactos del archivo de enlace, se siguen una serie de reglas. En este tema se tratan las reglas que se siguen al actualizar artefactos de una configuración que ya existe con los artefactos de un archivo de enlace.
En esta sección se da por hecho que existen valores válidos presentes en el archivo de enlace cuando se importa el archivo, y no se aborda ningún escenario en que el archivo de enlace contiene valores no válidos.
Reglas que sigue BizTalk Server al actualizar una configuración con un archivo de enlace
BizTalk Server sigue una serie de reglas al actualizar los artefactos existentes con sus homólogos de un archivo de enlace. En general, se aplican las reglas siguientes:
Los cuadros de texto y las casillas de verificación que se exponen al configurar un artefacto mediante la interfaz de usuario de BizTalk Server (por ejemplo, en la consola de administración de BizTalk Server o el Explorador de BizTalk) deberán estar establecidos en un valor específico o vacíos. Los valores proporcionados para los artefactos en un archivo de enlace establecerán en consecuencia el valor de la interfaz de usuario correspondiente al elemento actualizado.
Los cuadros de lista desplegable que se exponen al configurar un artefacto mediante la interfaz de usuario de BizTalk Server deberán estar establecidos en "Ninguno". Los valores proporcionados para los artefactos en un archivo de enlace establecerán en consecuencia el valor de la interfaz de usuario correspondiente al elemento actualizado.
Las vistas de cuadrícula de datos que se exponen al configurar un artefacto mediante la interfaz de usuario de BizTalk Server se actualizan con listas del elemento correspondiente en el archivo de enlace. La lista asociada a una vista de cuadrícula de datos siempre se sobrescribe con la lista del archivo de enlace, a no ser que la lista de la vista de cuadrícula de datos esté asociada a un puerto o una ubicación de recepción. En este caso, la lista del archivo de enlace se combina con la lista de la vista de cuadrícula de datos existente.
Los artefactos del archivo de enlace se identifican mediante un valor de clave primaria. El valor asociado a la clave primaria de un artefacto no se puede establecer nunca en NULL en la interfaz de usuario y, por consiguiente, todos los artefactos de un archivo de enlace deben tener establecido el valor de la clave primaria. Si el valor asociado a la clave primaria de un artefacto del archivo de enlace coincide con el valor asociado a la clave primaria de un artefacto de la configuración existente, ambos artefactos se considerarán idénticos o coincidentes. Si el artefacto del archivo de enlace y el artefacto existente son idénticos, entonces el existente se actualiza con el contenido en el archivo de enlace, como se describe en la tabla siguiente. Si un artefacto del archivo de enlace contiene un valor de clave primaria único, se creará un artefacto nuevo en la configuración de BizTalk Server al importar el archivo de enlace.
En la tabla siguiente se describe el comportamiento esperado al actualizar los artefactos de una configuración que ya existe con sus artefactos coincidentes al importar un archivo de enlace.
| Tipo de artefacto | Propiedad | Apariciones posibles de la propiedad especificada | Campo de la interfaz de usuario | Impacto de la importación de un artefacto coincidente del archivo de enlace. |
|---|---|---|---|---|
| Party | Nombre | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Clave principal |
| Alias | Se produce min: 0 Max Se produce: * |
Cuadrícula de datos | Sobrescribe la lista de alias con la lista de alias del archivo de enlace. | |
| Puertos de envío | Se produce min: 0 Max Se produce: * |
Cuadrícula de datos | Se combina la lista de puertos de esta entidad existente con la lista de puertos de esta entidad del archivo de enlace. | |
| Nombre común y Huella digital del certificado | Se produce min: 0 Se produce max: 1 (por propiedad) |
Cuadro de texto | Sobrescribe estos valores con los valores especificados en el archivo de enlace. Si estos valores no existen en el archivo de enlace, se establecen en NULL. | |
| Orquestación | Descripción | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. |
| Host | Se produce min: 0 Se produce max: 1 |
Desplegable | Sobrescribe este valor con el valor especificado en el archivo de enlace. Si este valor no existe en el archivo de enlace, se establece en NULL. | |
| Puertos de entrada y puertos de salida | Se produce min: 0 Max Se produce: * |
Desplegable | Enlaza un puerto lógico a un puerto físico existente. El puerto físico puede existir en las siguientes ubicaciones: - En el grupo. - En la aplicación. - En el archivo de enlace. Opcionalmente, establezca el puerto en Ninguno. Si se establece en Ninguno , el puerto lógico no está enlazado a ningún recurso. |
|
| Casillas de verificación de las propiedades de seguimiento | Se produce min: 1 Se produce max: 1 (por propiedad) |
Casilla de verificación | Sobrescriba estos valores con los valores especificados en el archivo de enlace. | |
| Grupo de puertos de envío | Nombre | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Clave principal |
| Puertos de envío | Se produce min: 0 Max Se produce: * |
Cuadrícula de datos | Se combina la lista de puertos de este grupo de puertos de envío existente con la lista de puertos de este grupo de puertos de envío especificada en el archivo de enlace. | |
| Filtros | Se produce min: 0 Max Se produce: * |
Cuadrícula de datos | Sobrescribe la lista de filtros de este grupo de puertos de envío existente con la lista de filtros de este grupo de puertos de envío especificada en el archivo de enlace. | |
| Puerto de envío | Nombre | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de texto | Clave principal |
| Transporte - Tipo | Se produce min: 1 Número máximo de casos: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Transporte – Controlador de envío | Se produce min: 1 Número máximo de casos: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Canalización de envío | Se produce min: 1 Número máximo de casos: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Número de reintentos, Intervalo de reintento y Prioridad | Se produce min: 1 Número máximo de casos: 1 (por propiedad) |
Cuadro de desplazamiento | Sobrescriba estos valores con los valores especificados en el archivo de enlace. | |
| Entrega ordenada | Se produce min: 1 Número máximo de casos: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Habilitar enrutamiento para mensajes con errores | Se produce min: 1 Número máximo de casos: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Habilitar ventana de servicio | Se produce min: 1 Número máximo de casos: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Hora de inicio y Hora de finalización en la ventana de servicio | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de desplazamiento | Sobrescriba estos valores con los valores especificados en el archivo de enlace. | |
| Maps | Se produce min: 0 Max Occurs: * |
Cuadrícula de datos | Sobrescribe la lista de asignaciones de puerto de envío existente con la lista de asignaciones de este puerto de envío especificada en el archivo de enlace. | |
| Filtrar | Se produce min: 0 Max Occurs: * |
Cuadrícula de datos | Sobrescribe la lista de filtros de este puerto de envío existente con la lista de filtros de este puerto de envío especificada en el archivo de enlace. | |
| Nombre común del certificado | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Huella digital del certificado | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Seguimiento | Se produce min: 0 Número máximo de casos: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Tipo (transporte de reserva) | Se produce min: 0 Número máximo de casos: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| URI (transporte de reserva) | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. solo es válido si se ha establecido el Tipo del transporte de reserva. | |
| Controlador de envío (transporte de reserva) | Se produce min: 1 Número máximo de casos: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. solo es válido si se ha establecido el Tipo del transporte de reserva. | |
| Número de reintentos (transporte de reserva) | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de desplazamiento | Sobrescriba este valor con el valor especificado en el archivo de enlace. solo es válido si se ha establecido el Tipo del transporte de reserva. | |
| Intervalo de reintentos (transporte de reserva) | Se produce min: 1 Número máximo de casos: 1 |
Cuadro de desplazamiento | Sobrescriba este valor con el valor especificado en el archivo de enlace. solo es válido si se ha establecido el Tipo del transporte de reserva. | |
| Habilitar ventana de servicio (transporte de reserva) | Se produce min: 1 Se produce max: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. solo es válido si se ha establecido el Tipo del transporte de reserva. | |
| Hora de inicio y Hora de finalización en la ventana de servicio (transporte de reserva) | Se produce min: 1 Se produce max: 1 |
Cuadro de desplazamiento | Sobrescriba estos valores con los valores especificados en el archivo de enlace. solo es válido si se ha establecido el Tipo y Habilitar ventana de servicio para el transporte de reserva. | |
| Puerto de recepción | Nombre | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Clave principal |
| Configuración de autenticación (botones de opción) | Se produce min: 1 Se produce max: 1 |
Botón de selección | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Habilitar enrutamiento para mensajes con errores | Se produce min: 1 Se produce max: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Descripción | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Ubicaciones de recepción | Se produce min: 0 Max Se produce: * |
Cuadrícula de datos | Sobrescribe la lista de ubicaciones de recepción de este grupo de puertos de recepción existente con la lista de ubicaciones de recepción de este grupo de puertos de recepción especificada en el archivo de enlace. Si todas las ubicaciones de recepción del archivo de enlace ya existen en el grupo, se produce un error al importar. | |
| Maps | Se produce min: 0 Max Se produce: * |
Cuadrícula de datos | Sobrescribe la lista de asignaciones de puerto de recepción existente con la lista de asignaciones de este puerto de recepción especificada en el archivo de enlace. | |
| Seguimiento - Seguimiento de partes de mensaje y Seguimiento de propiedades de mensaje | Se produce min: 1 Se produce max: 1 (por casilla de verificación) |
Casilla de verificación | Sobrescriba estos valores con los valores especificados en el archivo de enlace. | |
| Ubicación de recepción | Nombre | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Clave principal |
| Tipo de transporte | Se produce min: 1 Se produce max: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Controlador de recepción | Se produce min: 1 Se produce max: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Canalización | Se produce min: 1 Se produce max: 1 |
Desplegable | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Descripción | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Casillas de verificación y cuadros de lista desplegable de fecha de inicio y fecha de finalización de la programación. | Se produce min: 1 Se produce max: 1 |
Casilla de verificación y cuadro de lista desplegable. | Sobrescriba estos valores con los valores especificados en el archivo de enlace. Los valores de datos se importan aunque las casillas de verificación no estén activadas. | |
| Casilla de verificación Habilitar ventana de servicio | Se produce min: 1 Se produce max: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Hora de inicio y Hora de finalización en la ventana de servicio | Se produce min: 1 Se produce max: 1 |
Cuadro de desplazamiento | Sobrescriba estos valores con los valores especificados en el archivo de enlace. solo es válido si se ha establecido Habilitar ventana de servicio. | |
| Esquema | Descripción | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. |
| Seguimiento - Hacer siempre el seguimiento de todas las propiedades | Se produce min: 1 Se produce max: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. | |
| Seguimiento - Seleccionar todas las propiedades de mensajes | Se produce min: 1 Se produce max: 1 |
Casilla de verificación | Sobrescriba este valor con el valor especificado en el archivo de enlace. Si este valor está activado, todas las propiedades de mensaje que se puedan activar también se activarán. | |
| Seguimiento – propiedades individuales | Se produce min: 0 Max Se produce: * |
Casillas | Sobrescribe la lista de propiedades sometidas a seguimiento de este esquema existente con la lista de propiedades sometidas a seguimiento de este esquema especificada en el archivo de enlace. Si se importa un archivo de enlace que hace referencia a propiedades sometidas a seguimiento que no están disponibles para el esquema existente, se genera un error. |
|
| Map | Descripción | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. |
| Canalización | Descripción | Se produce min: 1 Se produce max: 1 |
Cuadro de texto | Sobrescriba este valor con el valor especificado en el archivo de enlace. |
| Seguimiento de eventos | Se produce min: 1 Se produce max: 1 (por casilla de verificación) |
Casilla de verificación | Sobrescriba estos valores con los valores especificados en el archivo de enlace. | |
| Realizar seguimiento de partes de mensaje | Se produce min: 1 Se produce max: 1 (por casilla de verificación) |
Casilla de verificación | Sobrescriba estos valores con los valores especificados en el archivo de enlace. | |
| Directiva | No es aplicable. Las directivas no se exportan a un archivo de enlace. | No aplicable | No aplicable | No aplicable |
| Vínculo de función | No es aplicable. Los vínculos de rol no se exportan a un archivo de enlace. | No aplicable | No aplicable | No aplicable |
Comportamiento de desenlace al actualizar artefactos existentes con sus homólogos de un archivo de enlace
Los artefactos del archivo de enlace suelen estar configurados de modo que hagan referencia a otros artefactos, por ejemplo, normalmente un puerto de recepción se configura de modo que haga referencia a una ubicación de recepción. En este escenario, el puerto de recepción es el artefacto principal, y la ubicación de recepción es el artefacto secundario. El puerto de recepción se configura explícitamente para hacer referencia a la ubicación de recepción y, a continuación, la ubicación de recepción hace referencia implícitamente al puerto de recepción. Si un archivo de enlace contiene artefactos principales que no se han configurado completamente, por ejemplo, un puerto de recepción que no se haya configurado con su ubicación de recepción, quedarán configurados de manera incompleta después de importar el archivo de enlace, independientemente de su estado en la configuración existente. Por ejemplo, si tiene un puerto de recepción existente configurado con la ubicación de recepción myRL y el puerto de recepción idéntico myRP en el archivo de enlace no está configurado con la ubicación de recepción myRL, la entrada del archivo de enlace tiene prioridad. En este ejemplo, el puerto de recepción myRP no se configurará con una ubicación de recepción después de importar el archivo de enlace, por lo que tendrá que desenlatar myRL de myRP de forma eficaz.
Esta regla solo se aplica a la importación de artefactos que realizan referencias explícitas, no a los que tienen referencias implícitas. De modo que si ha importado una asignación que hace referencia implícitamente otros 10 artefactos (que hacen referencia a la asignación de manera explícita), no debe temer que la asignación se desenlace de los artefactos a los que hace referencia implícitamente.