Optionen

Die folgende Tabelle enthält die Optionen, die den von „ValidateAddressLoqate“ zurückgegebenen Informationstyp steuern.

Tabelle 1. Ausgabedatenoptionen

optionName

Beschreibung

Database.Loqate

Gibt an, welche Datenbank Sie zum Überprüfen internationaler Adressen verwenden möchten. Wählen Sie für die Angabe einer Datenbank zur Überprüfung internationaler Adressen eine Datenbank aus der Dropdown-Liste Datenbank aus.

OutputFieldLevelReturnCodes

Gibt an, ob Ergebnisindikatoren auf Feldebene eingeschlossen werden sollen. Ergebnisindikatoren auf Feldebene beschreiben, wie „ValidateAddressLoqate“ jedes Adresselement verarbeitet. 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.

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. Ist diese Option deaktiviert, sind die Ausgabeadressfelder leer, wenn „ValidateAddressLoqate“ die Adresse nicht überprüfen kann.

N
Nein, fehlgeschlagene Adressen nicht formatieren (Standard).
Y
Ja, fehlgeschlagene Adressen formatieren.

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 die Ausgabe immer eine geparste Eingabeadresse enthalten soll, unabhängig davon, ob „ValidateAddressLoqate“ die Adresse überprüfen konnte, müssen Sie die Option Standardisierte Eingabeadresselemente einschließen auswählen.

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

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 die Ausgabe immer eine geparste Eingabeadresse enthalten soll, unabhängig davon, ob „ValidateAddressLoqate“ die Adresse überprüfen konnte, müssen Sie OutputRecordType=I angeben.

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

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 die Ausgabe immer eine geparste Eingabeadresse enthalten soll, unabhängig davon, ob „ValidateAddressLoqate“ die Adresse überprüfen konnte, geben Sie Option.OutputRecordType=I an.

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

„ValidateAddressLoqate“ formatiert die Adresse mithilfe von Standards der Postbehörden in Adressblöcke. Der Ländername wird gemäß Universal Postal Union-Ländername zurückgegeben. Beachten Sie, dass die Option OutputCountryFormat keine Auswirkungen auf den Ländernamen im Adressblock hat. Sie wirkt sich nur auf den im Ausgabefeld Land zurückgegebenen Namen aus.

Zur Auswahl stehen:

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

AmasFormatting

Gibt an, dass Ausgabeadressdaten gemäß den AMAS-Konventionen (AMAS = Address Matching Approval System) formatiert werden müssen.

Diese Option bewirkt, dass „Validate Address Loqate“ für die Standardisierung einer Adresse AMAS-Regeln verwendet. AMAS ist ein Programm der Australia Post zur Durchsetzung von Adressenstandards. Weitere Informationen zu den AMAS-Formatierungskonventionen finden Sie im „Address Matching Approval System (AMAS) Handbook“.

Diese Option ändert die Ausgabedaten wie folgt.

  • Numerische Felder werden mit Nullen aufgefüllt. Dies hat Auswirkungen auf folgende Ausgabefelder: „HouseNumber“, „HouseNumber2“, „PostalDeliveryNumber“ und „DPID“. Wenn die Eingabeadresse beispielsweise „298 New South Head Rd Double Bay NSW 2028“ lautet, dann wird das Format des Feldes „HouseNumber“ von „298“ in „00298“ geändert.
  • Wenn keine Übereinstimmung gefunden wird, sind alle Ziffern im Feld „DPID“ Nullen. Beispiel: 00000000.
  • Wenn keine Übereinstimmung gefunden wird, sind alle zurückgegebenen Felder (geparste Adresselemente) leer. Nur numerische Felder enthalten alle Nullen.
  • Das Feld „CCD“ wird nicht ausgegeben.

Gültige Werte sind:

N
Nein, Ausgabedaten nicht gemäß AMAS-Konventionen formatieren (Standard).
Y
Ja, Ausgabedaten gemäß AMAS-Konventionen formatieren.
Anmerkung: Wenn diese Option ausgewählt wird, werden Ergebnisse unabhängig von der in den Feldern Akzeptanzniveau und Minimaler Übereinstimmungswert getroffenen Auswahl mit AMAS-Formatierung zurückgegeben.

OutputCasing

Gibt die Groß-/Kleinschreibung der Ausgabedaten an. Zur Auswahl stehen:

M
Gibt die Ausgabe in Groß- und Kleinbuchstaben zurück (Standard). Beispiel:

123 Main St
Mytown FL 12345

U
Gibt die Ausgabe in Großbuchstaben zurück. Beispiel:

123 MAIN ST
MYTOWN FL 12345

HomeCountry

Gibt das Standardland an. Sie sollten das Land angeben, in dem sich die meisten Adressen befinden. Wenn Sie beispielsweise vor allem deutsche Adressen verarbeiten, geben Sie „Germany“ an. „ValidateAddressLoqate“ verwendet das von Ihnen angegebene Land, um eine Überprüfung einzuleiten, wenn es das Land nicht über die Adressfelder „StateProvince“, „PostalCode“ und „Country“ bestimmen kann. Gültige Ländernamen sind:

