Verint | Telligent Community
Verint | Telligent Community
  • Site
  • User
  • Site
  • Search
  • User
Telligent Community 10.x
  • Verint Community
Telligent Community 10.x
User Documentation How do I create a Knowledge Collection?
  • Ask the Community
  • User Documentation
  • API Documentation
  • Manager Training
  • Developer Training
  • Tags
  • More
  • Cancel
  • New
  • +Telligent Community 10.x User Documentation
  • Changing system terminology
  • Community and GDPR
  • How are wiki page editing conflicts handled?
  • How can I adjust what makes a thread popular within forums?
  • How can I administer available emoticons and emoji?
  • How can I allow members to customize their homepage/dashboard?
  • How can I allow users to delete their own accounts?
  • How can I change the requirements for requesting friendships?
  • How can I configure how members can join the site and their initial experience?
  • How can I control the RSS feeds that are provided for a blog?
  • How can I control the types and sizes of files that members can upload?
  • How can I control types, number, and total storage allowance for files in a media gallery?
  • How can I control whether forum thread and reply authors can edit or delete their own posts?
  • How can I control which actions members can perform on a blog?
  • How can I control which actions members can perform within a forum?
  • How can I control which actions members can perform within a media gallery?
  • How can I control which types of files can be embedded within forum threads and replies?
  • How can I customize messaging to new members?
  • How can I customize the content in aggregate blog RSS feeds?
  • How can I customize the content or delivery time of email digest?
  • How can I customize the fields available on members’ profiles?
  • How can I diagnose a problem or get help?
  • How can I enable a guest blogger on a blog?
  • How can I enable authentication via Windows / Active Directory (AD)?
  • How can I enable multiple members to manage a single blog?
  • How can I enable single sign-on (SSO) with another Microsoft .net-based website?
  • How can I enable single sign-on (SSO)?
  • How can I enable support for emailing to start or reply to a forum thread?
  • How can I enable visitors to authenticate through Facebook?
  • How can I enable visitors to authenticate through Google?
  • How can I enable visitors to authenticate through LinkedIn?
  • How can I enable visitors to authenticate through Live Connect?
  • How can I enable visitors to authenticate through Salesforce?
  • How can I enable visitors to authenticate through Twitter?
  • How can I enable visitors to contact the owners of a group?
  • How can I hide a member's forum posts from the community?
  • How can I identify abuse or SPAM within the community?
  • How can I impersonate a user to act on their behalf?
  • How can I include forum behavior in an external website?
  • How can I integrate my community with other websites and services?
  • How can I join a group?
  • How can I limit who or when someone can comment or trackback on a blog post?
  • How can I make a thread stick to the top of the thread list within a forum?
  • How can I manage blog posts with Open Live Writer (formerly Windows Live Writer)?
  • How can I mirror content from another blog or RSS feed?
  • How can I moderate tags within an application?
  • How can I move content from one area of my community to another?
  • How can I prevent SPAM accounts from being created using the ReCaptcha service?
  • How can I prevent spam content from being shown on my community?
  • How can I provide new members with a default set of friends?
  • How can I rebrand my community in an upgrade-safe way?
  • How can I render previews of documents (Word, Excel, PowerPoint, PDFs) in my community?
  • How can I require acceptance of terms of service before member registration?
  • How can I set the default theme and theme selection options for all blogs?
  • How can I set the default theme and theme selection options for all groups?
  • How can I show or require additional profile fields to be completed when members join my community?
  • How can I specify which types of member avatars are allowed and the default member avatar?
  • How can I split a forum thread into multiple threads?
  • How can I start or stop the job service?
  • How can I stop receiving updates from a forum thread?
  • How can I synchronize Active Directory (AD) groups with Telligent Community roles?
  • How can I uninstall the job service?
  • How can I use snippets within blogs to save time or reuse content when writing posts?
  • How can I use the REST API to automate data migrations or data modifications?
  • How can I write blog posts using email?
  • How do I add a community member?
  • How do I add an Achievement?
  • How do I add an idea to an ideation?
  • How do I add or upload a file to a media gallery?
  • How do I administer members?
  • How do I allow users to export their data?
  • How do I ask a question or start a discussion in a forum?
  • How do I automatically create a blog for each new member of the community?
  • How do I ban or disapprove a member?
  • How do I cancel an event in a calendar?
  • How do I capture a forum thread to a wiki?
  • How do I change my avatar?
  • How do I change the types of threads or thread answer and auto-locking configuration for a forum?
  • How do I chat with another member?
  • How do I compare wiki page revisions?
  • How do I configure email integration?
  • How do I configure Telligent Community to meet the privacy requirement of my locale?
  • How do I connect my community to my Verint Knowledge Management site?
  • How do I control the type and functionality of content that can be posted on my community?
  • How do I control types and sizes of files that members can upload?
  • How do I control whether members can post status messages within a group?
  • How do I control which Active Directory (AD) fields are synchronized and editable on member profiles?
  • How do I create a custom page within a theme?
  • How do I create a group?
  • How do I create a Knowledge Collection?
  • How do I create a wiki page?
  • How do I create an application?
  • How do I create an event in a calendar?
  • How do I create rules to automate my community?
  • How do I customize direct communication options such as email, notifications, and private messages?
  • How do I customize email sent from the community?
  • How do I customize the look and feel of my community?
  • How do I delete a blog post?
  • How do I delete a group?
  • How do I delete a Wiki Page?
  • How do I delete an application?
  • How do I delete an event from a calendar?
  • How Do I Deploy my Site to Microsoft Azure?
  • How do I edit a blog post?
  • How do I edit a file or URL in a media gallery?
  • How do I edit a forum thread or reply?
  • How do I edit a wiki page?
  • How do I edit an Achievement?
  • How do I embed custom forms in my community?
  • How do I enable moderation within a forum?
  • How do I enable moderation within a media gallery?
  • How do I enable visitors to contact me through my blog?
  • How do I export my data?
  • How do I get to the administration panel?
  • How do I get to the contextual management panel?
  • How do I implement single sign-on (SSO) with an existing authentication system using cookies?
  • How do I insert a poll into content?
  • How do I install chat support?
  • How do I install Telligent Community?
  • How do I lock a wiki page?
  • How do I manage advertisements in my community?
  • How do I manage comments?
  • How do I manage licenses?
  • How do I manage membership within a group?
  • How do I manage registrations for a calendar event?
  • How do I manage roles and permissions to control what members can do on the community?
  • How Do I Migrate My Existing File Storage to Azure?
  • How do I moderate a forum to move, split, merge, lock threads?
  • How do I moderate content a member creates?
  • How do I monitor the health of my community?
  • How do I preview UI changes in the community?
  • How do I register for an event?
  • How do I rename, change the avatar, or move a group?
  • How do I revert to a previous version of a wiki page?
  • How do I see download counts of files in a media gallery?
  • How do I send an ad-hoc mass email to community members?
  • How do I set the default timezone and date/time formats for my community?
  • How do I setup an about page for a blog?
  • How do I store some files in different locations than others?
  • How do I translate my community?
  • How do I update the status of an idea?
  • How do I upgrade Telligent Community?
  • How do I upgrade the user experience of my community?
  • How do I use the content editor?
  • How do I use wiki link syntax?
  • +How do I view reports?
  • How do I vote on ideas?
  • How do I write a blog post?
  • How does moderation and abuse work?
  • How does Telligent Community support mobile devices?
  • How does Telligent ensure the quality of Telligent Community?
  • How should I define groups and applications in my community?
  • How should I store user contributed media?
  • How should I support multiple languages on my community?
  • Release Notes
  • What are jobs?
  • +What are the system requirements?
  • What best practices should be followed when customizing the user interface?
  • What is a blog?
  • What is a calendar?
  • What is a forum thread?
  • What is a forum?
  • What is a gallery?
  • What is a group?
  • What is a hashtag?
  • What is a Knowledge Document?
  • What is a mention?
  • What is a theme?
  • What is a wiki?
  • What is an Achievement?
  • What is an activity stream?
  • What is an application?
  • What is chat?
  • What is document preview?
  • What is featured content?
  • What is friending and following?
  • What is ideation?
  • What is liking?
  • What is private messaging?
  • What is RSS?
  • What is the question and answer workflow in forums?
  • What type of video files can I embed in my community?
  • What types of videos can I embed in or attach to content?

