About Composites

What's Composite

A composite is a combination of widgets with configured data and scripting elements, which can be reused across optimized stories. It can be a unified corporate header or footer, page navigation panel, collapsible section with visualizations, or chart with a button to switch to another chart type or table view. With composites ready to be used in stories, story designers and developers spend less time building stories, and they can do further actions and customizations on the composite as a whole as well, such as changing styling and adding scripts.

You can create a composite and then import and directly use it in your optimized story as other SAP Analytics Cloud built-in widgets.

If you'd like to create composites, refer to:
- Create a Composite
- Define Interface Functions and Events in Composites (advanced mode)
- Navigate Within Composites: Check out what's available for creating your composite.
If you'd like to use composites in Optimized Story Experience, refer to
- Use Composites in Your Story Design (Optimized Story Experience)
- Add Scripts to Your Composites (Optimized Story Experience) (advanced mode)

Permissions and Roles

Here're composite related permissions:

To create a composite, ensure that you have the Create permission for the object type Composite.
To import and use a composite in stories, ensure that you have the Read permission.
To modify a composite, ensure that you have the Update permission.
To delete a composite, ensure that you have the Delete permission.
To share a composite, ensure that you have the Share permission.

Here's an overview of the default composite permissions available to different roles:

Role	Create	Read	Update	Delete	Share
Application Creator	Yes	Yes	Yes	Yes	Yes
BI Content Creator	No	Yes	No	No	No
BI Content Viewer	No	Yes	No	No	No
BI Admin	Yes	Yes	Yes	Yes	No

Manage Your Composites

Composites are saved as files, and you can find and manage them in  Files.

For example, you can edit details, share, delete and favorite a composite:

Select  (Edit Details) to edit the composite name and description.
Select  (Share) Share... to share the composite with other users or teams.
Select  to delete the composite from the file repository.
When hovering over the composite, select  (Add to Favorites) to add the composite to favorites.

References Between Composites and Optimized Stories

Delete Composites from File Repository

When you delete a composite from file repository, if it's used in stories, you receive a warning that reminds you of it with all the affected stories listed:

If you proceed to delete the composite, the references between it and the stories are lost, and the composite aren't loaded in the stories and are displayed as a placeholder. The composite is no longer in Assets panel or Insert menu, while you need to delete it from the stories.

Modify Composites

If a composite's modified while it's actively used in stories, the stories get updated when reloaded.