Afghanistan, Albania, Algeria, American Somoa, Andorra, Angola, Anguilla, Antigua And Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belarus, Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia, Bosnia And Herzegovina, Botswana, Brazil, British Virgin Islands, Brunei Darussalam, Bulgaria, Burkina Faso, Burundi, Cambodia, Cameroon, Canada, Cape Verde, Cayman Islands, Central African Republic, Chad, Chile, China, Colombia, Comoros Islands, Congo, Cook Islands, Costa Rica, Cote D'Ivoire, Croatia, Cuba, Cyprus, Czech Republic, Democratic Republic Of Congo, Denmark, Djibouti, Dominica, Dominican Republic, East Timor, Ecuador, Egypt, El Salvador, Equitorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands, Faroe Islands, Federated States Of Micronesia, Fiji, Finland, France, French Guiana, Gabon, Gambia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guinea, Guinea Bissau, Guyana, Haiti, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran, Iraq, Ireland, Israel, Italy, Jamaica, Japan, Jordan, Kazakhstan, Kenya, Kiribati, Korea, Kuwait, Kyrgyzstan, Laos, Latvia, Lebanon, Lesotho, Liberia, Libya, Liechtenstein, Lithuania, Luxembourg, Macau, Macedonia, Madagascar, Malawi, Malaysia, Maldives, Mali, Malta, Marshall Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Moldova, Monaco, Mongolia, Monserrat, Morocco, Mozambique, Myanmar, Namibia, Nauru, Nepal, Netherlands Antilles, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norway, Oman, Pakistan, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Islands, Poland, Portugal, Puerto Rico, Qatar, Republic Of Georgia, Republic Of Korea, Republic Of Singapore, Reunion, Romania, Russia, Rwanda, Saint Helena, Saint Kitts And Nevis, Saint Lucia, Saint Pierre And Miquelon, Saint Vincent And The Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Seychelles, Sierra Leone, Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, Spain, Sri Lanka, Sudan, Surivalue, Swaziland, Sweden, Switzerland, Syria, Tahiti, Taiwan, Tajikistan, Tanzania, Thailand, The Netherlands, Togo, Tonga, Trinidad And Tobago, Tristan Da Cunha, Tunisia, Turkey, Turkmenistan, Turks And Caicos Islands, Tuvalu, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Vanuatu, Venezuela, Vietnam, Virgin Islands (US), Wallis And Futuna, Yemen, Yugoslavia, Zambia, Zimbabwe

OutputCountryFormat

Gibt das Format an, das für den im Ausgabefeld Country zurückgegebenen Ländernamen verwendet werden soll. Wenn Sie beispielsweise „Englisch“ auswählen, wird der Ländername „Deutschland“ als „Germany“ zurückgegeben.

E
Englische Ländernamen verwenden (Standard).
I
ISO-Abkürzung mit zwei Buchstaben anstelle von Ländernamen für die Länder verwenden.
U
Abkürzung der Universal Postal Union anstelle von Ländernamen für die Länder verwenden.

OutputScript

Gibt das Alphabet oder die Schrift an, in dem oder in der die Ausgabe zurückgegeben werden soll. Diese Option ist bidirektional und ist im Allgemeinen als von Muttersprache zu Latein oder als von Latein zu Muttersprache festgelegt.

Input
Es wird keine Transkription durchgeführt. Die Ausgabe erfolgt in derselben Schrift wie die Eingabe (Standard).
Native
Die Ausgabe erfolgt in der muttersprachlichen Schrift des ausgewählten Landes, falls möglich.
Latn
Englische Werte werden verwendet.
Akzeptanzniveau

AcceptanceLevel