How do I create a Knowledge Collection?

Creating a knowledge collection is very much the same as other applications, however they do require a bit more setup.    Most applications allow users to create the content they contain, but knowledge collections simply consume knowledge documents from the host Knowledge Management system. This means in addition to being able to identify a collection, you must also tell it what content it should include.   

[toc]

To create a knowledge collection, you do the same as any application.   Using the upper left pencil icon on a group page, select manage group, applications, add application, then add knowledge collection.

If you just configured the Knowledge Management application in general and the first full synchronization has not yet run, you will get a message that states a full synchronization is required.  This is because your community has not yet received any data that is needed to properly create a knowledge collection.   You can learn more about synchronization in How do I connect my community to my Verint Knowledge Management Site?.

If you have already had a successful synchronization, the create form will appear.

The first fields are name and description.  This is the name that will be displayed in your community and the description is a brief overview of what it is.  Currently description is not surfaced in the community user interface.

Understanding Tag Configuration

Knowledge Management  organizes its content using tags, however these tags should not be confused with tags in the community.   In community tags are used a secondary method of identifying and categorizing content. In Knowledge Management it is the primary navigation structure, especially when it comes to knowledge collections.   Knowledge Management tags and community tags are not related to each other.

When configuring a knowledge collection, four top level tags common to most Knowledge Management sites are used as the primary filter for selecting knowledge documents for the collection.  Currently the integration relies on these four tags and does not support any custom  or additional top level tags.  These tags are:

  • Knowledge Base
  • Product
  • Region
  • Topic

