EN · DE · RU · FR · ES

#1381: PhoneNumberUtils.kt

projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt Clase Kotlin, projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt 289 líneas · 165 código · 84 comentarios · 40 en blanco
Propósito: Archivo fuente: projectforge/framework/utils/PhoneNumberUtils.kt. PhoneNumberUtils.kt es parte de la aplicación de gestión de proyectos de código abierto ProjectForge.

Fuente (primeras 100 líneas)

/////////////////////////////////////////////////////////////////////////////
//
// Proyecto ProjectForge Community Edition
//         www.projectforge.org
//
// Copyright (C) 2001-2026 Micromata GmbH, Alemania (www.micromata.com)
//
// ProjectForge tiene doble licencia.
//
// Esta edición comunitaria es software libre; puedes redistribuirla y/o
// modificarla bajo los términos de la Licencia Pública General GNU publicada
// por la Free Software Foundation; versión 3 de la Licencia.
//
// Esta edición comunitaria se distribuye con la esperanza de que sea útil,
// pero SIN NINGUNA GARANTÍA; sin siquiera la garantía implícita de
// COMERCIABILIDAD o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Consulte la Licencia
// General Pública de GNU para más detalles.
//
// Deberías haber recibido una copia de la Licencia Pública General GNU junto
// con este programa; si no, visita http://www.gnu.org/licenses/.
//
/////////////////////////////////////////////////////////////////////////////

package org.projectforge.framework.utils

import org.projectforge.framework.configuration.Configuration
import org.projectforge.framework.configuration.ConfigurationParam

/**
 * Funciones de utilidad para normalización y formateo de números de teléfono.
 *
 * @author Kai Reinhard (k.reinhard@micromata.de)
 */
object PhoneNumberUtils {

    // Códigos de país comunes (1-3 dígitos)
    private val KNOWN_COUNTRY_CODES = setOf(
        "1",   // EE. UU., Canadá
        "7",   // Rusia, Kazajistán
        "20", "27",  // Egipto, Sudáfrica
        "30", "31", "32", "33", "34", "36", "39", "40", "41", "43", "44", "45", "46", "47", "48", "49", // Europa
        "51", "52", "53", "54", "55", "56", "57", "58", // Sudamérica
        "60", "61", "62", "63", "64", "65", "66", // Asia/Oceanía
        "81", "82", "84", "86", "90", "91", "92", "93", "94", "95", "98", // Asia
        "212", "213", "216", "218", "220", "221", "222", "223", "224", "225", "226", "227", "228", "229", // África
        "230", "231", "232", "233", "234", "235", "236", "237", "238", "239", "240", "241", "242", "243", "244", "245", "246", "247", "248", "249", // África
        "250", "251", "252", "253", "254", "255", "256", "257", "258", "260", "261", "262", "263", "264", "265", "266", "267", "268", "269", // África
        "290", "291", "297", "298", "299", // Atlántico
        "350", "351", "352", "353", "354", "355", "356", "357", "358", "359", // Europa
        "370", "371", "372", "373", "374", "375", "376", "377", "378", "380", "381", "382", "383", "385", "386", "387", "389", // Europa
        "420", "421", "423", // Europa
        "500", "501", "502", "503", "504", "505", "506", "507", "508", "509", "590", "591", "592", "593", "594", "595", "596", "597", "598", "599", // Américas
        "670", "671", "672", "673", "674", "675", "676", "677", "678", "679", "680", "681", "682", "683", "684", "685", "686", "687", "688", "689", "690", "691", "692", // Pacífico
        "850", "852", "853", "855", "856", "880", "886", // Asia
        "960", "961", "962", "963", "964", "965", "966", "967", "968", "970", "971", "972", "973", "974", "975", "976", "977", "992", "993", "994", "995", "996", "998" // Asia/Oriente Medio
    )

