3.1.4.5 BusinessRulesCreate

  • Article

The BusinessRulesCreate operation creates new business rules and business rule components within the MDS repository. Each new business rule or component is created with the names that are provided, and a new GUID is generated for each item. Any components in the request that already exist in the model, matched by name and parent context (EntityId and MemberType), result in errors.

The BusinessRules data type in the request includes placeholders for all information about a business rule, including its descriptive and state information and its component conditions and actions.

Any GUID included in a request (for example, the business rule definition was sourced from another MDM hub instance) is ignored. For more information about the preservation of GUIDs, see section 3.1.4.4.

Newly created objects and their GUIDs are returned in the response as a BusinessRules type if ReturnCreatedIdentifiers is set to true in the request.

Specified domain-based attribute values in arguments of conditions or actions are validated against all open versions. Attribute values that are not found result in errors.

The following is the WSDL definition of the BusinessRulesCreate operation.

Applies to MDS 2008R2

     <wsdl:operation name="BusinessRulesCreate">
       <wsdl:input wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/BusinessRulesCreate" name="BusinessRulesCreateRequest" message="tns:BusinessRulesCreateRequest" />
       <wsdl:output wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/BusinessRulesCreateResponse" name="BusinessRulesCreateResponse" message="tns:BusinessRulesCreateResponse" />
    </wsdl:operation>

Applies to MDS 2012

     <wsdl:operation name="BusinessRulesCreate">
       <wsdl:input wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/BusinessRulesCreate" name="BusinessRulesCreateRequest" message="tns:BusinessRulesCreateRequest"/>
       <wsdl:output wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/BusinessRulesCreateResponse" name="BusinessRulesCreateResponse" message="tns:BusinessRulesCreateResponse"/>
       <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/BusinessRulesCreateSkuNotSupportedMessageFault" name="SkuNotSupportedMessageFault" message="tns:IService_BusinessRulesCreate_SkuNotSupportedMessageFault_FaultMessage"/>
       <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sqlserver/masterdataservices/2009/09/IService/BusinessRulesCreateEditionExpiredMessageFault" name="EditionExpiredMessageFault" message="tns:IService_BusinessRulesCreate_EditionExpiredMessageFault_FaultMessage"/>
    </wsdl:operation>