配置 SharePoint Services 发送端口

本主题将静态发送端口与动态发送端口进行比较,并列出了创建 Windows SharePoint Services 发送端口的步骤。 具体说来:

静态发送端口与动态发送端口

创建静态发送端口

创建动态发送端口

静态发送端口与动态发送端口

  静态发送端口 动态发送端口
使用具有不同适配器的单个发送端口。

创建静态发送端口时,需要传输类型。
是的

动态发送端口通常添加到一个编排流程中。 传输类型在编排逻辑中配置。
使用具有不同发送端口属性的单个发送端口,例如 URL。

创建静态发送端口时,必须配置某些适配器属性,例如 URL。
是的

动态发送端口通常添加到编排中。 属性在编排逻辑中配置。
必须使用默认的发送处理程序。

创建发送端口时,发送处理程序是可配置的。


创建发送端口时,发送处理程序是可配置的。
当不知道消息应该去哪里时使用。

创建静态发送端口时,可以指定传输类型和结束位置。
是的

可以在业务编排和内容路由场景中配置最终位置。 规则还可用于筛选消息的发送位置。
使用单个发送端口将消息发送到多个合作伙伴。

创建静态发送端口时,可以指定传输类型和结束位置。
是的

动态发送端口通常添加到编排中。 这些属性在业务流程逻辑中配置,并根据指定的规则,消息可以发送到多个合作伙伴。

创建静态发送端口

创建静态发送端口时,发送端口使用与传输类型关联的默认发送处理程序。 使用 Windows SharePoint Services 适配器时,默认的发送处理程序是 BizTalkServerApplication。 有关添加新的发送处理程序的步骤,请转到 “如何创建适配器处理程序”。

