Ausgabedatenoptionen - addressing - Spectrum_OnDemand - web_services - 23 - 23.1

Spectrum-Webdienste-Handbuch

Product type
Software
Portfolio
Integrate
Product family
Spectrum™ software
Product
Spectrum™ software > Web Services
Version
23.1
ft:locale
de-DE
Product name
Spectrum Technology Platform
ft:title
Spectrum-Webdienste-Handbuch
First publish date
2007
ft:lastEdition
2023-10-25
ft:lastPublication
2023-10-25T07:20:03.279000

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.

Tabelle 1. Ausgabedatenoptionen

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.

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 Standardmäßige Adressausgabe. 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.

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.

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

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

  • 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 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.
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).

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

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.

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

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

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.

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