Gibt die minimale Überprüfungsebene an, die ein Datensatz erreichen muss, um als erfolgreich verarbeitet zu gelten. Der Wert in diesem Feld entspricht dem zweiten Zeichen des „Address Verification Code“, das als „Vergleichsebene von Überprüfungen nach der Verarbeitung“ bezeichnet wird:

  • 5: Zustellort (Gebäude oder Postfach). Der Datensatz wird übergeben oder weist eine hohe Zuverlässigkeit auf, wenn die im Eingabedatensatz angegebenen Werte für „ApartmentNumber“, „HouseNumber“, „Street“, „City“ und „StateProvince“ mit dem Loqate-Referenzdataset übereinstimmen. Die Zuverlässigkeit ist mäßig, wenn eine Übereinstimmung mit „ApartmentNumber“ gegeben ist, mit den anderen Feldern jedoch nicht. In diesem Fall müsste die Loqate-Engine „ApartmentNumber“ jedoch differenzierter als „ApartmentNumber“ identifizieren können. Es ist keine Zuverlässigkeit gegeben, wenn „ApartmentNumber“ und andere Felder nicht von der Loqate-Engine geparst werden können.
  • 4: Einrichtung oder Gebäude. Der Datensatz wird übergeben oder weist eine hohe Zuverlässigkeit auf, wenn die im Eingabedatensatz angegebenen Werte für „HouseNumber“, „Street“, „City“ und „StateProvince“ mit dem Loqate-Referenzdataset übereinstimmen. Die Zuverlässigkeit ist mäßig, wenn eine Übereinstimmung mit „HouseNumber“ gegeben ist, mit den anderen Feldern jedoch nicht. In diesem Fall müsste die Loqate-Engine „HouseNumber“ jedoch identifizieren können, da sich „HouseNumber“ auf einer differenzierteren Ebene befindet. Es ist keine Zuverlässigkeit gegeben, wenn „HouseNumber“ und andere Felder nicht von der Loqate-Engine geparst werden können.
  • 3: Landstraße oder Straße. Der Datensatz wird übergeben oder weist eine hohe Zuverlässigkeit auf, wenn die im Eingabedatensatz angegebenen Werte für „Street“, „City“ und „StateProvince“ mit dem Loqate-Referenzdataset übereinstimmen. Die Zuverlässigkeit ist mäßig, wenn eine Übereinstimmung mit „City“ gegeben ist, mit „StateProvince“ jedoch nicht. In diesem Fall müsste die Loqate-Engine „StateProvince“ identifizieren können, da „City“ selbst Teil von „StateProvince“ ist. Es ist keine Zuverlässigkeit gegeben, wenn „City“ oder beide Felder („City“ und „StateProvince“) nicht von der Loqate-Engine geparst werden können.
  • 2: Lokalität (Stadt oder Ort). Der Datensatz wird übergeben oder weist eine hohe Zuverlässigkeit auf, wenn die im Eingabedatensatz angegebenen Werte für „City“ und „StateProvince“ mit dem Loqate-Referenzdataset übereinstimmen. Die Zuverlässigkeit ist mäßig, wenn eine Übereinstimmung mit „City“ gegeben ist, mit „StateProvince“ jedoch nicht. In diesem Fall müsste die Loqate-Engine „StateProvince“ identifizieren können, da „City“ selbst Teil von „StateProvince“ ist. Es ist keine Zuverlässigkeit gegeben, wenn „City“ oder beide Felder („City“ und „StateProvince“) nicht von der Loqate-Engine geparst werden können.
  • 1: Verwaltungsbereich (Bundesland/Kanton oder Region). Der Datensatz wird übergeben oder weist eine hohe Zuverlässigkeit auf, wenn der im Eingabedatensatz angegebene Wert für „StateProvince“ mit dem Loqate-Referenzdataset übereinstimmt.
  • 0: Keine. Dies entspricht der lockersten Option für die Übereinstimmung.

IsDuplicateHandlingMaskEnable

Aktiviert die Dublettenbehandlungsmaske und gibt an, wie Datensatzdubletten verarbeitet und entfernt werden. Wählen Sie mindestens eine der folgenden Optionen aus:

S
Ist standardmäßig ausgewählt. Eingabe vorab bearbeiten und Dubletten entfernen, die in einem Feld auftreten.
C
Ist standardmäßig ausgewählt. Eingabe vorab bearbeiten und Dubletten über alle Felder entfernen.
T
Eingabe vorab bearbeiten und Dubletten in Feldern entfernen, bei denen es sich nicht um Standardadressfelder handelt.
F
Ist standardmäßig ausgewählt. Ausgabe der Überprüfung nachbearbeiten und Dubletten aus nicht überprüften Feldern entfernen.

MinimumMatchScore

Gibt einen numerischen Wert zwischen 0 und 100 an, der den Grad angibt, um den „Validate Address Loqate“ eine Adresse ändert, um eine Übereinstimmung in der Loqate-Referenzdatenbank zu erhalten. Je niedriger die Zahl ist, desto mehr Änderungen sind zulässig. Der Wert 100 bedeutet, dass die Eingabeadresse nach dem Parsing fast mit der überprüften Adresse übereinstimmt. Der Wert 0 gibt an, dass die geparste Eingabeadresse vollständig geändert werden kann, um eine überprüfte Adresse zu erhalten.

KeepMultimatch

Gibt an, ob für Eingabeadressen mit mehreren möglichen Übereinstimmungen mehrere Adressen zurückgegeben werden sollen.

Y
Ja, Mehrfachübereinstimmungen zurückgeben (Standardeinstellung).
N
Nein, keine Mehrfachübereinstimmungen zurückgeben.

Weitere Informationen finden Sie unter Rückgabe von Mehrfachübereinstimmungen.

FailMultipleMatches

Erklärt bei Eingabeadressen mit mehreren möglichen Übereinstimmungen mehrere Adressen für ungültig.