charset-encode
La función charset- encode toma como cadena de entrada datos que cifra como texto en Base64. Los datos se cifran en el conjunto de caracteres especificado (por ejemplo, "utf-8") y se devuelven como un tipo xs:base64Binary. Si necesita descifrar datos binarios previamente cifrados como texto en Base64, use la función charset-decode. charset-decode .
Lenguajes
Disponible en el motor de ejecución integrado.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
string-data | xs:string | El datos de cadena que se debe cifrar. |
encoding | xs:string | El conjunto de caracteres usado para codificar (por ejemplo, "utf-8"). |
substitute | xs:string | Argumento opcional que indica qué carácter de reemplazo usar si se encuentran caracteres no válidos. Este argumento se aplica si está usando un cifrado que no sea Unicode. Para cifrados Unicode, el carácter de reemplazo es . |
Ejemplo
Imagine que quiere cifrar el texto "Lorem ipsum" como datos en Base64 usando el conjunto de caracteres UTF-8 y escribir esos datos en un archivo XML de destino. El archivo XML de destino tiene un elemento message de tipo xs:base64Binary, como se ve en el esquema:
<?xml version="1.0" encoding="UTF-8"?> |
Este es el aspecto de una asignación que cifra en Base64:
Esta asignación produce resultados XML como los del extracto de código siguiente (se han omitido las referencias al esquema y la declaración XML):
<message>TG9yZW0gaXBzdW0=</message> |
También puede cifrar texto o archivos XML como Base64 con ayuda de un componente de serialización de MapForce. Por ejemplo, la asignación de la imagen siguiente serializa un XML de origen en una cadena de texto. La cadena resultante se pasa como argumento a la función charset-encode. último, el resultado de la función se devuelve como resultado de la asignación, con ayuda de un componente simple de salida (véase el apartado Obtener valores de cadena de una asignación). Para más información consulte el apartado Redistribuir y serializar cadenas de texto.