Configurar un puerto de envío de SharePoint Services

En este tema se compara un puerto de envío estático con un puerto de envío dinámico y también se enumeran los pasos para crear un puerto de envío Windows SharePoint Services. En concreto:

Puerto de envío estático frente a puerto de envío dinámico

Crear un puerto de envío estático

Crear un puerto de envío dinámico

Puerto de envío estático frente a puerto de envío dinámico

	Puerto de envío estático	Puerto de envío dinámico
Use un puerto de envío individual con diferentes adaptadores.	No Al crear un puerto de envío estático, es necesario el tipo de transporte.	Sí Normalmente, se agrega un puerto de envío dinámico a una orquestación. El tipo de transporte se configura en la lógica de la orquestación.
Use un puerto de envío individual con diferentes propiedades como, por ejemplo, la URL.	No Al crear un puerto de envío estático, se deben configurar algunas propiedades de adaptador como la URL.	Sí Normalmente, se agrega un puerto de envío dinámico a una orquestación. Las propiedades se configuran en la lógica de la orquestación.
Debe usar el controlador de envío predeterminado.	No El controlador de envío se puede configurar al crear un puerto de envío.	No El controlador de envío se puede configurar al crear un puerto de envío.
Úselo cuando no sepa dónde debería ir el mensaje.	No Al crear un puerto de envío estático, se especifica el tipo de transporte y la ubicación de llegada.	Sí La ubicación de llegada se puede configurar en una orquestación y en un escenario de enrutamiento por contenidos. Las reglas también se pueden usar para filtrar dónde se envía el mensaje.
Use un puerto de envío individual para enviar mensajes a varios socios.	No Al crear un puerto de envío estático, se especifica el tipo de transporte y la ubicación de llegada.	Sí Normalmente, se agrega un puerto de envío dinámico a una orquestación. Las propiedades se configuran en la lógica de la orquestación y se basan en reglas que el usuario especifica; los mensajes se pueden enviar a varios socios.

Crear un puerto de envío estático

Al crear un puerto de envío estático, este usa el controlador de envío predeterminado asociado al tipo de transporte. Al usar el adaptador de Windows SharePoint Services, el controlador de envío predeterminado es BizTalkServerApplication. Para conocer los pasos para agregar un nuevo controlador de envío, vaya a Creación de un controlador de adaptador.

Cree el puerto de envío estático:

1. En la consola de administración de BizTalk Server, expanda Grupo de BizTalk [GroupName], expanda Aplicaciones y, a continuación, expanda la aplicación para contener el puerto de envío.

2. Haga clic con el botón derecho en Puertos de envío, haga clic en Nuevoy, a continuación, haga clic en Puerto de envío unidireccional estático.

   Importante

   Un puerto de envío de Solicit-Response estático no se puede configurar con el adaptador de Windows SharePoint Services.

3. En Propiedades, haga clic en Windows SharePoint Services en la lista desplegable Tipo. Escriba las propiedades Nombre, Controlador de envío y Canalización de envío .

