Skip to content

web-configuration-reference-master-data-services.md

Latest commit

 

History

History
74 lines (63 loc) · 5.45 KB

web-configuration-reference-master-data-services.md

File metadata and controls

74 lines (63 loc) · 5.45 KB
title Web Configuration Reference (Master Data Services) | Microsoft Docs
ms.custom
ms.date 03/01/2017
ms.prod sql-non-specified
ms.prod_service mds
ms.service
ms.component master-data-services
ms.reviewer
ms.suite sql
ms.technology
master-data-services
ms.tgt_pltfrm
ms.topic article
helpviewer_keywords
web configuration file [Master Data Services]
ms.assetid b8cc9a35-97ab-4fe0-ab4b-c07f13d9793a
caps.latest.revision 6
author smartysanthosh
ms.author nagavo
manager craigg
ms.workload Inactive

Web Configuration Reference (Master Data Services)

[!INCLUDEssMDSshort] uses a Web.config file to contain the configuration settings that enable Internet Information Services (IIS) to host the [!INCLUDEssMDSmdm] Web application and the Web service. This Web.config file is located in the WebApplication folder of the [!INCLUDEssMDSshort] installation path. For more information about the path and permissions, see Folder and File Permissions (Master Data Services).

Web.Config Elements

The Web.config file contains a custom [!INCLUDEssMDSshort] element, <masterDataServices>, in addition to standard IIS, .NET Framework, ASP.NET, and Windows Communication Foundation (WCF) configuration elements. The following table describes the elements included in the Web.config file.

Configuration Element Description
masterDataServices Custom element. Connects the [!INCLUDEssMDSshort] Web service to a [!INCLUDEssMDSshort] database.
connectionStrings ASP.NET element. For more information, see connectionStrings Element (ASP.NET Settings Schema) in the MSDN Library.
system.web ASP.NET element. For more information, see system.web Element (ASP.NET Settings Schema) in the MSDN Library.
startup .NET Framework element. For more information, see <startup> Element in the MSDN Library.
runtime .NET Framework element. For more information, see <runtime> Element in the MSDN Library.
system.codedom .NET Framework element. For more information, see <system.codedom> Element in the MSDN Library.
system.web.extensions ASP.NET element. For more information, see system.web.extensions Element (ASP.NET Settings Schema) in the MSDN Library.
system.webServer Section group that contains IIS elements. For more information, see system.webServer Section Group [IIS 7 Settings Schema] in the MSDN Library.
system.serviceModel WCF element. For more information, see <system.serviceModel> in the MSDN Library.
system.diagnostics .NET Framework element. For more information, see <system.diagnostics> Element in the MSDN Library.
appSettings ASP.NET element. For more information, see appSettings Element (General Settings Schema) in the MSDN Library.

masterDataServices Element

The <masterDataServices> element is a custom element that is used to connect a [!INCLUDEssMDSshort] Web service to a [!INCLUDEssMDSshort] database.

Syntax

<masterDataServices>  
   <instance virtualPath="path" siteName="name" connectionName="name" serviceName="name" />  
</masterDataServices>

Elements and Attributes

Item Description
instance Child element. Contains attributes that specify information for the Web service and database connection string.
virtualPath Attribute. Specifies the virtual path of the [!INCLUDEssMDSmdm] Web application and service. This corresponds to the path attribute of the <application> element under the <site> element in the IIS ApplicationHost.config file.
siteName Attribute. Specifies the name of the site that hosts the [!INCLUDEssMDSmdm] Web application and service. This corresponds to the name attribute of the <site> element under <sites> in the IIS ApplicationHost.config file.
connectionName Attribute. Specifies the name of the connection to use. This corresponds to the name attribute of the <add> element under the <connectionStrings> element in Web.config.
serviceName Attribute. Specifies the name of the Web service. This corresponds to the name attribute of the <service> element under the <services> element in Web.config.

Example

The following example demonstrates a service named MDS1 on the Contoso site and /MDS path using a connection string specified by MDSDB.

<masterDataServices>  
   <instance virtualPath="/MDS" siteName="Contoso" connectionName="MDSDB" serviceName="MDS1" />  
</masterDataServices>