Extensión de BTARN con un PIP nuevo
En este tema se describe cómo ampliar el Acelerador de Microsoft BizTalk para RosettaNet (BTARN) con un nuevo esquema de proceso de interfaz de asociado (PIP). Esto le permite agregar un esquema basado en un PIP de RosettaNet cuando ese PIP no está asociado a ninguno de los esquemas instalados por el programa de instalación de BTARN.
Al extender BTARN con un nuevo PIP, se implementa el nuevo esquema en su propio ensamblado. También puede modificar un esquema existente implementado en el ensamblado RNPIPs de BTARN. Para obtener más información, consulte Modificación de un PIP existente en RNPIPs.
Para ampliar BTARN con un nuevo PIP
Haga clic en Inicio y en Ejecutar, escriba cmd y, a continuación, haga clic en Aceptar.
En el símbolo del sistema, vaya a <unidad>:\Archivos de programa\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Utilities\Schema Generator.
En el símbolo del sistema, escriba CScript InstallDTD.vbsy presione Entrar.
Nota
Solo tendrá que realizar los pasos del 1 al 3 una vez después de instalar BizTalk Server.
Inicie Visual Studio.
En el menú Archivo , elija Nuevoy haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto, seleccione Proyectos de BizTalk en el panel izquierdo y, a continuación, haga clic en Vacío BizTalk Server Proyecto en el panel derecho.
Haga clic en Examinar y seleccione el directorio donde desea guardar el proyecto.
En el cuadro Nombre , escriba un nombre de proyecto, como MyCustomPIP y, a continuación, haga clic en Aceptar.
Inicie el símbolo del sistema de Visual Studio.
En el símbolo del sistema, vaya a la ubicación especificada en el paso 7, escriba sn -k <nombre del proyecto.snk> y presione Entrar.
En el Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto y, a continuación, haga clic en Propiedades.
En el cuadro de diálogo Páginas de propiedades, haga clic en Ensamblado en Propiedades comunes en el panel izquierdo.
En el panel derecho, desplácese hacia abajo hasta Nombre seguro, haga clic en Archivo de clave de ensamblado y, a continuación, haga clic en el botón de puntos suspensivos (...) en el panel derecho. Vaya a la ubicación especificada en el paso 7 y seleccione el nombre del archivo .snk creado en el paso 10.
En el cuadro de diálogo Páginas de propiedades , expanda Propiedades de configuracióny, a continuación, haga clic en Implementación. En el panel derecho, haga clic en Volver a implementar, seleccione
True
y, a continuación, haga clic en Aceptar.En Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto, seleccione Agregar y, a continuación, haga clic en Elemento existente.
En el cuadro de diálogo Agregar elemento existente , vaya a <unidad>:\Archivos de programa\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Schemas, seleccione xml.xsd y haga clic en Agregar.
Descargue el PIP que va a extender RNPIPs con RosettaNet.org. Para obtener más información, consulte Incorporación de un nuevo proceso de interfaz de asociado.
En Explorador de soluciones, expanda el nombre del proyecto, haga clic con el botón derecho en Referencia y, a continuación, haga clic en Agregar referencia.
En el cuadro de diálogo Agregar referencia , haga clic en Examinar y vaya a <unidad>:\Archivos de programa\Microsoft BizTalk 2013 Accelerator for RosettaNet\Bin y, a continuación, seleccione Microsoft.Solutions.BTARN.Schemas.RNPIPs.dll. Haga clic en Abriry, a continuación, haga clic en Aceptar.
En Explorador de soluciones, haga clic con el botón derecho en el nombre del proyecto, seleccione Agregar y, a continuación, haga clic en Agregar elementos generados.
En el cuadro de diálogo Agregar elementos generados , en el panel Categorías , haga clic en Generar esquemas. En el panel Plantillas , haga clic en Generar esquemas y, a continuación, haga clic en Agregar.
En el cuadro de diálogo Generar esquemas, haga lo siguiente:
Use Para hacer esto Tipo de documento Seleccione Esquema DTD. Archivo de entrada Haga clic en Examinar, vaya a la carpeta que contiene el archivo DTD de RosettaNet.org, seleccione el archivo DTD que desee y, a continuación, haga clic en Abrir. En el cuadro de diálogo Generar esquemas , haga clic en Aceptar.
En Explorador de soluciones, haga doble clic en el archivo .xsd que acaba de importar.
En el Editor de BizTalk, seleccione el < nodo Esquema>.
En el ventana Propiedades, desplácese hacia abajo hasta Tipo de documento. En el cuadro Tipo de documento, código >PIP <de tres dígitos, por ejemplo, PIP3A2. En el cuadro Versión del documento , escriba v<xx.xx> o R<xx.xx>, por ejemplo, R01.02. Esta versión debe ser como se documenta en la especificación pip de RosettaNet.
En el ventana Propiedades, desplácese hacia abajo hasta Referencia raíz. Haga clic en Referencia raíz y, en la lista desplegable, seleccione el nodo raíz del esquema, por ejemplo, seleccione Pip3C5BillingStatementNotification.
En el ventana Propiedades, desplácese hacia arriba hasta Espacio de nombres de destino. En Espacio de nombres de destino, escriba
http://schemas.microsoft.com/biztalk/btarn/2004/{DTD file name}.dtd
, donde el nombre del archivo DTD es, por ejemplo, 3C5_MS_R01_00_BillingStatementNotification.dtd.Nota
Esta convención de nomenclatura para el espacio de nombres de destino es necesaria para BTARN. Si usa otra convención de espacio de nombres, BTARN no procesará documentos PIP para la validación del esquema.
Nota
El nombre del archivo DTD en la propiedad del espacio de nombres de destino incluye el número de versión del PIP. Esto le permite usar varias versiones del mismo código PIP.
En el ventana Propiedades, desplácese hacia arriba hasta Importaciones. Haga clic en el botón de puntos suspensivos (...) situado junto a Importaciones y, a continuación, haga clic en Agregar.
En el cuadro de diálogo Selector de tipos de BizTalk , expanda <Nombre> del proyecto, expanda Referencias, expanda Microsoft.Solutions.BTARN.Schemas.RNPIPs, expanda Esquemas, seleccione Microsoft.Solutions.BTARN.Schemas.RNPIPs.BaseDataTypes, haga clic en Aceptar y, a continuación, haga clic en Aceptar de nuevo.
Haga clic con el botón derecho en el nombre del proyecto y haga clic en Implementar.
Haga clic en Inicio, seleccione Todos los programas, MicrosoftBizTalk Server y, a continuación, haga clic en Administración de BizTalk Server.
En la Consola de administración de BizTalk, expanda MicrosoftBizTalk Server(Local) y, a continuación, expanda Hosts. En Host, haga clic en BizTalkServerApplication.
En el panel derecho, haga clic con el botón derecho en el nombre del host y, a continuación, haga clic en Reiniciar.
Nota
Después de extender RNPIPs con un PIP recién importado, debe crear la configuración de PIP correcta y un contrato mediante ese PIP, en la Consola de administración de BTARN.
Consulte también
Incorporación de un nuevo proceso de interfaz de socio comercial
Trabajar con PIP
Modificación de un PIP existente en RNPIP