添加/编辑数据提供者

每当您请求创建新的数据提供者或编辑现有数据提供者时，都会显示“添加/编辑数据提供者屏幕。在两种模式下，该屏幕的行为相同，唯一的区别是，在“编辑”模式下加载屏幕时，将显示所选数据提供者的详细信息。

当您选择添加新的数据提供者时，屏幕最初将显示如下内容：

为了方便您操作，“添加/编辑数据提供者屏幕会尽可能为每个字段填充默认值；如果默认值不正确，只需覆盖即可。因此，每当“提供者”值更改时，许多其他字段也会设置为新提供者的默认值，例如数据提供者的前缀，如下图选择Enterprise Architect时所示：

注记：定义数据提供者时，有许多必填字段（用“*”表示），需要输入值才能保存数据提供者。

数据提供者设置

物品	描述	也见
已启用	默认值：未选中此值控制集成服务器(SBPI.exe) 是否应允许将通信转发到此数据提供者。
名称	此值代表当前提供者的友好名称。它将显示给Enterprise Architect的用户。
提供者	此值指定当前数据提供者的提供者类型；仅可使用受支持的值。如上所述，每当此值更改时，许多其他字段将自动更新，以方便用户输入数据。
前缀	此值表示用于标识当前数据提供者简短唯一名称。此值将保存在每个链接到外部元素Enterprise Architect元素中。
团体	仅当选择“自定义集成”提供商类型时，此字段才可用。通常在Enterprise Architect中，集成按提供者类型（例如“ Jira”或“ Dropbox”）分组。对于自定义集成，将根据此字段中输入的值进行分组。
最大请求时间	仅当选择“自定义服务”提供商类型时，此字段才可用。此值表示对提供者系统的调用在超时之前等待的最长时间（以秒为单位）。当提供者系统位于远程或性能较慢时，增加此值特别有用。默认值为 60 秒。注记：这是专业云服务器v4.2 build 65中引入的新设置。

集成插件设置

这组设置定义了集成插件和集成服务器之间的关系以及两者如何交互。

物品	描述	也见
自动开始	默认值：已选中此值控制集成服务器(SBPI.exe) 是否应为此数据提供者维护正在运行的进程 (*sbpi.exe)。对于标准集成插件我们希望检查该值；但是，对于自定义插件，不要自动启动插件，而是手动控制其运行时间，尤其是在开发插件时，可能会很有用。
端口	默认值： 8081 该值表示集成服务器应用于与集成插件进行通信的端口。集成服务器假定端口相对于当前计算机（或 http:// localhost :{port}）。每个集成插件都需要一个唯一的端口号，当尝试保存插件的设置时将检查该端口号。但专业云服务器只能检查专业云服务器本身及其组件使用的端口，仍然存在与其他应用程序发生端口冲突的可能性。
协议	此值表示集成服务器用来与集成插件通信的协议；在最简单的配置中，这将是“HTTP”。
DLL 路径	此字段仅适用于“定制服务”、“定制集成”和“翻译”提供商类型。此值表示自定义 DLL 的物理路径，该路径将由 CustomService.exe 或 CustomIntegration.exe 数据提供者进程调用。为方便起见，应用程序使用 .\SBPI\Custom\ 文件夹 (C:\Program Files (x86)\ Sparx Systems \专业云服务器\SBPI\Custom\) 中存在的所有 .DLL 文件填充下拉列表。

自定义属性

自定义属性部分仅对“自定义服务”类型的数据提供者显示。

物品	描述	也见
自定义属性列表	列出自定义数据提供者的当前属性。
添加	此按钮显示“添加 SBPI提供者自定义属性”屏幕，并允许输入定义为项目/值对的新自定义属性。
编辑	此按钮显示“编辑 SBPI提供者自定义属性”屏幕，并允许修改现有自定义属性定义。
删除	此按钮将从当前数据提供者中永久删除选定的自定义属性。

提供者服务器设置

这组设置定义了外部数据提供商的详细信息，例如 Dropbox、Jira 或 TFS。集成插件将使用定义的详细信息连接到远程系统并从中检索数据，以便将其发送回Enterprise Architect 。“协议”、“服务器名称”和“端口”的组合必须能够由托管集成插件的服务器解析，最简单的情况是专业云服务器。

