Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
cancel
Showing results for 
Search instead for 
Did you mean: 
jinghe
Advisor
Advisor

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.

jinghe_0-1714707519884.png

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

jinghe_1-1714707933643.png

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

jinghe_3-1714713681339.png

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.

       jinghe_5-1714714169072.png 
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.

      jinghe_6-1714714507357.png.     
Go to Site Directory -> Open Settings for "SAP Build Work Zone" 
       jinghe_7-1714714586397.png
 Edit the Site -> Add your role to the site assignments
jinghe_8-1714714751042.png

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

jinghe_9-1714715254861.png 

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
jinghe_10-1714715462674.png

 

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.
jinghe_11-1714715834590.png

 

jinghe_12-1714715888607.png
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. 

 

 
 
 

 

 

 


 

 

 

3 Comments
marcotritoni
Explorer

Hi @jinghe ,
thank you for sharing the guide "How to upload a new card" with the new procedure.

In my case, I have many cards already uploaded in SAP Build Workzone. No problem If I try to upload a new card, but I cannot update the cards (uploaded with the old procedure via the "UI Cards" section in the Administration Console) without removing it and uploading again via the new one. 

How can I update the cards without removing them? This point is very important, because by removing the card I will lost all configurations, and it is breaking for my customers.

Waiting for your feedback

Thanks
Kind Regards
Marco

jinghe
Advisor
Advisor
0 Kudos

Hi @Marco ,

In the coming releases, we will migrate all the existing cards to local apps. After the migration, we can upgrade the cards in Content Manager without removing them. So if it is not that urgent to upgrade the card, we can just wait until the migration. If you have to upgrade the card now, you have to uninstall it and upload the newer version in Content Manager. 

pieterjanssens
Active Participant

I guess this whole operation is being done to move away from content stored inside of WZ and migrate to HTML5 repo.  Is there a way to get access to the card content via the "cf html5-list" CLI?

 

---

FYI - it's good to know that when you delete the card from the Admin Console and recreate it via the Content Manager, you will not lose the assignments or configuration of the card! 😉