Méthode MailMergeDataField.MapToRecipientField (Publisher)

Mappe un champ (colonne) dans une source de données particulière représentée par l'objet parent MailMergeDataField à un champ de destinataire (colonne) dans la source de données master (liste de destinataires fusion et publipostage combinée).

Syntaxe

expression. MapToRecipientField (bstrValue)

Expression Variable qui représente un objet MailMergeDataField .

Parameters

Nom	Requis/Facultatif	Type de données	Description
bstrValue	Facultatif	Chaîne	Le nom du champ de destinataire auquel la colonne de la source de données doit être mappée.

Remarques

Cette méthode fonctionne uniquement si l'objet parent MailMergeDataField n'a pas déjà été mappé à un champ de destinataire. Utilisez la propriété IsMapped pour déterminer si l’objet a déjà été mappé.

Si vous ne transmettez pas de valeur pour le paramètre facultatif bstrValue , Microsoft Publisher suppose que le champ à mapper porte le même nom que le champ destinataire dans la source de données master à laquelle il est mappé.

Si vous transmettez le nom d'un champ qui n'existe pas, Publisher renvoie une erreur.

Remarque

[!REMARQUE] Pour ajouter un champ, utilisez la méthode AddToRecipientFields.

Exemple

Le suivant Microsoft Visual Basic pour Applications (VBA) montre comment utiliser la MapToRecipientField, méthode pour mapper un champ de données (colonne) dans une source de données particulière à un champ dans la source de données master (liste de destinataires combinée) pour la composition.

Avant d’exécuter cette macro, remplacez par datasourceindex le numéro d’index d’une source de données valide dans la collection de sources de données du document actif, remplacez par fieldname le nom du champ dans la source de données que vous souhaitez mapper à un champ de destinataire et remplacez par recipientfieldname le nom du champ destinataire.

Remarque

Pour obtenir un exemple montrant comment utiliser la propriété Name de l’objet DataSource pour déterminer le numéro d’index de la source de données souhaitée, consultez la méthode MailMergeDataSources.Item .

Public Sub Map() 
 
 Dim pubMailMergeDataSources As Publisher.MailMergeDataSources 
 Dim pubMailMergeDataField As Publisher.MailMergeDataField 
 
 Set pubMailMergeDataSources = ThisDocument.MailMerge.DataSource.DataSources 
 Set pubMailMergeDataField = pubMailMergeDataSources.Item(datasourceindex).DataFields.Item("fieldname") 
 
 If pubMailMergeDataField.IsMapped Then 
 
 Debug.Print "This field is already mapped" 
 
 Else 
 
 pubMailMergeDataField.MapToRecipientField ("recipientfieldname") 
 Debug.Print "Field mapped successfully." 
 
 End If 
 
End Sub

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.