Manual de consulta

DTW_URLESCSEQ


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>
%}

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.


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]