物品	描述	也见
协议	该值表示集成插件用于与外部数据提供者进行通信的协议。注记：大多数在线云托管提供商都需要https和端口443。
服务器名称/IP	该值表示集成插件用于与外部数据提供者进行通信的服务器名称或 IP 地址。
端口	该值表示集成插件用于与外部数据提供者进行通信的端口。注记：大多数在线托管帐户通过https运行，这需要 443端口。自托管服务器将取决于各个服务器的配置。 Jazz：服务器默认使用http端口9080或者https 9443 Jira：自托管服务器默认端口是http端口8080 Confluence：自托管服务器默认端口是http端口8090
基本 URL	一些外部数据提供商允许在单个位置存在多个存储库的概念；对于此类数据提供商，此字段充当过滤器。例如，可以使用另一个Enterprise Architect模型作为外部数据源；在这种情况下，“协议”、“服务器”和“端口”确定专业云服务器（例如，http://myEAServer:804），而“基本 URL”是存储库 (myModel) 的 DB别名。因此： http://myEAServer:804/myModel 特定提供商的详细信息： Confluence：在线云托管帐户要求将其设置为“wiki”；自托管服务器将取决于单个服务器的设置 Jira：对于在线云托管帐户，此项应为空白；自托管服务器将取决于单个服务器的设置 Dropbox：此项应留空 Enterprise Architect ：这应该是目标Enterprise Architect模型的“模型别名”
最大请求时间	此值表示对提供者系统的调用在超时之前等待的最长时间（以秒为单位）。当提供者系统位于远程或性能较慢时，增加此值特别有用。默认值为 60 秒。注记：这是专业云服务器v4.2 build 65中引入的新设置。
验证	默认值：凭证此值允许选择应该用于提供者的身份验证类型，有效选项为凭据和 OAuth。当选择“凭证”时，需要输入用户名称和密码。当选择“OAuth”时，预计将在数据提供者高级身份验证屏幕上填写高级验证选项。注记1 ：此选项仅在所选提供者支持多种身份验证形式时启用，例如：Dropbox、Jira、 Salesforce 、ServiceNow、SharePoint 和 Wrike 注记2 ：此选项是在专业云服务器v5.0 build 100中引入的，之前的版本仅支持基于凭据的身份验证。
用户名称	此值表示用于访问外部系统内数据的用户名（与密码结合使用）。如果在此字段中定义了值，则当前数据提供者的所有Enterprise Architect用户将使用同一组凭据来读取外部系统。否则，如果用户名字段留空， Enterprise Architect将分别提示每个用户输入其凭据。仅当选择“凭证”身份验证时才会显示此值。注记：对于许多在线云帐户，用户名可以是该帐户的电子邮件地址。
密码	该值表示与“用户名称”字段中指定的用户名匹配的密码。仅当选择“凭证”身份验证时才会显示此值。注记：对于 Atlassian云托管的帐户（Jira、Confluence），常规密码已被 API 密钥取代。请参阅 Atlassian 文档，了解如何获取 API 密钥并将其粘贴到密码输入框中。
高级...	此按钮用于显示数据提供者高级身份验证屏幕，并且仅在选择 OAuth 身份验证时可见。
创建项	默认值：未选中此复选框控制Enterprise Architect用户是否能够在外部系统中创建新项目。
修改项	默认值：未选中此复选框控制Enterprise Architect用户是否能够修改外部系统内的外部项目的详细信息。
发表讨论	默认值：已选中此复选框控制Enterprise Architect用户是否能够针对外部系统内的元素创建讨论。
忽略 SSL 错误	默认值：未选中此复选框控制集成插件是否应忽略与外部系统通信时发生的 SSL 相关错误。

日志记录设置

这组设置定义了集成插件如何在其log文件中创建条目。由于集成插件无需用户干预即可运行，因此能够将任何消息或潜在问题报告写入log文件非常重要。但是，必须特别考虑确保写入此类文件不会影响性能，如果log文件持续无限制地增长，则可能会影响性能。期望需要手动干预来确保log文件的大小和数量不会影响性能也是不合理的。因此，每个集成插件都有自己的一组log文件和配置选项来管理这些log文件。

当前log文件的文件名末尾始终包含“ 1 ”。每当集成插件启动或当前log文件的物理大小达到“最大文件大小”时，都会创建A新的log文件。发生这种情况时，所有现有文件都将被“滚动更新”，这意味着它们的文件编号将递增，并创建一个新的“{filename} 1 . log ”。如果滚动更新过程导致存在的文件数量超过“文件计数”设置允许的数量，则这些额外的文件将被删除。

物品	描述	也见
文件数	默认值：3 此值表示应为当前集成插件保留的log文件的“滚动”数量。
最大文件大小	默认值：1048576 此值表示在创建新log文件之前log文件可以达到的最大大小（以字节数为单位）。
等级	默认值：警告此值表示应写入log文件的消息的最高级别。级别包括：OFF、致命、警告、信息和 SYSTEM。定义的log A包含所有较低级别；因此，如果将插件的log级别设置为信息，则所有致命、警告和信息消息都将写入其log文件。
目录	（只读）此字段显示当前数据提供者的log文件保存目录的物理位置。

代理设置

这组设置定义了当外部数据提供者被代理服务器分隔时，集成插件应如何与外部数据提供者进行通信。

物品	描述	也见
服务器名称/IP	代理服务器的服务器名称（或IP）和端口号；例如，proxyserver.com:3131
旁路	此字段为某些地址提供了一种绕过代理的机制；它接受以分号 (;) 分隔的多个值。例如：192.168.;.localdomain.com;www.mydomain.com
用户名称	如果代理服务器需要凭据，则此字段提供用户名。
密码	如果代理服务器需要凭据，则此字段提供用户密码。