New Card Upload Process and Role-based Filtering of Cards in Work Zone Adv

[jinghe]

Background

From SAP Build Work Zone, advanced edition U2404 Release, Cards are now supported as a visualization type of local apps and are maintained in the Content Manager. 

It is no longer possible to manually upload standalone cards or update cards through the Admin Console. Remaining functionality in the Admin Console is configuring the card and enabling/disabling the card.

• It is no longer possible to directly deploy a card created via the Development Tools for SAP Build Work Zone extension in SAP Business Application Studio to the subaccount.

Card Management

1. Go to Content Manager 

With the admin access, you can go to Work Zone Adv system -> Admin Console. Go to the Business Content Tab -> Open Content Manager.

2. Upload Card

You can package and download the card zip from the Development Tools for SAP Build Work Zone extension in SAP Business Application Studio. 
In Content Manager, Click Create -> App

In App Creation, directly go to Visulization Tab, Choose Visualization Type as "UI Integration Card" and Upload Card zip.

3. Setup Role Filtering

3.1 Make Card Available to All Users

To make this card available to all users, you need to assign Everyone role to the app.
In Content Manager -> Find out Everyone Role -> Edit -> Toggel On your app.

        

3.2 Make Card Available to subset Users

To make this card available to a subset of users, you need to create your own role, assign your app to your role, assign your role to the Work Zone site and assign your role to the requied users in the BTP Subaccount.
In Content Manager -> Create -> Role -> Toggel On your app.

      .     

Go to Site Directory -> Open Settings for "SAP Build Work Zone" 

       

 Edit the Site -> Add your role to the site assignments

Go to BTP Subaccount -> Role Collections -> Find out your role -> Configure Users or User Groups to your role who should see your App/Card.

 

4.Enable Card

Before the end user can see or use the card. One last step is to enable the card in Admin Console.
Go to Work Zone Admin Console -> UI Integration -> Cards, Find out your card -> Toggel On the card

5. Use Card

The end user go to Work Zone Adv system, go to any Workspaces and edit any Workpage.

If the end user have the role, he can see this card in widget picker and also see the card the workpage.

If the end user do not have the role, he should not see the card in the widget picker and workpages.

Tips for Admins

When the admin go to Content Manager/Admin Console, he can see all the apps/cards regardless of his own roles.
When the admin go to Home or any workpages, he will behave like a normal user representing himself, thus he can only see the cards based on this own role.