Using a combination of these tags, specific documents will be selected to be part of a knowledge collection.  They are all optional, and not selecting any tag filters will ignore the tag filtering all together.  When specifying the tags, the tags selected within a specific top level tag are considered OR, while the top level tags themselves are AND.  You can select tags in a top level area by typing the name to invoke a list to choose from, or use the browse link to see all the tags beneath that top level tag.

To understand how the logic is applied, consider the following configuration:

In this case, you can see several tags are selected for each top level tag to build this collection:

  • Knowledge Base:  Internal
  • Product: EFM 7.x, EFM 8.x
  • Region: USA
  • Topic: Installation, Administration

This means when the knowledge collection is finally saved, when it selects what knowledge documents to include, it will use the following logic:

"Find all knowledge document that are tagged   ('Internal') AND ('EFM7.x' OR 'EFM 8.x') AND ('USA') AND ('Administration OR Installation')"

Languages and Categories

In addition to tags, you can further restrict the selected knowledge documents by available translations and categories.  When determining the documents to go into a collection, filtering to language and category is actually applied first.

Languages

This will list all language packs installed on your community.  In order to show translated documents you must have the equivalent language pack installed, regardless of whether or not a knowledge document has a specific translation available.   The reverse also applies in that having a language pack installed on your community does not mean a document will be available in that language.  The community will always try and show a document in the logged in user's language, even if its different than the collection's configured language.   If one does not exist, it will show in the first available configured language.

So assuming User A is Spanish speaking according to their profile, if you configure a collection to only include English, it will still try and show it in Spanish.  If Spanish is not available, it will show the English version.  It will always have at least 1 translation to show because your configuration says to include the document it MUST have at least one of the configured languages available.

Categories

The integration supports four Knowledge Management categories:

  • Articles
  • Alerts
  • FAQ
  • Uploaded

This means you can select the check boxes next to the categories you wish to include in your collection(selecting none is the same as selecting all).   Currently these are the only supported categories.  The integration does not support custom categories or spidered content.

When building a collection, it first filters down to only the documents with translations supplied by the languages selected and only ones in the specific categories selected.  Consider this configuration:

In this scenario we are saying we only want documents with at least an English version and documents that are in the FAQ or  Article category.   When we combine this additional configuration to our above tag configuration, the logic that is applied as:

"Find all knowledge document that have an 'English' version AND are categorized 'Article' OR 'FAQ' AND are tagged   ('Internal') AND ('EFM7.x' OR 'EFM 8.x') AND ('USA') AND ('Administration OR Installation')"

Empty Knowledge Collections

If you specify too much filtering, you run the risk of not getting any documents that match the criteria.  In this case you will receive a system notification to prompt you that your collection resulted in no documents and to review your configuration.

Navigation Root

This option is not related to filtering the documents to include in a collection.  Instead this defines the navigation that will be displayed on the left hand side of the knowledge collection to allow you to filter the document list.  You can select any tag here, either by typing or selecting it using browse.  

On the left hand side of the knowledge collection, the entire tag tree starting with the tag you chose will be displayed, the actual tag you selected however is excluded.  Selecting a tag will filter the main document list by that tag and it's children.  The navigation does respect hierarchy, so if a document is tagged with a lower level child tag, it will also show when any level above that tag is selected.  Additionally if this tree contains a tag that is not used on any document in the collection, it will not be shown. 

You can choose to not set this, in which case no left hand navigation will be available.  The left hand navigation will also not show if you selected a tag tree in which no documents contain any of the tags in that hierarchy.

Below you can see a collection with a navigation based on the tag 'EFM' as shown above.  Notice the levels are collapsible and selected tag itself is omitted.

And this is a collection with no navigation specified OR the navigation has been filtered out entirely.


Once you have decided on all the filtering options, click SAVE.   You will be prompted that save was successful, however it may take several minutes for the collection and all documents to display as it can be a lengthy process depending on the data involved.

Editing a Collection

You can return and edit a collection at any time by selecting the pencil icon, then  'Manage Knowledge Collection'  when on a knowledge collection page.  If you are on a group page, select manage group, applications, then select the collection you wish to edit and select edit.   All of the above options are editable with the addition of the url key used by that collection.   The same potential delay in seeing changes applies.

Compatibility

The feature discussed in this article is only available in Telligent Community 10.2 and higher.  It also requires that you are running a licensed version of Verint Knowledge Management Pro or Enterprise v15.3 or higher and OpenAM as the Knowledge Management API authentication provider. 

  • Share
  • History
  • More
  • Cancel
Related
Recommended
  • Telligent
  • Professional Services
  • Submit a Support Ticket
  • Become a Partner
  • Request a Demo
  • Contact Us

About
Privacy Policy
Terms of use
Copyright 2022 Verint, Inc.
Powered by Verint Community