Creación o edición de un acuerdo
En este tema se describe cómo crear o editar un acuerdo de socio comercial. Un acuerdo de socios comerciales configura la relación entre dos socios comerciales, incluidas sus identidades; el proceso de interfaz de asociado (PIP); las direcciones URL de acción, señal y sincronización; y los protocolos asociados.
Un contrato de socio comercial incluye la configuración de un proceso, la organización principal, el socio y el contrato. Todas estas opciones de configuración son necesarias para un contrato. Puede crear una configuración de proceso basada en un PIP de RosettaNet o en un esquema personalizado, pero debe crear la configuración. También debe definir una organización principal y una organización asociada. El Acelerador de Microsoft BizTalk para RosettaNet (BTARN) no admite el intercambio de mensajes entre partes desconocidas.
BTARN procesa y valida un mensaje basado en todas estas configuraciones. Por ejemplo, para un mensaje CIDX, BTARN valida según la versión de RosettaNet Implementation Framework (RNIF) (solo 1.1), el acuerdo 0A1 (solo 0A1) y Is Single Action la propiedad (solo acción única). Un mensaje CIDX solo se validará si establece la versión de RNIF en "1.1", el contrato 0A1 en "No 0A1" y la Is Single Action propiedad en True. BTARN también valida que las propiedades del contrato sean coherentes con la configuración del perfil de configuración del proceso. Por ejemplo, comprobará que ha establecido la Standard propiedad del perfil en "CIDX" y que la propiedad de contrato 0A1 del contrato está establecida en "No 0A1".
Si cambia un contrato mientras un proceso está activo, es posible que encuentre resultados imprevisibles. Los cambios en las propiedades del contrato se aplicarán tan pronto como haga clic en Aplicar o Aceptar para aceptarlos, pero no puede predecir qué fase de un proceso se está ejecutando. Después de cambiar el contrato, cualquier actividad nueva en un proceso actual o cualquier proceso nuevo usará las propiedades de contrato modificadas. Sin embargo, es posible que un proceso que se ejecute al cambiar el contrato ya haya usado las propiedades de contrato anteriores para un mensaje que está procesando.
Después de crear un contrato, debe activarlo para permitir que los mensajes asociados al contrato se envíen o reciban. También puede desactivar un contrato para evitar que los mensajes asociados al contrato se envíen o reciban. Debe desactivar un contrato para editarlo y volver a activarlo después de editarlo.
BTARN guarda esta información en la tabla TPAConfig de la base de datos BTARNCONFIG.
La configuración del acuerdo entre socios comerciales se muestra en la tabla siguiente, organizada por pestaña. La configuración predeterminada son los valores más usados. Los procedimientos para crear y editar esta configuración aparecen después de la tabla.
| Pestaña | Configuración | Uso |
|---|---|---|
| General | Nombre | Un nombre único para el contrato, como Fabrikam_To_Contoso_3A2. Campo obligatorio. |
| General | Configuración de proceso | Identificador del PIP. Este número identifica qué configuración de proceso está asociada a este contrato. El valor predeterminado es el primero de la lista de configuraciones de proceso. La lista desplegable incluye todas las configuraciones de proceso especificadas anteriormente. Campo obligatorio. |
| General | Mi organización | La organización principal, seleccionada en una lista desplegable. Campo obligatorio. |
| General | Organización de asociados | La organización asociada, seleccionada en una lista desplegable. Campo obligatorio. |
| General | Descripción | Descripción del acuerdo entre socios comerciales. |
| General | Versión de RNIF | La versión del RNIF que BTARN usará para las comunicaciones de contrato. Puede ser V01.10.00 o V02.00.01 (valor predeterminado). Debe ser V01.10.00 para CIDX. |
| General | Rol principal | Rol de la organización principal. Puede ser rol de iniciador o rol de respondedor. |
| General | Acuerdo 0A1 | Si BTARN devolverá un mensaje de notificación de error (PIP 0A1) cuando se produzca un error. Puede ser No 0A1 (valor predeterminado) o 0A1. Debe ser No 0A1 para CIDX. |
| General | Uso | Indica el tipo de escenario que usará el contrato. Puede ser Test (valor predeterminado) o Production. |
| General (Área del adaptador de aplicación ) |
Nombre del ensamblado | Nombre de archivo del ApplicationAdapter que puede seleccionar en el sistema de archivos. El valor predeterminado es una cadena vacía. |
| General (Área del adaptador de aplicación) |
Nombre de la clase | Nombre de la clase que BTARN usará desde ApplicationAdapter. El valor predeterminado es <none>. |
| General (Área del adaptador de validación) |
Nombre del ensamblado | Nombre de archivo del ValidationAdapter que puede seleccionar en el sistema de archivos. El valor predeterminado es una cadena vacía. |
| General (Área del adaptador de validación) |
Nombre de la clase | Nombre de la clase que BTARN usará desde ValidationAdapter. El valor predeterminado es <none>. |
| Puertos | Dirección URL de acción | Dirección URL a la que la organización principal transmitirá un mensaje de acción. Por ejemplo, http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Se trata de un campo obligatorio si se cumple lo siguiente: - El valor is Synchronous process-configuration es False.- El valor is Single Action process-configuration es True.- La configuración del contrato de rol principal es Iniciador. También es un campo obligatorio si se cumple lo siguiente (en cuyo caso, también se requiere el campo Dirección URL de señal): - El valor is Synchronous process-configuration es False.- El valor is Single Action process-configuration es False.- Debe escribir un URI válido en este campo, uno que comience por "< http://domain>" o "".<https://domain> |
| Puertos | URL de la señal | Dirección URL a la que la organización principal transmitirá un mensaje de señal. Por ejemplo, http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Este es un campo obligatorio si se cumple lo siguiente: - El valor is Synchronous process-configuration es False.- El valor is Single Action process-configuration es True.- La configuración del contrato de rol inicio es Respondedor. También es un campo obligatorio si se cumple lo siguiente (en cuyo caso, también se requiere el campo Dirección URL de la acción ): - El valor is Synchronous process-configuration es False.- El valor is Single Action process-configuration es False.Debe escribir un URI válido en este campo, uno que comience por "< http://domain>" o "".<https://domain> |
| Puertos | URL de sincronización | Dirección URL que usará la organización principal para establecer una conexión a través del adaptador HTTP. Por ejemplo, http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Este es un campo obligatorio si se cumple lo siguiente: - El valor is Synchronous process-configuration es True.- La configuración del contrato de rol inicio es Iniciador. Debe escribir un URI válido en este campo, uno que comience por "< http://domain>" o "".<https://domain> |
| Protocolo | Método digest | Protocolo utilizado para calcular el resumen de los mensajes entrantes con fines de no rechazo. A partir de BizTalk Server 2016 y versiones más recientes, la compatibilidad con SHA2 se incluye automáticamente. Entre las opciones se incluyen: MD5, SHA-1, SHA-256 (valor predeterminado), SHA-384 y SHA-512. En las versiones anteriores de BizTalk Server, las opciones incluyen MD5 o SHA-1 (valor predeterminado). La canalización de recepción de BTARN recibe y descifra un mensaje incluso si el protocolo usado para cifrar el mensaje y la configuración codificación de esta pestaña del contrato no coinciden. Por lo tanto, BTARN recibe mensajes cifrados en RC2-40 o 3DES. Todos los mensajes firmados salientes tienen un resumen de SHA-1. |
| Protocolo | Codificar todas las partes | Si el sistema codificará todas las partes del mensaje de varias partes juntas. Puede ser True o False (el valor predeterminado).Cuando True, todas las partes del mensaje de varias partes se codificarán juntas con el método indicado por la Encoding propiedad .Cuando False, el sistema solo codificará los datos adjuntos mediante el método indicado por la Encoding propiedad . (Los datos adjuntos siempre se codifican mediante la canalización de envío mediante el método indicado por la Encoding propiedad ). De forma predeterminada, cuando establece esta propiedad Falseen , BTARN codifica las demás partes del mensaje (cuatro partes en RNIF 2.01, tres partes en RNIF 1.1) en formato imprimible entre comillas. |
| Protocolo | Encoding | El protocolo utilizado para codificar todas las partes (si el cuadro Codificar todas las partes es True) o los datos adjuntos (si el cuadro Codificar todas las partes es False).Puede ser de 8 bits, base 64 (valor predeterminado) o imprimible entre comillas. |
| Protocolo | Algoritmo de cifrado | Algoritmo utilizado para cifrar los mensajes entrantes y salientes. A partir de BizTalk Server 2016 y versiones más recientes, se incluye automáticamente la compatibilidad con AES. Entre las opciones se incluyen RC2-40, 3DES, AES128 (valor predeterminado), AES192 y AES256. En las versiones anteriores de BizTalk Server, las opciones incluyen RC2-40 (valor predeterminado) o 3DES. El algoritmo de cifrado solo surte efecto si ha establecido la Is Persistent Confidentiality Required propiedad en Payload o Payload Container en la configuración del proceso correspondiente. |
| Protocolo | Dirección del cifrado | Si el sistema cifrará el mensaje entrante o el mensaje saliente, o ambos. Puede ser Entrante, Saliente o Entrante/Saliente (valor predeterminado). La configuración de dirección de cifrado solo surte efecto si ha establecido la Is Persistent Confidentiality Required propiedad en Payload o Payload Container en la configuración de proceso correspondiente. |
| Propiedades personalizadas | Nombre | Nombre de la propiedad personalizada. Puede establecer propiedades personalizadas por contrato. Si crea un nuevo proceso privado personalizado, puede usar estas propiedades personalizadas en el procesamiento de diferentes contratos. Puede usar el RuntimeConfig.GetTPACustomConfigValue método en el SDK de BTARN para recuperar propiedades personalizadas de la configuración de BTARN.La Name propiedad debe ser única y no estar vacía.Puede escribir los siguientes valores personalizados: - AAR. Esta es la propiedad personalizada Confirmación de aceptación requerida. Esto solo se aplica a RNIF 1.1. Establézcalo en false (que no distingue mayúsculas de minúsculas) para requerir solo una confirmación de recibo, no una confirmación de aceptación. Si AAR se establece en algo distinto de false, el proceso público del respondedor debe enviar una confirmación de aceptación y el proceso público del iniciador esperará una confirmación de aceptación. Si AAR está establecido en false, los procesos públicos se completarán después de la confirmación de recibo. - HPCC. Este es el código de clasificación del asociado principal. Esto solo se aplica a RNIF 1.1. Esto le permite establecer el elemento GlobalPartnerClassificationCode para el asociado principal en el encabezado de servicio de un mensaje saliente en la entrada de la columna Valor. Este valor invalida la propiedad clasificación de la organización Principal en la configuración de Organización principal. Use esta propiedad personalizada cuando la organización principal pueda tener más de una clasificación. - CCPC. Este es el código de clasificación de perfil de asociado. Esto solo se aplica a RNIF 1.1. Esto le permite establecer el elemento GlobalPartnerClassificationCode para el asociado en el encabezado de servicio de un mensaje saliente en la entrada de la columna Valor. Este valor invalida la propiedad Clasificación de partners en la configuración del asociado. Use esta propiedad personalizada cuando el asociado pueda tener más de una clasificación. |
| Propiedades personalizadas | Valor | Valor de la propiedad personalizada. |
Creación de un acuerdo emtre socios comerciales
Haga clic en Inicio, seleccione Todos los programas, Seleccione Acelerador de MicrosoftBizTalk para RosettaNet y, a continuación, haga clic en Acelerador de BizTalk para RosettaNetManagement Console.
En la Consola de administración de BTARN, expanda Acelerador de BizTalk para RosettaNet.
Haga clic con el botón derecho en Contratos, seleccione Nuevoy, a continuación, haga clic en Contrato.
En el cuadro de diálogo Propiedades del nuevo contrato, en las pestañas General, Puertos, Protocolo y Propiedades personalizadas , escriba los valores de configuración. Para obtener información acerca de estas opciones de configuración, consulte la tabla anterior.
Haga clic en OK.
Nota
BTARN no aceptará mensajes relacionados con el contrato hasta que active el contrato.
Haga clic con el botón derecho en el nombre del contrato en el panel derecho y, a continuación, haga clic en Activar.
Nota
Si ya ha activado un contrato, puede hacer clic con el botón derecho en el nombre del contrato en el panel derecho y, a continuación, hacer clic en Desactivar para evitar que se envíen o reciban mensajes asociados al contrato.
Editar un acuerdo de socios comerciales
Haga clic en Inicio, seleccione Todos los programas, Seleccione Acelerador de MicrosoftBizTalk para RosettaNet y, a continuación, haga clic en Acelerador de BizTalk para RosettaNetManagement Console.
En la Consola de administración de BTARN, expanda Acelerador de BizTalk para RosettaNet y, a continuación, haga clic en el nodo Contratos .
Haga clic con el botón derecho en el contrato que desea editar y, a continuación, haga clic en Propiedades.
En el cuadro de diálogo Propiedades del nombre> del < contrato, en las pestañas General y Propiedades de contacto, cambie la configuración según sea necesario. Para obtener información acerca de estas opciones de configuración, consulte la tabla anterior.
Haga clic en OK.
Consulte también
Administrar la configuración, certificados, bases de datos y seguridad
Administración de la configuración de BTARN