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 de los miembros especificados a los nuevos miembros objetivo.
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
Solicitud.
Devoluciones
- Atributos
Comentarios
La EntityMembersCopy(EntityMembersCopyRequest) operación copia a los miembros y sus datos asociados (por ejemplo, padres de atributos y jerarquía) a nuevos miembros con nuevos códigos de miembros.
Se utiliza una lista de miembros para la entrada. Esta lista incluye códigos de los miembros fuente y destino. Cada elemento de la lista incluye una fuente (código de un miembro existente) y un destino (código de un nuevo miembro).
Los miembros de origen se emparejan por modelo, versión, entidad y código de miembro. Los GUIDs y/o nombres exactos se utilizan para identificar el contexto de los componentes de metadatos.
Cada miembro fuente que no se encuentra resulta en un error en el EntityMembersCopyResponse. Cada código destino que ya existe dentro de la entidad y la versión resulta en un error. Esto ocurre porque los códigos DEBEN ser únicos. Todos los miembros listados son intentados independientemente de errores individuales en el registro. La salida incluye una lista de los miembros que fueron copiados con éxito.
Para utilizar esta operación, los usuarios DEBEN tener permiso para crear nuevos miembros y actualizar los miembros fuente; cuando este permiso no se concede, se devuelve un error en el EntityMembersCopyResponsearchivo . Para información general sobre los miembros, véase Member. Cualquier atributo y padre de jerarquía asociado al miembro fuente para el que se concede permiso de actualización se asigna al miembro objetivo.
Cualquier asignación de permisos de miembros jerarquicos que esté directamente adjunta a miembros fuente (no heredados) se copia a los miembros objetivo.