ReplaceRegExGroup - función de script y de gráfico
ReplaceRegExGroup() devuelve una cadena de caracteres tras sustituir una o varias instancias entre una cadena de entrada y el patrón de expresión regular compuesto que se especifique. El texto que sustituye al texto coincidente se especifica en el argumento to_str. La función opera de izquierda a derecha, pero si especifica un valor de occurrence negativo, las funciones se leerán de derecha a izquierda.
Esta función realiza operaciones regex que distinguen entre mayúsculas y minúsculas. Puede utilizar alternativamente la variante ReplaceRegExGroupI() para realizar operaciones regex sin distinguir mayúsculas de minúsculas.
Sintaxis:
ReplaceRegExGroup
(text, regex, to_str, group [, occurrence])
Tipo de datos que devuelve: cadena de texto
Argumentos
Argumento
Descripción
text
El texto de la cadena de entrada que desea sustituir, total o parcialmente, por el nuevo texto de to_str.
regex
La expresión regular que define cuándo reemplazar el texto. Se sustituyen las coincidencias entre este argumento y el argumento text.
to_str
El nuevo texto que desea utilizar para sustituir el contenido existente de text.
group
El número del grupo, en el caso de una expresión regular compuesta.
Si la expresión regular solo contiene un grupo, utilice en su lugar la función ReplaceRegEx(). Como alternativa, utilice ReplaceRegExGroup() con un valor de group0.
Puede especificar un valor negativo en group para buscar grupos de derecha a izquierda.
occurrence
El número de la coincidencia (entre el texto de entrada y la expresión regular) que sustituir por el nuevo texto.
Se trata de un argumento opcional. El valor predeterminado es 0 si se omite. Cuando se utiliza un valor 0, o si se omite el argumento, todas las coincidencias entre text y regex se sustituyen por to_str.
Puede especificar un valor negativo para occurrence si desea identificar las coincidencias de derecha a izquierda.
Devuelve abc123abx123. Hay dos coincidencias entre el primer grupo del texto de entrada y el patrón regex. Sin embargo, solo se sustituye la segunda instancia.
Devuelve ABC123ABC123. En otras palabras, no se sustituye ningún texto. Esto se debe a que la función distingue entre mayúsculas y minúsculas, y no se utiliza la variante de la función que no distingue entre mayúsculas y minúsculas.
Devuelve ABx123ABx123. En este ejemplo, la sustitución del texto se produce porque se utiliza la variante de la función que no distingue entre mayúsculas y minúsculas, ReplaceRegExGroupI().
Cuándo se utiliza
Puede utilizar ReplaceRegExGroup() para modificar el texto y cumplir las normas de formato y conformidad, especialmente cuando necesite identificar patrones complejos en los datos. El argumento adicional group de esta función le permite actualizar solo determinadas partes de un patrón de texto más amplio. Por ejemplo, puede actualizar partes específicas de una URL.
Si es necesario, también puede utilizar esta función para enmascarar información sensible, como la información de identificación personal (IIP), para que no se muestre a los usuarios que analicen su app.
Ejemplo 1: script de carga para actualizar el dominio en las direcciones URL
Descripción
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
Una tabla URLs que contiene inicialmente una lista de cadenas de entrada en las que queremos identificar y actualizar URL específicas. Queremos actualizar el dominio en estas URL.
La creación de un campo, ResourceURL_Updated, que contiene texto de entrada modificado con las URL procesadas.
Una variableURL_RegEx para almacenar la expresión regular que se utiliza para identificar las URL que se van a procesar.
Nuestros requisitos:
Cada cadena de entrada contiene dos URL, con la URL del recurso especificada en la primera URL. No queremos actualizar ninguna URL que no sea la primera de la lista.
La URL que se ha de actualizar debe tener el formato <https o https>://<dominio>.com/<ruta del recurso>. La ruta del recurso es opcional pero no se utiliza en este ejemplo.
Script de carga
Set URL_RegEx = '(https?):\/\/(([a-zA-Z0-9]+)\.([a-zA-Z0-9]*)\.??([a-zA-Z0-9]*))\/?((([a-zA-Z0-9]*)*)((\/?([a-zA-Z0-9]*)*))*)\/{0,1}([\.,;]+(?=\s))*?';
URLs:
Load
ReplaceRegExGroup(URLsList, '$(URL_RegEx)', 'replacement-server', 2,1) as ResourceURL_Updated;
Load * Inline `
URLsList
The resource is located at https://testserver.com/files. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/files/worksheet. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/files/book. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/files/form. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/datamodel. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/resourcenew. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/page. For more help, see: https://support.company.com.
The resource is located at https://testserver.com/page/overview. For more help, see: https://support.company.com.
` (delimiter is '\t');
Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:
ResourceURL_Updated
Tabla de resultados
ResourceURL_Updated
The resource is located at https://replacement-server/datamodel. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/files. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/files/book. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/files/form. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/files/worksheet. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/page. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/page/overview. For more help, see: https://support.company.com.
The resource is located at https://replacement-server/resourcenew. For more help, see: https://support.company.com.
Ejemplo 2: expresión de gráfico para actualizar el protocolo en las URL
Descripción
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
Una tabla denominada URLsList que contiene una lista de cadenas de entrada en las que queremos identificar y actualizar URL específicas. Queremos actualizar el protocolo de http a https en los enlaces a la página web de Soporte.
Nuestros requisitos:
Cada cadena de entrada contiene dos URL, apareciendo el enlace del sitio web de apoyo como segunda URL. No queremos actualizar ninguna otra URL que no sea la segunda.
La URL que queremos actualizar debe tener el formato <https o https>://<dominio>.com/<ruta del recurso>. La ruta del recurso es opcional pero no se utiliza en este ejemplo.
Script de carga
URLs:
Load * Inline `
URLsList
The resource is located at https://testserver.com/files. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/files/worksheet. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/files/book. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/files/form. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/datamodel. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/resourcenew. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/page. For more help, see: http://support.company.com.
The resource is located at https://testserver.com/page/overview. For more help, see: http://support.company.com.
` (delimiter is '\t');
Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:
No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.