创建静态发送端口:

  1. BizTalk Server 管理控制台 中,展开 BizTalk 组 [GroupName],展开 应用程序,然后展开应用程序以包含发送端口。

  2. 右键单击 “发送端口”,单击“ 新建”,然后单击“ 静态单向发送端口”。

    重要

    Windows SharePoint Services 适配器无法配置 静态 Solicit-Response 发送端口

  3. “属性”中,单击“类型”下拉列表中的 Windows SharePoint Services。 输入 名称发送处理程序发送管道 属性。

  4. 单击 “配置” 。 在 “属性”中,配置以下内容:

    资产 DESCRIPTION
    适配器 Web 服务端口 必需。 承载 SharePoint Services 适配器 Web 服务的 IIS 网站上配置的端口。

    默认值为端口 80,即标准 HTTP 端口。 如果使用除 80 以外的端口,请更新此值。
    超时 必需。 此值以毫秒为单位,确定适配器从 Web 服务接收响应的时间。

    默认值为 100000 毫秒 (100 秒)。

    如果消息或批大小高于预期,则增加此值。

    适配器运行时 Web 服务调用对 Windows SharePoint Services 适配器 Web 服务的超时(以毫秒为单位)。 如果消息或批大小高于适配器预期的平均值,则可能需要增加此值。
    使用客户端 OM 必需。 确定是使用 SharePoint 客户端对象模型(CSOM)还是服务端对象模型(SSOM)。

    默认值为 “是”。 设置为 “是 ”以在 BizTalk Server 上使用 SharePoint CSOM。 SharePoint Services 计算机上没有特定要求。

    设置为 “否 ”以使用 SharePoint SSOM,其中包括在 SharePoint Services 计算机上安装的 Web 服务。

    附录 B:安装 Microsoft SharePoint 适配器 提供有关 SharePoint Services 适配器使用的 SSOM 和 CSOM 组件的特定信息。
    目标文件夹 URL 必需。 用于存储文档的 SharePoint Services 文件夹 URL。 输入 SharePoint 网站的相对路径。 例如, 共享文档共享文档/采购订单/。 还可以将列表用作目标。 例如, 列表/任务。 如果指定列表,则邮件正文不会随列表项一起保存。 从消息中提取的值将提升到 SharePoint 列中。 注意: SharePoint 文档库或文件夹 URL 可能不同于其名称。 在 Web 浏览器中检查地址以获取正确的 URL。
    文件名 可选。 输入 SharePoint Services 文件名。

    输入文件名,如 PurchaseOrder0001.xml 或表达式。 表达式包括文本、宏和 XPATH 查询的任意混合。 例如,输入 PurchOrd-%XPATH=//po:PurchaseOrderId%-%MessageID%.xml。 如果未提供文件名,则使用原始文件的文件名、协调程序提供的值或“Msg-%MessageID%.xml”。 有关详细信息,请参阅 Windows SharePoint Services 适配器表达式注意: 将消息发送到列表时,将忽略此 Filename 值,而不保存在 SharePoint 列中。 相反,请使用可用的16列之一更新“标题”列。 SharePoint 列表没有文件名列。
    命名空间别名 可选。 命名空间别名定义的列表,以逗号或分号分隔。

    使用此字段定义 XPATH 查询在“文件名”或“列值”等字段中引入的命名空间别名。 例如 ,输入 po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation' xmlns=“”; ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'注意: 此属性不会覆盖业务流程所定义的 WSS.ConfigNamespacesAliases 消息上下文属性。 而是合并这两个值。
    覆盖 必需。 如果文件存在,确定是否需要覆盖它。

    默认值为 No。 选项包括:

    - :如果存在同名的文件,则引发错误并挂起消息。
    - 编排:如果存在同名的文件,则使用编排中定义的值。
    - 重命名:如果存在同名的文件,则重命名新文件。
    - :如果现有文件具有相同的名称,则覆盖该文件。
    如果设置为 “是”,发送大量具有相同名称的消息可能会导致 SharePoint 事件查看器错误。 这些错误不会影响适配器,并且任何失败的消息都会被重试。
    SharePoint 网站 URL 必需。 SharePoint Services 网站的完整 URL。 例如,http:// SharePointServer/sites/TestSite。 注意: 发送端口或接收位置 URI 不能超过 256 个字符。
    Microsoft Office 集成 必需。 对于二进制消息,必须使用 “否 ”或 “可选”。

    默认值为 可选。 选项包括:

    • :保存文档 as-is。 对于二进制消息,可以使用此选项。
    • 可选:修改文档,使其自动在 Office 应用程序中打开,如 InfoPath。 如果未找到处理指令,文档将被 as-is 处理。 对于二进制消息,可以使用此选项。
    • 编排:使用编排中定义的值。
    • :修改文档,使其自动在 Office 应用程序中打开,如 InfoPath。 如果处理指令未找到,消息将被挂起。

      设置为 “是”时,至少需要以下属性对之一:

      • 模板文档库模板命名空间列
      • 模板回退文档库模板回退命名空间列
    • 是(InfoPath 表单库):如果 InfoPath 解决方案驻留在表单库中,文档将被修改,以便它自动在 Office 应用程序中打开,如 InfoPath。 如果表单库没有解决方案,消息将被暂停。
    模板文档库 仅在填充模板命名空间列时才是必需的。 存储 InfoPath 解决方案的 SharePoint 文档库。 例如, “我的解决方案”。 适配器在 模板文档库中 查找匹配的 InfoPath 解决方案。 如果未找到解决方案,适配器会查找 模板回退文档库注意:模板文档库至少需要一个填充以下内容的“单行文本”SharePoint 列:
    • 使用 InfoPath 解决方案打开的 XML 文档的命名空间和根节点
    • 或者,XML 文档的根节点
    有关详细信息,请参阅 演练:模块 2 - 将 Office 与 Windows SharePoint Services 适配器集成
    模板备用文档库 当填充模板回退命名空间列时才是必需的。 存储 InfoPath 解决方案的 SharePoint 文档库。 例如,模板

    如果在 模板文档库中找不到解决方案,适配器在 模板回退文档库中 查找匹配的 InfoPath 解决方案。 模板回退文档库模板文档库字段可用于两组 InfoPath 解决方案。 有一些通用 InfoPath 解决方案适用于所有常规用途,专用 InfoPath 解决方案仅用于特定合作伙伴。 “模板回退文档库”字段应指向通用解决方案,模板文档库应指向该特定合作伙伴的专用解决方案。 注意:模板回退文档库 至少需要一个填充以下内容的“单行文本”SharePoint 列:
    • 使用 InfoPath 解决方案打开的 XML 文档的命名空间和根节点
    • 或者,XML 文档的根节点
    有关详细信息,请参阅 演练:模块 2 - 将 Office 与 Windows SharePoint Services 适配器集成
    模板回退命名空间列 模板备用文档库填充时才是必需的。 存储 InfoPath 解决方案命名空间的 SharePoint 文档库。 例如 ,myNamespace注意: 此字段区分大小写。
    模板命名空间列 填充模板文档库时才是必需的。 存储 InfoPath 解决方案命名空间的 SharePoint 模板文档库 列。 例如 ,myNamespace注意: 此字段区分大小写。
    SharePoint Online 密码 可选。 SharePoint Online 帐户的密码。
    SharePoint Online 用户名 可选。 SharePoint Online 帐户的用户名。
    n 可选目标文档库中存在的 SharePoint 列。 使用从消息中提取的值或在 “列值” 字段中指定的值更新此列。 注意: 最多可以指定 16 列。 此字段区分大小写。
    n 可选。 输入要为此消息设置的列值。 可以键入文本值,例如“采购订单”或表达式。 表达式可以包含文本、宏和 XPATH 查询的任意混合。 例如,输入“%XPATH=//po:POAmount%”,“%SendingOrchestrationID%”。 注意: 最多可以指定 16 列。
  5. 单击 “确定 ”保存设置。

  6. 其他发送端口配置选项包括:

    1. 如何为发送端口配置传输高级选项

    2. 如何为发送端口配置备份传输选项

    3. 如何为发送端口配置出站映射

    4. 如何为发送端口配置筛选器

    5. 如何将证书分配给发送端口

    6. 如何为发送端口配置跟踪

