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 connect my community to my Verint Knowledge Management site?
  • 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 connect my community to my Verint Knowledge Management site?

Before you can connect a community to Verint Knowledge Management, you must be sure that you are running a Knowledge Management site that is version 15.3 or higher, are using or capable of using OpenAM as an authentication mechanism, and that your Telligent Community job service and web application servers can communicate with Knowledge Management using standard HTTP(S) requests.   Configuration of your Knowledge Management site is beyond the scope of these articles.  Please consult your Knowledge Management documentation for more information.

To configure your community to connect to Verint Knowledge Management, you must be signed into your community as a user in the Administrators role.  Then as that user, access the administration area of your community.

[toc]

Choosing a document author

Knowledge documents  are representations of an article in Knowledge Management.   Because of this things like the original author information is not available inside of your community, but an author is still required in order to show the documents.   By default, the community will use the standard system account to do this, however as will see later you can customize this to show a user that may be a better fit for your community.  To do that you must first create that user in community so it is available when configuring the application.  You can learn how to create and manage users in How do I add a community member?.   This user requires no special roles or permissions, however if your community license is based on users, this user will count as a user or seat in your community.   Using the service account will not.

Configuration

In the administration area, select Applications, then Knowledge Collections which will show the configuration screen.

Fill out the form on the right using the following information.  Note the data inside the above image is for informational purposes only.

Tenant Id This is the tenant Id for your Knowledge Management PRO instance.  It is provided by your Knowledge Management administrator.  For Enterprise customers the tenant Id is 'default'.
API Base Url This is the base url of your KnowledgeManagement API, usually the same as the base url of your Knowledge Management site.   
Realm This is the realm for your Knowledge Management PRO OpenAM instance.  It is provided by your Knowledge Management administrator.  For Enterprise customers the realm is 'default'.
Authentication Base Url This is the base url of your KnowledgeManagement OpenAM authentication site.  It should only be the main domain. 
Redirect Url

Generally nothing needs to be entered here and it can be left blank.  If blank the default redirect url will be generated as API Base Url + '/GTConnect/UnifiedAcceptor/FrameworkDesktop.Main'.   If however this url is not valid in your OpenAM configuration or a different value is needed, you would enter the fully qualified redirect url here.

For Enterprise KM:  This field is required for Enterprise sites as it does not conform to the same default as a Professional site.   In most cases the url is the same as Professional with the addition of the port.  So for example if your site was at 'https://mykmsite.com'  then the redirect url would be 'https://mykmsite.com:443/GTConnect/UnifiedAcceptor/FrameworkDesktop.Main'.   Additionally you need to verify that this url, including the port is registered as a valid redirect url in openAM.

Knowledge Management User This is a user on the Knowledge Management site that can read the documents you wish to show in community.   It should be dedicated to this function, not be used by an actual user, and the password should never expire.   This user does count against any user based licenses for Knowledge Management.
Knowledge Management Password The password for the Knowledge Management user.
Community Document Author If you configured a user to act as your document author previously, select it here by typing the username.   If not specified the system account will be used.

Once all fields are completed correctly, you can check the enable checkbox at the top and save.

Synchronizing Data

Before you can start creating knowledge collections the tags and articles from Knowledge Management must be copied to community.  This is done regularly using 2 background jobs.

Full Synchronization

This is the process that must run first. It is the more robust of the data synchronization jobs and has the potential to take the longest and use more system resources.   Because of this it is scheduled to run only once per day at 3:00AM Universal Coordinated Time(UTC).   During this process all tags and all articles are retrieved and added if they are missing, or changes are detected and updated and articles and tags remove that are no longer needed.   You can customize the schedule if needed by entering the administration area, selecting jobs, then locating or filtering to the Knowledge Management Synchronization Job.  From there select the schedule tab.  Note the time here will be adjusted to your user account's timezone and should be taken into account when making adjustments.


Incremental Synchronization

Every 3 hours by default the community will check for changes against Knowledge Management.  During this process if an article is found to have a publish date that is newer on the Knowledge Management site than the last time a check was made, it will be added or updated in the community.   If a tag discrepancy is detected it will re-synchronize all tags.   During this period no articles will be removed from the community.   Much like the full synchronization you can adjust the frequency of this job.  Enter the administration area, select jobs, then locate or filter to the Knowledge Management Incremental Synchronization Job.  From there select the schedule tab. 


Manual Synchronization

There may be a situation where you need to kick off a synchronization outside of the normal schedule, like you just set this up for the first time and do not want to wait until the first full synchronization.   Both the main application configuration and both jobs have a Sync tab that allows either of the 2 processes to be manually invoked.  To know which to invoke, use the following scenarios as a guide:

Run a FULL Synchronization if:

  • This is the first time setting up KM and you do not wish to wait
  • You need to have documents removed from community that were removed in Knowledge Management and it cannot wait
  • A segment in Knowledge Management was updated and you cannot wait for a full synchronization to update it in other articles.

***There may be performance impacts to running FULL synchronizations during normal operating hours.

Run an INCREMENTAL Synchronization If:

  • You added a document that needs to be added to community immediately
  • You updated a document that needs to updated immediately.

It is recommended to only use the manual process when absolutely necessary.

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