Ausgabedatenoptionen

Die folgende Tabelle führt die Optionen auf, die den Informationstyp steuern, der von „ValidateAddress“ zurückgegeben wird. Einige dieser Optionen können für kanadische Adressen überschrieben werden. Weitere Informationen finden Sie unter Optionen für kanadische Adressen.

Tabelle 1. Ausgabedatenoptionen

Option

Beschreibung

Standardadresse einschließen

Gibt 1–4 Zeilen der Adressdaten plus Informationen zu Ort, Bundesland/-staat, Postleitzahl, Firmenname und Wohnanlage zurück. Jede Adresszeile steht für eine Zeile der Adresse, wie sie tatsächlich auf einem Briefumschlag erscheinen würde. Weitere Informationen finden Sie unter Ausgabe.

Wenn „Validate Address“ die Adresse überprüfen konnte, enthalten die Adresszeilen die standardisierte Adresse. Bei der Adressenstandardisierung wird die Interpunktion entfernt, Richtungsangaben und Straßensuffixe werden abgekürzt und Adresselemente korrigiert.

Wenn „Validate Address“ die Adresse nicht überprüfen konnte, enthalten die Adresszeilen die Adresse, wie sie in der Eingabe vorgekommen ist („Durchlaufdaten“). Nicht überprüfte Adressen werden immer als Durchlaufdaten in die Adresszeilenfelder eingeschlossen, selbst wenn Sie diese Option deaktivieren.

Übereinstimmende Adresselemente einschließen

Jede Komponente der Adresse, z. B. die Hausnummer, der Straßenname, das Straßensuffix, Richtungsangaben usw., wird in einem separaten Feld zurückgegeben. Weitere Informationen finden Sie unter Ausgabe von geparsten Adresselementen. Beachten Sie, dass bei Auswahl dieser Option und der Option Normalisierte Daten zurückgeben, wenn keine Übereinstimmung gefunden wird die Adresselemente die Eingabeadressen für Adressen enthalten, die nicht überprüft werden konnten.

Postalische Informationen einschließen

Ausgabeadressen enthalten verschiedene zusätzliche Daten für jede überprüfte Adresse. Weitere Informationen finden Sie unter Ausgabe von postalischen Daten.

Standardisierte Eingabeadresselemente einschließen

Diese Option gibt die Eingabeadresse in geparster Form zurück, unabhängig davon, ob „Validate Address“ die Adresse überprüfen kann oder nicht. Jede Komponente der Eingabeadresse, z. B. die Hausnummer, der Straßenname, das Straßensuffix, Richtungsangaben usw., wird in einem separaten Feld zurückgegeben.

Die Auswahl dieser Option unterscheidet sich von der Auswahl der Option Übereinstimmende Adresselemente einschließen in Kombination mit der Option Normalisierte Daten zurückgeben, wenn keine Übereinstimmung gefunden wird darin, dass Standardisierte Eingabeadresselemente zurückgeben alle Eingabeadressen geparst zurückgibt und keine Eingabe, die nicht überprüft werden konnte. Weitere Informationen finden Sie unter Geparste Eingabe.

Ergebniscodes für einzelne Felder einschließen

Gibt an, ob Ergebnisindikatoren auf Feldebene eingeschlossen werden sollen. Ergebnisindikatoren auf Feldebene erläutern, wie jedes einzelne Adresselement verarbeitet wurde. Ergebnisindikatoren auf Feldebene werden im Begrenzungszeichen „Ergebnis“ zurückgegeben. Der Ergebnisindikator auf Feldebene für „HouseNumber“ ist beispielsweise in HouseNumber.Result enthalten. Eine vollständige Liste der Ausgabefelder für Ergebnisindikatoren finden Sie unter Ergebnisindikatoren auf Feldebene.

Normalisierte Daten zurückgeben, wenn keine Übereinstimmung gefunden wird

Gibt an, ob eine formatierte Adresse zurückgegeben werden soll, wenn eine Adresse nicht überprüft werden kann. Die Adresse wird entsprechend dem durch das Adressland bevorzugten Adressenformat formatiert. Wird diese Option nicht ausgewählt, bleiben die Ausgabeadressfelder leer, wenn die Adresse nicht überprüft werden kann.

Anmerkung: Diese Option gilt nur für US-amerikanische und kanadische Adressen. Formatierte Daten werden für keine andere Adresse zurückgegeben.

Formatierte Adressen werden im Format zurückgegeben, das durch die Kontrollkästchen Standardadresse einschließen, Adresszeilenelemente einschließen und Postalische Informationen einschließen aktiviert wurde. Beachten Sie, dass bei Auswahl von Adresszeilenelemente einschließen die geparsten Adresselemente die geparste, überprüfte Adresse für Adressen enthalten, die überprüft werden konnten. Wenn die Adresse nicht überprüft werden konnte, enthalten die geparsten Adresselemente die Eingabeadresse in geparster Form. Wenn Sie immer möchten, dass die Ausgabe die Eingabeadresse in geparster Form enthält, unabhängig davon, ob „ValidateAddress“ die Adresse überprüfen konnte, wählen Sie Standardisierte Eingabeadresselemente einschließen aus.

