AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Sustituye los caracteres seleccionados que no se admiten en un URL con sus valores de escape, conocidos como códigos cifrados de URL.
Formato
@DTW_URLESCSEQ(serieEntrada, serieSalida)
@DTW_rURLESCSEQ(serieEntrada)
Parámetros
Tabla 58. Parámetros de DTW_URLESCSEQ
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | serieEntrada | IN | Variable o serie literal. |
serie | serieSalida | OUT | Variable que contiene la serie de entrada con caracteres que no se admiten en los URL que se sustituyen por sus valores de escape hexadecimales. |
Códigos de retorno
Tabla 59. Códigos de retorno de DTW_URLESCSEQ
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
1003 | Se ha transmitido un número incorrecto de parámetros en una llamada de función. |
1005 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente. |
1006 | Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida. |
Notas de utilización
Utilice esta función para transmitir cualquiera de los caracteres listados
en la Tabla 60 a otra macro o bloque HTML.
Tabla 60. Valores de escape de caracteres para los URL
Carácter | Nombre | Código |
ESPACIO | Espacio | %20 |
" | Comillas dobles | %22 |
# | Símbolo de número | %23 |
% | Porcentaje | %25 |
& | Ampersand | %26 |
+ | Signo más | %2B |
\ | Barra inclinada invertida | %2F |
: | Dos puntos | %3A |
; | Punto y coma | %3B |
< | Menor que | %3C |
= | Igual a | %3D |
> | Mayor que | %3E |
? | Signo de interrogación | %3F |
@ | Signo de arroba | %40 |
[ | Corchete izquierdo | %5B |
/ | Barra inclinada | %5C |
] | Corchete derecho | %5D |
^ | Acento circunflejo | %5E |
{ | Llave izquierda | %7B |
| | Barra vertical | %7C |
} | Llave derecha | %7D |
~ | Tilde | %7E |
Ejemplos
Ejemplo 1: Sustituye los caracteres de espacio y ampersand de string1 por sus valores de escape y asigna el resultado a string2
@DTW_URLESCSEQ(string1,string2)
Ejemplo 2: Sustituye los caracteres de espacio de ampersand por sus códigos de escape.
@DTW_rURLESCSEQ("Guys & Dolls")
Ejemplo 3: Utiliza DTW_rURLESCSEQ en un bloque ROW y sustituye los caracteres de espacio y 'arroba' (@) por sus códigos de escape.
%ROW{ <p><a href="fullRpt.mac/input ?name=@DTW_rURLESCSEQ(V1)&email=@DTW_rULRESCSEQ(V2)"> $(V1)</a></p> %}
<p><a href="fullrpt.mac/input?name=Patrick%20O'Brien &email="obrien%40ibm.com">Patrick O'Brien</a></p>
Cuando el usuario de la aplicación pulsa en el nombre "Patrick O'Brien," los valores que se han especificado para el nombre y dirección de correo electrónico fluyen dentro de la serie de consulta del URL que hace que Net.Data ejecute la sección de entrada de la macro fullrpt.mac.