iT Synergy Blogs

Growing Innovation - Soluciones a problemas reales

Copyright © 2025 · iT Synergy·

Consumir servicio web o WCF desde Biztalk
Consumir servicio web o WCF desde Biztalk avatar

By Leave a Comment

Para consumir un servicio web o WCF desde biztalk se debe realizar los siguientes pasos:

image

En un proyecto Biztalk hacer click derecho, seleccionar “Add” y hacer click en la opción Add Generated Itemsimage

Una vez realizada la anterior operación, aparece una ventana emergente para agregar el ítem que se desea generar, se selecciona la opción “Consume WCF Service” y click en el botón “Add”.

image

Después de hacer click sobre el botón “Add”, se presenta una ventana wizard en dos formas para el consumo del servicio web, así:

  • La primera opción “Metadata Exchange (MEX) endpoint” opera si se tiene y se puede acceder a la URL del servicio web o del WCF.
  • La segunda opción “Metadata Files (WSDL and XSD)”, aplica cuando se tiene el WSDL del servicio web o WCF, para los casos en que éste haga referencia a esquemas adicionales se deben adicionar éstos también.

Para nuestro ejemplo se selecciona la opción “Metadata Exchange (MEX) endpoint”, y se hace click sobre el botón “Next >”

image

Posteriormente se escribe la URL del servicio web o WCF y se hace click en el botón “Get”, luego de un momento se carga el servicio web y se habilita el botón “Next >”.

image

A continuación, se escribe el namespace del servicio y se hace click en el botón “import >>“

image

Una vez se ha finalizado la importación del servicio web o WCF, se crean archivos dependiendo del wsdl, en este caso genera, dos XML (la diferencia de estos dos es el tipo de transporte WCF-BasicHttp y WCF-Custom) que contienen el bindings del puerto que se comunica con el servicio web o WCF y XSD que son los contratos de los objetos que puede tener el servicio web o WCF y la orquestación que contiene los multi-part message types y Port types que se obtuvieron del servicio web o WCF

image

Para probar la invocación del servicio web o WCF, se crea una orquestación que está compuesta por un Receive Port (puerto de entrada), dos send Port(Servicio Web o WCF) y una transformación (Mapa que contiene esquema personalizado con el esquema de request del Servicio Web o WCF).

image

Después de hacer el Deploy de los artefactos (orquestaciones, mapas, esquemas) para crear el send port del servicio, se abre la consola administradora de BizTalk Server, en la aplicación donde se hizo el despliegue de los artefactos mencionados anteriormente, se hace clic derecho se selecciona “Import” y luego se hace clic sobre “Bindings”

image

Aparece una ventana emergente y se busca el binding que se generó al importar el servicio web o WSDL, una vez seleccionado se da clic en el botón “Open”.

image

Luego se va a los Send Port y se busca el puerto que consume el servicio Web o WCF.

image

La orquestación arranca con un puerto de entrada tipo file para este ejemplo la estructura es:

image

La respuesta que se obtiene con la invocación del WCF es:

image

NOTA: No siempre cuando se importa un WCF o un servicio web se obtiene el Send Port Físico que se comunica con el servicio, para estos casos lo que se debe hacer es crear el send Port desde la consola administrador BizTalk. Se debe tener en cuenta es Transport type, Address (URI) y el action.

image

Para armar el SOAP action, se debe tener la siguiente estructura:

<BtsActionMapping xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>

<Operation Name=”Nombre del método del servicio” Action=”ruta del método en el WSDL del servicio” />

<Operation Name=”consultarPersonaByIdentificacion” Action=”http://tempuri.org/IPersonas/consultarPersonaByIdentificacion” />

</BtsActionMapping>

Schema referenced by Map has been deleted. The local, cached version of the BizTalk Server group configuration is out of date. You must refresh the BizTalk Server group configuration before making further changes.
Schema referenced by Map has been deleted. The local, cached version of the BizTalk Server group configuration is out of date. You must refresh the BizTalk Server group configuration before making further changes. avatar

By Leave a Comment

Sometimes when you try to update the BizTalk group within the BizTalk console (BizTalk Server Administration Console) the following error windows comes up saying that the BizTalk Server group is out of date and you must refresh, but the really estrange thing is when you try to do it you simply can’t! and the same windows error still there and you can’t see the BizTalk Application you have deployed.

It happens when a map´s reference is lost and the console can display all the application which are into the BizTalk Group.

So, what you have to do is:

  • Search the reference of the map that the windows error is showing you in the Database and delete it.

The Database’s name is: BizTalkMgmtDb and the table’s name where the maps information is store is: bt_MapSpec.

Query to delete it:

DELETE

FROM [BizTalkMgmtDb].[dbo].[bt_MapSpec]

WHERE id = ‘Somenthing’

The table has some columns, the columns that you are looking for to find quickly the map are:

  • [indoc_docspec_name]
  • [outdoc_docspec_name]

These columns constains the reference location which the map is using for example:

  • Maps name: ConsultaInfraYTecnoGenerico_To_ConsultaInfraYTecnoNCAReq.btm

The reference location that contains the file maps has the schema reference the map has like the pictures below shows:

Those references are the ones you are going to find in the table mentioned before just like that:

Be careful and make sure you delete the right reference (The reference which is lost). To do it, I recommend you find a column which has the
unique value for each row. In this case you can use the Id column.

When you have already done it, you can try again to update and everything is going to work fine again. 🙂

Could not enlist Send Port ‘ALL.Exceptions’. Exception from HRESULT: 0xC00CE557 (Microsoft.BizTalk.ExplorerOM)
Could not enlist Send Port ‘ALL.Exceptions’. Exception from HRESULT: 0xC00CE557 (Microsoft.BizTalk.ExplorerOM) avatar

By Leave a Comment

Problema

Después de instalar el ESB Toolkit 2.1 y al tratar de iniciar la aplicación Microsoft.Practices.ESB desde la consola de administración de BizTalk Server, no inicia correctamente porque el send port ALL.Exceptions no inicia correctamente.

Could not enlist Send Port ‘ALL.Exceptions’. Exception from HRESULT: 0xC00CE557 (Microsoft.BizTalk.ExplorerOM)

Solución

1. Desde el menu Configure.. de la aplicación Microsoft.Practices.ESB,  quitar la referencia del send port asociado a la orquestación Microsoft.Practices.ESB.Agents.Delivery.

2. Eliminar los send y receive ports que contiene la aplicación Microsoft.Practices.ESB

3. Importar los bindings  Microsoft.Practices.ESB.CORE_Bindings.xml ubicados en la ruta

  • C:\Program Files (x86)\Microsoft BizTalk ESB Toolkit 2.1\Bindings

4. Volver a iniciar la aplicación Microsoft.Practices.ESB

Espero sirva ! 😉