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.
optionName |
Beschreibung |
---|---|
OutputRecordType |
Typ des Ausgabedatensatzes. Geben Sie bei mehr als einem Typ eine Liste an.
|
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.
|
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.
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.
|
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:
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.
|
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 Dies führt zu folgender Adressblockausgabe: AddressBlock1: 4200 Parliament PL STE 600 „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.
|
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 Dies führt zu folgender Adressblockausgabe: AddressBlock1: 4200 Parliament PL STE 600 „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.
|