4. Haga clic en Configurar. En Propiedades, configure lo siguiente:

   Propiedad	Descripción
   Puerto del servicio Web del adaptador	Requerido. Puerto configurado en el sitio web de IIS que hospeda el servicio web de adaptador de SharePoint Services. El valor predeterminado es el puerto 80, que es el puerto HTTP estándar. Actualice este valor si utiliza un puerto distinto del 80.
   Tiempo de espera	Requerido. En milisegundos, este valor determina el tiempo transcurrido cuando el adaptador recibe una respuesta del servicio web. El valor predeterminado es 100000 ms (100 segundos). Aumente este valor si el tamaño del lote o el mensaje es mayor de lo esperado. Tiempo de espera, en milisegundos, de las llamadas del servicio Web de tiempo de ejecución del adaptador que se realizan al servicio Web del adaptador de Windows SharePoint Services. Puede que tenga que aumentar este valor si el tamaño del mensaje o del lote es mayor que el promedio que espera el adaptador.
   Utilizar modelo de objetos del cliente	Requerido. Determina si se utiliza el modelo de objetos del cliente de SharePoint (CSOM) o el modelo de objetos del servicio (SSOM). El valor predeterminado es Sí. Establezca en Sí para usar el CSOM de SharePoint en el BizTalk Server. No hay ningún requisito en el equipo de SharePoint Services. Establezca en No para usar el SSOM de SharePoint que incluye el servicio web instalado en el equipo de SharePoint Services. Apéndice B: Instalar el adaptador de Microsoft SharePoint proporciona información específica sobre los componentes SSOM y CSOM usados por el adaptador de SharePoint Services.
   Dirección URL de carpeta de destino	Requerido. Dirección URL de la carpeta SharePoint Services para almacenar los documentos. Escriba una ruta de acceso relativa al sitio de SharePoint. Por ejemplo, Documentos compartidos o Documentos compartidos/Pedidos de compra/. También se puede usar una lista como destino. Por ejemplo, Lists/Tasks. Si especifica una lista, el cuerpo del mensaje no se guarda con el elemento de lista. Los valores extraídos del mensaje se promueven en las columnas de SharePoint. Nota: La dirección URL de la carpeta o la biblioteca de documentos de SharePoint puede ser diferente de su nombre. Compruebe la dirección en el explorador web para obtener la dirección URL correcta.
   Filename	Opcional. Escriba el nombre de SharePoint Services nombre de archivo. Escriba un nombre de archivo, como PurchaseOrder0001.xml o una expresión. Las expresiones incluyen cualquier combinación de valores literales, macros y consultas XPATH. Por ejemplo, escriba PurchOrd-%XPATH=//po:PurchaseOrderId%-%MessageID%.xml. Cuando no se proporciona un nombre, se usa el nombre de archivo del archivo original, el valor proporcionado por la orquestación o 'Msg-%MessageID%.xml'. Consulte expresiones de adaptador de Windows SharePoint Services para obtener más información. Nota: Al enviar mensajes a una lista, este valor de Nombre de archivo se omite y no se guarda en una columna de SharePoint. En su lugar actualice la columna 'Título' con alguna de las 16 columnas disponibles. Las listas de SharePoint no tienen una columna Nombre de archivo.
   Alias de espacios de nombres	Opcional. Lista separada por comas o punto y coma de definiciones de alias de espacios de nombres. Use este campo para definir los alias de espacios de nombres que usan las consultas XPATH introducidas en los campos como 'Nombre de archivo' o 'Valor de columna'. Por ejemplo, escriba po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation' xmlns=""; ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'. Nota: Esta propiedad no invalida el WSS. Propiedad de contexto del mensaje ConfigNamespacesAliases definida por la orquestación. En lugar de eso, se combinan los dos valores.
   Sobrescribir	Requerido. Si existe un archivo, determina si el archivo se sobrescribe. El valor predeterminado es No. Las opciones son: - No: genera un error y suspende el mensaje si existe un archivo con el mismo nombre. - Orquestación: usa el valor definido en la orquestación si existe un archivo con el mismo nombre. - Cambiar nombre: cambia el nombre del nuevo archivo si existe un archivo con el mismo nombre. - Sí: sobrescribe un archivo existente si tiene el mismo nombre. Cuando se establece en Sí, enviar un gran número de mensajes con el mismo nombre puede dar lugar a errores de sharePoint Visor de eventos. Estos errores no influyen en el adaptador y se volverán a intentar los mensajes que no se envíen correctamente.
   Dirección URL del sitio de SharePoint	Requerido. Dirección URL completa del sitio web de SharePoint Services. Por ejemplo, http:// SharePointServer/sites/TestSite. Nota: Un puerto de envío o un URI de ubicación de recepción no puede superar los 256 caracteres.
   Integración con Microsoft Office	Requerido. En el caso de los mensajes binarios, debe usar No o Opcional. El valor predeterminado es Opcional. Las opciones son: No: guarda el documento tal como está. Puede usar esta opción para los mensajes binarios. Opcional: modifica el documento para que se abra automáticamente en una aplicación de Office, como InfoPath. Si no se encuentran las instrucciones de procesamiento, el documento se procesa tal y como está. Puede usar esta opción para los mensajes binarios. Orquestación: usa el valor definido en la orquestación. Sí: Modifica el documento para que se abra automáticamente en una aplicación de Office, como InfoPath. Si no se encuentran las instrucciones de procesamiento, el mensaje se suspende. Cuando se establece en Sí, se requiere al menos uno de los siguientes pares de propiedades: Plantillas biblioteca de documentos y columna de espacio de nombres templates Plantillas Reserva de la biblioteca de documentos y plantillas Columna de espacio de nombres de reserva Sí (Biblioteca de formularios de InfoPath): si una solución de InfoPath reside en la Biblioteca de formularios, el documento se modifica para que se abra automáticamente en una aplicación de Office, como InfoPath. Si la Biblioteca de documentos no tiene una solución, el mensaje se suspende.
   Biblioteca de documentos de plantillas	Solo es necesario cuando se rellenan las columnas de espacio de nombres de plantillas. La biblioteca de documentos de SharePoint que almacena las soluciones de InfoPath. Por ejemplo, Mis soluciones. El adaptador busca en la biblioteca de documentos plantillas una solución de InfoPath coincidente. Si no se encuentra una solución, el adaptador busca en la Biblioteca de documentos de reserva de plantillas. Nota: La Biblioteca de documentos de plantillas requiere al menos una columna de SharePoint "Línea única de texto" que se rellena con lo siguiente: El espacio de nombres y el nodo raíz de los documentos XML que se abren con la solución de InfoPath O bien, el nodo raíz del documento XML Para obtener más información, vea Tutorial: Módulo 2: Integración de Office con el adaptador de Windows SharePoint Services.
   Biblioteca de documentos de reserva de plantillas	Solo es necesario cuando se rellena la columna de espacio de nombres de reserva de plantillas. La biblioteca de documentos de SharePoint que almacena las soluciones de InfoPath. Por ejemplo, Plantillas. Si no se encuentra una solución en la Biblioteca de documentos de plantillas, el adaptador busca en Plantillas reserva de documentos biblioteca de documentos para una solución de InfoPath coincidente. Los campos Templates Fallback Document Library y Templates Document Library se pueden usar con dos conjuntos de soluciones de InfoPath. Hay soluciones de InfoPath genéricas que funcionan para todos los fines y soluciones de InfoPath especializadas que se usan únicamente para un socio concreto. El campo Templates Fallback Document Library (Biblioteca de documentos de reserva de plantillas ) debe apuntar a las soluciones genéricas y la Biblioteca de documentos templates debe apuntar a las soluciones especializadas para ese asociado en particular. Nota:Templates Fallback Document Library requiere al menos una columna de SharePoint "Línea única de texto" que se rellena con lo siguiente: El espacio de nombres y el nodo raíz de los documentos XML que se abren con la solución de InfoPath O bien, el nodo raíz del documento XML Para obtener más información, vea Tutorial: Módulo 2: Integración de Office con el adaptador de Windows SharePoint Services.
   Columna de espacio de nombres de reserva de plantillas	Solo es necesario cuando se rellena la biblioteca de documentos de reserva de plantillas. La biblioteca de documentos de SharePoint que almacena el espacio de nombres de las soluciones de InfoPath. Por ejemplo, myNamespace. Nota: Este campo distingue mayúsculas de minúsculas.
   Columna de espacio de nombres de plantillas	Solo es necesario cuando se rellena la biblioteca de documentos de plantillas. La columna Biblioteca de documentos plantillas de SharePoint que almacena el espacio de nombres de la solución de InfoPath. Por ejemplo, myNamespace. Nota: Este campo distingue mayúsculas de minúsculas.
   Contraseña de SharePoint Online	Opcional. Contraseña de la cuenta de SharePoint Online.
   Nombre de usuario de SharePoint Online	Opcional. Nombre de usuario de la cuenta de SharePoint Online.
   Columna n	Opcional. Columna de SharePoint que existe en la biblioteca de documentos de destino. Actualice esta columna con el valor extraído del mensaje o especificado en el campo Valor de columna . Nota: Se pueden especificar hasta 16 columnas. Este campo distingue mayúsculas de minúsculas.
   Valor de columna n	Opcional. Escriba el valor de columna que se establecerá para este mensaje. Puede escribir un valor literal como 'Pedido' o una expresión. Las expresiones pueden incluir cualquier combinación de valores literales, macros y consultas XPATH. Por ejemplo, escriba "%XPATH=//po:POAmount%", "%SendingOrchestrationID%". Nota: Se pueden especificar hasta 16 columnas.

