New Card Upload Process and Role-based Filtering o...

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.

marcotritoni

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

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

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! 😉

RiccardoFassina

Hi @jinghe ,

we are using the "new card upload process by content manager" and we encountered many issues during the loading of workpages where cards loaded by the new method don't load. In the same workzone page we have cards loaded by the old process and cards loaded by the new process. Often, only cards loaded by the new process failed to load, as you can see below :

We are worried because next Friday old cards will be migrated to the "Content Manager" according to SAP BUILD Workzone Release Notes.

We're going to open a ticket to SAP Support but we would just inform you.

jinghe

Hi @RiccardoFassina ，

Just want to confirm whether the cards(uploaded via new way) are working at the beginning but no longer work after 1 week? If yes, we have already identified the issue and a patch is on the way.

If it is not working after the upload, it may due to other issues like the role not setup properly. Please help to open a ticket. Thanks.

miltonc

@jinghe

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.

Is this a temporary issue that will be fixed shortly (OR) has the process completely changed... From the wordings in the blog, it looks like a permanent change - But it also feels like a temporary issue.

Can we no longer deploy a card created in Business Application Studio from within Business Application Studio ? Is this a temporary issue (if so, timeline for fix) OR a change in process ?

jinghe

@miltonc

The button in BAS is temporarily removed and we will add it back in the next release and adopt the new way to upload the card. The card will be automatically assigned to everyone if it is the first card deployment.