Use Custom Widgets
You can use custom widgets, which extend the functionality of SAP Analytics Cloud and complement the standard palette of widgets according to your needs.
As a developer you can build your own widgets in addition to the widgets delivered in SAP Analytics Cloud. For more information, see SAP Analytics Cloud Custom Widget Developer Guide.
Upload a Custom Widget to SAP Analytics Cloud
Follow the steps to upload a custom widget to SAP Analytics Cloud so that you can use it as other widgets in your story.
Prerequisites
Please note that you need the appropriate permission to create and upload custom widgets. For more information, see Standard Application Roles and Privileges and Permissions.
Procedure
- On the Stories start page, choose the Custom Widgets tab.
- Select (Create).
- In the Create Custom Widget from File dialog, choose Browse... under JSON File.
- Select the custom widget JSON file from your device.
- Choose Create.
Results
Next Steps
Every custom widget has a version number in the format majorVersion.minorVersion.patchVersion defined in its original file, for example, 1.0.0. You can add different major versions of a custom widget to SAP Analytics Cloud at the same time, for example, versions 1.0.0 and 2.0.0.
However, when you add a custom widget that differs in minor version from the one present in SAP Analytics Cloud, it replaces the present one. For example, if a custom widget of version 1.5.0 exists in SAP Analytics Cloud, then adding either version 1.4.0 or 1.6.0 replaces version 1.5.0.
References Between Stories and Custom Widgets
Exported archives of stories by default contain all referenced custom widgets.
If you use a custom widget in a story that is transported between different SAP Analytics Cloud systems, the story archive automatically includes the referenced custom widget as it works for models. In this way only one archive needs to be imported to the target system to get the story up and running.
You can know which stories are actively using a custom widget when you try to delete it from an SAP Analytics Cloud system in the Custom Widgets tab. The Delete Custom Widgets dialog lists all related stories and warns you that deleting the custom widget breaks them.