5. Haga clic en Aceptar para guardar la configuración.

6. Entre las opciones de configuración adicionales del puerto de envío se incluyen:

   1. Cómo configurar opciones avanzadas de transporte para un puerto de envío

   2. Cómo configurar opciones de transporte de reserva para un puerto de envío

   3. Cómo configurar asignaciones de salida para un puerto de envío

   4. Cómo configurar filtros para un puerto de envío

   5. Cómo asignar un certificado a un puerto de envío

   6. Cómo configurar el seguimiento de un puerto de envío

Crear un puerto de envío dinámico

Al crear un puerto de envío dinámico, el controlador de envío se puede configurar para cada adaptador. Varios adaptadores pueden usar un puerto de envío dinámico individual. Consulte Dynamic Send Port Handler is Configurable (Controlador de puerto de envío dinámico) para conocer los pasos para configurar el controlador de puerto de envío dinámico.

1. En la consola de administración de BizTalk Server, expanda Grupo de BizTalk [GroupName], expanda Aplicaciones y, a continuación, expanda la aplicación para que contenga el puerto de envío.

2. Haga clic con el botón derecho en Puertos de envío, haga clic en Nuevoy, a continuación, elija Puerto de envío unidireccional dinámico o Puerto de envío dinámico Solicit-Response.

