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

optionName

Beschreibung

OutputRecordType

Typ des Ausgabedatensatzes. Geben Sie bei mehr als einem Typ eine Liste an.

A
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 die Adresse überprüft wird, enthalten die Adresszeilen die standardisierte Adresse. Bei der Adressenstandardisierung wird die Interpunktion entfernt, Richtungsangaben und Straßensuffixe werden abgekürzt und Adresselemente korrigiert. Wenn die Adresse nicht überprüft wird, 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 OutputRecordType=A nicht angeben.
E
Geparste Adresselemente. 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 Angabe von „E“ und OutputFormattedOnFail=Y die geparsten Adresselemente die Eingabeadresse für Adressen enthalten, die nicht überprüft werden konnten.
I
Geparste Eingabe. Diese Option gibt die Eingabeadresse in geparster Form zurück, unabhängig davon, ob die Adresse überprüft wird. Jede Komponente der Eingabeadresse, z. B. die Hausnummer, der Straßenname, das Straßensuffix, Richtungsangaben usw., wird in einem separaten Feld zurückgegeben. Die geparste Eingabe (Wert „I“) unterscheidet sich von der Kombination aus OutputRecordType=E und OutputFormattedOnFail=Y insofern, als dass „I“ alle Eingabeadressen in geparster Form zurückgibt, und nicht nur Eingaben, die nicht überprüft werden konnten. Weitere Informationen finden Sie unter Geparste Eingabe.
P
Postalische Daten. Ausgabeadressen enthalten zusätzliche Daten für jede überprüfte Adresse. Weitere Informationen finden Sie unter Ausgabe von postalischen Daten.
Leer
Kein Adressdaten oder postalischen Daten zurückgeben.

OutputFieldLevelReturnCodes

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.

N
Nein, keine Rückgabecodes auf Feldebene zurückgeben (Standard).
Y
Ja, Rückgabecodes auf Feldebene zurückgeben.

OutputFormattedOnFail

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.
N
Nein, fehlgeschlagene Adressen nicht formatieren (Standard).
Y
Ja, fehlgeschlagene Adressen formatieren.

Formatierte Adressen werden in dem über die Option OutputRecordType angegebenen Format zurückgegeben. Beachten Sie, dass bei Angabe von OutputRecordType=E 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, geben Sie OutputRecordType=I an.

Formatierte Adressen werden in dem über die Option Option.OutputRecordType angegebenen Format zurückgegeben. Beachten Sie, dass bei Angabe von Option.OutputRecordType=E 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, geben Sie Option.OutputRecordType=I an.

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 „Y“ angeben, müssen Sie „A“ und/oder „E“ für „OutputRecordType“ angeben.

Wenn Sie „Y“ angeben, müssen Sie „A“ und/oder „E“ für Option.OutputRecordType angeben.

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

OutputStreetNameAlias

Geben Sie bei US-amerikanischen Adressen an, ob in der Ausgabe ein Straßenalias verwendet werden soll. Bei einem Straßen-Alias handelt es sich um einen alternativen Namen für eine Straße, der in der Regel nur für einen bestimmten Bereich von Adressen in der Straße gilt. Wenn Sie keine Straßen-Aliasse in der Ausgabe zulassen, wird der „Basis“-Name der Straße in der Ausgabe angezeigt, unabhängig davon, ob ein Alias für die Straße vorhanden ist. Bei dem Basisnamen handelt es sich um den Namen, der für die gesamte Straße gilt.

N
Nein, keine Straßennamen-Aliasse in der Ausgabe zurückgeben.
Y
Ja, Straßennamen-Aliasse in der Ausgabe zurückgeben, wenn es einen Alias für die Straße gibt (Standard).

OutputStreetNameAlias

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 in der Regel 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 OutputPreferredAlias und OutputAbbreviatedAlias.

Anmerkung: Wenn OutputAbbreviatedAlias aktiviert wird, erscheint der abgekürzte Alias immer in der Ausgabe, selbst wenn Sie OutputStreetNameAlias deaktiviert haben.
N
Nein, keine Straßennamen-Aliasse in der Ausgabe zurückgeben.
Y
Ja, Straßennamen-Aliasse in der Ausgabe zurückgeben, wenn der Straßenname bei der Eingabe ein Alias ist (Standard).

OutputAddressBlocks

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 OutputCountryFormat 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.

N
Nein, keine Adressblöcke zurückgeben. Standardeinstellung.
Y
Ja, Adressblöcke zurückgeben.

OutputAMAS

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 OutputCountryFormat 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.

N
Nein, keine Adressblöcke zurückgeben. Standardeinstellung.
Y
Ja, Adressblöcke zurückgeben.