IService.EntityMembersCopy(EntityMembersCopyRequest) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將指定成員副本給新的目標成員。
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.EntityMembersCopyResponse
Public Function EntityMembersCopy (request As EntityMembersCopyRequest) As EntityMembersCopyResponse
參數
- request
- EntityMembersCopyRequest
要求。
傳回
- 屬性
備註
此操作會 EntityMembersCopy(EntityMembersCopyRequest) 將成員及其相關資料(例如屬性與階層父)複製到帶有新成員碼的新成員。
輸入時會使用成員清單。 此列表包含來源與目標會員代碼。 清單中的每個項目包含一個來源(現有成員的程式碼)和一個目標(新成員的程式碼)。
來源成員依型號、版本、實體及成員代碼進行配對。 GUID 和/或精確名稱用於識別元資料元件的上下文。
每個找不到的來源成員都會在 中 EntityMembersCopyResponse產生錯誤。 實體與版本中已存在的每個目標程式碼都會產生錯誤。 這是因為代碼必須是唯一的。 所有列出的成員均可嘗試,無論個別紀錄錯誤如何。 輸出包含成功複製的成員清單。
要使用此操作,使用者必須擁有建立新成員及更新原始成員的權限;若未授予此權限,則會在 中回傳 EntityMembersCopyResponse錯誤。 關於成員的一般資訊,請參見 Member。 任何與來源成員相關聯且獲得更新權限的屬性與階層父,皆指派給目標成員。
任何直接附加於來源成員(非繼承)的階層成員權限指派,都會被複製到目標成員。