intapp walls api：高效管理道德墙和敏感数据访问

Intapp Walls API 是一款功能强大的工具，用于管理道德墙并安全地控制对敏感数据的访问。开发人员可借助其强大的功能，实现事务团队的高效协作、成员资格管理以及保密要求的严格遵守。

Intapp Walls API 是一个基于 SOAP 协议的 Web 服务，提供与 Intapp Walls 应用程序交互的编程接口，并作为标准组件 Web 服务部署。

为简化说明，本文示例代码省略了错误检查、异常处理和日志记录等环节。示例仅供参考，并非最佳编码实践。

本文重点介绍两个核心场景：

1. 检索并列出事务团队成员。
2. 向现有事务团队添加新成员。

通过 Intapp Walls API 的操作（例如 getmatterteamformatter、loadmatterteam 和 adduserstomatterteam），您可以简化道德墙管理相关任务。以下示例包含代码片段和步骤指导。

本文档不包含 Intapp Walls API 开发访问权限配置的详细信息。但需注意，管理解决方案必须安装在本地环境，通常可通过名为 apiservice.svc 的文件访问 Web 服务，该文件应作为服务引用添加到 Visual Studio 中。

示例代码中用到的 Intapp Walls API 操作：

• getmatterteamformatter：获取指定案件关联的案件团队 ID。
• loadmatterteam：加载事务团队属性。
• getdmsuserid：获取 DMS 用户 ID。某些 API 方法需要用户的 DMS 用户 ID，例如 createwall() 方法需要 DMS ID，而非计时员 ID 或记录系统 ID。此方法用于在已知用户其他 ID 的情况下获取 DMS 用户 ID。
• loadmatterteammembership：加载案件团队成员资格。
• getwarningsifuserisincluded：获取授予特定客户端或事务访问权限（即包含）的用户可能生成的警告。此函数返回任何可能由冲突的道德墙生成的警告。
• adduserstomatterteam：将用户添加到指定角色的现有事务团队。

示例：检索并列出事务团队成员

以下代码片段使用 Intapp Walls API 的 getmatterteamformatter 和 loadmatterteam 操作检索事务团队成员列表，并将团队成员详细信息写入控制台。

说明：

• 使用 Intapp API 通常需要特定权限，通常授予具有适当 Intapp Walls 访问权限的服务帐户。
• 下列代码片段中对 “intapp_web_api” 的引用是指 Visual Studio 中定义的 Intapp API 服务引用名称。

步骤 1：检索唯一的 Intapp Walls 管理的事务团队 ID。

检索与指定事务关联的事务团队 ID。此案件团队 ID 将用于获取案件团队成员详细信息。调用 getmatterteamformatter 操作，该操作需要 matterid 参数。matterid 通常是内部生成的 ID，有时称为“案例编号”，由用户或程序员从其自身的计时员类型源提供。

string matterid = "01234"; // 您提供的 matterid
string matterteamid = string.Empty; // 返回值

// 获取 Walls 事务团队 ID
// 事务团队 ID 示例 "coole-033517"
matterteamid = intapp_web_api.getmatterteamformatter(matterid);

// ... (getmatterteamformatter 方法实现，与原文相同) ...

步骤 2：加载事务团队结果。

定义 loadmatterteam 方法，并使用 getmatterteamformatter 方法获得的唯一 Intapp Walls 管理的案件团队 ID 号 matterteamid 变量调用 loadmatterteam 方法来检索案件团队。迭代事务团队内的 usermemberships 集合，并将用户团队 ID 和角色输出到控制台。

// ... (loadmatterteam 方法实现，与原文相同) ...

matterteam the_matter_team_list = loadmatterteam(wallscaseteamid);

// ... (循环遍历 usermemberships 集合并输出用户信息，与原文相同) ...

示例：向现有事务团队添加新成员

以下代码片段演示如何使用 Intapp Walls API 检查现有团队成员身份，并在检查冲突后向团队添加新成员。

说明：

• 通过 Intapp API 操作 Intapp Walls 团队需要特定权限，这超出了本文档的范围。请求者还需要具有 Intapp Walls 中定义的 Intapp Walls 事务管理员角色。
• 使用 Intapp API 通常需要特定权限，通常授予具有适当 Intapp Walls 访问权限的服务帐户。
• 下列代码片段中对 “intapp_web_api” 的引用是指 Visual Studio 中定义的 Intapp API 服务引用名称。

(步骤 1-5 与原文相同，只是对语句进行了微调，使其更清晰流畅)

结论

Intapp Walls API 提供了一套全面的操作，用于管理事务团队成员资格和保护敏感信息。从检索团队详细信息到在检查冲突时添加新成员，这些 API 功能可以与您的工作流程无缝集成并遵守道德墙策略。通过正确的实施，管理事务团队将成为一个简化且高效的流程，以维护数据完整性。