Skip Headers
Oracle® Universal Content Management Web Parts User Guide
Release 10gR3
E10884-01
 
Library
Go To Product List
Product
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

The WebSupportServer.exe.config file

The WebSupportServer.exe.config file is used to configure elements such as the user names, navigation tree, and the search stack. This file is typically installed in the c:\Program Files\Stellent\WSS.

Each portion of the file is described by an XSLT 'path' to the section with a brief description of the content. Example snippets are also provided for each portion. Portions of this file that are not listed here should not be modified.

This section describes the following portions of the WebSupportServer.exe.config file:

Mapped Users

This setting lists all users who are mapped from external users to Content Server users.

XML Path: \configuration\ContentServer\SCSMappedUsers\Users

Example:

<SCSMappedUsers>
    <Users>
        <clear />
        <add SourceName="ABSCSWP2\Administrator" TargetName="sysadmin"         Password="idc" />
    </Users>
</SCSMappedUsers>

Profile Proxies Users

This setting lists all Search Forms defined by the administrator. This has several example forms initially. If not needed, they can be removed and replaced with custom versions.

XML Path: \configuration\ContentServer\SCSProfileProxies\Profiles

Example:

<SCSProfileProxies>
    <Profiles>
      <clear />
      <add ProfileName="AllFields" DisplayName="All Fields" FieldList="*" />
      <add ProfileName="DocTitle" DisplayName="By Title" FieldList="dDocTitle" />
      <add ProfileName="Author" DisplayName="By Author" FieldList="dDocAuthor" />
      <add ProfileName="AuthorAndTitle" DisplayName="By Author and Title"
         FieldList="dDocAuthor,dDocTitle" />
    </Profiles>
</SCSProfileProxies>

Activation Stack

This setting describes which object will be used in the activation of a WSS session. The example shows the mapped user feature commented out by using the <!-- --> XML comment.


Important:

Do not remove the "Web Support Server - Session Initialization" or the "Content Server User Validation" elements. They are needed to create a WSS session and verify the user's Content Server roles.

XML Path: \configuration\WebSupportServer\ActivationProviderStack

Example:

<ActivationProviderStack>
    <SynchronousItems>
        <clear />
        <!-- add Name="Content Server User Map"
ActivationProviderType="Stellent.Wss.Scs.ActivationProviders.SCSMappedUser
Provider,Stellent.Wss.Scs" / -->
    <add Name="Web Support Server - Session Initialization"
ActivationProviderType="Stellent.IPM.Web.WebSupportServerObjects.
ActivationProviders.WebSupportSessionIdProvider,WebSupportServerObjects"
Configuration="WebSupportUserName=IPMUserName;WSS_AdminRoleName=WebAdmin" />
    <add Name="Content Server User Validation"
ActivationProviderType="Stellent.Wss.Scs.ActivationProviders.SCSActivation
Provider,Stellent.Wss.Scs" />
    </SynchronousItems>
    <AsynchronousItems>
        <clear />
    </AsynchronousItems>
    <ChangePasswordItems>
        <clear />
    </ChangePasswordItems>
</ActivationProviderStack>

Navigation Tree Content

This setting determines which nodes are loaded into the navigation tree web part. Customization could include removing tree items or changing the required roles to determine the existence of the elements. The example section here contains only the SavedQueries nav tree node.

XML Path: \configuration\WebSupportServer\NavTreeDefinitions\Items

Example:

<NavTreeDefinitions>
    <Items>
        <clear />
        <add Name="SavedQueries"
        NavTreeType="Stellent.Wss.Scs.NavigationTree.SCSNavTreeSavedSearches,
        Stellent.Wss.Scs" />
    </Items>
</NavTreeDefinitions>

Search Stack Definitions

The search stack defines where WSS will obtain data for presentation to users. Most of these items should not be altered or removed. However, some items specify Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields as a value for ResultsListPageFilterType. This defines the column content of the search results and the order of those columns.

To change the column set and search results order, alter the ResultsListPageFilterConfig attribute which has a setting value of ColumnList. The column list contains the names of the columns to include in the search results. For example, the standard Content Server search results use a column list of the form:

"ColumnList=dDocTitle,dDocAuthor,dSecurityGroup,dDocName" 

which specifies the names of the columns to show.

Additionally, if ResultsListPageFilterConfig has a setting value of UseOrder=1 the order of the columns specified by ColumnList are used.

XML Path: \configuration\WebSupportServer\NavTreeDefinitions\Items

Example:

<SearchStackDefinitions>
    <Items>
        <clear />
