Los ejemplos los vamos a hacer en Business Central, pero sirven igual para las versiones anteriores.
Así que voy a explicar con algunos ejemplos cada una de las funciones.
STRSUBSTNO
Reemplaza los campos% 1,% 2,% 3 … y/o # 1, # 2, # 3 … de una cadena con los valores que proporciones como parámetros opcionales. Substituye los %1 por la variable que pongas.
Documentación oficial de Microsoft en Link
Ejemplo
Las tres variables son claras, Customer es para buscar los datos, MyTxt para almacenar el resultado y por último MyLbl es para el texto a formatear.
Lo que estamos haciendo aquí es substituir el “%1” por el numero de cliente y el “%2” por el nombre del cliente
El resultado sería:
El número de cliente 10000 tiene el nombre GDE Distribución S.A.
STRPOS
Busca la primera aparición de la subcadena dentro de una cadena.
Documentación oficial de Microsoft en Link
Ejemplo
Aquí al igual que arriba creamos la variable de cliente dos Labels, el primero para buscar la palabra y el segundo para mostrar el mensaje, por último, una variable para que nos indique en que posición esta.
En la función lo que tenemos que pasarla primero es el texto donde estará lo que queremos buscar, y en el segundo parámetro el texto a buscar.
Notar que en este ejemplo a la hora de sacarlo por el mensaje no hemos hecho el StrSubstNo por que el MESSAGE lo lleva incorporado.
El resultado sería:
El texto “S.A.” empieza en la posición 18, del nombre de cliente GDE Distribución S.A.
STRLEN
Obtiene la longitud de una cadena que define.
Documentación oficial de Microsoft en Link
Ejemplo
Creamos la variable de ejemplo de cliente, el Integer para obtener la longitud del texto y por ultimo el texto que mostraremos en pantalla
Como vemos este ejemplo lo que nos devolverá es el total de caracteres en un texto en concreto, o lo que es lo mismo la longitud del texto.
El resultado sería:
El texto “GDE Distribución S.A.”, tiene 21 caracteres.
INCSTR
Aumenta un número positivo o disminuye un número negativo dentro de una cadena en uno (1).
Documentación oficial de Microsoft en Link
Ejemplo
Las variables son un texto para recibir el resultado y dos labels uno donde estará el texto a incrementar y el otro para mostrar el resultado por mensaje.
Lo que estamos haciendo aquí es substituir el “%1” por el numero de cliente y el “%2” por el nombre del cliente
El resultado sería:
El número de cliente 10000 tiene el nombre GDE Distribución S.A.
COPYSTR
Copia una subcadena de cualquier longitud desde una posición específica en una cadena (texto o código) a una nueva cadena. Extrae parte del texto de la posición hasta el final.
Documentación oficial de Microsoft en Link
Ejemplo
Volvemos a crear la variable de cliente, el texto de destino y el label final para mostrar por mensaje.
Como podemos ver lo que hemos hecho es descomponer el nombre del cliente sacando una parte del texto.
El resultado sería:
El texto inicial era: “GDE Distribución S.A.” y el nuevo testo es: “Distribución”
MAXSTRLEN
Obtiene la longitud máxima definida de una variable de cadena.
Documentación oficial de Microsoft en Link
Ejemplo
Primero creamos la variable de clientes para tener el texto a comprobar, después la variable de Integer para que nos de el resultado y por ultimo la variable que mostraremos en el mensaje.
Como podemos ver la función solo le tenemos que pasar el texto que queremos analizar y ver su máximo contenido.
Hemos ido a la tabla a buscar como esta creado este campo para que podáis ver que el resultado que nos esta dando e el mismo que esta parametrizado en el campo de la tabla.
El resultado sería:
El texto inicial era: “GDE Distribución S.A.” tiene 100 de capacidad maxima.
PADSTR
Cambia la longitud de una cadena a una longitud que usted defina. También rellenar el resto del texto.
Documentación oficial de Microsoft en Link
Ejemplo
En este ejemplo crearemos la variable de clientes, dos texto para recoger los resultados y tres variables de label para mostrar el resultado.
En este ejemplo añadimos una cosa que hasta ahora no lo habíamos mostrado y es que podemos hacer un salto de línea añadiendo al final del texto el símbolo “\” Por lo que las tres variables de tipo Label las unimos en el mismo mensaje, pero se mostraran en líneas diferentes.
Vamos a explicar un poco los dos resultados. El primero lo que hace es algo similar al CopyStr pero el parámetro de inicio es siempre 1. Por lo que acortara el texto hasta lo que le marquemos.
El segundo ejemplo es para que le digamos que quiere rellenar el resto del texto con el texto que hayamos puesto en el parámetro el final en este caso el número del cliente tiene 5 caracteres y añadimos 10 mas como “0”.
El resultado sería:
El texto original es: “10000”.
El resultado del primer ejemplo es: “10”.
El resultado del segundo ejemplo es:”100000000000000″.
DELCHR
Elimina uno o más caracteres de una cadena. Le dices un carácter y te borra de un texto ese carácter.
Documentación oficial de Microsoft en Link
Ejemplo
Creamos la variable de clientes. Después el texto donde recibiremos el resultado del formateo. Lo siguiente son las labels de parámetros y por ultimo los labels de mensaje.
Los labels de parámetros son lo más complicado de entender de esta función, sobre todo el label “WhereLbl”. Este label hará que la función haga una cosa u otra dependiendo de lo que le añadamos. Los tipos pueden ser:
El segundo parámetro es para indicarle que queremos eliminar. En este ejemplo lo que hemos querido eliminar es la letra “D”.
El resultado sería:
El texto original es: “GDE Distribución S.A.”
El texto nuevo es: “DE Distribución S.A.”
STRCHECKSUM
Calcula una suma de comprobación para una cadena que contiene un número.
Documentación oficial de Microsoft en Link
Ejemplo
Las variables en este caso son, dos Integers uno para recibir el resultado, dos labels para los números a calcular y los dos labels del mensaje.
Para que lo entendamos un poco mejor lo que está haciendo la fórmula es esta: (7 – (4×1 + 3×2 + 7×3 + 8×4) MOD 7) MOD 7=0
El resultado sería:
El número original es: 4378
El resultado de la verificación de suma es: 0
CONVERTSTR
Convierte algunos caracteres en una cadena. Reemplazar caracteres en un texto.
Documentación oficial de Microsoft en Link
Ejemplo
Creamos la variable de clientes, 2 labels donde indicamos lo que queremos cambiar y como y los labels que mostraremos con el mensaje.
Este proceso lo que hace es substituir que este en el “My1Lbl” por lo que este en el “My2Lbl” y devuelve el nuevo texto.
El resultado sería:
El texto original es: “GDE Distribución S.A.”
El nuevo texto es: “gde Distribución S.A.”
LOWERCASE
Convierte todas las letras de una cadena a minúsculas.
Documentación oficial de Microsoft en Link
Ejemplo
Las variables son cliente, la variable de texto y los labels del mensaje.
Como podemos ver en el código esto es simple transforma todo el texto en minúsculas.
El resultado sería:
El texto original es: “GDE Distribución S.A.”
El nuevo texto es: “gde distribución s.a.”
UPPERCASE
Convierte todas las letras de una cadena a mayúsculas.
Documentación oficial de Microsoft en Link
Ejemplo
Las variables son cliente, la variable de texto y los labels del mensaje.
Como podemos ver en el código esto es simple transforma todo el texto en mayúsculas.
El resultado sería:
El texto original es: “GDE Distribución S.A.”
El nuevo texto es: “GDE DISTRIBUCIÓN S.A.”
SELECTSTR
Recupera una subcadena de una cadena separada por comas. Seleccionar un trozo del texto que este entre comas.
Documentación oficial de Microsoft en Link
Ejemplo
Las variables son el texto que recibirá el resultado, el label donde tenemos el texto original y por ultimo los labels del mensaje.
Esta función es como si transformara el texto que hay entre cada coma como si fuera un array, por lo que si le decimos el 2 lo que devolverá es la palabra que hay después de la primera coma.
El resultado sería:
El texto original es: “Esteve Sanpons Carballares”
El nuevo texto es: “Sanpons”
DELSTR
Elimina una subcadena dentro de una cadena (texto o código). Borrar un cacho de cadena con posición inicial y final.
Documentación oficial de Microsoft en Link
Ejemplo
Primero creamos la variable de clientes, una de texto para recibir el resultado y por ultimo los labels del mensaje.
Como podemos ver lo que hace esta función es eliminar des de una posición hasta tantos caracteres como le decimos. En este caso lo que queremos es quitar la parte inicial del texto.
El resultado sería:
El texto original es: “GDE Distribución S.A.”
El nuevo texto es: “Distribución S.A.”
INSSTR
Inserta una subcadena en una cadena. Añade texto en mitad de un texto.
Documentación oficial de Microsoft en Link
Ejemplo
Primero creamos la variable de clientes, una de texto para recibir el resultado y por ultimo los labels del mensaje.
Esta función es muy curiosa lo que hace es insertar un texto en mitad de otro en el lugar que tú le indiques.
El resultado sería:
El texto original es: “GDE Distribución S.A.”
El nuevo texto es: “GDE Distribuciones S.A.”
GitHub de los ejemplos en el Link
Leave a Reply