配置 SharePoint Services 发送端口

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

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

创建静态发送端口

创建动态发送端口

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

  静态发送端口 动态发送端口
将单个发送端口用于不同适配器。

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


通常会将动态发送端口添加到业务流程中。 传输类型在业务流程逻辑中配置。
将单个发送端口用于不同发送端口属性(如 URL)。

当创建静态发送端口时,必须配置某些适配器属性(如 URL)。


通常会将动态发送端口添加到业务流程中。 属性在业务流程逻辑中配置。
必须使用默认发送处理程序。

可在创建发送端口时配置发送处理程序。


可在创建发送端口时配置发送处理程序。
在不知道应将消息发送到何处时使用。

在创建静态发送端口时指定传输类型和结束位置。


可以在业务流程和基于内容的路由方案中配置结束位置。 还可以使用规则来筛选消息的发送位置。
将单个发送端口用于向多个合作伙伴发送消息。

在创建静态发送端口时指定传输类型和结束位置。


通常会将动态发送端口添加到业务流程中。 属性将在业务流程逻辑中基于你指定的规则配置,可以将消息发送到多个合作伙伴。

创建静态发送端口

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

创建静态发送端口:

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

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

    重要

    静态 Solicit-Response 发送端口不能通过Windows SharePoint Services适配器进行配置。

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

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

    属性 说明
    适配器 Web Services 端口 “必需”。 托管 SharePoint Services 适配器 Web 服务的 IIS 网站上配置的端口。

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

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

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

    对 Windows SharePoint Services 适配器 Web Services 进行的适配器运行时 Web Services 调用的超时值(以毫秒计)。 如果消息或批的大小超过适配器预期的平均大小,则可能需要增加此值。
    使用客户端 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 站点的相对路径。 例如, 共享文档共享文档/采购订单/。 也可以将列表用作目标。 例如, Lists/Tasks。 如果指定列表,消息正文则不会和列表项一起保存。 从消息中提取的值将提升到 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 消息上下文属性。 相反,这两个值是合并的。
    Overwrite “必需”。 如果存在某个文件,则确定是否覆盖该文件。

    默认值为 “否”。 选项包括:

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

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

    • :按 原样保存文档。 二进制消息可以使用此选项。
    • 可选:修改文档,使其在 Office 应用程序中自动打开,如 InfoPath。 如果未找到处理指令,则按 原样处理文档。 二进制消息可以使用此选项。
    • 业务流程:使用业务流程中定义的值。
    • :修改文档,使其自动在 Office 应用程序中打开,如 InfoPath。 如果找不到处理指令,则会挂起消息。

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

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

    如果在 模板文档库中找不到解决方案,适配器将在 模板回退文档库中 查找匹配的 InfoPath 解决方案。 “模板回退文档库”和“模板文档库”字段可以与两组 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 可选。 输入要为此消息设置的栏值。 你可以键入文本值(例如“Purchase Order”),也可以键入表达式。 表达式可以包括文本、宏和 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 服务。 向 HostB 授予针对该 Web 服务的用户帐户权限。 这同时也会阻止其他主机帐户访问不需要访问的实体。

    • 单独的适配器:例如,有多个项目 (接收位置和使用 HTTP 适配器发送端口) 。 你希望与该 HTTP 适配器关联的一切内容位于自己的主机中。

    • 单独的业务流程:单个业务流程可以位于其自己的主机中。 例如,如果某个业务流程的内存或 CPU 使用率较高,则将该业务流程置于自己的主机中。

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

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

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

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

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

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

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

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

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

    其他发送端口主题:

    创建和配置发送端口

    创建和配置发送端口组

另请参阅

排查 SharePoint Services 适配器问题 配置 SharePoint Services 接收位置CSOM:SharePoint Services 适配器