IService.EntityMembersCopy(EntityMembersCopyRequest) メソッド

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

パラメーター

返品

属性

FaultContractAttribute OperationContractAttribute

注釈

EntityMembersCopy(EntityMembersCopyRequest)操作は、メンバーおよびそれに関連するデータ(例えば属性や階層の親)を新しいメンバーコードを持つ新しいメンバーにコピーします。

メンバーリストが入力に使用されます。 このリストには、ソースコードとターゲットメンバーコードが含まれています。 リスト内の各項目にはソース(既存メンバーのコード)とターゲット(新規メンバーのコード)が含まれています。

ソースメンバーはモデル、バージョン、エンティティ、メンバーコードでマッチングされます。 メタデータコンポーネントのコンテキストを特定するために、GUIDや正確な名称が使われます。

見つからないソースメンバーは、 EntityMembersCopyResponseにエラーが生じます。 エンティティおよびバージョン内に既に存在する各ターゲットコードはエラーを引き起こします。 これはコードが一意でなければならないためです。 個々の記録の誤りに関わらず、すべてのリストメンバーの試みが行われます。 出力には、成功裏にコピーされたメンバーのリストが含まれています。

この操作を使用するには、ユーザーが新しいメンバーの作成およびソースメンバーの更新の権限を持っている必要があります。この許可が付与されない場合、 EntityMembersCopyResponseでエラーが返されます。 会員に関する一般的な情報については、 Memberを参照してください。 更新権限が付与されたソースメンバーに関連付けられた属性や階層の親は、ターゲットメンバーに割り当てられます。

ソースメンバーに直接付随している階層メンバー権限割り当て(継承されないもの)はターゲットメンバーにコピーされます。