IService.EntityMembersCopy(EntityMembersCopyRequest) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Copia los miembros especificados en nuevos miembros de destino.
public:
Microsoft::MasterDataServices::Services::MessageContracts::EntityMembersCopyResponse ^ EntityMembersCopy(Microsoft::MasterDataServices::Services::MessageContracts::EntityMembersCopyRequest ^ request);[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))]
[System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))]
[System.ServiceModel.OperationContract]
public Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyResponse EntityMembersCopy (Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyRequest request);[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.SkuNotSupportedMessage))>]
[<System.ServiceModel.FaultContract(typeof(Microsoft.MasterDataServices.Services.DataContracts.EditionExpiredMessage))>]
[<System.ServiceModel.OperationContract>]
abstract member EntityMembersCopy : Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyRequest -> Microsoft.MasterDataServices.Services.MessageContracts.EntityMembersCopyResponsePublic Function EntityMembersCopy (request As EntityMembersCopyRequest) As EntityMembersCopyResponseParámetros
- request
- EntityMembersCopyRequest
La solicitud.
Devoluciones
- Atributos
Comentarios
La EntityMembersCopy(EntityMembersCopyRequest) operación copia los miembros y sus datos asociados (por ejemplo, atributos y elementos primarios de jerarquía) a nuevos miembros con nuevos códigos de miembro.
Se usa una lista de miembros para la entrada. Esta lista incluye códigos de miembro de origen y de destino. Cada elemento de la lista incluye un origen (código de un miembro existente) y un destino (código de un nuevo miembro).
Los miembros de origen coinciden con el código de modelo, versión, entidad y miembro. Los GUID o nombres exactos se usan para identificar el contexto del componente de metadatos.
Cada miembro de origen que no se encuentra produce un error en .EntityMembersCopyResponse Cada código de destino que ya existe dentro de la entidad y la versión produce un error. Esto ocurre porque los códigos DEBEN ser únicos. Todos los miembros enumerados se intentan independientemente de los errores de registro individuales. La salida incluye una lista de los miembros que se copiaron correctamente.
Para usar esta operación, los usuarios DEBEN tener permiso para crear nuevos miembros y actualizar los miembros de origen; cuando no se concede este permiso, se devuelve un error en .EntityMembersCopyResponse Para obtener información general sobre los miembros, vea Member. Los atributos y los elementos primarios de jerarquía asociados al miembro de origen para los que se concede el permiso de actualización se asignan al miembro de destino.
Las asignaciones de permisos de miembro de jerarquía que se adjuntan directamente a los miembros de origen (no heredados) se copian en los miembros de destino.