Die folgende Tabelle führt die Optionen auf, die den Informationstyp steuern, der von Validate MailingAddressUSCAN zurückgegeben wird. Einige dieser Optionen können für kanadische Adressen überschrieben werden. Weitere Informationen finden Sie unter Optionen für kanadische Adressen.
Option optionName Parameter |
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 Standardmäßige Adressausgabe. 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. |
OutputRecordType Option.OutputRecordType |
Typ des Ausgabedatensatzes. Geben Sie bei mehr als einem Typ eine Liste an.
|
Ergebniscodes für einzelne Felder einschließen OutputFieldLevelReturnCodes Option.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.
|
Normalisierte Daten zurückgeben, wenn keine Übereinstimmung gefunden wird OutputFormattedOnFail Option.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-Adressen 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. Geben Sie OutputRecordType=I an, wenn Sie möchten, dass die Ausgabe immer die Eingabeadresse in geparster Form enthält, unabhängig davon, ob Validate MailingAddressUSCAN die Adresse überprüfen konnte. 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. Geben Sie Option.OutputRecordType=I an, wenn Sie möchten, dass die Ausgabe immer die Eingabeadresse in geparster Form enthält, unabhängig davon, ob Validate MailingAddressUSCAN die Adresse überprüfen konnte. 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 „Validate Address“ 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. |
Straßennamen-Alias zurückgeben OutputStreetNameAlias Option.OutputStreetNameAlias |
Gibt nur bei US-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:
Diese ist eine von drei Optionen, die steuern, wie Validate MailingAddressUSCAN Straßennamen-Aliasse verarbeitet. Die anderen beiden Optionen sind OutputPreferredAlias und OutputAbbreviatedAlias. Diese ist eine von drei Optionen, die steuern, wie Validate MailingAddressUSCAN Straßennamen-Aliasse verarbeitet. Die anderen beiden Optionen sind Option.OutputPreferredAlias und Option.OutputAbbreviatedAlias. Diese ist eine von drei Optionen, die steuern, wie „Validate Address“ 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 OutputAbbreviatedAlias aktiviert wird, erscheint der abgekürzte Alias immer in der Ausgabe, selbst wenn Sie OutputStreetNameAlias deaktiviert haben.
Anmerkung: Wenn Option.OutputAbbreviatedAlias aktiviert wird, erscheint der abgekürzte Alias immer in der Ausgabe, selbst wenn Sie Option.OutputStreetNameAlias deaktiviert haben.
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 OutputAddressBlocks Option.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 Validate MailingAddressUSCAN 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. Beachten Sie, dass die Option Option.OutputCountryFormat keine Auswirkung auf den Ländernamen im Adressblock hat, sondern lediglich auf den Namen, der im Ausgabefeld Land zurückgegeben wird. 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 Validate MailingAddressUSCAN die Adresse bei Adressen außerhalb der USA und Kanada 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 OutputAMAS Option.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 Validate AddressUSCAN 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. Beachten Sie, dass die Option Option.OutputCountryFormat keine Auswirkung auf den Ländernamen im Adressblock hat, sondern lediglich auf den Namen, der im Ausgabefeld Land zurückgegeben wird. 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 Validate AddressUSCAN die Adresse bei Adressen außerhalb der USA und Kanada 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.
|