3. En Propiedades, escriba el nombre y las propiedades de canalización .

   Haga clic en Configurar.

4. En la ventana Configurar controlador de envío , elija el controlador de envío para los adaptadores individuales. El controlador de envío predeterminado es BizTalkServerApplication. Para conocer los pasos para agregar un nuevo controlador de envío, vaya a How to Create an Adapter Handler (Cómo crear un controlador de adaptador).

   Hay muchos motivos para usar hosts independientes, que incluyen:

   • Requisitos de 32 bits: algunos adaptadores requieren un host de 32 bits, como los adaptadores FTP y POP3. Puede agrupar todos los adaptadores de 32 bits individual o conjuntamente en su propio host.

     Compatibilidad de BizTalk Server con 64 bits

   • Host por propósito: cree un host para enviar, un host para recibir, un host para procesar orquestaciones y un host para el seguimiento.

   • Diferentes configuraciones de host: muchas configuraciones se implementan en el nivel de host. En consecuencia, se pueden configurar diferentes parámetros de limitación para cada host. Por ejemplo, se puede deshabilitar la limitación del HostA. Realizar un seguimiento de los eventos del HostB. Modificar la configuración de .NET CLR del HostC. Aumentar el uso de memoria del HostD.

   • Seguridad: la seguridad se implementa en el nivel de host. Cada host se ejecuta bajo su propia cuenta de Windows. Por ejemplo, el HostA usa el adaptador de archivo para tener acceso al recurso compartido de archivos. Conceda a la cuenta de usuario del HostA permisos para el recurso compartido de archivos. El HostB usa un servicio web hospedado en un servidor de IIS. Conceda a la cuenta de usuario del HostB autorización para el servicio web. De este modo, también se evita que otras cuentas de host tengan acceso a entidades a las que no necesitan tener acceso.

   • Adaptadores independientes: por ejemplo, tiene varios artefactos (ubicación de recepción y puertos de envío) mediante el adaptador HTTP. Desea que todo esté asociado con el adaptador HTTP en su propio host.

   • Orquestaciones independientes: las orquestaciones individuales pueden estar en su propio host. Por ejemplo, si una orquestación usa mucha memoria o una CPU elevada, coloque dicha orquestación en su propio host.

     BizTalk Server Guía de optimización del rendimiento y Cómo mantener y solucionar problemas BizTalk Server bases de datos proporcionan sugerencias de rendimiento.

5. Haga clic en Aceptar para guardar la configuración.

6. Entre las opciones de configuración adicionales del puerto de envío se incluyen:

   1. Cómo configurar opciones avanzadas de transporte para un puerto de envío

   2. Cómo configurar asignaciones de salida para un puerto de envío

   3. Cómo configurar filtros para un puerto de envío

   4. Cómo asignar un certificado a un puerto de envío

   5. Cómo configurar el seguimiento de un puerto de envío

7. Haga clic en Aceptar para guardar la configuración.

   Temas adicionales sobre el puerto de envío:

   Creación y configuración de puertos de envío

   Creación y configuración de grupos de puertos de envío

Consulte también

Solución de problemas del adaptador de SharePoint Servicesconfigurar SharePoint Services ubicación de recepciónCSOM: adaptador de SharePoint Services