<add Name="Content.ProfileProxies"
    ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.SCSProfile
    ProxiesResultsList, Stellent.Wss.Scs" 
    CreateResultsListWhenMissing="true"
    ResultsListPageFilterType="Stellent.IPM.Web.WebSupportServerObjects.Folder
    Filters.FilterAndOrderFields"
    ResultsListPageFilterConfig="ColumnList=DisplayName,FieldList;UseOrder=1" />
<add Name="WSS.Logs"
    ResultsListSourceType="Stellent.IPM.Web.WebSupportServerObjects.
    ResultsListSources.WSSLogViewer" 
    CreateResultsListWhenMissing="true" ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields"
    ResultsListPageFilterConfig="ColumnList=Msg,Time,
    Elapsed,ThreadId;UseOrder=1" />
<add Name="Content" NameListSourceType="Stellent.Wss.Scs.NameListSources.
    SCSProfileNameListSource, Stellent.Wss.Scs" PromtsListSourceType=
    "Stellent.Wss.Scs.PromptListSource.SCSSearchFormPromptListSource,
    Stellent.Wss.Scs" ResultsListSourceType=
    "Stellent.Wss.Scs.ResultsListSources.SCSContentResultsListSource,
    Stellent.Wss.Scs" ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.
    FilterAndOrderFields" ResultsListPageFilterConfig="ColumnList=
    dDocTitle,dDocAuthor,dSecurityGroup,
    dDocName;UseOrder=1" CreateResultsListWhenMissing="true" />
<add Name="Content.Subscriptions" NameListSourceType=
    "Stellent.Wss.Scs.NameListSources.SCSSubscriptionsNls,Stellent.Wss.Scs"
    PromtsListSourceType="Stellent.Wss.Scs.PromptListSource.SCSDetailsViewPls,
    Stellent.Wss.Scs" ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.
    SCSSubscriptionsResultsList, Stellent.Wss.Scs" ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields" ResultsListPageFilterConfig="ColumnList=dDocTitle;UseOrder=1"
    CreateResultsListWhenMissing="true" />
<add Name="Content.CheckedOut"
    NameListSourceType="Stellent.Wss.Scs.NameListSources.SCSCheckInsNls,
    Stellent.Wss.Scs"
    PromtsListSourceType="Stellent.Wss.Scs.PromptListSource.SCSDetailsViewPls,
    Stellent.Wss.Scs"
    ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.
    SCSCheckInsResultsList, Stellent.Wss.Scs" ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields"
    ResultsListPageFilterConfig="ColumnList=dDocTitle,dCheckoutUser,dDocName;
    UseOrder=1" CreateResultsListWhenMissing="true" />
<add Name="Content.MyWorkflow"
    NameListSourceType="Stellent.Wss.Scs.NameListSources.SCSWorkflowNls,
    Stellent.Wss.Scs"
    PromtsListSourceType="Stellent.Wss.Scs.PromptListSource.SCSDetailsViewPls,
    Stellent.Wss.Scs"
    ResultsListSourceType=
    "Stellent.Wss.Scs.ResultsListSources.SCSWorkflowResultsList,Stellent.Wss.Scs"
    ResultsListPageFilterType="Stellent.IPM.Web.WebSupportServerObjects.
    FolderFilters.FilterAndOrderFields"
    ResultsListPageFilterConfig=
    "ColumnList=dDocTitle,dDocName,wfQueueLastActionTs,wfQueueActionState,wfQueueEnterTs;
    UseOrder=1" CreateResultsListWhenMissing="true" />
<add Name="Content.Users"
    NameListSourceType="Stellent.Wss.Scs.NameListSources.SCSUserNls,
    Stellent.Wss.Scs" PromtsListSourceType=
    "Stellent.Wss.Scs.PromptListSource.SCSDetailsViewPls,Stellent.Wss.Scs"
    ResultsListSourceType=
    "Stellent.Wss.Scs.ResultsListSources.SCSUserNameResultsList, Stellent.Wss.Scs"
    ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields"
    ResultsListPageFilterConfig="ColumnList=dName,dFullName,dEmail;UseOrder=1"
    CreateResultsListWhenMissing="true" />
<add Name="Content.MappedUsers"
    NameListSourceType="Stellent.Wss.Scs.NameListSources.SCSUserNls,
    Stellent.Wss.Scs" PromtsListSourceType=
    "Stellent.Wss.Scs.PromptListSource.SCSDetailsViewPls,Stellent.Wss.Scs"
    ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.SCSUser
    MapResultsList, Stellent.Wss.Scs" CreateResultsListWhenMissing="true" />
<add Name="Content.MyUrls"
    ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.SCSPersonalUrlsResults
    List, Stellent.Wss.Scs" CreateResultsListWhenMissing="true" />
