CheckNumber.AI · 6 min read
Einen vCard-Export in eine Liste zur Massenüberprüfung von Telefonnummern umwandeln
vCard-TEL-Einträge in eine Sammeldatei mit einer Nummer pro Zeile extrahieren – unter Beibehaltung von Kontakt-IDs, Labels und Prüfausnahmen.
Um einen vCard-Export in eine Liste zur Massenüberprüfung von Telefonnummern umzuwandeln, extrahieren Sie jeden TEL-Eintrag, behalten Sie die Referenz zum Quellkontakt bei und normalisieren Sie die Telefonnummer in eine separate Datei mit einer Nummer pro Zeile. Eine Kontaktkarte kann mehrere Telefonfelder enthalten, daher entspricht die Anzahl der Prüfeingaben nicht zwangsläufig der Anzahl der Karten. Behalten Sie eine Zuordnung zur ursprünglichen Karte bei, bevor Sie Daten deduplizieren oder hochladen.
Verstehen, was ein vCard-TEL-Eintrag darstellt
Die vCard specification definiert TEL als Telefoneigenschaft innerhalb einer Kontaktkarte. Eine Karte kann mehrere TEL-Eigenschaften mit Labels oder Typparametern enthalten, die zwischen geschäftlicher Nutzung, Mobiltelefon, privatem Anschluss oder einem anderen Verwendungszweck unterscheiden. Einige Exporte stellen den Wert als Text dar; andere verwenden eine URI-Form. Ein Name auf der Karte stellt Kontaktkontext dar und ist kein Bestandteil der zu prüfenden Nummer. Ebenso ist eine Präferenzkennzeichnung ein Hinweis darauf, welche Nummer das Adressbuch möglicherweise zuerst anzeigt, jedoch keine Garantie dafür, dass die bevorzugte Nummer gültig ist.
Ein allgemeiner Leitfaden für CSV setzt häufig erst an, nachdem die Kontaktdaten bereits verflacht wurden. Bei der vCard-Konvertierung tritt bereits zuvor eine Herausforderung auf: Eine Karte kann sich in null, eine oder viele Telefonzeilen aufteilen. Behält das Team nur den ersten TEL-Wert bei, entgeht ihm möglicherweise ein relevanter geschäftlicher Anschluss. Wird die gesamte Karte in eine einzige Tabellenzelle kopiert, kann ein Prüfdienst die Eingabe nicht als eine Telefonnummer pro Zeile interpretieren. Der Konvertierungsschritt muss sowohl die Nummer als auch die Beziehung zur Karte erhalten.
Eine quellenerhaltende Extraktionstabelle erstellen
Speichern Sie den ursprünglichen .vcf-Export und erstellen Sie eine Arbeitstabelle mit einer stabilen Kartenkennung, einer TEL-Vorkommniskennung, dem ursprünglichen TEL-Text, dem angezeigten Namen der Karte (sofern für die interne Prüfung erforderlich), eventuellen TEL-Typlabels, dem interpretierten Land, dem normalisierten Kandidaten und einem Prüfstatus. Dies sind vorgeschlagene lokale Felder, keine dokumentierten CheckNumber.AI-Upload- oder -Ergebnisfelder. Eine einzelne Karte mit geschäftlichen und mobilen TEL-Einträgen wird zu zwei Tabellenzeilen, die sich dieselbe Karten-ID teilen, jedoch separate Vorkommnis-IDs besitzen.
Verwenden Sie nach Möglichkeit einen Parser, der vCard verarbeiten kann. Das Format weist Regeln für Maskierungen und Zeilenumbrüche (Line Folding) auf; ein reines Aufteilen anhand von Zeilenumbruchzeichen kann lange Eigenschaften beschädigen. Behalten Sie den ursprünglichen TEL-Wert neben dem analysierten Wert bei, damit Prüfer einen Parsing-Fehler von einem fehlerhaften Quelldatensatz unterscheiden können. Handelt es sich bei einem TEL-Wert um eine tel:-URI, verarbeiten Sie deren URI-Notation im lokalen Parser und behalten Sie den unveränderten Wert für Nachweiszwecke bei. Gehen Sie nicht davon aus, dass das Quelladressbuch ein einheitliches Land verwendet oder jede Nummer im internationalen Format gespeichert hat.
Kandidaten normalisieren und unklare Einträge isolieren
Ermitteln Sie für jedes TEL-Vorkommnis, ob ausreichend Länderkontext vorhanden ist, um eine internationale Telefonnummer zu bilden. Eine lokale Nummer ohne Ländercode erfordert möglicherweise ein Land, das dem Kontakt oder dem Quellsystem zugeordnet ist; die Sprache eines Kontakts allein ist ein unzureichender Anhaltspunkt. Raten Sie das Land nicht anhand einer vertrauten Vorwahl und zwingen Sie eine Nummer nicht in ein gültig wirkendes Format. Leiten Sie unvollständige Werte, reine Durchwahlen, Dienstcodes und mehrdeutige Angaben in eine Prüfwarteschlange weiter. Enthält eine Nummer eine Nebenstellennummer (PBX), behalten Sie diese in der Zuordnung bei und übermitteln Sie nur die öffentliche Basisnummer, sofern diese Aufteilung durch die Quelle unterstützt wird.
Der ITU E.164 numbering plan liefert den Rahmen für internationale Nummern. Für den Massenprüfungs-Arbeitsablauf von CheckNumber.AI nutzen Telefonlistendateien ein Land pro Datei und eine Nummer pro Zeile mit Ländercode; das Pluszeichen kann weggelassen werden. Erstellen Sie für jedes Land eine separate, reine Nummerndatei. Eine Karte, die Nummern aus zwei Ländern enthält, kann jeweils einen Eintrag zu jeder Datei beisteuern und bleibt dennoch eine einzelne Karte in der Quellzuordnung. Fügen Sie niemals Kontaktnamen, TEL-Labels oder IDs in eine reine Nummernzeile ein.
Prüfeingaben deduplizieren, ohne Kontakte zusammenzuführen
Mehrere Kontaktkarten können auf dieselbe Firmenzentrale oder Familiennummer verweisen. Normalisieren Sie die Kandidatenwerte und erstellen Sie anschließend eine Zuordnung von jeder eindeutigen Prüfeingabe zu allen TEL-Vorkommnis-IDs, aus denen sie hervorgegangen ist. Dies kann redundante Prüfungen reduzieren, die Quellzeilen müssen jedoch getrennt bleiben. Eine doppelte Nummer ist kein Nachweis dafür, dass die Karten dieselbe Person darstellen. Ebenso bedeutet eine einzelne Karte mit zwei Nummern nicht, dass die Nummern dasselbe Gültigkeits- oder Aktivitätssignal aufweisen.
Vergleichen Sie vor dem Hochladen die Anzahlen auf jeder Stufe: analysierte Karten, extrahierte TEL-Eigenschaften, prüfbedürftige Einträge, normalisierte Kandidaten und vorbereitete eindeutige Nummern. Gehen Sie unerwarteten Rückgängen nach. Prüfen Sie stichprobenartig Karten mit mehreren TEL-Werten und stellen Sie sicher, dass für sie mehrere Zuordnungszeilen vorhanden sind. Überprüfen Sie einige Datensätze durchgängig: ursprüngliche vCard-Eigenschaft, lokaler normalisierter Kandidat, Upload-Zeile und Zuordnungsschlüssel. Dies ist aufschlussreicher als lediglich zu bestätigen, dass sich eine CSV- oder TXT-Datei öffnen lässt.
Ergebnisse prüfen und wieder zusammenführen
Wählen Sie das dokumentierte Produkt zur Massenüberprüfung von Telefonnummern, das die Fragestellung des Teams beantwortet; CheckNumber.AI’s product catalog unterscheidet verschiedene Prüfsignale. Ein Format- oder Gültigkeitsergebnis, ein Plattform-Registrierungssignal und ein Aktivitätssignal haben unterschiedliche Bedeutungen. Betrachten Sie keines davon als Nachweis für ein anderes und leiten Sie aus keinem dieser Signale die Inhaberschaft des Kontakts ab. Speichern Sie das Prüfdatum und das ausgewählte Produkt zusammen mit dem lokalen Ergebnis.
Wenn die Ergebnisse exportiert werden, gleichen Sie die geprüfte Nummer mit dem normalisierten Schlüssel in der Extraktionstabelle ab und führen Sie diese Beziehung anschließend wieder zu jedem TEL-Vorkommnis und jeder Karte zusammen. Verlassen Sie sich nicht auf die Dateireihenfolge und gehen Sie nicht davon aus, dass jede Upload-Zeile eine identische Ergebniszeile erzeugt hat. Untersuchen Sie nicht zugeordnete, doppelte oder unsichere Ergebnisse, bevor Sie das Adressbuch oder CRM aktualisieren. Behalten Sie das ursprüngliche TEL-Label bei, damit ein Team nachvollziehen kann, ob sich ein Ergebnis auf eine geschäftliche Leitung oder einen Mobilfunkanschluss bezog. Ein benutzergesteuerter Prüfschritt kann anschließend entscheiden, ob jeder Kontaktwert gekennzeichnet, korrigiert oder beibehalten wird. Der Prüfdienst liefert ein Signal auf Nummernebene; der Abgleich der Kontaktkarten obliegt dem Team.
FAQ
Wie können Teams mit mehreren TEL-Einträgen auf einer einzelnen vCard umgehen?
Teilen Sie jede TEL-Eigenschaft in eine separate lokale Zeile mit eigener Vorkommnis-ID auf, während Sie dieselbe Quellkarten-ID beibehalten. Bereiten Sie jede geeignete Nummer als einzelne Prüfeingabe vor.
Sollten doppelte Nummern auf verschiedenen Karten gelöscht werden?
Nein. Deduplizieren Sie die Prüfeingaben, falls dies zweckmäßig ist, behalten Sie jedoch jede Zuordnung von Karte zu Nummer bei. Gemeinsam genutzte Nummern belegen nicht, dass es sich um identische Personen oder Unternehmen handelt.
Was ist zu tun, wenn ein TEL-Eintrag keinen Ländercode enthält?
Nutzen Sie verlässlichen Kontext aus der Quelle, um das Land zu bestimmen, oder halten Sie den Eintrag zur Überprüfung zurück. Raten Sie kein Land, nur damit der Wert eine Formatprüfung besteht.
Kann eine Telefonprüfung den Namen auf einer vCard verifizieren?
Nein. Ein Prüfsignal auf Nummernebene verifiziert weder die Identität des Karteninhabers noch die aktuelle Beziehung zwischen der Nummer und dem genannten Kontakt.