创建动态发送端口

创建动态发送端口时,每个适配器都可以配置发送处理程序。 多个适配器可以使用单个动态发送端口。 有关配置动态发送端口处理程序的步骤,请参阅 动态发送端口处理程序是可配置 的。

  1. BizTalk Server 管理控制台 中,展开 BizTalk 组 [GroupName],展开 应用程序,然后展开应用程序以包含发送端口。

  2. 右键单击“发送端口”,单击“新建”,然后选择“动态单向发送端口”或“动态 Solicit-Response 发送端口

  3. “属性”中,输入“名称和管道”属性

    单击 “配置”

  4. “配置发送处理程序 ”窗口中,为各个适配器选择 “发送处理程序 ”。 默认的发送处理程序是 BizTalkServerApplication。 有关添加新发送处理程序的步骤,请转到 “如何创建适配器处理程序”。

    使用单独的主机有很多原因,包括:

    • 32 位要求:某些适配器需要 32 位主机,例如 FTP 和 POP3 适配器。 可以将所有或单个 32 位适配器分组到自己的主机中。

      BizTalk Server 64 位支持

    • 按目的托管:创建用于发送的主机、用于接收的主机、用于处理业务流程的主机和用于跟踪的主机。

    • 不同的主机设置:许多设置在主机级别实现。 因此,可以为每个主机配置不同的限制设置。 例如,可以在 HostA 上禁用限制。 跟踪 HostB 中的每个事件。 修改 HostC 的 .NET CLR 设置。 增加 HostD 上的内存使用率。

    • 安全性:安全性是在主机级别实现的。 每个主机在其自己的 Windows 帐户下运行。 例如,HostA 使用 FILE 适配器访问文件共享。 向 HostA 用户帐户授予对文件共享的权限。 HostB 使用 IIS 服务器上托管的 Web 服务。 向 Web 服务授予 HostB 用户帐户授权。 这还会阻止其他主机帐户访问它不需要访问的实体。

    • 单独的适配器:例如,您有多个使用 HTTP 适配器的工件(接收位置和发送端口)。 你想要与 HTTP 适配器关联的所有内容在其自己的主机上。

    • 单独的编排:各个编排可以位于自己的主机中。 例如,如果编排使用高内存或高 CPU,请将其分配到一个独立的主机。

      BizTalk Server 性能优化指南 以及如何 维护和排查 BizTalk Server 数据库 问题可提供性能建议。

  5. 单击 “确定 ”保存设置。

  6. 其他发送端口配置选项包括:

    1. 如何为发送端口配置传输高级选项

    2. 如何为发送端口配置出站映射

    3. 如何为发送端口配置筛选器

    4. 如何将证书分配给发送端口

    5. 如何为发送端口配置跟踪

  7. 单击 “确定 ”保存设置。

    其他有关发送端口的主题:

    创建和配置发送端口

    创建和配置发送端口组

另请参阅

SharePoint Services 适配器配置 SharePoint Services 接收位置CSOM 疑难解答:SharePoint Services 适配器