BAFormatPhoneNumber(telefonnummer, region, format)
Diese Funktion bringt Telefonnummern in ein einheitliches Format.
Parameter
1. Die zu konvertierende Telefonnummer.
2. Optional: ISO-Code des Landes zur interpretation der Telefonnummer.
Diese wird für unvollständige, nicht internationale Telefonnummern, d.h. die nicht mit + beginnen, benötigt.
Standardmäßig wird das Standardland der Anwendung aus den Anwendungseinstellungen verwendet. Wenn auch keine Standardland hinterlegt ist, können unvollständige Nummern nicht interpretiert werden.
3. Optional: Zielformat: ‘E164’, ‘INTERNATIONAL’, ‘NATIONAL’ oder ‘RFC3966’. Standard ist E164, was sich primär für die technische Verwendung eignet.
Die Ermittlung des Standardlandes aus der Anwendungskonfiguration kann über den Customer.config-Parameter BA:CTI.DefaultRegion überschrieben werden.
An dieser Stelle kann zusätzlich über BA:CTI.DefaultCityCode eine Standard-Vorwahl für das lokale Ortsnetz hinterlegt werden, die zur Ergänzung unvollständiger Telefonnummern verwendet wird. Es wird aber empfohlen immer nur Telefonnummern mit Vorwahl zu hinterlegen.
Ergebnis
| E164 | ‘+492631801357’ |
| INTERNATIONAL | ‘+49 2631 801357’ |
| NATIONAL | ’02631 801357’ |
| RFC3966 | ‘tel:+49-2631-801357’ |
| Telefonnummer ist leer oder null | ‘’ (leerer Text) |
| Fehler: Nummer in Region ungültig | null |
Beispiele
| Formel | Erklärung |
|---|---|
BAFormatPhoneNumber([Phone] ?? [PersonalCellphone], 'DE') |
Die Telefonnummer oder, falls nicht verfügbar, die Mobilfunknummer einer Person als vollständige Nummer incl. Ländervorwahl. Die gespeicherte Nummer wird als Deutsche Nummer betrachtet, falls sie nicht schon eine Ländervorwahl enthält. |
BAFormatPhoneNumber(BAGetPrimarySource([<OrmCRMCompany>RelatedResponsiblePerson],null,null,[Phone]), null, INTERNATIONAL') |
Die Telefonnummer des Betreuers einer Firma. Es wird das Standardland der Anwendung für die Interpretation der gespeicherten Nummer verwendet. |
BAFormatPhoneNumber([Phone], [Addresses][[AddressType]={EB7852EF-9BA5-47F6-AB68-82FB891A2943}].Single(BAGetEnumValueAdditionalText([Country], 'Countries', 'ISOCode')), 'NATIONAL') |
Die Telefonnummer im Kontext des Landes der Primäranschrift als nationale Nummer. |
BAFormatPhoneNumber([Phone], null, 'NATIONAL') ?? [Phone] |
Telefonnummer ins Nationale Format ihres Landes umwandeln oder, falls die Nummer ungültig ist, unverändert anzeigen. |