charset-decode
La función charset-decode toma como entrada datos binarios cifrados como texto en Base64. Descifra datos conforme al conjunto de caracteres indicado (por ejemplo, "utf-8") y devuelve el valor de cadena resultante. Si necesita cifrar datos binarios como texto en Base64, use la función charset-encode .
Lenguajes
Disponible en el motor de ejecución integrado.
Parámetros
Nombre | Tipo | Descripción |
|---|---|---|
binary-data | xs:base64Binary | Los datos binarios como texto en Base 64. |
encoding | xs:string | El conjunto de caracteres usado para codificar (por ejemplo, "utf-8"). |
error-abort | xs:boolean | Argumento opcional que indica cómo debe continuar el procesamiento si se encuentran errores. Son valores válidos:
•true: terminar el procesamiento con una excepción donde está el carácter no válido. •false: terminar el procesamiento y reemplazar los caracteres no válidos con el carácter de sustitución .
El valor predeterminado es true. |
Ejemplo
Imagine que quiere descodificar datos binarios con origen en el siguiente archivo XML. Observe que el elemento message contiene datos binarios codificados como texto en Base 64.
<?xml version="1.0" encoding="UTF-8"?> |
El tipo de datos del elemento message es xs:base64Binary, como se ve en el esquema:
<?xml version="1.0" encoding="UTF-8"?> |
Este es el aspecto de una asignación que descodifica el mensaje anterior:
La asignación de este mensaje tiene como salida el texto "Lorem ipsum".
Una asignación también puede procesar texto o archivos XML codificados como datos en Base64 con ayuda de un componente de serialización de MapForce. Por ejemplo, la asignación siguiente tiene un parámetro de entrada que espera datos de texto en Base64. Si asumimos que los datos en Base64 se crearon a partir de un archivo XML, como se muestra en el ejemplo charset-encode , se puede recrear el archivo XML original como se aprecia en esta asignación:
En esta asignación el argumento error-abort toma el valor false, que se produce con ayuda de la función integrada boolean. Esto garantiza que el procesamiento siga aunque se encuentren caracteres no válidos. La cadena de texto que resulta de la función se pasa a un componente de análisis XML que la convierte en un archivo XML. Observe que para que sea posible el análisis XML debe tener el archivo de esquema XSD. Para más información consulte Redistribuir y serializar cadenas de texto.