3.1.4.91.2.1 ImportPackage

The ImportPackage element specifies the input data for the ImportPackage WSDL operation.

 <xs:element name="ImportPackage" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <xs:complexType>
     <xs:sequence>
       <xs:element minOccurs="0" name="xml" nillable="true" type="xs:string"/>
       <xs:element xmlns:q9="Microsoft.SharePoint.BusinessData" minOccurs="0" name="packageContents" type="q9:PackageContents"/>
       <xs:element xmlns:q9="Microsoft.SharePoint.BusinessData" minOccurs="0" name="adminStruct" nillable="true" type="q9:AdministrationMetadataCatalogStruct"/>
       <xs:element minOccurs="0" name="settingId" nillable="true" type="xs:string"/>
       <xs:element minOccurs="0" name="callerCultureLcid" type="xs:int"/>
       <xs:element minOccurs="0" name="updateModel" type="xs:boolean"/>
     </xs:sequence>
   </xs:complexType>
 </xs:element>

xml: The XML representation of the MetadataModel that conforms to the Business Data Connectivity Model File Format as specified in [MS-BDCMFFS].

packageContents: Specifies what part of the MetadataModel is to be created. The protocol server MUST use the following rules:

  • If the "Model" value is specified, this operation MUST create MetadataObjects in the metadata store. The protocol server MUST set all Entities contained by the specified MetadataModel to active. If any of the Entities contain reference errors as specified in section 3.1.4.5.3.2, the protocol server MUST NOT set any Entity contained by the specified MetadataModel as active.

  • If the "Model" value is not specified, the protocol server MUST NOT create any MetadataObjects.

  • If the "Properties" value is specified, the protocol server MUST create the specified Properties for the corresponding MetadataObjects. If the metadata store already contains a Property with the same name in the specified Setting for the MetadataObject, the Property in the metadata store MUST be replaced.

  • If the "Properties" value is not specified, the protocol server MUST ignore Properties in the specified MetadataModel.

  • If the "LocalizedNames" value is specified, the protocol server MUST create the specified localized names for the corresponding MetadataObjects. If the metadata store already contains a localized name with the same LCID in the specified Setting for the MetadataObject, the localized name in the metadata store MUST be replaced.

  • If the "LocalizedNames" value is not specified, the protocol server MUST ignore localized names in the specified MetadataModel.

  • If the "Permissions" value is specified, the protocol server MUST delete ACEs in the metadata store for the corresponding MetadataObjects and create the specified ACEs for the corresponding MetadataObjects.

  • If the "Permissions" value is not specified, the protocol server MUST ignore ACEs in the specified MetadataModel.

adminStruct: The MetadataCatalog that contains the Model contained by the MetadataModel. If the "Model" value is specified for the packageContents element, the protocol server MUST create the Model in the specified MetadataCatalog. The partition of this MetadataCatalog MUST be the partition of the protocol client.

settingId: The Setting in which to create the Properties, localized names, and ACEs.

callerCultureLcid: Specifies the LCID corresponding to the locale for which the error messages are to be returned. If the protocol server is capable of generating error messages in the specified locale, all error messages MUST be generated for the specified locale. Otherwise, protocol server MUST return errors in a locale determined with an implementation-specific algorithm.

updateModel: Specifies whether the Model contained by the MetadataModel already exists in the metadata store. If this element is set to "true", the protocol server MUST remove all Entity references from the Model. Then, the protocol server MUST create Entity references in the Model to all the Entities contained by the specified MetadataModel. If the "Model" value is not specified for the packageContents element the value of this element MUST be ignored by the protocol server.