深度探索 | 轻松入门SAP分析云脚本编写（ 三）

[LinnaZhang]

SAP 分析云提供了强大且丰富的图表样式和交互方式来满足用户对于数据可视化以及企业计划的需求。在实际应用中，我们的用户对图表的交互有时会有更定制化的需求，比如希望创建隐藏和显示图标的按钮。因此，SAP 分析云提供了脚本功能来进一步提高图表和交互的定制程度。 

本系列文章将继续分享在 SAP 分析云中通过简单的脚本代码实现增强故事功能的实践经验，旨在帮助没有深厚编程背景的用户学习SAP分析云故事中的脚本编写。如果您对之前的文章感兴趣，请查看文章末尾的合集。

一、前言 

在之前的两篇文章中，我们分享了如何通过按钮在图表和表格之间切换显示、如何让用户在运行时动态添加或修改表格的维度和度量，以及如何通过简单的脚本元素来帮助你提高故事的美观程度。接下来本文将介绍如何使用脚本将故事快速还原到初始化状态。 

在使用 SAP 分析云进行数据分析和可视化时，确保用户能够快速将故事（Story）恢复到初始状态是提升交互体验的重要手段。然而， SAP 分析云并未提供直接的脚本方法（例如 application.reset()）来实现这一功能，因此需要通过其他方式设计一个“重置”功能。本文介绍了一种基于书签（Bookmark）功能的实现方法，该方法以最小的代码量实现了故事状态的快速还原。 

此方法通过书签功能将故事的初始状态保存下来，随后利用脚本触发书签的应用，以此实现故事的重置。相比其他可能涉及复杂逻辑的实现方式，这种方法操作简单，易于部署，适用于各种 SAC 故事场景。 

二、 创建故事并启用书签功能 

首先，我们需要在 SAC 中创建一个优化设计体验的故事。故事可以包含图表、过滤器或其他组件，无论故事的复杂程度如何，均可支持此功能。 

在完成故事的基础设计后，需要启用书签功能。具体步骤如下： 

• 打开 故事设置； 

• 进入查看时间设置并找到书签，点击书签； 

• 在弹出的设置窗口中，选择“故事中的所有部件”。 

接下来，我们需要保存一个用于记录初始状态的书签。具体操作如下： 

• 进入故事的“查看模式”或“演示模式”。 

• 调整过滤器、图表等组件至初始状态。 

• 在工具栏中点击“将当前状态加为书签”，打开书签设置窗口。 

• 同时勾选以下三项：  
  • 保存过滤器状态 
  • 保存图表状态 
  • 保存所有其他组件 
• 为书签命名（例如“初始状态”），并点击保存。 

保存完成后，可以通过工具栏的书签选项验证是否能够正确恢复初始状态。 

三、提取书签的 URL 参数并添加重置按钮 

在应用书签后，浏览器地址栏的 URL 会出现 bookmarkId 关键字，例如： 

https:// SAP_Tenant/……/?bookmarkId=28326505-3931-4259-8600-416153831322&mode=view 

其中，“28326505-3931-4259-8600-416153831322” 是书签的唯一标识符。 

打开故事的编辑模式，添加一个按钮作为重置功能的触发器。之后在按钮的脚本编辑器中输入以下代码： 

// 应用书签以重置故事状态 
Bookmarks.apply(28326505-3931-4259-8600416153831322');  

上述代码中的参数为书签的唯一标识符。 

保存故事后，可以对其功能进行验证。例如，随意调整过滤器或修改其他组件的状态，然后点击“重置”按钮。系统会自动应用初始状态的书签，快速恢复到原始设计状态。 

四、总结 

本文主要介绍了在 SAC 故事中，通过使用书签功能和简单的脚本，能够有效地实现 SAP 分析云中故事状态的重置。该方法操作简便，兼具灵活性和实用性，适合多种场景。此外，本系列的下一篇文章将继续探讨如何通过添加脚本元素来增强视觉效果和用户体验 。 

祝编码愉快！ 

原作者：Daniel_Davis

原文链接：Start Your scripting Journey The Easy Way With SAP Analytics Cloud | Part Three