KB User's Guide - Documents Tab - Using the IncludeDoc Feature to Restrict Content

This document will show you how to create a document that is restricted to a subset of your internal users. We will then show you how to embed the document with the restricted content into a container document which is intended for general consumption.

Restricting Specific Content in a Document Intended for General Consumption

In some cases, you may want to publish a general document, but would like portions of the content viewable only by a subset of your users. While this is not possible within a single document, you can accomplish this by creating a completely separate document with the restricted content and feeding that into the document for general consumption (e.g. the container document in which you will embed your restricted content via the IncludeDoc feature).

  1. If you have not done so yet, create a User Access Group where the members are the users who should be able to view the restricted content. See KB User's Guide - Users Tab - User Access Groups and Limited Access Groups for a refresher on creating and managing User Access Groups.

  2. Create a document with all the restricted content you wish to share with a select number of people, i.e. the members of the User Access Group you created. We recommend these document settings:

    • Search Priority - Exclude from search

      The image below shows a sample document's Search Priority selection circled in red.



    • Click on + Show Other Write Access - Check the box next to the appropriate UserAccess group(s).
    • Click on + Show Other Read Access - Check the box next to the appropriate UserAccess group(s).
    • SiteAccess - Check the box next to the appropriate SiteAccess; Internal and/ or External.

      The image below shows the UserAccess group "KB Team" selected for both the Write and Read Access and are circled in red. In our example here, the SiteAccess is set to the Internal KB Site only as indicated by the red arrow. Therefore, the restricted content will only be seen when viewing the container document on the Live Internal Site.

      Do you require the restricted content to be viewable (only by the selected UserAccess group) on the Live External Site? If so, check the external site box in the SiteAccess field.



    • Status - Set to Active
    • Click the Update button to save your changes.

    After activating the document with the restricted content, keep the document ID number handy as you will be needing it shortly.

  3. Next, begin creating the container document for general consumption based on your KB group's workflow.

  4. On the document edit screen of the container document, determine where you feel the restricted content would fit best. Type the document ID number of the restricted document in the body of the container document, highlight that number and click on the IncludeDoc button.

    WYSIWYG Design Editor: includeDoc_WYSIWIG

    HTML Editor: includedoc_HTML

Ultimately,

  • The restricted content embedded in the container document will only be viewable by members of the selected User Access Group.
  • All other users will see the container document as it was originally intended to appear; the restricted section will simply not be visible for general viewing.
  • There will be no "gap" or blank space in the Live container document where you have embedded the restricted data via the IncludeDoc feature.
  • When the container document is viewed in either Live Site, the container document AND the embedded document will be counted in your document Stats.

    The image below shows a container document that is being viewed from the Live Internal KB Site. The container document is entitled, "Flag up! Ice fishing in Wisconsin". The restricted content embedded  via the IncludeDoc feature is entitled, "Instructions for KB User's Guide Staff: Requesting Updates to DNR PDFs". Those with appropriate ReadAccess to the restricted data will see the restricted content on the Internal Live Site. Those with the appropriate WriteAccess to the restricted content will see an Edit this section button  (circled below in red) which will lead to the KB Admin Tools.


IncludeDoc Chain

The "Includedoc Chain" can go up to five layers deep (so there is no infinite looping). When the depth limit is reached, the last layer of 'IncludeDoc'(s) is converted into 'LinkDoc'(s). Access permissions, 'LinkDoc' tags, 'Htmlentity' tags, etc. are all honored along the "IncludeDoc chain". Infinite loops are prevented without enforcing any depth limit.

See Also:




Keywords:restriction document restrict content hide section text internally readaccess user access group includeDoc chain levels   Doc ID:5236
Owner:Teresa A.Group:KB User's Guide
Created:2007-01-03 18:00 CSTUpdated:2016-12-06 16:33 CST
Sites:KB Demo, KB Demo - Child Demo, KB User's Guide
Feedback:  2   0