Support Fusion Knowledge Management Asset in DCS Portal

Fusion Knowledge Management Asset Picker enables authors to embed assets such as images, videos, and other file types within the context of their articles from a single location.  The 25B DCS Reference Template supports this knowledge feature.

Once authors publish the articles, the KM asset will be rendered in the NextGen application UIs and in the DCS support portal. An End-user is now able to view and download files within the context of the article text. Visual support makes it easier to understand the content.

The oj-dcs-km-article-view component available in the DCS Reference Template supports KM assets for both protected and public assets.  The DCS reference implementation and components support this feature for the V2 KM API version only.

Business benefit:

• Eliminate the need for external tools: Authors can upload, organize, manage and search files directly within the knowledge base from one location and display them across user interfaces including the support portal.
• Improve readability and consistency: Using common icons and images helps end-users quickly navigate through articles.
• Improve comprehension and context: Instead of a list of files at the end of your article, end-users can now view and download these in context of the text.  This also makes it possible to group the files in a way that is logical for readers of the article.  Images also make it easier to understand what the article is describing.
• Ready to use: The DCS Reference Template has out-of-the-box components that support latest Fusion Knowledge Management features

Steps to Enable

Steps to enable your DCS app with Knowledge Management V2 API which is required for the KM Asset Picker feature:

1. In Visual Builder Designer, navigate to Services --> Backends
2. Open the Services side panel by clicking on the Service icon on the left of Visual Builder
3. Open the Backends tab
4. Click on 'Knowledge Management V2 API'
5. Click on the pencil to edit the server 
6. Update the scope by replacing the {instance} name with fusion environment name (eg. abcd-test)
   Eg. urn:opc:resource:fusion:{instance}:knowledge-management/
   

Modify the scope to enable DCS with KM V2 API

1. Save
2. Click on DCS --> Variables
3. Select knowledgeAPIVersion
4. Change the default value from 1 to 2 in the properties panel
   

   Modify the knowledgeAPIVersion variable to enable DCS with KM V2

   
   
5. Stage the app

Tips And Considerations

• Your author will need to add the asset when creating articles. 
• The ability to add UCM assets is part of the Redwood UI Authoring experience.
• The DCS reference implementation and components support this feature for V2 KM APIs.  

Key Resources

This 25B DCS feature is related to the 25B Knowledge Management Authoring feature to Add files and images to knowledge articles.

Please refer to the following Oracle Fusion Service documentation:

• Get Started with Digital Customer Service: https://docs.oracle.com/en/cloud/saas/fusion-service/digital-customer-service.html
• Get Started with Knowledge: https://docs.oracle.com/en/cloud/saas/fusion-service/knowledge.html

Access Requirements

Sign in to the Oracle Visual Builder editor as a user with the Developer role to design your DCS portal experience.