<add Name="Content.ContributionFolders"
    ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.
    SCSContributionFolder ResultsList,Stellent.Wss.Scs" ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields"
    ResultsListPageFilterConfig="ColumnList=
    wssDisplayedName,dReleaseDate,dDocAuthor;
    UseOrder=1" CreateResultsListWhenMissing="true" />
<add Name="Content.DocumentRevisions"
    ResultsListSourceType="Stellent.Wss.Scs.ResultsListSources.
    SCSRevisionResultsList, Stellent.Wss.Scs" ResultsListPageFilterType=
    "Stellent.IPM.Web.WebSupportServerObjects.FolderFilters.FilterAndOrderFields"
    ResultsListPageFilterConfig="ColumnList=
    dStatus,dInDate,dOutDate,dStatus,dRevision
    ID;UseOrder=1" CreateResultsListWhenMissing="true" />
</Items>
</SearchStackDefinitions>

User Log Definitions

This setting lists the users that will have active logging. To activate WSS logging for a particular username, add that username to this list. The example causes the session logging to turn on for any user logged in as "sysadmin" or "RRogers".

XML Path: \configuration\WebSupportServer\UserLogDefinitions\Items

Example:

<UserLogDefinitions>
    <Items>
        <clear />
        <!-- Name must be unique across all names -->
        <add Name="sysadmin"/>
        <add Name="RRogers"/>
    </Items>
</UserLogDefinitions>

App Settings

Several other AppSettings used by WSS and the Web Parts can be changed, including cache folder location, WSS session timeout, and Content Server port. The following example shows several of these configuration. The text in bold font indicates the pertinent section.

Example:

<appSettings>
<!-- The Cache folder used to cache global and user session data -->
    <add key="WebSupportServer.CacheDirectory" value=
    "C:\Program Files\Stellent\WSS\WebSupportServerCache" />

<!-- Debug and Tracing - This turns logging on for all WSS Activity -->
    <add key="WebSupportServer.Trace" value="false" />
    <!-- Debug and Tracing - If logging is on this should be turned on -->
    <add key="WebSupportServer.UseConsole" value="false" />
    <!-- Debug and Tracing - This turns on logging for Entry points into WSS-->
    <add key="WebSupportServer.KeyPoints" value="false" />
<!-- Session Infrastructure - This is the WSS Session timeout.  Any session with no activity for this number of minutes is cleaned up on WSS -->
<add key="WebSupportServer.SessionStore.SessionTimeoutMinutes" value="20" />

<!-- Session Infrastructure - This is the WSS Global Cache timeout.  After this number of minutes WSS will flush its cache causeing any access of global cache to be refreshed.  Things like Folder Structure in the Contribution folders or Field Definitions are cached at WSS for efficiency.  -->
<add key="WebSupportServer.SessionStore.GlobalCacheTimeoutMinutes" value="480" />

<!-- List Row Counts - These are the default row counts in the pages presented to the user -->
<add key="WebSupportServer.DefaultUserSetting.Content.PageRowCount" value="10" />
<add key="WebSupportServer.DefaultUserSetting.WSS.Logs.PageRowCount" value="50" />

<!-- Stellent Content Server Settings - This is the URL to the Content Server web services used by WSS -->
<add key="StellentContentServer.WebServiceConnectionUrl" value="http://cos-jjumper/stellentcs/idcplg" />

<!-- Stellent Content Server Settings - This is the System user used for Web Services User Proxy along with that password used for the user -->
<add key="Stellent.Scs.DirectServiceSupport.StellentRequest.Communication.
    SystemUser" value="sysadmin" />
<add key="Stellent.Scs.WebServiceSupport.SystemUserName" value="sysadmin" />
<add key="Stellent.Scs.WebServiceSupport.SystemUserPassword" value="idc" />

<!-- Stellent Content Server Settings - This is the Content Server port used to comunicate through the socket layer to content server  -->
<add key="Stellent.Scs.DirectServiceSupport.StellentRequest.Communication.
    EndPoint" value="4444" />

<!—Stellent Content Server Settings – Use this setting to control whether WSS will send the users Windows domain as part of the user name when requesting services from Content Server. This is usually set to 'false', however, in environments where Content Server security precludes the use of domain information, setting this value to 'true' will cause WSS to strip the relevant domain information before making Content Server requests -->
<add key=”Stellent.Scs.WebServiceSupport.StripDomainFromUserName” value=”false” />

Special App Setting

A new key was added to afford the administrator the opportunity to disable default behavior and NOT include active directory groups when mapping roles and accounts. This setting is located in the WEB.CONFIG file for the WebApp installation. A likely use for this option is when users might belong to Active directory groups that would map to roles and accounts inappropriate for your environment. Please refer to "Changing the Web Configuration Setting" for details about how to find this file and how changing this setting could affect your users' permissions.