本系列文章介绍了用于IBM®Blueworks Live的代表性状态转移（REST）应用程序编程接口（API），它提供了额外的功能，例如对存储在Blueworks Live中的业务流程信息的自定义报告。 Blueworks Live是IBM软件即服务（SaaS）产品，用于在云中对业务流程和业务规则进行协作建模。 REST是与服务器通信的方法，并且是基于SOAP的Web服务的替代方法。
第1部分介绍了五个使用REST API的常规用例，并概述了充分利用每种用例的方法。 本系列的其余部分将深入探讨这些方法，并展示如何基于实际示例来实现用例。
Blueworks Live是一个强大的流程建模平台。 它提供了用于协作流程建模的直观环境，以及用于流程和决策工件的云存储库。 Blueworks Live不仅仅是简单的流程建模工具，而且经常未被充分利用。
充分发挥潜力后，Blueworks Live可以成为整个组织的结构图，从高层部门分类到特定过程中各个步骤的细节。 它是您的过程资产的宏观描述，而不是孤立的过程的分组。 可以使用过程数据的金矿。 充分利用Blueworks Live帐户中包含的数据来优雅地采用Blueworks Live，可以为您带来以下好处：治理检查，仪表板，构建流程报告（如RACI矩阵和自定义SIPOC报告）的功能以及对文件进行排名和排序的能力量化投资优化过程。
此外，将该数据与其他系统数据集成在一起，使Blueworks Live成为了更广泛的企业体系结构引擎中的一环。 将先前断开连接的系统及其先前分离的数据进行组合，可以在组织范围内就业务术语和术语达成共识。 对于无需繁琐管理的自主流程，与Blueworks Live中的信息进行交互的范围超出了最终用户看到的用户界面。
来自Blueworks Live的信息需要与企业体系结构难题的其他部分共享，因此您发现您需要用于系统-系统集成的工具，以及用于海量信息提取和整合的方法。 这些工具已经存在，但经常没有得到充分利用。 Blueworks Live具有广泛的API集，您可以使用这些API使Blueworks Live中的信息和服务可用于组织中的其他应用程序。
本文介绍了API提供的功能，如何使用它们，以及最重要的是为什么我们都应该使用它们。
在Blueworks Live中使用流程资产数据的完整方法
您可以从Blueworks Live中提取什么价值，为什么要关心呢？ 将数据锁定在Blueworks Live中很好。 但是，获取这些数据以填充其他工件或进行各种分析活动，对您的业务将是巨大的帮助。
在解决如何在Blueworks Live之外使用数据之前，请考虑您想要这么做的原因 。 查看来自Blueworks Live客户的以下五个示例，这些示例展示了使用Blueworks Live中的流程资产数据的完整方法可以实现的目标。
治理检查用例
在协作环境中，有时不清楚何时对流程进行完全建模并准备发布。 许多编辑人员在处理该过程，并且它没有根所有者。 因此，没有用户无所不知地知道一个过程是否准备好发布并与查看者社区共享。 而且，大多数组织都有正式的治理程序来发布流程，其中包括各种检查，各个个人需要完成这些检查以确保流程准备就绪。
例如，“该过程是否完整记录？” 这是一个显而易见的问题，但不是一个容易回答的问题。 完整记录流程的标准是什么？ 答案可能是主观的，每个评论者都不同。
通过浏览和使用流程蓝图数据，您可以基于自定义条件设计结构化的系统，以查看流程文档的级别。 例如，您可以提取这些数据并在Microsoft Word中对其进行分析。 您可以设计Microsoft Excel公式模板来计算指标，例如以下示例：
- 流程说明的长度
- 包含非空文档部分的活动的百分比
- 某些标签的存在
- 特定活动类型与默认正常活动类型的比率
- 具有确定的投入/产出的活动百分比
- 具有确定成本和其他属性的活动的百分比
每个度量标准都可以计入流程完整性分数，并且要批准发布，流程需要特定的完整性分数。 您可以快速构建可靠且一致的治理检查系统，以确保已发布流程的特定级别的完整性。
用户管理用例
大型团队面临的一大挑战是管理Blueworks Live用户许可证。 艰巨而昂贵的任务包括跟踪配置请求访问Blueworks Live的新用户，以及取消配置不再使用它的用户。
一种常见的做法是分别向用户发送电子邮件，询问是否仍需要访问（并依靠其回答的诚实性），然后通过用户界面手动取消提供用户帐户并重新分配许可证。 这种方法效率低下且耗时。
如果您可以通过提取用户登录信息和用户许可证信息，然后构建一个系统来自动检查用户登录率并从非活动用户向新请求者重新分配许可证，来使该过程更加自治，该怎么办？
例如，您可以制定一条规则，如果用户两个月未登录，则会取消他们的配置。 或者，您可以使用更复杂的规则集，例如在滚动期内的最小登录数（以停止“我今天应该登录以保持许可证”的心态）。 更好的是，如果系统自动设置新用户帐户，则可以避免Blueworks Live管理员通过Blueworks Live用户界面单独设置和取消设置用户的麻烦。 这种方法可以加快管理员的工作速度，尤其是在需要批量配置时！ 这种自主的或辅助的用户管理可以为Blueworks Live维护成本带来可观的节省。
在BwlSamples / BwlBulkRegistration上查看GitHub上的Blueworks Live Bulk用户注册。
流程级自定义报告用例
如果流程记录了所需的供应商，输入，流程，输出和客户（SIPOC）信息，则Blueworks Live会自动为每个流程生成一个SIPOC报告。 Blueworks Live的默认功能不包括创建满足特定需求的自定义报告，也不创建负责，负责，咨询和告知（RACI）的矩阵。 但是，报告的所有信息都在工具中，这仅仅是将其发布并放入适当格式的问题。 例如，其他活动属性与RACI属性同义（例如，参与者=负责，专家=咨询）。 如果这些属性不能满足您的需求，则可以简单地创建一些自定义属性。
将数据输入到Blueworks Live之后，诀窍就是将其发布并构建所需的资源。 一个简单的示例是流程蓝图的Excel导出，它可以全面提取流程中的数据。 您可以创建一个模板Excel工作表，可以将其作为其他工作表粘贴到导出的报告中。 然后，通过从导出中获取适当的值来为每个过程构建自定义报告。
仪表板用例
Blueworks Live中的流程分析涵盖了最常见的需求，但是自然而然地专注于流程级别。 您如何轻松地查看和使用帐户范围的信息，例如带有特定选项卡的进程数和特定策略的使用数，而不必在粒度级别上浏览Blueworks Live用户界面？ 所需的数据在Blueworks Live中，但分析和导航在宏观级别上并未优化：用户界面侧重于在流程级别上显示信息，但要查看更广泛的端到端流程并不容易数据视图。
解决此问题的方法之一是帐户级仪表板。 通过从Blueworks Live中提取数据，然后在数据之上构建自定义仪表板（使用现有技术），您可以可视化数据，以便在流程资源级别轻松进行探索。 以下仪表盘类似于使用Blueworks Live的大型英国组织当前正在使用的仪表盘。 仪表板提供了有用的可视化效果，并且可以轻松导航大量数据，从工件和用户的数量到使用某个标签或属性值的流程的数量。
通过这种方法，您可以省力省力，最新的仪表盘来进行过程状态分析，这些仪表盘显然成为进行过程分析和过程改进的有价值的工具。
量化和排序流程用例
如果组织使用的是Blueworks Live，则该组织可能会进行某种流程转换，该流程将按原样映射流程以发现当前任务的运行方式，然后映射将要处理的流程以解决这些问题。未来。 为了帮助确定哪些流程将重点放在您的转型工作上，相对于资产中的其他流程，量化用于改进特定流程的业务收益。 自然，有些流程比其他流程更有效，但是某些流程比其他流程更快速，更便宜地进行重新设计和改进。 决定哪种方法可提供最大的收益，而成本和时间却具有挑战性。
您可以使用过程文档中包含的大量数据来帮助基于自定义条件对过程进行相互排名，然后创建简短列表以进行仔细检查。 选择您的条件，按重要性对其进行排名，然后进行比较。 Blueworks Live提供了一些指标，可用于确定流程的成本和重要性：诸如成本，参与者数量，系统，链接的流程数量之类的通用属性，以及诸如流程变更数量，流程更新数量之类的不常用属性，并创建日期。 您可以使用其他指标来确定当前哪些流程效率低下，例如增值，投入/产出和风险。 通过利用这些数据并进行一些比较分析，您可以突出显示最适合进行转换的流程。
例如，假设您有预算来改进流程清单中的两个流程。 首先要考虑的标准之一可能是流程的大小。 过程大小的定义因行业而异。 金融服务组织可以确定流程参与者的数量。 零售组织可能会将规模视为每个流程的投入和产出量。 这两个示例均使用Blueworks Live中作为文档属性包含的数据。 您只需导出一小段流程并对文档属性进行排序，就可以确定您的组织认为哪个流程在您的资产中最大。 下图显示了一个空白区域，表示您的流程资源，流程显示为大小范围的圆圈，以表示size属性：
考虑进一步比较以添加到该图像。 下表提供了更多示例，这些示例使用Blueworks Live数据对流程进行排名以集中精力进行优化的方式：
| 标准 | 如何测量 |
|---|---|
| 流程规模 | 参加人数 |
| 废物量 | Blueworks Live中的“增值流程”属性 |
| 自动化机会 | 带系统泳道的活动数和以Excel输入/输出开头的进程数 |
| 整合机会 | 流程链接级别 |
| 合理化机会 | 流程间相似度 |
很难确定如何将这些正交变量相互比较。 石头长到弦长吗？ 这是一个棘手的问题，在权衡这些因素时总会有一些猜测。 但是，如果您对这些变量之间的相对权重进行了有根据的猜测，则可以得出具有实际意义的基本（“ T恤尺寸”）估算值。 请记住，这里的目的不是要确定转换预算的绝对清单。 相反，此技术可以识别简短列表，您可以对列表进行更详细的专家分析以得出结论。
如果要向此图中添加其他变量，而不是使用其他同心圆，请选择与面积大小（例如颜色或边框粗细）不可比拟的可视化效果。 这种方法最能说明问题。 最终，您可能会得出一种如下图所示的方法：
即使在这种简化的总体水平上，您也可以开始估算哪些流程比其他流程更适合进行优化。 乍一看，仅比较过程大小时，图中最下面的两个过程是显而易见的选择。 现在您已经进一步构建了图片，顶部中间过程似乎是一个更好的选择。
这项工作只是一个图表。 但是，这代表了通过Blueworks Live正确提取和使用正确数据所能实现的方法。 也许最简单，最熟悉的这种分析工具是Excel。 从Blueworks Live中获得数据后，可以将其放入Excel中的合理结构中。 然后，通过为每个标准分配权重并为每个过程计算总体优化收益来开始排名分析。
您能采取更优雅的方法吗？ 本系列的第5部分探讨了可能性的艺术，并给出了一个定制Web应用程序的示例，该应用程序基于从Blueworks Live提取的数据来构建有用的可视化。 前面的图只是一个示意图，但是第5部分介绍了一个可操作的版本，并不太相似。
通过在Blueworks Live中适当使用数据，您可以获得强大的见解，并且可以在更短的时间内得出更深刻的结论。 上面所有示例的问题是“如何尽可能高效地从Blueworks Live中获取正确的数据？”
使用API从Blueworks Live提取数据的方法
本文前面的部分仅描述了这些概念。 现在考虑从Blueworks Live提取数据的实用方法。
最明显的方法是通过Blueworks Live用户界面使用各种Excel导出，然后将数据合并到Excel中并完成分析。 这种方法是可行的，当然值得付出努力，但不是最优雅的选择。 您无法通过用户界面访问Blueworks Live中提供的大量信息，并且可能不需要空间中的某些信息以及正在导出的信息。 这种方法不是使用和从Blueworks Live数据中获取洞见的最有效方法。
Blueworks Live具有一组广泛的REST API，您可以使用它们从Blueworks Live获取数据或将数据推送到Blueworks Live，而无需使用Blueworks Live用户界面。 好处是，如果您知道要从Blueworks Live获得的信息，则可以更快地访问信息。 另外，某些数据仅可通过API获得，因此此方法增加了可供使用的信息总量。 API库中可用的数据包括用户管理，组管理，工件详细信息，文件管理，工作管理。 您基本上可以检索或编辑Blueworks Live帐户中的所有信息。 API是用于在Blueworks Live帐户之外扩展Blueworks Live中数据值的强大工具。 例如，前面描述的所有用例都部分或全部使用API来与Blueworks Live数据进行交互：
- 对于治理检查，您可以使用Blueworks Live API仅检索您感兴趣的数据，而不是常规的Space导出或Process导出。 而且，您可以比登录Blueworks Live并导航到特定的空间或进程更快地检索它。
- 对于用户管理，您可以使用各种Blueworks Live用户管理API来检索用户信息，例如用户的登录日期和许可证类型。 此外，您可以从用户取消供应许可或将其供应给另一个。 使用这些API，您可以构建一个可以自动运行的系统，并根据上次登录日期为您的组织预配和取消预配用户。 该系统可自动执行大量传统上手动的流程，并且无需单独向用户发送电子邮件以评估他们对该工具的持续业务需求。 这种方法允许批量设置和取消设置，而不是通过UI单独处理每个用户更改。
- 对于SIPOC图或RACI矩阵的自定义扩展，可以使用Blueworks Live API进行流程导出，这可以快得多，尤其是一次要进行多个导出时。
- 对于仪表板，您可以通过Blueworks Live用户界面创建许多空间导出，然后合并数据，但是这种方法需要从Blueworks Live导出大量数据并将其插入仪表板工具。 更为复杂的是，从Blueworks Live中取出数据后，它是静态的，而不是实时的。 需要频繁重复导出以确保仪表板中的数据可靠，如果每次需要手动导出此数据，则可能很快成为负担。
但是，如果您以编程方式调用API，则可以自动化导出数据的过程（并有可能以仪表板所需的格式和位置来获取数据）。 例如，一个位于作业调度程序上的小脚本可以定期运行而无需人工干预，从而调用Blueworks Live API来收集大量数据，例如帐户中每个流程的流程导出。 然后，脚本可以转换结果并将其存储在适当的位置。 此外，您可以确保在处理大量数据时，不会导出不需要的数据。 这种方法使数据提取效率最大化。 通过使用API，您可以挑选所需的特定数据。
- 为了量化和排序流程，类似于准备仪表板，您可以选择所需的确切数据（基于预定义的自定义条件），然后使用API提取这些数据。 然后，您就可以进行分析了，而无需浏览Blueworks Live用户界面，也不必担心空间和进程导出过多。
API已针对与系统之间的通信进行了优化。 当将它们用作自动化系统的一部分（例如自定义应用程序）时，它们确实功能强大，在该系统中，可以以编程方式和迭代方式调用API。 然后，您可以配置应用程序以组合多个API响应，并以可视上有用的格式将其呈现给所有用户。 天空才是极限。
使用Blueworks Live API的模式
现在，考虑一下入门方法。 您可能具有流程建模和Blueworks Live的经验，并且您可能是一名业务分析师，可能没有深厚的IT技能或对如何利用API的了解。 Blueworks Live本质上是一种业务工具，是一项即服务的产品，因此通常不需要利用IT团队来部署或使用Blueworks Live。 业务用户可能面临一个困境，他们希望能够使用API来实现上面列出的某些优势，但是却不知道如何。
无论您是否有使用API的经验，该系列文章都为您提供了成为Blueworks Live API专家所需的全部知识。 该系列涵盖了要使用的工具和API请求示例。 使用Blueworks Live API的三种主要模式：
1.通过本地脚本，程序或本地REST测试人员
下图显示了第一个模式。
在第一个模式中，您从本地计算机发出API请求，以从Blueworks Live云中提取数据并将其保存在本地。 您可以通过以下两种方法之一来完成此方法：
- 本地REST测试程序，例如Postman或SoapUI ，它允许一次性的API请求并通过有用的用户界面显示响应，而无需编写代码。 请参阅本系列的第2部分。
- 发出单个或多个API请求，收集响应并将其以某种形式保存到指定位置的自定义脚本或代码段。 该脚本可以手动执行，也可以设置为定期运行。 请参阅本系列的第3部分和第4部分。
两种方法都有用例。 REST测试人员在将API编译为脚本之前会对其进行正确的测试，并且还会逐案进行一次调用，以收集较慢收集或无法通过UI使用的信息。 示例包括访问用户活动信息，搜索和收集特定工件的数据，以及下载特定流程PDF或BPMN2.0文件。
脚本方法的优点是仅执行一次脚本即可发出多个API请求或多次重复同一API请求。 此方法非常适合批处理任务，例如基于上次登录日期的批处理供应或取消供应许可证，以及为帐户中的所有空间收集和存储.xls导出。
2.通过申请
这种模式从Blueworks Live中提取数据，并将其推送到本地或集中式应用程序上运行的预构建应用程序中。 可以将此模式视为脚本方法的扩展，在脚本方法中，您有一个定制应用程序来组合API请求。 然后，通过在顶部添加一个自定义用户界面来扩展此应用程序，该界面提供给所有用户各种控件来决定他们要发出的API请求或API请求的组合，以在有用的可视化视图中查看API响应是否通过用户界面。
可以将其视为捆绑API请求的一些预先配置的配方以及响应的预先设计的表示，企业用户可以随意访问和触发。 这种模式的示例包括先前描述的仪表板或量化和排名过程。 您可以在从API请求收集的数据之上添加有用的可视化效果，以使业务用户可以在以有用的方式显示数据之后浏览数据。
这种方法对访问中央托管应用程序的许多用户也非常有用。 特别是如果该应用程序提供了Web界面，以便用户仅需要使用其正常的Web浏览器，就像使用Blueworks Live一样。 这样，他们可以简单地停留在熟悉的工作环境中，并在Blueworks Live和扩展应用程序之间无缝切换。 下图描述了此方法的特定变体：
本系列的第5部分讨论了示例实现及其详细信息。
3.通过系统间集成
最终模式是完整的系统到系统集成：通过组成系统的API进行数据共享，如下图所示：
一个系统具有一个运行时环境，您可以将其配置为向另一个系统发出API请求并使用响应。 该过程可以通过集成总线或提取，转换，加载工具进行，也可以是点对点的。 结果是许多系统都共享并使用彼此的数据的体系结构。 这种方法可以真正整合业务词汇表，在许多系统中实施标准化和统一的术语。
由于Blueworks Live没有运行时环境，因此它不能向其他系统发出API请求，但是您可以从Blueworks Live中提取数据，然后通过集成总线或某些其他中间件体系结构将其推入另一个系统。 这种方法允许合并数据，或不同系统之间真相的单一版本。 例如，您可以定期从Blueworks Live获取用户列表和词汇表术语，并在组织的企业体系结构工具中共享，从而使Blueworks Live成为更广泛的企业体系结构引擎中的一员。
结论
本文介绍了实际用例，以说明如何从Blueworks Live流程资源中获取最大的业务价值。
在Blueworks Live帐户的整个生命周期中都会添加大量信息。 通过Blueworks Live用户界面查看和使用此信息非常有用，具有许多优点。 但是，如果您提取信息以在Blueworks Live之外使用，则可以极大地扩展优势。
您学习了使用Blueworks Live工件数据创建资产的方法，这些资产可以创建自定义报告，RACI矩阵和仪表板等。 您遵循了一个访问数据以减少管理员和管理开销的示例。 您还看到了用于治理检查和流程识别的辅助方法，这些方法是通过从Blueworks Live环境中提取和分析数据来进行改进的良好候选者。
本教程介绍了所有数据收集和提取背后的工具：Blueworks Live REST API库，可供Blueworks Live管理员用户使用。 本系列的下一部分将探讨如何使用Blueworks Live API并演示第1部分中描述的模式的功能和潜力。
转到第2部分继续。
致谢
作者要感谢Barclays的Mark White和David Elliott以及IBM的Rolf Riedlinger对本文的评论和评论。
翻译自: https://www.ibm.com/developerworks/library/mw-1706-weeks/1706-weeks.html
1955
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