    /**
     * Normaliza un número de teléfono a un formato estandarizado y legible.
     *
     * Formato: +[País] [Área] [Número][-Extensión]
     *
     * Ejemplos:
     * - "0561 316793-0" → "+49 561 316793-0"
     * - "+49 (0) 561 / 316793-0" → "+49 561 316793-0"
     * - "0170 1234567" → "+49 170 1234567"
     * - "+1 415 555-1234" → "+1 415 5551234"
     *
     * @param phoneNumber El número de teléfono a normalizar (puede contener espacios, barras, paréntesis, etc.)
     * @param defaultCountryPrefix El prefijo de país predeterminado a usar si no hay ninguno presente (por defecto: desde configuración o "+49")
     * @return Número de teléfono normalizado en formato "+CC AAA NNNNNNN[-EXT]" o null si la entrada es nula/vacía
     */
    fun normalizePhoneNumber(
        phoneNumber: String?,
        defaultCountryPrefix: String = getDefaultCountryPrefix()
    ): String? {
        if (phoneNumber.isNullOrBlank()) {
            return null
        }

        var cleaned = phoneNumber.trim()

        // Eliminar prefijos como "Tel:", "Phone:", "Fax:", etc.
        cleaned = cleaned.replace(Regex("^(?:Tel\\.?:|Telefon:|Phone:|Mobil:|Mobile:|Fax:)\\s*", RegexOption.IGNORE_CASE), "")

        // Eliminar caracteres de control UTF
        cleaned = cleaned.replace("\\p{C}".toRegex(), "")

        // Eliminar (0) en +49 (0) 123456789
        cleaned = cleaned.replace(Regex("\\(0\\)"), "")

        // Eliminar paréntesis y barras al inicio para la detección del código de país
        cleaned = cleaned.replace(Regex("[/()]"), "")

        if (cleaned.isEmpty()) {
            return null
        }

        // Devolver números muy cortos (3 dígitos o menos) sin cambios: números de emergencia, códigos cortos, etc.
        // Ejemplos: 0, 00, 110, 112

Historial Git

868d6abb7 2025 -> 2026
2b9888261 Refactorizado el formateo de números en Sipgate y manejo de vcard.
a2608ee2e PhoneNumberUtils...
c624d79b8 PhoneNumberUtils.formatPhoneNumber y AddressTextParser

868d6abb7

2025 -> 2026
868d6abb75cd191a892911ac8e45058932cf9074
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
index 320fb1c99..37ee6ed30 100644
--- a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -3,7 +3,7 @@
 // Project ProjectForge Community Edition
 //         www.projectforge.org
 //
-// Copyright (C) 2001-2025 Micromata GmbH, Germany (www.micromata.com)
+// Copyright (C) 2001-2026 Micromata GmbH, Germany (www.micromata.com)
 //
 // ProjectForge is dual-licensed.
 //

2b9888261

Refactorizado el formateo de números en Sipgate y manejo de vcard.
2b9888261f5880a0d9bda8d7343c4367bd32d7c9
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
index 506ea65ab..320fb1c99 100644
--- a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -89,21 +89,50 @@ object PhoneNumberUtils {
         // Eliminar (0) en +49 (0) 123456789
         cleaned = cleaned.replace(Regex("\\(0\\)"), "")
 
+        // Eliminar paréntesis y barras al inicio para la detección del código de país
+        cleaned = cleaned.replace(Regex("[/()]"), "")
+
         if (cleaned.isEmpty()) {
             return null
         }
 
+        // Devolver números muy cortos (3 dígitos o menos) sin cambios: números de emergencia, códigos cortos, etc.
+        // Ejemplos: 0, 00, 110, 112
+        // Pero NO si comienzan con 00X (prefijo internacional) o +X
+        val digitCount = cleaned.count { it.isDigit() }
+        if (digitCount in 1..3) {
+            // Permitir "0", "00", "110", "112" etc. pasar sin cambios
+            // Pero bloquear "001", "0049" etc. (formato internacional) - necesitan procesamiento
+            if (cleaned == "0" || cleaned == "00" || !cleaned.startsWith("00") && !cleaned.startsWith("+")) {
+                return cleaned
+            }
+        }
+
         // Extraer código de país
-        val (countryCode, remainingPart) = extractCountryCode(cleaned, defaultCountryPrefix)
+        val (countryCode, remainingPart, hasPrefix) = extractCountryCode(cleaned, defaultCountryPrefix)
+
+        // Si no se detectó prefijo (sin +, sin 00, sin 0 inicial), devolver el número limpio sin cambios
+        if (!hasPrefix) {
+            // Solo limpiar caracteres especiales y normalizar espacios
+            val result = cleaned
+                .replace(".", " ")
+                .replace(Regex("\\s+"), " ")
+                .trim()
+            // Pero validar que contenga al menos algunos dígitos
+            if (!result.contains(Regex("\\d"))) {
+                return null
+            }
+            return result
+        }
 
         if (remainingPart.isBlank()) {
-            return null
+            // Si solo existe el código de país (ej., "001" -> "+1"), devolver solo el código de país
+            return countryCode
         }
 
-        // Limpiar parte restante: reemplazar puntos con espacios (separador), eliminar barras/paréntesis, luego normalizar espacios
+        // Limpiar parte restante: reemplazar puntos con espacios (separador), luego normalizar espacios
         var remaining = remainingPart.trim()
             .replace(".", " ") // El punto es un separador entre bloques de números
-            .replace(Regex("[/()]"), "") // Eliminar barras, paréntesis
             .replace(Regex("\\s+"), " ") // Normalizar múltiples espacios a un solo espacio
             .trim()
 

a2608ee2e

PhoneNumberUtils...
a2608ee2e9bf20343a26a5543fc0f06176735862
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
index 41a89f714..506ea65ab 100644
--- a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -100,9 +100,10 @@ object PhoneNumberUtils {
             return null
         }
 
-        // Limpiar parte restante: eliminar barras, puntos, paréntesis primero, luego normalizar espacios
+        // Limpiar parte restante: reemplazar puntos con espacios (separador), eliminar barras/paréntesis, luego normalizar espacios
         var remaining = remainingPart.trim()
-            .replace(Regex("[/().]"), "") // Eliminar barras, paréntesis, puntos
+            .replace(".", " ") // El punto es un separador entre bloques de números
+            .replace(Regex("[/()]"), "") // Eliminar barras, paréntesis
             .replace(Regex("\\s+"), " ") // Normalizar múltiples espacios a un solo espacio
             .trim()
 

c624d79b8

PhoneNumberUtils.formatPhoneNumber y AddressTextParser
c624d79b8c005f4f746148f647e9eb1dbff3226f
diff --git a/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
new file mode 100644
index 000000000..41a89f714
--- /dev/null
+++ b/projectforge-business/src/main/kotlin/org/projectforge/framework/utils/PhoneNumberUtils.kt
@@ -0,0 +1,256 @@
+/////////////////////////////////////////////////////////////////////////////
+//
+// Proyecto ProjectForge Community Edition
+//         www.projectforge.org
+//
+// Copyright (C) 2001-2025 Micromata GmbH, Alemania (www.micromata.com)
+//
+// ProjectForge tiene doble licencia.
+//
+// Esta edición comunitaria es software libre; puedes redistribuirla y/o
+// modificarla bajo los términos de la Licencia Pública General GNU publicada
+// por la Free Software Foundation; versión 3 de la Licencia.
+//
+// Esta edición comunitaria se distribuye con la esperanza de que sea útil,
+// pero SIN NINGUNA GARANTÍA; sin siquiera la garantía implícita de
+// COMERCIABILIDAD o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Consulte la
+// Licencia General Pública de GNU para más detalles.
+//
+// Deberías haber recibido una copia de la Licencia Pública General GNU junto
+// con este programa; si no, visita http://www.gnu.org/licenses/.
+//
+/////////////////////////////////////////////////////////////////////////////
+
+package org.projectforge.framework.utils
+
+import org.projectforge.framework.configuration.Configuration
+import org.projectforge.framework.configuration.ConfigurationParam
+
+/**
+ * Funciones de utilidad para normalización y formateo de números de teléfono.
+ *
+ * @author Kai Reinhard (k.reinhard@micromata.de)
+ */
+object PhoneNumberUtils {
+
+    // Códigos de país comunes (1-3 dígitos)
+    private val KNOWN_COUNTRY_CODES = setOf(
+        "1",   // EE. UU., Canadá
+        "7",   // Rusia, Kazajistán
+        "20", "27",  // Egipto, Sudáfrica
+        "30", "31", "32", "33", "34", "36", "39", "40", "41", "43", "44", "45", "46", "47", "48", "49", // Europa
+        "51", "52", "53", "54", "55", "56", "57", "58", // Sudamérica
+        "60", "61", "62", "63", "64", "65", "66", // Asia/Oceanía
+        "81", "82", "84", "86", "90", "91", "92", "93", "94", "95", "98", // Asia
+        "212", "213", "216", "218", "220", "221", "222", "223", "224", "225", "226", "227", "228", "229", // África
+        "230", "231", "232", "233", "234", "235", "236", "237", "238", "239", "240", "241", "242", "243", "244", "245", "246", "247", "248", "249", // África
+        "250", "251", "252", "253", "254", "255", "256", "257", "258", "260", "261", "262", "263", "264", "265", "266", "267", "268", "269", // África
+        "290", "291", "297", "298", "299", // Atlántico
+        "350", "351", "352", "353", "354", "355", "356", "357", "358", "359", // Europa
+        "370", "371", "372", "373", "374", "375", "376", "377", "378", "380", "381", "382", "383", "385", "386", "387", "389", // Europa
+        "420", "421", "423", // Europa
+        "500", "501", "502", "503", "504", "505", "506", "507", "508", "509", "590", "591", "592", "593", "594", "595", "596", "597", "598", "599", // Américas
+        "670", "671", "672", "673", "674", "675", "676", "677", "678", "679", "680", "681", "682", "683", "684", "685", "686", "687", "688", "689", "690", "691", "692", // Pacífico