Wenn Sie diese Option aktivieren, müssen Sie Standardadresse einschließen und/oder Adresszeilenelemente einschließen auswählen.

Straßennamen-Alias zurückgeben

Geben Sie bei US-amerikanischen Adressen an, wie in der Eingabe verwendete Straßennamen-Aliasse verarbeitet werden sollen. Bei einem Straßen-Alias handelt es sich um einen alternativen Namen für eine Straße, der nur für einen bestimmten Bereich von Adressen in der Straße gilt.

Wenn Sie diese Option aktivieren, erscheinen in der Eingabe verwendete Straßennamen-Aliasse in der Ausgabe . Wenn Sie diese Option nicht aktivieren, werden Straßennamen-Aliasse in der Eingabe bei der Ausgabe in den Basis-Straßennamen umgewandelt, mit folgenden Ausnahmen:

  • Wenn ein bevorzugter Alias bei der Eingabe verwendet wird, wird dieser immer in der Ausgabe verwendet.
  • Bei der Eingabe verwendete geänderte Aliasse werden bei der Ausgabe immer in den Basis-Straßennamen umgewandelt.

Diese ist eine von drei Optionen, die steuern, wie „ValidateAddress“ Straßennamen-Aliasse verarbeitet. Die anderen beiden Optionen sind Verarbeiten von bevorzugtem Alias-Straßennamen und Verarbeiten von abgekürztem Alias-Straßennamen.

Anmerkung: Wenn Verarbeiten von abgekürztem Alias-Straßennamen aktiviert wird, erscheint der abgekürzte Alias immer in der Ausgabe, selbst wenn Sie Straßennamen-Alias zurückgeben deaktiviert haben.

Adressdatenblöcke zurückgeben

Gibt an, ob die Adresse in einem Format zurückgegeben werden soll, das dem Aufdruck auf einer tatsächlichen Postsendung entspricht. Jede Adresszeile wird in einem separaten Adressblockfeld zurückgegeben. Es kann bis zu neun Adressblock-Ausgabefelder geben: AddressBlock1 bis AddressBlock9.

Zum Beispiel diese Eingabeadresse:

AddressLine1: 4200 Parliament Place
AddressLine2: Suite 600
City: Lanham
StateProvince: MD
PostalCode: 20706

Dies führt zu folgender Adressblockausgabe:

AddressBlock1: 4200 Parliament PL STE 600
AddressBlock2: Lanham MD 20706-1882
AddressBlock3: UNITED STATES OF AMERICA

„ValidateAddress“ formatiert die Adresse gemäß Postbehördenstandards in Adressblöcke. Der Ländername wird gemäß Universal Postal Union-Ländername zurückgegeben. Beachten Sie, dass die Option Landesformat keine Auswirkung auf den Ländernamen im Adressblock hat, sondern lediglich auf den Namen, der im Ausgabefeld Land zurückgegeben wird.

Wenn bei Adressen außerhalb der USA und Kanada „ValidateAddress“ die Adresse nicht überprüfen kann, werden keine Adressblöcke zurückgegeben. Bei Adressen in den USA und Kanada werden Adressblöcke zurückgegeben, selbst wenn die Überprüfung fehlschlägt.

Daten gemäß AMAS-Konventionen formatieren

Gibt an, ob die Adresse in einem Format zurückgegeben werden soll, das dem Aufdruck auf einer tatsächlichen Postsendung entspricht. Jede Adresszeile wird in einem separaten Adressblockfeld zurückgegeben. Es kann bis zu neun Adressblock-Ausgabefelder geben: AddressBlock1 bis AddressBlock9.

Zum Beispiel diese Eingabeadresse:

AddressLine1: 4200 Parliament Place
AddressLine2: Suite 600
City: Lanham
StateProvince: MD
PostalCode: 20706

Dies führt zu folgender Adressblockausgabe:

AddressBlock1: 4200 Parliament PL STE 600
AddressBlock2: Lanham MD 20706-1882
AddressBlock3: UNITED STATES OF AMERICA

„ValidateAddress“ formatiert die Adresse gemäß Postbehördenstandards in Adressblöcke. Der Ländername wird gemäß Universal Postal Union-Ländername zurückgegeben. Beachten Sie, dass die Option Landesformat keine Auswirkung auf den Ländernamen im Adressblock hat, sondern lediglich auf den Namen, der im Ausgabefeld Land zurückgegeben wird.

Wenn bei Adressen außerhalb der USA und Kanada „ValidateAddress“ die Adresse nicht überprüfen kann, werden keine Adressblöcke zurückgegeben. Bei Adressen in den USA und Kanada werden Adressblöcke zurückgegeben, selbst wenn die Überprüfung fehlschlägt.