Configuration Files
MatchPoint Snow utilizes MatchPoint web part for implementing both user interface and application logic. MatchPoint provides a centralized configuration mechanism for web parts (one configuration file per web part) and for other functionality and components.
The following sections provide an overview on the various configuration files deployed with MatchPoint Snow. For better understanding, they have been grouped by topics.
Web Part Overview
MatchPoint Snow uses a subset of the web parts available with MatchPoint. The following Web Parts are used:
- Composite web part
- User Control web part
- Composite Refinement web part
- Form web part
- Data Grid web part
For more information on configuration and functionality of these web parts, please refer to the MatchPoint Technical Reference document.
Generic Configuration Files
The following generic configuration files are deployed with MatchPoint Snow.
| Configuration File | Web Part |
|---|---|
|
LicenseConfiguration.xml (LicenseConfiguration) |
Contains the MatchPoint license key. |
|
MatchPointConfiguration.xml (MatchPointConfiguration) |
See MatchPoint Configuration |
|
Colygon.MatchPoint.Snow.xml (ConfigFileProtectionConfiguration) |
Ensures integrity of configuration files in free MatchPoint Snow installations. |
|
MatchPointSnowConfiguration.xml (MatchPointSnowConfiguration) |
See MatchPoint Snow Configuration |
|
MPSnow.StringResources.xml (StringResourcesConfiguration) |
Contains translations for the string constants used within MatchPoint Snow. |
|
SearchScopesConfiguration.xml (SearchScopesConfiguration) |
Defines the search scopes used within the |
With the exception of MPSnow.StringResources.xml, all configuration
files above are singleton configurations. MatchPoint singleton
configurations are configuration files that exist once per MatchPoint
instance. Therefore, they usually contain central configuration
properties that define a behavior for the complete application.
MatchPointConfiguration.xml
The configuration file MatchPointConfiguration.xml contains central
parameters that determine the behavior of a MatchPoint instance. As
such, the file does not contain specific functionality for MatchPoint
Snow, with the following exceptions:
- The MatchPoint Snow assembly is registered within the
ExternalAssembliesproperty. This makes components of MatchPoint Snow available for use within MatchPoint. - Likewise, the MatchPoint Snow user controls are registered within
the
UserControlsproperty. This allows using the user controls within the MatchPoint web parts.
Icons for tags (and other metadata properties) are registered within the
Icons property. This defines a consistent look and feel for metadata
throughout MatchPoint Snow.
Please note that a set of icons that match the general look and feel of the MatchPoint Snow icon set is provided as part of the Snowflake developer kit.
MatchPointSnowConfiguration.xml
The configuration file MatchPointSnowConfiguration.xml contains
central parameters that define the behavior of MatchPoint Snow. Namely,
the following functionalities:
- The
TopNavigationproperty defines the main navigation nodes for MatchPoint Snow. By default, these are the landing pages timeline, workspaces, content and users. - The
ContextualActionsproperty defines actions that are available within the right section of a MatchPoint Snow landing page. - The
WorkspaceTypesproperty defines workspace types for MatchPoint Snow. By default, the workspace types project, team and community are available.
More information the configuration files related to workspace types is provided in Customizations and Extensions.
Web Parts on Landing Pages
The landing pages on the MatchPoint Snow instance site are configured with MatchPoint web parts. The following sub-sections provide information on the configuration files for these web parts.
Welcome Dialog
The following web part is used within the welcome dialog.
| Configuration | Description |
|---|---|
|
MPSnow.User.Welcome.xml (Composite web part) |
Displays the MatchPoint Snow welcome dialog, rendered by user control MPSnow.User.Welcome.ascx. |
Timeline Landing Page
The following web parts are used on the Timeline landing page.
| Configuration File | Description |
|---|---|
|
MPSnow.Timeline.Middle.xml (User Control web part) |
Displays the tab control for different views that are available on the timeline landing page. Rendered by the user control MPSnow.Timeline.Middle.ascx. |
|
MPSnow.Timeline.OverviewAll.xml (Composite web part) |
Displays timeline entries. Content is aggregated using SP Search and rendered by the user control MPSnow.Timeline.OverviewSearch.ascx. |
|
MPSnow.Timeline.OverviewCreatedByMe.xml (Composite web part) |
Displays timeline entries. Content is aggregated from the current user's my site and rendered by the user control MPSnow.Timeline.OverviewList.ascx. |
|
MPSnow.Timeline.OverviewFollowed.xml (Composite web part) |
Displays timeline entries. Content is aggregated from user's my site and rendered by the user control MPSnow.Timeline.OverviewSearch.ascx. |
|
MPSnow.Timeline.OverviewMentioningMe.xml (Composite web part) |
Displays timeline entries. Content is aggregated using SP Search and rendered by the user control MPSnow.Timeline.OverviewSearch.asc. |
|
MPSnow.Timeline.OverviewTrending.xml (Composite web part) |
Displays timeline entries. Content is aggregated using SP Search and rendered by the user control MPSnow.Timeline.OverviewSearch.ascx. |
|
MPSnow.Timeline.Refinement.xml (User Control web part) |
Displays the correct refinement control, based on the data source of the timeline entries displayed
on the landing page. Uses the user control MPSnow.Timeline.Refinement.ascx.
|
|
MPSnow.Timeline.RefinementList.xml (Composite Refinement web part) |
Allows refining timeline entries. |
|
MPSnow.Timeline.RefinementSearch.xml (Composite Refinement web part) |
Allows refining timeline entries. |
|
MPSnow.Timeline.AddPost.xml (Composite web part) |
Allows refining timeline entries. |
Workspaces Landing Page
The following web parts are used on the Workspace landing page.
| Configuration File | Description |
|---|---|
|
MPSnow.Workspaces.Middle.xml (User Control web part) |
Displays the tab control for different views that are available on the workspaces landing page. Rendered by the user control MPSnow.Workspaces.Middle.ascx. |
|
MPSnow.Workspaces.Overview.xml (Composite web part) |
Displays workspaces. Content is aggregated from the workspace list and rendered by the user control MPSnow.Workspace.Overview.ascx. |
|
MPSnow.Workspaces.OverviewFollowed.xml (Composite web part) |
Displays workspaces. Content is aggregated from the user's my site and rendered by the user control MPSnow.Workspace.Overview.ascx. |
|
MPSnow.Workspaces.OverviewTrending.xml (Composite web part) |
Displays workspaces. Content is aggregated from the workspace list and rendered by the user control MPSnow.Workspace.Overview.ascx. |
|
MPSnow.Workspaces.Refinement.xml (User Control web part) |
Displays the correct refinement control, based on the data source of the workspace entries displayed on the landing page. Uses the user control MPSnow.Workspaces.Refinement.ascx. |
|
MPSnow.Workspaces.RefinementAllMy.xml (Composite Refinement web part) |
Allows refining workspaces. |
|
MPSnow.Workspaces.RefinementFollowed.xml (Composite Refinement web part) |
Allows refining workspaces. |
|
MPSnow.Workspaces.RefinementTrending.xml (Composite Refinement web part) |
Allows refining workspaces. |
|
MPSnow.Workspace.Detail.Header.xml (Composite web part) |
Callout that displays detail information on a workspace. Uses the user control defined in MPSnow.Workspace.Detail.Header.ascx. |
|
MPSnow.Workspace.Detail.Documents.xml (Composite web part) |
Displays information on documents. Uses the user control defined in MPSnow.Workspace.Detail.Documents.ascx.
|
|
MPSnow.Workspace.Detail.Events.xml (Composite web part) |
Displays information on events. Uses the user control defined in MPSnow.Workspace.Detail.Events.ascx. |
|
MPSnow.Workspace.Detail.Tasks.xml (Composite web part) |
Displays information on tasks. Uses the user control defined in MPSnow.Workspace.Detail.Tasks.ascx. |
Content Landing Page
The following web parts are used on the Content landing page.
| Configuration File | Description |
|---|---|
|
MPSnow.Content.Middle.xml (User Control web part) |
Displays the tab control for different views that are available on the content landing page. Rendered by the user control MPSnow.Content.Middle.ascx. |
|
MPSnow.Content.Overview.xml (Composite web part) |
Displays content entries. Content is aggregated using SP Search and rendered by the user control MPSnow.Content.Overview.ascx. |
|
MPSnow.Content.OverviewFollowed.xml (Composite web part) |
Displays timeline entries. Content is aggregated from user's my site and rendered by the user control MPSnow.Content.OverviewFollowed.ascx. |
|
MPSnow.Content.OverviewTrending.xml (Composite web part) |
Displays timeline entries. Content is aggregated using SP Search and rendered by the user control MPSnow.Content.Overview.ascx. |
|
MPSnow.Content.Refinement.xml (User Control web part) |
Displays the correct refinement control, based on the data source of the content entries displayed on the landing page. Uses the user control MPSnow.Content.Refinement.ascx. |
|
MPSnow.Content.RefinementAllMy.xml (Composite Refinement web part) |
Allows refining content. |
|
MPSnow.Content.RefinementFollowed.xml (Composite Refinement web part) |
Allows refining content. |
|
MPSnow.Content.RefinementTrending.xml (Composite Refinement web part) |
Allows refining content. |
People Landing Page
| Configuration File | Description |
|---|---|
|
MPSnow.People.Middle.xml (User Control web part) |
Displays the tab control for different views that are available on the people landing page. Rendered by the user control MPSnow.People.Middle.ascx. |
|
MPSnow.People.OverviewAll.xml (Composite web part) |
Displays users. Content is aggregated using SP Search and rendered by the user control MPSnow.People.Overview.ascx. |
|
MPSnow.People.OverviewFollowed.xml (Composite web part) |
Displays users. Content is aggregated from the user's my site and rendered by the user control MPSnow.People.Overview.ascx. |
|
MPSnow.People.OverviewMy.xml (Composite web part) |
Displays users. Content is aggregated from the user's my site and rendered by the user control MPSnow.People.Overview.ascx. |
|
MPSnow.People.OverviewTrending.xml (Composite web part) |
Displays users. Content is aggregated using SP Search and rendered by the user control MPSnow.People.Overview.ascx. |
|
MPSnow.People.Refinement.xml (Composite Refinement web part) |
Allows refining user entries from the people landing page. |
|
MPSnow.People.Detail.Header.xml (Composite web part) |
Callout that displays detail information on a user. Uses the user control MPSnow.People.Detail.Header.ascx. |
|
MPSnow.People.Detail.Documents.xml (Composite web part) |
Displays information in documents. Uses the user control defined in MPSnow.People.Detail.Documents.ascx. |
|
MPSnow.People.Detail.Workspaces.xml (Composite web part) |
Displays information on workspaces. Uses the user control defined in MPSnow.People.Detail.Workspaces.ascx. |
Reports Landing Page
The following web parts are used on the Reports landing pages.
|
MPSnow.Reports.Overview.xml (Composite web part) |
Displays an overview of workspaces on the reports landing page |
|
MPSnow.Reports.Refinement.xml (Composite Refinement web part) |
Allows refining the workspaces. |
|
MPSnow.Reports.ProjectPortfolio.Issues.xml (Chart web part) |
Displays issues from project workspaces. |
|
MPSnow.Reports.ProjectPortfolio.Tasks.xml (Chart web part) |
Displays tasks from project workspaces |
|
MPSnow.Reports.ProjectPortfolio.OperatingNumbers.xml (Composite web part) |
Displays statistics on the project workspaces. |
|
MPSnow.Reports.ProjectPortfolio.NumberOfProjects.xml (Composite web part) |
Displays the number of projects. |
|
MPSnow.Reports.ProjectPortfolio.Refinement.xml (Composite Refinement web part) |
Allows refining the displayed items on the project portfolio page. |
|
MPSnow.Reports.ProjectPortfolio.HiddenRefinementProvider.xml (Data Grid web part) |
Provides refinement criteria. |
|
MPSnow.Reports.WSMonitor.NewWorkspaces.xml (Chart web part) |
Displays new workspaces |
|
MPSnow.Reports.WSMonitor.Likes.xml (Chart web part) |
Displays 'liked' workspaces. |
|
MPSnow.Reports.WSMonitor.OperatingNumbers.xml (Composite web part) |
Displays statistics on workspaces. |
|
MPSnow.Reports.WSMonitor.Refinement.xml (Composite Refinement web part) |
Allows refining the displayed workspaces. |
|
MPSnow.Reports.WSMonitor.HiddenRefinementProvider.xml (Data Grid web part) |
Provides refinement criteria. |
Web Parts in Workspaces
The following sub-sections describe web part configuration files used within the MatchPoint Snow workspaces.
Workspace Content
The following wep parts are used within the workspace site.
| Configuration File | Description |
|---|---|
|
MPSnow.Workspace.Activities.xml (Composite web part) |
Displays entries from the SP activity feed. Rendered by the user control MPSnow.Timeline.Activity.ascx. |
|
MPSnow.Workspace.Feed.xml (Composite web part) |
Displays entries from the SP activity feed. Rendered by the user control MPSnow.Timeline.Activity.ascx. |
|
MPSnow.Workspace.Introduction.xml (Composite web part) |
Displays workspace information. Rendered by the user control MPSnow.Workspace.Introduction.ascx. |
|
MPSnow.Workspace.Meeting.Overview.xml (Data Grid web part) |
Displays meetings. |
| MPSnow.Workspace.Documents.Overview.xml | Displays documents. |
|
MPSnow.Workspace.Search.xml (Composite web part) |
Allows find-on-type for content on the workspace site. |
|
MPSnow.Workspace.BusinessTopics.xml (User Control web part) |
Displays the applied business topic tags. |
|
MPSnow.Workspace.AddPost.xml (Composite web part) |
Allows creating posts within a workspace. |
|
MPSnow.Workspace.Community.Announcements.Overview.xml (Composite web part) |
Displays announcements in a community workspace. |
|
MPSnow.Workspace.Community.Discussions.Overview.xml (Composite web part) |
Displays discussions in a community workspace. |
Governance
The following web parts are used for the governance functionality.
| Configuration File | Description |
|---|---|
|
MPSnow.Workspace.EditorLoader.xml (User Control web part) |
Opens the correct workspace editor web part for the workspace, rendered by MPSnow.Workspace.EditorLoader.ascx. |
User Management
The following web parts are used for the user management.
| Configuration File | Description |
|---|---|
|
MPSnow.Workspace.Role.xml (User Control web part) |
Displays the users management control for a workspace |
|
MPSnow.Workspace.Users.PerRole.xml (Composite web part) |
Displays the assigned users 'per role' (owner, member, reader) |
|
MPSnow.Workspace.Users.Remove.xml (Composite web part) |
Allows removing a user from a workspace. |
|
MPSnow.Workspace.Users.Add.xml (Form web part) |
Allows adding a user to a workspace. |
|
MPSnow.Workspace.Users.WorkspaceMembers.xml (Composite web part) |
Displays user information on the workspaces landing page. |
Meeting Workspaces
The following web parts are used within meeting workspaces.
| Configuration File | Description |
|---|---|
|
MPSnow.Meeting.Agenda.Overview.xml (Data Grid web part) |
Displays items from the meeting agenda. |
|
MPSnow.Meeting.Minutes.Overview.xml (Data Grid web part) |
Displays items from the meeting minutes. |
|
MPSnow.Meeting.Minutes.CreateTask.xml (Form web part) |
Allows creating new entries for the meeting minutes. |
Web Parts on Other Pages
The following sub-sections describe web part configuration files used pages 'outside' of landing pages and workspace sites.
Profile Page
The following web parts are used within the profile site.
| Configuration | Description |
|---|---|
|
MPSnow.Profile.Introduction.xml (User Control web part) |
Displays general information on the user, rendered by user control MPSnow.Profile.Introduction.ascx. |
|
MPSnow.Profile.Navigation.xml (User Control web part) |
Displays information from the user profile store, rendered by user control MPSnow.Profile.Navigation.ascx. |
|
MPSnow.Profile.Activity.xml (Composite web part) |
Displays the user's activities. |
|
MPSnow.Profile.Documents.xml (Composite web part) |
Displays the user's documents, rendered by user control MPSnow.Profile.Documents.ascx. |
|
MPSnow.Profile.Issues.xml (Composite web part) |
Displays the user's issues, rendered by user control MPSnow.Profile.Issues.ascx. |
|
MPSnow.Profile.Tasks.xml (Composite web part) |
Displays the user's tasks, rendered by user control MPSnow.Profile.Tasks.ascx.
|
|
MPSnow.Profile.Workspaces.xml (Composite web part) |
Displays the user's workspaces, rendered by user control MPSnow.Profile.Workspaces.ascx. |
Search
The following web parts are used within the search page.
| Configuration File | Description |
|---|---|
|
MPSnow.Search.xml (Form web part) |
Renders the text input field that allows searching all landing pages. |
|
MPSnow.Search.Definition.xml (SearchDefinitionConfiguration) |
Allows defining search criteria on the Advanced Search page. |
|
MPSnow.Search.Result.xml (Composite web part) |
Renders the search results on the Advanced Search page. |
|
MPSnow.Search.Refinement.xml (Composite Refinement web part) |
Allows refining entries on the Advanced Search Page. |
Dialog Controls
The following sub-sections describe web part configuration files used within dialog fields.
Contextual Actions
The following web parts are used within contextual actions.
| Configuration File | Description |
|---|---|
|
MPSnow.ContextualActions.xml (User Control web part) |
Displays contextual actions on landing pages and workspaces, rendered by user control MPSnow.Controls.ContextualActions.ascx. |
|
MPSnow.Workspace.SelfSubscription.xml (User Control web part) |
Allows users to subscribe to a community site, rendered by user control MPSnow.Workspace.SelfSubscription.ascx. |
|
MPSnow.Workspaces.UploadLogo.xml (User Control web part) |
Allows users to upload a logo for a workspace, rendered by user control MPSnow.Workspaces.LogoUpload.ascx. |
|
MPSnow.Feedback.xml (Form web part) |
Allows users to provide feedback to the configured mail address. |
|
MPSnow.Document.Uploader.xml (User Control web part) |
Allows users to upload a document to a workspace, rendered by user control |
Picker Controls
The following web parts are used within picker controls.
| Configuration File | Description |
|---|---|
|
MPSnow.Document.Template.Selector.xml (User Control web part) |
Displays the dialog for selecting a document template (i.e. for creating a new document within a workspace), rendered by user control MPSnow.Document.Template.Selector.ascx. |
|
MPSnow.Document.Template.Selector.xml (Composite web part) |
Displays the list of templates (documents). |
|
MPSnow.Document.Template.Search.xml (Form web part) |
Renders a search field for find-on-type within the displayed templates. |
|
MPSnow.Workspace.Picker.xml (User Control web part) |
Displays the dialog for selecting a workspace (i.e. for uploading a document or creating a new list item), rendered by user control MPSnow.Workspace.Type.Picker.ascx. |
|
MPSnow.Workspace.Selector.xml (Composite web part) |
Displays the list of workspaces. |
|
MPSnow.Workspace.Selector.Search.xml (Form web part) |
Renders a search field for find-on-type within the displayed locations. |
|
MPSnow.Workspace.Type.Picker.xml (User Control web part) |
Displays the dialog for selecting a workspace type (i.e. for creating a new workspace), rendered by user control MPSnow.Workspace.Type.Picker.ascx. |
|
MPSnow.Workspace.Type.Selector.xml (Composite web part) |
Displays the list of workspace types. |
|
MPSnow.Workspace.Type.Search.xml (Form web part) |
Renders a search field for find-on-type within the displayed workspace types. |
Other
The following web parts are used in other locations.
| Configuration File | Description |
|---|---|
|
MPSnow.Comment.xml (Form web part) |
Allows users to comment on items within MatchPoint Snow. |
|
MPSnow.RightSection.Today.xml (Composite web part) |
Displays tasks, issues and items assigned to the current user. |
Timer Jobs
The following configuration files are used for configuring MatchPoint tag importer timer jobs.
| Configuration File | Description |
|---|---|
|
MPSnow.Tags.Static.xml (StaticTagImporterConfiguration) |
Timer job configuration for importing root tags and governance tags. |
|
MPSnow.Tags.System.xml (TagImporterConfiguration) |
Timer job configuration for importing system tags. |
|
MPSnow.Tags.BusinessTopic.xml (TagImporterConfiguration) |
Timer job configuration for importing business topic tags. |
Workspace Configuration Files
The following sub-sections describe the configuration files used to implement the MatchPoint Snow workspaces.
Provisioning Templates
These are the provisioning configuration files used within MatchPoint Snow.
| Configuration Files | Description |
|---|---|
|
MPSnow.Workspaces.BaseProvisioning.xml (ProvisioningConfiguration) |
Provisioning configuration for all workspaces. |
|
MPSnow.Workspaces.CommunityProvisioning.xml (ProvisioningConfiguration) |
Provisioning configuration for community workspaces. Extends MPSnow.Workspaces.BaseProvisioning.xml.
|
|
MPSnow.Workspaces.ProjectProvisioning.xml (ProvisioningConfiguration) |
Provisioning configuration for project workspaces. Extends MPSnow.Workspaces.BaseProvisioning.xml.
|
|
MPSnow.Workspaces.TeamProvisioning.xml (ProvisioningConfiguration) |
Provisioning configuration for team workspaces. Extends MPSnow.Workspaces.BaseProvisioning.xml.
|
|
MPSnow.MeetingProvisioning.xml (ProvisioningConfiguration) |
Provisioning configuration for meeting workspaces. |
Workspace Templates
This is the workspace template that is the basis for all MatchPoint Snow workspaces.
| Configuration File | Description |
|---|---|
|
MPSnow.Workspace.Template.xml (WorkspaceTemplateConfiguration) |
Workspace template for project, team and community workspaces |
|
MPSnow.MeetingWorkspace.Template.xml (WorkspaceTemplateConfiguration) |
Workspace template for meeting workspaces |
Workspace Editors
The following web parts are used for creating and edition MatchPoint Snow workspaces.
| Configuration File | Description |
|---|---|
|
MPSnow.Workspace.DefaultCreator.xml (WorkspaceEditorConfiguration) |
Allows creating a new workspace (project, team, community) |
|
MPSnow.Workspace.DefaultEditor.xml (WorkspaceEditorConfiguration) |
Allows editing a workspace (project, team, community) |
|
MPSnow.Workspaces.Meeting.Create.xml (WorkspaceEditorConfiguration) |
Allows creating a new workspace (meeting) |
|
MPSnow.Workspaces.BusinessTopics.Edit.xml (WorkspaceEditorConfiguration) |
Allows editing a workspace (meeting) |
Hybrid - Configuration Files
The following configuration files are deployed with MatchPoint Snow Hybrid.
| Configuration File | Web Part |
|---|---|
|
MatchPointSnowHybridConfiguration.xml (MatchPointSnowHybridConfiguration) |
See MatchPoint Snow Hybrid Configuration |
MatchPointSnowHybridConfiguration.xml
The configuration file MatchPointSnowHybridConfiguration.xml contains
central parameters that define the behavior of MatchPoint Snow Hybrid setup. Namely,
the following functionalities:
- The
SearchConditionsproperty defines the additional search conditions that will be returned byMPSRemoteHelper.GetSearchConditions(). This method can be used in ExpressionCondition inSearchDataProviderwhere content is aggregated.