Upgrading legacy browse card to new version

1. Click your Profile icon on the right side of the top navigation. From the menu, select Admin portal.

2. On the Admin portal, from the Settings page, select Browse card.

3. Click the Upgrade button. The browse card updates to the new version with a refreshed UI. Preview the changes in the Preview section.

4. Click the Apply changes button. When prompted, confirm the upgrade. Changes will be applied immediately for all users in the organization.

   Warning

   This action is not reversible.

   Once you have completed the upgrade, users can continue to use the browse card without any disruption. However, you can choose to enhance the browse card to improve the experience of the users. For example, you can update the resource links to use the access control feature and create tabs and reorganize the resources in the browse card.

5. Next, you need to update your resource links. Resources indicated with an asterisk (*) are manual links and do not have access control enforced.

6. To enforce access control for resources, upgrade the links in the browse card:

   1. Click the link within a section. The Edit browse card link window opens.

   2. Click Search for a different resource to remap the resource to the link.

   3. In the Resource field, search for your resource. The field shows search results as you type in it. Locate the resource from the dropdown menu.

   4. Click Done to complete the link upgrade process.

7. Return to the browse card and click the Apply changes button to save all updates.

8. Further enhance the browse card by adding new tabs and sections to reorganize the resources in your browse card!

To upgrade the legacy browse card to the new version:

1. Open the exising instance-profile.ttl file for the browse card in a text editor.

2. Covert the legacy browse card to tabbed browse card:

   Table 1.

   Legacy code	New code
   Sample code :BrowseCardProfile a instance:BrowseCardProfile; kos:title "Featured" ; common:subtitle "Recommended recipes and menus, grouped by season." ; instance:hasBrowseCardPresentation [ a instance:SimpleSectionedBrowseCardPresentation; common:section :SectionSummer, :SectionFall, :SectionSpring, :SectionWinter ; ] .	Sample code :BrowseCardProfile a instance:BrowseCardProfile; instance:hasBrowseCardPresentation [ a instance:TabbedBrowseCardPresentation; common:tab :TabFeatured ; ] . :TabFeatured a common:Tab ; kos:title "Featured" ; common:subTitle "Recommended recipes and menus, grouped by season." ; common:section :SectionSummer, :SectionFall, :SectionSpring, :SectionWinter .

   
   
   

3. Convert the syntax for links to resources to new syntax. Making this change allows you to enformce the access control feature for resources in the catalog.

   Table 2.

   Legacy code	New code
   User or organization
   Syntax instance:BrowseCardAgentEntryPresentation instance:agentid instance:path instance:title Sample code :ItemPresentation1 a instance:BrowseCardAgentEntryPresentation; instance:agentid "spongebob"; instance:path "/spongebob"; kos:title "SpongeBob SquarePants".	Syntax instance:BrowseCardAgentSearchResultPresentation instance:agentid Sample code :ItemPresentation1 a instance:BrowseCardAgentSearchResultPresentation; instance:agentid "spongebob".
   Dataset
   Syntax instance:BrowseCardDatasetLinkPresentation instance:agentid instance:datasetid instance:pathinstance:title Sample code :ItemPresentation2 a instance:BrowseCardDatasetLinkPresentation; instance:agentid "democorp"; instance:datasetid "discoverable-dataset-in-org"; instance:path "/democorp/discoverable-dataset-in-org"; kos:title "discoverable dataset in org".	Syntax instance:BrowseCardDatasetSearchResultPresentation instance:agentid instance:datasetid Sample code :ItemPresentation2 a instance:BrowseCardDatasetSearchResultPresentation; instance:agentid "democorp"; instance:datasetid "discoverable-dataset-in-org".
   Project links
   Syntax instance:BrowseCardProjectLinkPresentation instance:agentid instance:projectid instance:path instance:title Sample code :ItemPresentation3 a instance:BrowseCardProjectLinkPresentation; instance:agentid "democorp"; instance:path "/democorp/sample-project"; kos:title "Sample project"; instance:projectid "sample-project".	Syntax instance:BrowseCardProjectSearchResultPresentation instance:agentid instance:projectid Sample code :ItemPresentation3 a instance:BrowseCardProjectSearchResultPresentation; instance:agentid "democorp"; instance:projectid "sample-project".
   Insight
   Syntax instance:BrowseCardInsightLinkPresentation instance:agentid instance:projectid instance:insightid instance:path instance:title Sample code :ItemPresentation4 a instance:BrowseCardInsightLinkPresentation; instance:agentid "democorp"; instance:path "/democorp/demo-project-xproject-03-10-2024/insights/e5f39d94-1ef3-40f2-9ceb-783ef30414ee"; kos:title "ANOTHER INSIGHT"; instance:projectid "demo-project-xproject-03-10-2024"; instance:insightid "e5f39d94-1ef3-40f2-9ceb-783ef30414ee".	Syntax instance:BrowseCardInsightSearchResultPresentation instance:projectid instance:agentid instance:insightid Sample code :ItemPresentation4 a instance:BrowseCardInsightSearchResultPresentation; instance:agentid "democorp"; instance:projectid "demo-project-xproject-03-10-2024"; instance:insightid "e5f39d94-1ef3-40f2-9ceb-783ef30414ee".
   Collection
   Syntax instance:BrowseCardCollectionLinkPresentation instance:path instance:title Sample code :ItemPresentation5 a instance:BrowseCardCollectionLinkPresentation; instance:path "/democorp/catalog/collection/H6r64NwCIoEkTvATWamuXVcGEMBVRV70Aa3hgndeizI"; kos:title "tableau-catalog".	Syntax instance:BrowseCardMetadataSearchResultPresentation instance:agentid # ID of the organization instance:referent # IRI of the resource Sample code :ItemPresentation5 a instance:BrowseCardMetadataSearchResultPresentation; instance:agentid "democorp"; instance:referent "https://democorp.app.linked.data.world/d/ddw-catalogs/cat.0c6334".
   Business Term
   Syntax instance:BrowseCardCatalogBusinessTermLinkPresentation instance:path instance:title Sample code :ItemPresentation6 a instance:BrowseCardCatalogBusinessTermLinkPresentation; instance:path "/democorp/catalog/resource/AZKxYxRuErJlezKgQzNDCj-nTGQqEIpPMyB5fQDRS20"; kos:title "Purchase Order (PO)".	Syntax instance:BrowseCardMetadataSearchResultPresentation instance:agentid # ID of the organization instance:referent # IRI of the resource Sample code :ItemPresentation6 a instance:BrowseCardMetadataSearchResultPresentation; instance:agentid "democorp"; instance:referent "https://democorp.app.linked.data.world/d/ddw-catalogs/businessTerm-c6115fd5-123".
   Metadata resources
   Syntax instance:BrowseCardCatalogEntryLinkPresentation instance:path instance:title Sample code :ItemPresentation7 a instance:BrowseCardCatalogEntryLinkPresentation; instance:path "/democorp/catalog/resource/4xem1r_hZy1akP4dc3wMPJ-b_UjV7IPYpblWptA81n4"; kos:title "Commission Model".	Syntax instance:BrowseCardMetadataSearchResultPresentation instance:agentid # ID of the organization instance:referent # IRI of the resource Sample code :ItemPresentation7 a instance:BrowseCardMetadataSearchResultPresentation; instance:agentid "democorp"; instance:referent "https://democorp.linked.data.world/d/ddw-catalogs/dashboard-ad9fc869-d2f3".