MailMergeDataField.MapToRecipientField-Methode (Publisher)

Artikel
04/07/2023

Ordnet einem Feld (Spalte) in einer bestimmten Datenquelle, dargestellt durch das übergeordnete MailMergeDataField -Objekt auf ein Empfängerfeld (einer Spalte) in der Masterdatenquelle (kombinierte Seriendruck Empfängerliste).

Syntax

Ausdruck. MapToRecipientField (bstrValue)

Ausdruck Eine Variable, die ein MailMergeDataField-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
bstrValue	Optional	String	Der Name des Empfängerfeldes, zu der die Spalte der Datenquelle zugeordnet wird.

HinwBemerkungeneise

Diese Methode funktioniert nur, wenn das übergeordnete MailMergeDataField -Objekt nicht bereits auf ein Empfängerfeld zugeordnet wurde. Verwenden Sie die IsMapped-Eigenschaft , um zu ermitteln, ob das Objekt bereits zugeordnet wurde.

Wenn Sie keinen Wert für den optionalen bstrValue-Parameter übergeben, geht Microsoft Publisher davon aus, dass das zuzuordnende Feld denselben Namen wie das Empfängerfeld in der Masterdatenquelle hat, der es zugeordnet ist.

Wenn Sie den Namen eines Feldes, das nicht vorhanden ist, übergeben, wird in Publisher ein Fehler zurückgegeben.

Hinweis

[!HINWEIS] Verwenden Sie zum Hinzufügen eines Feldes die AddToRecipientFields -Methode.

Beispiel

Der folgende Microsoft Visual Basic für Applikationen (VBA)-Makro zeigt, wie die MapToRecipientField -Methode, um ein Datenfeld (Spalte) in einer bestimmten Datenquelle an ein Feld in der Masterdatenquelle zuordnen (kombinierter Empfängerliste) für die Publikation.

Ersetzen datasourceindex Sie vor dem Ausführen dieses Makros durch die Indexnummer einer gültigen Datenquelle in der Datenquellenauflistung des aktiven Dokuments, ersetzen fieldname Sie durch den Namen des Felds in der Datenquelle, das Sie einem Empfängerfeld zuordnen möchten, und ersetzen Sie durch recipientfieldname den Namen des Empfängerfelds.

Hinweis

Ein Beispiel dafür, wie Sie die Name-Eigenschaft des DataSource-Objekts verwenden können, um die Indexnummer der gewünschten Datenquelle zu bestimmen, finden Sie unter der MailMergeDataSources.Item-Methode .

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über