Guía del usuario de xPresso para Dreamweaver · por los programas de software que muestran iconos...

Guía del usuariode xPresso paraDreamweaverVersión 3.5

EMC Corporation, Hopkinton, MA 01748-91031-508-435-1000www.EMC.com

Copyright 2005-2009 EMC Corporation. Reservados todos los derechos.

La protección del copyright incluye todos los formatos de información y material protegidos por copyright regidospor la legislación o normativa legal actual o futura. Esto incluye, sin limitaciones, cualquier material generadopor los programas de software que muestran iconos u otras interfaces de pantalla. No puede copiar ni transmitircualquier parte de este documento en formato electrónico ni impreso sin el permiso expreso por escrito de EMCCorporation. xPression, CompuSet y todos los demás productos de EMC Corporation mencionados en estapublicación son marcas registradas de EMC Corporation. Para obtener información completa sobre el copyright,consulte el archivo xPression Licensing Document.pdf incluido en el CD de la biblioteca de eBook.

TABLA DE CONTENIDO

1 Introducción ........................................................................................................................................ 7¿A quién va dirigido este libro? ...................................................................................................... 7Cómo utilizar xPresso para Dreamweaver ...................................................................................... 7¿Qué es xPresso para Dreamweaver? ........................................................................................... 8Cuadros de información y barras de revisión .................................................................................. 8Asistencia técnica de soluciones.................................................................................................... 9

2 Un recorrido por xPresso para Dreamweaver ........................................................................................ 10Área de trabajo de xPresso para Dreamweaver .............................................................................. 10

Vistas del área de trabajo de Dreamweaver............................................................................. 13Qué se puede ver en la vista Código....................................................................................... 13Cómo trabajar con paneles de Dreamweaver .......................................................................... 15Panel o barra de inserción de xPresso .................................................................................... 15El panel Esquema de datos de xPresso .................................................................................. 16Panel Esquema de xPresso Design ........................................................................................ 16Panel Definición de variable de xPresso.................................................................................. 18Panel Propiedad de documento .............................................................................................. 21

El clic que actualiza: Eliminación de elementos de xPresso............................................................. 23Utilización de los comandos Deshacer y Rehacer de Dreamweaver ................................................. 23Cómo guardar los archivos en xPresso para Dreamweaver ............................................................. 23Validación de etiquetas de xPresso ................................................................................................ 23Visualización del archivo de registro de xPresso ............................................................................. 24Actualización de la licencia ............................................................................................................ 24Los datos y su documento ............................................................................................................. 24

Preparación de archivos de datos ........................................................................................... 25Criterios ................................................................................................................................ 28Variables ............................................................................................................................... 28

Contenido del documento.............................................................................................................. 29¿Qué es el contenido dinámico?............................................................................................. 29

TABLA DE CONTENIDO

¿Qué es el contenido estático?............................................................................................... 29

3 Trabajo en modo en línea..................................................................................................................... 30Inicio de sesión............................................................................................................................. 30

Definición de un servidor ........................................................................................................ 31Iniciar sesión en un servidor ................................................................................................... 31

Cómo abrir un documento desde el servidor ................................................................................... 31Cómo abrir un documento de sólo lectura ............................................................................... 32Cómo abrir un documento para editar (desprotección) ............................................................. 32Cancelación de una desprotección ......................................................................................... 32

Protección de un documento ......................................................................................................... 32Protección de un nuevo documento ........................................................................................ 33Protección de un documento editado ...................................................................................... 34

Trabajo con otros archivos del servidor........................................................................................... 34Búsqueda de archivos en el servidor .............................................................................................. 35

Búsqueda sencilla.................................................................................................................. 35Búsqueda avanzada .............................................................................................................. 35

4 Creación de documentos xPresso......................................................................................................... 37Asociación de datos con documentos............................................................................................. 37

Carga de su esquema............................................................................................................ 38Creación del contenido.................................................................................................................. 38

Grupos de contenido.............................................................................................................. 39Instancias de contenido.......................................................................................................... 41

Adición de criterios al contenido dinámico....................................................................................... 41Definición de criterios de activación/desactivación ................................................................... 43Definición de criterios de cambio ............................................................................................ 44Definición de criterios If-Else .................................................................................................. 46Edición de los criterios existentes ........................................................................................... 47

Utilización del Asistente de grupo de contenido............................................................................... 47Configuración de instancia de varios If-Else ............................................................................ 49Configuración de instancia de Cambio simple.......................................................................... 50Adición de contenido a una instancia ...................................................................................... 50

Bucles de contenido...................................................................................................................... 50Creación de bucles de contenido ............................................................................................ 51Copia de un bucle de contenido.............................................................................................. 51

Tablas dinámicas .......................................................................................................................... 51Creación de una tabla dinámica usando bucles de contenido ................................................... 52

Cómo agregar contenido externo al documento .............................................................................. 53Copia de contenido externo.................................................................................................... 54

5 Uso de variables.................................................................................................................................. 55Breve información sobre variables ................................................................................................. 55

Etiquetas HTML en datos XML ............................................................................................... 55Importación de definiciones de variables ................................................................................. 56

TABLA DE CONTENIDO

Exportación de definiciones de variables ................................................................................. 58Copia de variables ................................................................................................................. 58

Cómo trabajar con variables .......................................................................................................... 58Creación de variables ............................................................................................................ 59Definición de atributos de variable .......................................................................................... 60Colocación de variables de texto en el documento................................................................... 61Formato de variables de texto ................................................................................................ 62Colocación de variables de imagen en el documento ............................................................... 64

Creación de expresiones de variables ............................................................................................ 64Variables ............................................................................................................................... 65Funciones ............................................................................................................................. 66Instrucciones If/Else............................................................................................................... 66Verificación de expresiones .................................................................................................... 66Creación de una sencilla variable de dirección de origen/destino .............................................. 66

Eliminación de líneas vacías en bloques de texto............................................................................ 67Cómo trabajar con propiedades del documento .............................................................................. 68

Creación de propiedades de documento ................................................................................. 69Opciones de atributos de propiedad de documento.................................................................. 70Importación de propiedades de documento ............................................................................. 70Exportación de propiedades de documento ............................................................................. 71

Cómo trabajar con hipervínculos de variable................................................................................... 71Cómo colocar hipervínculos de variable en el documento......................................................... 71

Cómo trabajar con matrices ........................................................................................................... 72Creación de matrices ............................................................................................................. 73Definición de atributos de matriz ............................................................................................. 73Definición de los atributos de elementos de matriz ................................................................... 73Colocación de variables de tabla en el documento................................................................... 74

Consulta de datos de variables en el documento ............................................................................ 74

6 Cómo crear un resultado...................................................................................................................... 76Cómo obtener una vista previa del documento................................................................................ 76Utilización de la utilidad de envío de correo electrónico ................................................................... 77Creación de un correo electrónico multiparte .................................................................................. 77

Creación de un archivo de texto sin formato independiente ...................................................... 78Creación de una versión de texto sin formato durante la publicación ......................................... 80

Empaquetado de documentos ....................................................................................................... 80Marcado de una plantilla como Listo para publicar ................................................................... 81Creación de un paquete no listo para publicar ......................................................................... 82Creación de un paquete listo para publicar .............................................................................. 83

Cómo adjuntar archivos externos a un correo electrónico ................................................................ 83Archivos generados dinámicamente........................................................................................ 84Archivos estáticos.................................................................................................................. 84

A Especificaciones de las etiquetas de xPresso........................................................................................ 85Atributos generales de etiquetas de xPresso .................................................................................. 85

TABLA DE CONTENIDO

Atributos de etiquetas de grupo ..................................................................................................... 85Atributos de etiquetas de contenido................................................................................................ 86Atributos de etiquetas de texto....................................................................................................... 87Atributos de etiqueta de bucle........................................................................................................ 87Atributos de etiquetas de VarDef .................................................................................................... 87Atributos de etiqueta de TableDef................................................................................................... 88

B Funciones de expresión ....................................................................................................................... 90Funciones numéricas .................................................................................................................... 90

abs ....................................................................................................................................... 90floor ...................................................................................................................................... 90ceil........................................................................................................................................ 91round .................................................................................................................................... 91stringToInteger....................................................................................................................... 91

Funciones de lógica ...................................................................................................................... 91Funciones de grupo ...................................................................................................................... 92

groupCount ........................................................................................................................... 92groupSum ............................................................................................................................. 92groupMax.............................................................................................................................. 93groupMin............................................................................................................................... 93

Funciones de cadena .................................................................................................................... 94length.................................................................................................................................... 94contains ................................................................................................................................ 94toLowerCase ......................................................................................................................... 94toUpperCase ......................................................................................................................... 95trim ....................................................................................................................................... 95substring ............................................................................................................................... 95position ................................................................................................................................. 96replace.................................................................................................................................. 96numericToString..................................................................................................................... 96

Funciones de fecha, hora y fecha y hora ........................................................................................ 96addYear ................................................................................................................................ 97addMonth.............................................................................................................................. 97addDay ................................................................................................................................. 97now ...................................................................................................................................... 98

Introducción 1Introducción

Bienvenido a xPresso para Dreamweaver. xPresso para Dreamweaver forma parte del conjuntode productos xPression y está diseñado para ayudarle a crear páginas web HTML gráficas ypersonalizadas o mensajes de correo electrónico con una variedad de contenido. El contenido puedeoscilar de la correspondencia que contiene contenido de marketing gráfico e imágenes de marca, ainstrucciones o alertas de cuenta que llevan al destinatario a un sitio web personalizado creado enxPresso para Dreamweaver.

¿A quién va dirigido este libro?La Guía del usuario de xPresso para Dreamweaver contiene la información que necesita un usuariode Dreamweaver experimentado para utilizar xPresso para Dreamweaver. Se espera que tengaconocimientos prácticos de Dreamweaver, y que esté familiarizado con los datos XML que seutilizarán en los documentos que se van a crear con xPresso para Dreamweaver.

En este libro no se indica cómo utilizar las funciones básicas de Dreamweaver, a menos que sea algoconcreto sobre cómo utilizar la función con xPresso para Dreamweaver. Este libro no le indica cómocrear sus datos, pero sí incluye instrucciones para crear datos compatibles con xPresso e incluyeinformación sobre cómo utilizarlos.

Nota

La mayoría de las imágenes de esta guía del usuario son de la versión Creative Suite 3 deDreamweaver. Si está utilizando la versión Creative Suite 4, la interfaz parecerá diferente. No hayninguna diferencia funcional en la manera en la que funciona la interfaz, a menos que se observe deotra manera en esta guía del usuario.

Cómo utilizar xPresso para DreamweaverJunto con esta guía del usuario, se incluye también un tutorial de xPresso para Dreamweaver que leguiará por las tareas asociadas a la creación de un documento. Puede acceder al documento deltutorial haciendo clic en Tutorial en el menú xPresso. xPresso para Dreamweaver también incluyeuna Ayuda en pantalla, a la que se puede acceder haciendo clic en Ayuda en el menú xPresso.

7

Capítulo 1 — Introducción

Si no conoce Dreamweaver, o simplemente necesita ponerse al día, EMC Document Sciencesrecomienda encarecidamente los siguientes recursos de aprendizaje:

• Si tiene Dreamweaver instalado, en el menú Ayuda seleccione Ayuda de Dreamweaver.Los tutoriales de esta guía le dirigen por el proceso de crear un sitio web sencillo perofuncional.

• El Centro de recursos de documentación de Dreamweaver está disponible en pantalla en:http://www.adobe.com/support/documentation/en/dreamweaver/.

¿Qué es xPresso para Dreamweaver?xPresso para Dreamweaver es un componente de diseño del conjunto de productos de xPressionque le permite crear documentos Dreamweaver dinámicos que se pueden publicar en el servidor delxPression.

xPresso para Dreamweaver se encuadra en el área de diseño de documentos del conjunto deproductos xPression.

Cuadros de información y barras de revisiónSi uno de los cuadros siguientes aparece en una página es para indicarle información especial.

PRECAUCIÓNEl cuadro de precaución le advierte de que se puede producir un error grave, una salida pocosatisfactoria o una pérdida de datos si no se siguen las instrucciones con atención.

8

http://www.adobe.com/support/documentation/en/dreamweaver/

Capítulo 1 — Introducción

Sugerencia

Las sugerencias le ofrecen consejos para simplificar una tarea o describen un acceso directo útil.También pueden describir una manera alternativa de utilizar las técnicas descritas en el texto.

Nota

Una nota proporciona información que enfatiza o complementa puntos importantes del texto principal.

Las barras de revisión le permiten localizar información nueva o modificada. Busque estas barras derevisión en el margen derecho de cada página afectada.

Asistencia técnica de solucionesPara obtener más información o para resolver un problema, puede ponerse en contacto con el serviciode asistencia técnica de soluciones de Document Sciences de una de las siguientes maneras:

Teléfono (760) 602-1500

Fax (760) 602-1515

World Wide Web http://support.docscience.com

Correo electrónico [email protected]

9

http://support.docscience.com

Un recorrido por xPresso paraDreamweaver 2

Un recorrido por xPresso para Dreamweaver

En este capítulo realizará un breve recorrido por la interfaz de usuario de xPresso para Dreamweaver.xPresso para Dreamweaver se "coloca" sobre Adobe Dreamweaver y trabaja con él sin problemas.La instalación de xPresso agrega la barra de inserción de xPresso (en CS3) o panel (en CS4) aDreamweaver, así como varios paneles de xPresso.

Área de trabajo de xPresso para DreamweaverxPresso para Dreamweaver admite las versiones de Creative Suite 3 y 4 de Dreamweaver. Segúnla versión que esté usando, el área de trabajo de Dreamweaver parecerá algo diferente. Al abrirxPresso para Dreamweaver, verá el escritorio de Dreamweaver estándar, con algunos elementosde xPresso agregados. Obtendrá más información sobre lo que hacen estos elementos en lassecciones siguientes.

Después de la instalación, verá que esos componentes de xPresso se han agregado a su área detrabajo de Dreamweaver. Esta imagen muestra la versión CS3 de Dreamweaver.

10

Capítulo 2 — Un recorrido por xPresso para Dreamweaver

11


Esta imagen muestra la versión CS4 de Dreamweaver.

12


Vistas del área de trabajo de DreamweaverDreamweaver presenta tres formas diferentes de ver el área de trabajo: vista Diseño, vista Código ovista Dividir. Al trabajar en xPresso para Dreamweaver, es mejor trabajar en un área de trabajo de lavista Dividir, de modo que se pueda consultar tanto la vista Diseño como la vista Código.

Este gráfico muestra un documento de ejemplo en modo de vista Dividir.

La vista Código en xPresso para Dreamweaver no sólo muestra el HTML del contenido generaldel documento, sino también el HTML generado para las acciones de xPresso. Algunas accionesrelacionadas con xPresso deben hacerse en la vista Código, mientras que otras se pueden haceren la vista Diseño. Puede cambiar entre las tres vistas usando los botones situados en la partesuperior del área de trabajo.

Qué se puede ver en la vista CódigoxPresso para Dreamweaver coloca etiquetas en el código HTML cuando realiza las funcionesrelacionadas con xPresso en el documento, como crear grupos de contenido o colocar variables. Alseleccionar los elementos en la vista Diseño, el código correspondiente se resalta en la vista Código.

13


A continuación se muestra una lista de las etiquetas que verá cuando trabaja en xPresso paraDreamweaver, junto con un ejemplo de cada una de ellas:

• Etiqueta Group

<xPresso type="group" id="16" name="banner" selecttype="ifelse" logic=""onoff=""name"==" test""><xPresso type="instance" id="17" name="general"logic=’"name"=="test"’></xPresso></xPresso>

• Etiqueta Content

<xPresso type="instance" id="19" name="general logic=’"international"=="PEK"’ ></xPresso>

• Etiqueta Text

<xPresso type="text" id="9" name="destination" type="text" variable="desc"vid="4">{desc}</xPresso>

• Etiqueta Loop

<xPresso type="loop" id="10" name="triptable" variable="trip" vid="7"></xPresso>

• Etiqueta VarDef

<VarDef name="international" id="1" type="string" expType="schema" expression="/root/campaign/city/international" position="2"></VarDef>

• Etiqueta TableDef

<TableDef> <TableDef name="region" id="6" expType="schema" expression="/root/campaign/recommendations/region" position="6"></TableDef><TableDef name="trip" id="7" expType="schema" expression="/root/campaign/recommendations/region/trip" position="8"> <VarDef name="date" id="8"type="string" expType="schema" expression="/root/campaign/recommendations/region/trip/date" position="9"></VarDef> </TableDef> </TableDefs>

Para obtener más información, consulte Especificaciones de las etiquetas de xPresso.

Nota

Si selecciona un rango de texto en la vista Diseño y la primera etiqueta <xPresso> para el rango noestá seleccionada en la vista Código, active el resaltado de las etiquetas de terceros para habilitar suselección. Para obtener más información, consulte Cómo resaltar elementos de xPresso.

Selección de texto en la vista CódigoAl seleccionar el contenido de la vista Código que desea incluir en un grupo de contenido o instancia,asegúrese de que selecciona las etiquetas de comienzo y fin del párrafo y de la fuente así comoel mismo contenido.

14


PRECAUCIÓNCuando se selecciona una instancia de contenido completa en la vista Código, todo lo que se hagasobrescribirá la instancia. Si se aplica un color con el Selector de color en las Herramientas desugerencia de código, por ejemplo, se reemplaza la instancia de contenido (junto con todas susetiquetas de xPresso) con el número de color, quitando por tanto la instancia del documento.

Cómo resaltar elementos de xPressoComo aprenderá en los capítulos y secciones siguientes de este libro, xPresso para Dreamweaver lepermite agregar elementos de contenido dinámicos a sus documentos de Dreamweaver. Para queDreamweaver identifique estos elementos de xPresso:

1. En el menú Edición, seleccione Preferencias.

2. Seleccione Resaltando en la lista de categorías.

3. Active la casilla de verificación Mostrar al lado de Etiquetas de terceros y, a continuación,haga clic en Aceptar.

Cómo trabajar con paneles de DreamweaverDreamweaver le permite agrupar sus paneles en combinaciones lógicas según su forma de trabajary los paneles de xPresso no constituyen ninguna excepción. Para agrupar uno o más paneles dexPresso para Dreamweaver, haga clic en el botón de menú del panel y seleccione Agrupar [Nombredel panel de xPresso] con. Elija el panel con el que desea agrupar el panel seleccionado.

Panel o barra de inserción de xPressoPuede ocultar o mostrar y contraer o expandir la barra de inserción de Dreamweaver (en CS3) o elpanel (in CS4), si fuera necesario. La extensión de xPresso para Dreamweaver agrega un elementode xPresso al panel o la barra de inserción. Si no consulta el panel o la barra de inserción, haga clicen el menú Ventana de Dreamweaver y seleccione Insertar. Para mostrar la parte de xPresso delpanel Insertar en CS4, seleccione xPresso en la lista desplegable de paneles. La barra de inserciónen CS3 se puede mostrar como menús o como fichas; el valor predeterminado son las fichas. Paramostrar la parte de xPresso de la barra de inserción, seleccione una de las siguientes opciones:

• Haga clic en la flecha junto al nombre de categoría situada en el extremo izquierdo de labarra de inserción y seleccione xPresso en el menú emergente.

• Haga clic en la ficha xPresso.

La barra de inserción de xPresso contiene los botones de acceso directo a xPresso para lasfunciones de Dreamweaver. Al desplazar el puntero sobre un botón, aparece una información sobreherramientas con el nombre del botón. En CS4, el panel contiene vínculos a las mismas funciones dexPresso para Dreamweaver.

15


La tabla siguiente muestra y describe cada botón o vínculo.

Botón Acción Botón AcciónCargar un archivo de esquemade datos.

Insertar una variable de imagen.

Crear grupo de contenido. Insertar una variable dehipervínculo.

Agregar una instancia decontenido a un grupo decontenido.

Insertar una variable de contenidoexterna.

Iniciar el Asistente de grupo decontenido.

Suprimir elementos seleccionadosde los paneles de xPresso.

Agregar un bucle de contenidopara crear una tabla dinámica.

Convertir un archivo HTML entexto sin formato.

Crear una tabla de una matriz enel panel Definición de variable.

Actualizar las vistas en los panelesde xPresso.

Insertar una variable de texto enel panel Definición de variables.

Pegar el último elemento dexPresso copiado en el Esquemaen la posición del cursor en eldocumento.

El panel Esquema de datos de xPressoEl panel Esquema de datos de xPresso muestra los datos de variables, tal y como se incluyen enel esquema de datos. ¿No lo visualiza en el área de trabajo? En el menú xPresso, seleccioneEsquema de datos. El menú Esquema de datos le permite cargar un esquema en el documento.Al cargar un esquema de datos en el panel, xPresso para Dreamweaver muestra la estructura desu esquema en un resumen jerárquico. Puede cargar sólo un archivo XSD. Si no tiene el archivode esquema, necesitará crear uno de su archivo de datos XML.

Al seleccionar un campo en el panel Esquema de datos, el tipo de datos del campo aparece en laparte inferior del panel. Esta información es de sólo lectura.

Menú Esquema de datos de xPressoEl menú Esquema de datos le permite cargar un esquema en el documento.

Panel Esquema de xPresso DesignEn el panel Esquema de xPresso Design se muestra la estructura, la lógica y la variación de contenidode las partes dinámicas del documento, en una estructura de esquema. ¿No lo visualiza en el área detrabajo? En el menú xPresso, seleccione Explorador de esquemas de diseño. Piense en estocomo el plan estructural de la variabilidad de un documento, donde se muestran todas las partes y

16


bits variables que se pueden utilizar para crear la salida final, así como los criterios que controlan lainclusión.

El Esquema de xPresso Design consta de un esquema en el que se muestra su estructura decontenido variable y el área de atributos del esquema de xPresso en la que se muestran los atributosdel elemento del esquema seleccionado.

A través del esquema de xPresso, puede crear grupos e instancias de contenido para su uso en eldocumento. También se pueden definir los criterios para la inclusión de contenido concreto.

Los elementos mostrados en el esquema corresponden a contenido variable en la página deDreamweaver. Al seleccionar un grupo de contenido o una instancia de contenido en el esquema,el contenido correspondiente se selecciona en la página del documento. Si se selecciona unainstancia de contenido que esté activa, ésta se mostrará y se resaltará. Esto le permite cambiar entreinstancias de contenido, a fin de ver qué aspecto tienen en la página o para realizar modificaciones.Al seleccionar el contenido en la página del documento, xPresso resalta la instancia de contenidocorrespondiente en el esquema.

Área de atributos de xPresso SchematicEl área de atributos del esquema de xPresso aparece en la parte inferior del panel Esquema dexPresso y muestra información sobre el elemento seleccionado en el esquema. Puede realizarcambios en cualquier atributo editable que aparezca en el área. Puede cambiar el nombre decualquiera de los grupos de contenido, instancias de contenido o variables contenidas en el esquemaeditando el nombre mostrado en el área de atributos del esquema de xPresso. No puede cambiar el

17


nombre del esquema o de la carpeta de variables globales. La información que aparece en el paneldepende del tipo de elemento que se seleccione.

Menú Esquema de xPressoEl menú Esquema de xPresso contiene los comandos que se necesitan para trabajar con loselementos variables del esquema. Las selecciones de menú varían dependiendo del elementoseleccionado en el esquema.

Opción DescripciónOrdenar esquema Vuelva a ordenar los elementos del esquema por su código ASCII. Seleccione

la raíz del esquema para ordenar todos los elementos dinámicos de nivelprincipal del esquema o seleccione un elemento dinámico para ordenar suselementos secundarios.

Por ejemplo, si actualmente tiene GrupoContenidos3, GrupoContenidos2 yGrupoContenidos1 (en ese orden) y ordena el esquema, los verá ordenadoscomo GrupoContenidos1, GrupoContenidos2 y GrupoContenidos3.

Nota: la ubicación de la Carpeta de variables globales no cambiará al ordenar;su ubicación es fija.

Eliminar Eliminar el elemento seleccionado en el esquema y quitarlo del documentode plantilla.

Etiquetas de borde de xPressoactivadas

Mostrar las etiquetas de fin y de comienzo de los comandos de xPresso enlas vistas Código y Diseño.

Etiquetas de borde de xPressodesactivadas

Ocultar las etiquetas de fin y de comienzo de los comandos de xPresso enlas vistas Código y Diseño.

Copiar elemento Copiar el elemento actualmente seleccionado en el esquema. Puede copiar loselementos de Esquema siguientes: grupos de contenido, variables, bucles decontenido y variables de contenido externas. Utilice la opción xPresso-Pegaren el panel o la barra de inserción para pegar el elemento copiado en la plantillade documento.

Ordenar instancia Ordenar las instancias contenidas en el grupo de contenido actualmenteseleccionado en el esquema en orden alfabético.

Clonar instancia de contenido Crear un clon de la instancia de contenido actualmente seleccionada en elesquema. Las nuevas instancias aparecen en el esquema bajo la instanciaoriginal con el nombre de clon Nombreoriginalelemento.

Listo para publicar Defina la plantilla como lista para ser publicada o no lista para ser publicada.Para obtener más información, consulte Marcado de una plantilla como Listopara publicar.

Panel Definición de variable de xPressoEl panel Definición de variable funciona conjuntamente con el panel Esquema de datos y le permitecrear con facilidad y definir variables y matrices para su uso en documentos. ¿No lo visualiza en

18


el área de trabajo? En el menú xPresso, seleccione Definición de variable. El panel le permiteagregar variables, matrices, elementos secundarios a las matrices y modificar las propiedades deelementos. La parte principal del panel Definición de variable es el esquema de variables, dondese muestran sus matrices y variables definidas. En el esquema, una carpeta ( ) representa unamatriz y un icono ( ) de página representa una variable. Debajo del resumen se encuentra el áreade atributos de variables. Al seleccionar un elemento en el resumen, se pueden definir o editar susatributos en el área de atributos de variables.

Al aplicar los datos de variables al documento, xPresso para Dreamweaver muestra una etiqueta "nde m" y un conjunto de flechas en la parte superior del panel Definición de variable para permitirleexplorar los registros del archivo de datos.

La etiqueta n de m muestra el número del registro en el que se encuentra actualmente (n) y cuántosregistros existen en el archivo (de n). Haga clic en las flechas para desplazarse por los registros deldocumento. Haga clic en Cargar para aplicar los datos de un registro determinado a su trabajo. Losresultados aparecerán en su explorador web predeterminado.

Menú Definición de variableHaga clic en la flecha en la esquina derecha del panel Definición de variable para acceder al menú.

El menú Definición de variable contiene los comandos que necesita para trabajar con las variables ysus datos. Las selecciones de menú variarán dependiendo del elemento seleccionado en el panel.

Opción DescripciónDefinir variable Agregar una variable de texto o de imagen al panel Definición de variable. Para

obtener más información, consulte Creación de variables.

Definir matriz Agregar una variable de tabla o matriz al panel Definición de variable. Paraobtener más información, consulte Creación de matrices.

Definir variable a partir deesquema

Agregar una variable de texto o de imagen al panel Definición de variableutilizando el campo seleccionado en el panel Esquema de datos. Seleccioneel campo del panel Esquema de datos antes de seleccionar esta opción. Paraobtener más información, consulte Creación de variables.

Definir matriz a partir deesquema

Agregar una variable de tabla o matriz al panel Definición de variable utilizandoel campo padre seleccionado en el panel Esquema de datos. Seleccione elcampo padre del panel Esquema de datos antes de seleccionar esta opción.Para obtener más información, consulte Creación de matrices.

Importar definiciones devariable

Importe un archivo de exportación de definición de variables que contenga lasdefiniciones de variables definidas en un documento xPresso diferente, parasu uso en este documento. Todas las definiciones contenidas en el archivoaparecerán en el panel Definición de variable.

Importar definiciones de variabledesde servidor

Importe un archivo de exportación de definición de variable que se encuentraen el servidor de xPression que contenga las definiciones de variable definidasen un documento xPresso diferente, para su uso en este documento. Todaslas definiciones contenidas en el archivo aparecerán en el panel Definiciónde variable.

19


Opción DescripciónExportar definiciones devariable

Crear un archivo XML que contiene todas las definiciones de variable en elpanel Definición de variable. A continuación, puede importar este archivo a otrodocumento xPresso.

Exportar definiciones devariable a servidor

Crear un archivo XML que contenga todas las definiciones de variable enel panel Definición de variable y guárdelo en el servidor de xPression. Acontinuación, puede importar este archivo a otro documento xPresso.

Eliminar elemento Eliminar el elemento seleccionado del panel Definición de variable. Si la variableaparece en el documento, no podrá eliminarlo del panel; primero tendrá queeliminar la variable de la página del documento.

Crear carpeta Crear una carpeta de contenedor en el panel, a la que pueda mover loselementos de variable ya existentes o agregar otros nuevos. Las carpetaspermiten organizar el panel.

Ordenar elementos de variable Ordenar los elementos mostrados en el panel en orden alfabético.

Aplicar datos de variable Abra un cuadro de diálogo donde pueda seleccionar un archivo XML parautilizarlo con los datos de variables. Al seleccionar un archivo, xPressopara Dreamweaver actualiza el documento con los datos del archivo XMLseleccionado.

Aplicar datos de variable desdeservidor

Abra un cuadro de diálogo donde pueda seleccionar un archivo XMLalmacenado en el servidor XPression para utilizarlo con los datos de variables.Al seleccionar un archivo, xPresso para Dreamweaver actualiza el documentocon los datos del archivo XML seleccionado.

Restablecer datos de variable Restablecer todas las variables del documento de nuevo a su estado original,eliminando los datos de variables. Todas las variables muestran el nombre devariable en lugar de los datos de variables reales.

Vista previa Ver el trabajo con los datos aplicados en su explorador web predeterminado.Para obtener más información, consulte Cómo obtener una vista previa deldocumento.

Obtener una vista previa desdeservidor

Ver su trabajo con datos, situado en el servidor de xPression, aplicado en suexplorador web predeterminado. Para obtener más información, consulte Cómoobtener una vista previa del documento.

Ver registro Ver el archivo de registro xPresso.log. Para obtener más información, consulteVisualización del archivo de registro de xPresso.

Opciones de registro de esquema Abra el cuadro de diálogo Configuración del registro del esquema donde puedeseleccionar los elementos del esquema sobre los que desea que aparezcainformación en el archivo de registro del esquema. También puede especificarla carpeta donde desea que se almacene el archivo de registro. Para obtenermás información, consulte Configuración de opciones de registro de esquema.

20


Configuración de opciones de registro de esquemaPuede indicar que xPresso para Dreamweaver cree un archivo de registro después de aplicar datosque contengan información sobre los elementos actualmente incluidos en Esquema de xPresso.Puede seleccionar los tipos de elementos sobre los que desea que aparezca información en el archivode registro. Este archivo de registro es útil para solucionar problemas lógicos y estructurales, y lopuede utilizar el servicio de asistencia técnica de soluciones de EMC si es necesario.

Después de indicar a XPresso para Dreamweaver que cree el archivo de registro, la próxima vez queaplique datos aparecerá un archivo de nombre Unpack the schematic.xml en la ubicación definida alactivar el registro y configurar las opciones de registro del esquema.

El registro del esquema puede contener la información siguiente:• La versión y el número de compilación de xPresso del software instalado actualmente.• Las variables utilizadas en el documento, agrupadas por bucle de contenido o grupo de

contenido donde se utilizan las variables, junto con los atributos de xPresso y los atributosde esquema de la variable, y el valor.

• Cada nombre de bucle de contenido y su ubicación en el documento, atributos, valores,elementos de contenido y bucles anidados.

• Cada nombre de grupo de contenido y su ubicación en el documento, elementos decontenido y atributos.

Para configurar los elementos que desea que aparezcan en el archivo de registro del esquema:1. Haga clic en el menú Definición de variable y seleccione Opciones de registro de esquema.

Aparece el cuadro de diálogo Configuración del registro del esquema.2. Active la casilla de verificación Registro del esquema para indicar a xPresso para

Dreamweaver que genere un archivo de registro del esquema.3. Seleccione los elementos que desea que aparezcan en el archivo de registro del esquema:

variables, atributos de variable, bucles de contenido, objetos de bucle de contenido, criterios deobjeto de bucle de contenido, atributos de objeto de bucle de contenido, grupos de contenido,objetos de grupo de contenido, criterios de objeto de grupo de contenido, atributos de objeto degrupo de contenido y propiedades de documento.

4. Haga clic en el botón de exploración para buscar y seleccionar la carpeta en la que deseaalmacenar el archivo de registro.

5. Haga clic en Aceptar. La próxima vez que aplique datos de variable, aparecerá un archivo deregistro denominado Unpack the schematic.xml en la ubicación seleccionada.

Panel Propiedad de documentoEn el panel Propiedad de documento se muestran todas las propiedades del documento definidasen el documento. Las propiedades del documento se asocian a un documento específico y estándisponibles en xAdmin para su definición como variables de salida y su uso en expresiones y plantillasde nombres de archivos. En xPresso para Dreamweaver, puede especificar una variable existentecomo una propiedad del documento y, por consiguiente, asociar dicha variable con su documento.

Asegúrese de que cualquier propiedad de documento que se vaya a usar en plantillas de nombres dearchivos se ha asociado a variables cuyos valores serán únicos para cada registro del archivo de

21


datos. Si un valor no es único, se arriesga a crear nombres de archivo duplicados, lo que generará unerror. Asegúrese también de que el valor no incluye ninguno de estos caracteres: \, /, :, *, ?, ", <, >, |.

La parte principal del panel Propiedad de documento es el resumen, donde se muestran laspropiedades del documento definidas. Debajo del resumen se encuentra el área de atributos depropiedades de documento. Al seleccionar un elemento en el resumen, se pueden definir o editarsus atributos en el área de atributos.

Menú Propiedad de documentoEl menú Propiedad de documento contiene los comandos que necesita para agregar las propiedadesde documento al documento.

Seleccione esta opción ParaAgregar propiedad dedocumento

Agregar la variable seleccionada del panel Definición de variable al panelPropiedad de documento. Debe seleccionar una variable en el panelDefinición de variable antes de poder utilizar esta opción.

Eliminar propiedad dedocumento

Eliminar la propiedad de documento seleccionada del panel y quitar suasociación al documento.

Importar propiedades dedocumento

Importe un archivo de exportación de propiedades de documento quecontenga las propiedades definidas en un documento xPresso diferente,para su uso en este documento. Todas las propiedades contenidas en elarchivo aparecerán en el panel Propiedad de documento.

Importar propiedades dedocumento desde servidor

Importe un archivo de exportación de propiedades de documentoalmacenado en el servidor de xPression que contenga las propiedadesdefinidas en un documento xPresso diferente, para su uso en estedocumento. Todas las propiedades contenidas en el archivo aparecerán enel panel Propiedad de documento.

Exportar propiedades dedocumento

Crear un archivo XML que contiene todas las propiedades del documentoen el panel Propiedad de documento. A continuación, puede importar estearchivo a otro documento xPresso.

Exportar propiedades dedocumento a servidor

Cree un archivo XML que contenga todas las propiedades de documentodel panel Propiedades de documento y almacénelo en el servidor dexPression. A continuación, puede importar este archivo a otro documentoxPresso.

Área de atributos de Propiedad de documentoEl área de atributos de la propiedad del documento aparece en la parte inferior del panel Propiedadde documento y muestra información de los atributos sobre el elemento seleccionado en el panel.

En el área de atributos se puede:• Cambiar el nombre de la propiedad de documento. Los nombres de propiedad de

documento deben contener como mínimo una letra y todos deben ser letras, números ocaracteres de subrayado (_). No se admiten espacios. El nombre debe tener al menos200 caracteres y sólo puede contener caracteres ingleses.

• Cambiar la asignación de variable de propiedad

22


• Consultar el tipo de variable (sólo lectura)

El clic que actualiza: Eliminación de elementos dexPressoxPresso para Dreamweaver le permite quitar las variables del panel Definición de variable de xPressoy los grupos de contenido e instancias en el Esquema de xPresso Design, con la selección de menúEliminar. También puede quitar estos elementos en las vistas Código y Diseño de Dreamweaver.Sin embargo, al eliminar los elementos en estas vistas, es posible que los paneles de xPresso no seactualicen inmediatamente y que un elemento eliminado aparezca en el panel. Para asegurarse deque todo está correctamente sincronizado, haga clic en el botón Actualizar Documento en el panelo la barra de inserción de xPresso.

Utilización de los comandos Deshacer y Rehacer deDreamweaverLos comandos Rehacer y Deshacer de Dreamweaver no suelen funcionar bien en las acciones dexPresso. Ésta es una limitación de Dreamweaver. Si se utiliza el comando Deshacer, es posible queno se puedan quitar todas las etiquetas de xPresso para el elemento que está deshaciendo. Siutiliza el comando Deshacer para crear un grupo de contenido, tiene que hacer clic dos veces enDeshacer para deshacer las dos acciones que tienen lugar durante el proceso de creación de grupode contenido. Se recomienda que elimine el elemento en lugar de utilizar el comando Deshacer.

Cómo guardar los archivos en xPresso paraDreamweaverAl guardar un archivo en xPresso para Dreamweaver, debe asegurarse de que incluye la extensión dearchivo al escribir el nombre de archivo (por ejemplo, Miarchivo.html). xPresso para Dreamweavertiene como valor predeterminado un tipo de archivo de "Paquete de xPresso" (.pkg) si no seproporciona ninguna extensión de archivo, independientemente del tipo seleccionado en el campoGuardar como tipo.

Validación de etiquetas de xPressoxPresso utiliza la función de informes del sitio de Dreamweaver para validar las etiquetas que seagregan al documento. Para comprobar el documento de xPresso, en el menú Sitio, seleccioneInformes. O haga clic en el botón Informes ( ) en la ficha Informes de sitios. Se muestra el cuadro

23


de diálogo Informes. Seleccione Validación de xPresso y haga clic en Ejecutar para generar uninforme. Se muestra una lista de resultados en el panel Informes de sitios.

Visualización del archivo de registro de xPressoEl archivo xPRS.log (ubicado en [Directorio de instalación de Dreamweaver]\xPresso) contieneinformación sobre algunas de las funciones que ha realizado xPresso para Dreamweaver. El archivode registro es acumulativo y será preciso desplazarse a la parte inferior del archivo para encontrarlas entradas más recientes.

Se debería consultar el archivo de registro al recibir mensajes de error y si desee ver más informaciónde ellos. Busque palabras como "ERROR" o "WARN" (advertencia) para localizar los problemas.

Para ver el archivo de registro, haga clic en el menú Definición de variable y seleccione Verregistro. El archivo xPRS.log se abrirá en el Bloc de notas. Desplácese a la parte inferior del archivopara ver las entradas más recientes.

Actualización de la licenciaSi recibe una nueva licencia de xPresso para Dreamweaver de EMC Document Sciences CustomerCare, puede activar la nueva licencia haciendo clic en Registrar en el menú xPresso. Cuandoaparezca el cuadro de diálogo Registrar, sustituya la clave de licencia actual por la nueva y hagaclic en Aceptar.

Los datos y su documentoLos datos de variables condicionan la salida y personalización de los documentos de xPresso paraDreamweaver. Primero, cargue un esquema, que puede utilizar para crear sus variables y definirsus criterios. Si lo desea, puede importar también definiciones de variable de otros documentos dexPresso y utilizarlas en su documento. A continuación, puede utilizar los datos para rellenar lasvariables, que le permiten consultar los datos reales mientras trabaja en su documento. Al publicarun documento, xPression utiliza datos XML para satisfacer los criterios que seleccionan contenido yrellenan las variables de la salida final.

Existen básicamente dos tipos de datos que se pueden introducir en un documento de xPresso paraDreamweaver: datos de "perfil de usuario" y datos de "contenidos de variables".

• Los datos del perfil de usuario están formados por información del cliente, como el nombre,el número de cuenta y la dirección. Se pueden utilizar en criterios para controlar elcontenido que aparece en un documento y pueden aparecer en variables que introducendatos personales en el documento, como el nombre y la dirección del destinatario.

• Los datos de contenidos de variables pueden estar formados por una o dos líneas detexto, o párrafos completos. Mediante el uso de variables, puede introducir este contenidoen el documento. En este caso, su documento es más que una plantilla con variables ymarcos para el diseño del texto y su archivo XML incluye el contenido de su documento.

24


Existen dos maneras de utilizar el contenido de la variable en un documento de xPressopara Dreamweaver:

– Puede tener varios archivos XML, cada uno con variaciones diferentes del contenidode su documento, y un documento con variables para introducir dicho contenido.

– Su archivo de datos puede contener distintas variaciones del contenido y sudocumento contiene grupos de contenido integrados por variables diferentes, a finde introducir el contenido adecuado, o un bucle de contenido para recorrer losdatos y colocarlos.

Al publicar un documento, selecciona la categoría y, a continuación, el documento y el archivo dedatos correspondiente. Por consiguiente, la persona que publique el documento en el servidor debesaber qué archivos de datos acompañan al documento. Si no puede nombrar el archivo de paquetede documentos y los archivos de datos de forma parecida, debería contar con algún otro sistema paraasegurarse de que se utilizan los archivos de datos correctos en sus documentos.

Preparación de archivos de datosNi xPresso para Dreamweaver ni el servidor del xPression proporcionan la función para manipular losarchivos de datos; por consiguiente, es importante tener correctamente configurados los archivos dedatos (archivos XML y esquema) antes de empezar a generar el documento. Usted, o el administradorde bases de datos, debería asegurarse de seguir las instrucciones incluidas en esta sección cuandoprepare sus archivos a fin de evitar problemas en el momento de producción.

Nota

(1) Los archivos de esquema utilizados con xPresso para Dreamweaver no pueden utilizarinstrucciones de inclusión. (2) Los nodos principal y secundario de un esquema no pueden tener elmismo nombre.

Diseñe su esquema para que incluya un elemento raíz y un modelo de contenido que permita variosregistros. El diseñador de documentos que utiliza el esquema en xPresso para Dreamweavernecesitará conocer la raíz del esquema, ya que se le solicitará que la seleccione al cargar el esquema.El elemento raíz debería ser la etiqueta de nivel superior que represente el registro de repeticiónen los datos. Le recomendamos que la etiqueta de repetición aparezca en el segundo nivel en lajerarquía del esquema. En el ejemplo siguiente, el elemento raíz sería "Person":

<?xml version="1.0" encoding="UTF-8"?><xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"><xs:element name="Root_Element"><xs:complexType><xs:sequence><xs:element maxOccurs="unbounded" ref="Person"/>

</xs:sequence></xs:complexType>

</xs:element><xs:element name="Person"><xs:complexType><xs:sequence>

25


<xs:element ref="First"/><xs:element ref="Last"/><xs:element ref="City"/><xs:element ref="State"/>

</xs:sequence></xs:complexType>

</xs:element><xs:element name="First" type="xs:NCName"/><xs:element name="Last" type="xs:NCName"/><xs:element name="City" type="xs:string"/><xs:element name="State" type="xs:string"/></xs:schema>

Los datos de variables se pueden incluir en un solo archivo XML con varios registros, varios archivosXML con varios registros o varios archivos XML cada uno con un único registro. A continuaciónincluimos algunos ejemplos de archivos XML con varios registros y un único registro.

Archivo con un único registro:

<Root_Element><Person><First>John</First><Last>Smith</Last><City>Hartford</City><State>CT</State>

</Person></Root_Element>

Archivo con varios registros:

<Root_Element><Person><First>John</First><Last>Smith</Last><City>Hartford</City><State>CT</State>

</Person><Person><First>Chris</First><Last>Richards</Last><City>Northhampton</City><State>MS</State>

</Person><Person><First>Mary</First><Last>Race</Last><City>San Diego</City><State>CA</State>

</Person>

26


</Root_Element>

Nota

(1) Los archivos de datos XML utilizados con Dreamweaver para Word 2007 deben usar lacodificación UTF-8 y no pueden incluir espacios de nombres XML. (2) Los archivos de datos XMLque se implementen en el servidor y se utilicen en la publicación no pueden incluir los siguientescaracteres en sus nombres: & ^ = # @ $ % ‘ * , / ? \ " + | { } < > ; :

Tipos de esquema compatiblesSe pueden utilizar los siguientes tipos de esquema en un esquema de xPresso al describir laestructura de base de datos:

• schema• element• complexType• simpleType• attributeGroup• sequence• attribute• import• include

No se admiten espacios de nombres XML. Los tipos no mostrados aquí se omiten y pueden provocarerrores si se utilizan.

Uso de instrucciones de inclusión en el esquemaEn la actualidad, xPresso para Dreamweaver no permite cargar varios archivos de esquema en undocumento; sin embargo, puede utilizar las instrucciones de inclusión en su esquema para utilizarbásicamente más de un esquema con un documento. No hay ningún límite al número de instruccionesde inclusión que puede tener en su esquema o en el nivel de anidación de las instrucciones. xPressopara Dreamweaver no admite actualmente el uso de la etiqueta "Import" en los archivos de esquema.

Las instrucciones de inclusión deben tener este formato:

<xsd:include schemaLocation="file path"/>

Por ejemplo:

<xsd:include schemaLocation="C:\Data\Common\IndustryTypes.xsd"/>

Si xPresso para Dreamweaver no puede localizar uno de los archivos incluidos, genera este mensaje:

Failed to find include file: <file path>.

27


Tendrá que corregir la instrucción de inclusión o buscar el archivo que no se encuentra antes deseguir trabajando con el esquema.

Adición de saltos de línea a campos XMLEs posible que resulte útil o necesario incluir saltos de línea en campos XML de texto (cadena).xPresso para Dreamweaver y el servidor de xPression pueden procesar campos < xs:string > quecontengan retornos de carro. Por ejemplo:

<Street_Address>9573 Main StreetCA 92009,USA</Street_Address>

Algunos editores XML, como el bloc de notas XML, puede que no muestren ni guarden este formatocorrectamente. Puede que tenga que abrir el archivo en un editor de texto para agregar los saltos delínea.

CriteriosxPresso para Dreamweaver le permite asignar criterios a los grupos de contenido para determinarsi el contenido específico se debería incluir en la salida final del documento. El tipo de criterio sedetermina en el nivel del grupo de contenido, seleccionando Varios If-Else o Cambio simple en elárea de atributos de esquema. Si opta por Varios If-Else, podrá entonces definir criterios concretospara cada instancia de contenido dentro del grupo de contenido. En el nivel de grupo de contenido,también puede especificar criterios de activación y desactivación para determinar cuándo está activoun grupo de contenido completo para el documento. Al publicar su documento, los datos satisfacencriterios para determinar qué contenido aparece en la salida final. Para obtener más información,consulte Adición de criterios al contenido dinámico.

VariablesAgregar variables al documento le permite controlar el contenido, las tablas y las imágenes incluidosen la salida. Este tipo de flexibilidad le permite personalizar cada documento para el destinatariofinal, con información como su nombre, sexo u ocupación. Puede optimizar su mensaje para queincluya sólo información pertinente al destinatario concreto que recibe el documento. Puede utilizarvariables para aspectos como la inclusión del nombre de destinatario en el saludo o para determinarqué imagen aparece en el documento en función de un campo de datos, como la profesión o elsexo del destinatario.

xPresso para Dreamweaver le permite agregar tres tipos de variables al documento: texto, tabla eimagen. Las variables se crean y se almacenan en el panel Definición de variable. Para obtener másinformación, consulte Uso de variables.

Las variables de texto se pueden utilizar para más que simplemente introducir datos del cliente; sepueden crear archivos XML que contengan gran cantidad de contenido que, a continuación, puedaintroducir en el documento mediante variables. El documento puede ser simplemente una plantilla convariables y marcos para la ubicación de contenido, que en realidad se encuentra en un archivo XML.

xPresso Schematic contiene una sección denominada Carpeta de variables globales. Esta carpetacontiene todas las variables definidas en el documento que no estén incluidas dentro de un grupo decontenido. Si agrega una variable al contenido incluido en una instancia de contenido, dicha variableaparecerá en el esquema, bajo la instancia de contenido, y no en la Carpeta de variables globales.

28


Contenido del documentoHay dos tipos básicos de contenido que constituyen un documento: dinámico y estático; ambospueden representar un papel importante en el aspecto final del documento.

¿Qué es el contenido dinámico?El contenido dinámico puede cambiar en cada versión de un documento y se puede controlar mediantecriterios y datos de variable. El contenido dinámico de xPresso para Dreamweaver se incluye engrupos de contenido, por lo que cada variación aparece en su propia instancia de contenido.

Generalmente sólo una instancia de contenido en un grupo de contenido aparece en la salida final.Por ejemplo, podría tener dos párrafos de apertura diferentes para un documento, cada uno dirigidoa un público de destino diferente. Incluiría cada párrafo como su propia instancia de contenidodentro del mismo grupo de contenido y, a continuación, utilizaría criterios para determinar cuándoaparece cada párrafo en la salida.

Los criterios le permiten controlar cuándo aparece el contenido dinámico en la salida. A continuación,los datos determinan el contenido mediante la satisfacción de los criterios definidos. Puede definircriterios para controlar qué grupos de contenido están activos en el documento y qué instancias decontenido de dichos grupos de contenido aparecen en la salida final. Para obtener más información,consulte Adición de criterios al contenido dinámico.

¿Qué es el contenido estático?El contenido estático aparece en cada repetición del documento y, dado que su inclusión no estácontrolada por criterios, no es necesario incluirlo en un grupo de contenido. Por ejemplo, el nombrey la dirección de su compañía sería el contenido estático de su documento. El contenido estáticose agrega al documento del mismo modo que se agrega cualquier otro tipo de contenido a undocumento de Dreamweaver.

El texto estático puede contener variables; aunque la inclusión del texto en sí es estática (siempre seincluye en la salida), puede utilizar variables para hacer que partes del contenido sean dinámicas.

29

Trabajo en modo en línea 3Trabajo en modo en línea

XPresso para Dreamweaver permite trabajar en "modo en línea", con acceso directo a xPressionDocumentum Edition Server. Mientras trabaja en modo en línea, puede proteger y desprotegerplantillas de documento almacenadas en el servidor de xPression. Esto permite trabajar en lasplantillas almacenadas en el servidor, así como almacenar nuevas plantillas directamente en elservidor. También puede mover conjuntos de definiciones de variable y propiedades de documentoal servidor y desde él, así como utilizar en el documento archivos de esquemas y datos que estánalmacenados en el servidor.

Nota

Actualmente, el modo en línea sólo se admite en xPression Documentum Edition Server; no seadmite en XPression Enterprise Edition Server.

Inicio de sesiónPara conectar con el servidor de xPression, debe iniciar sesión desde XPresso para Dreamweaver.Después de iniciar sesión, puede realizar funciones de servidor mientras trabaje en el cliente deXPresso para Dreamweaver. No tendrá que volver a iniciar sesión cada vez que desee realizarotra tarea de servidor.

Para poder iniciar una sesión en un servidor se debe definir antes. Para definir un servidor tiene quesaber la dirección URL del servidor. Para iniciar sesión al servidor, tendrá que saber su nombre deusuario y contraseña.

30

Capítulo 3 — Trabajo en modo en línea

Definición de un servidorPuede definir varios servidores a los que se puede obtener acceso a través del modo en línea. Parapoder iniciar una sesión en un servidor, se debe definir antes a través de la interfaz del modo en línea.

Para definir un servidor:

1. En el menú xPresso, haga clic en Inicio de sesión. Aparece el cuadro de diálogo Iniciode sesión.

2. Haga clic en Servidor. Aparece el cuadro de diálogo Servidor.

3. Haga clic en Agregar. Aparece el cuadro de diálogo Agregar servidor.

4. Escriba un nombre para el servidor. Elija un nombre con el que identificar este servidor .

5. Escriba la dirección URL del servidor.

6. Haga clic en Aceptar. El servidor se muestra ahora en el cuadro de diálogo Servidor.

7. Haga clic en Cerrar. El servidor queda disponible para que inicie sesión en él.

Iniciar sesión en un servidorUna vez definido un servidor, puede iniciar una sesión en él y comenzar a trabajar con recursosdel servidor.

Para iniciar sesión en un servidor:

1. En el menú xPresso, haga clic en Inicio de sesión. Aparece el cuadro de diálogo Iniciode sesión.

2. Seleccione el nombre del servidor en la lista desplegable.

3. Escriba su nombre de usuario para el servidor.

4. Escriba su contraseña para el servidor.

5. Haga clic en Aceptar. Aparece un mensaje de inicio de sesión correcto.

6. Haga clic en Aceptar en el mensaje. Ya ha iniciado sesión en el servidor de xPression. Lasotras opciones en línea del menú xPresso están ahora disponibles.

Nota

Si abre un cuadro de diálogo de servidor mediante la función en línea, compruebe que lo cierra obien completando la selección de un archivo o haciendo clic en Cancelar. Si deja abierto el cuadrode diálogo mientras trabaja con xPresso para Dreamweaver se pueden producir problemas conel software.

Cómo abrir un documento desde el servidorExisten dos opciones para abrir un documento actualmente almacenado en el servidor. Puede abriruna copia de sólo lectura del documento o puede abrir el documento para editar.

31


Cómo abrir un documento de sólo lecturaSi solamente desea ver un documento que reside en el servidor, pero no desea realizar ningún cambioen él, puede abrir una copia de sólo lectura del documento. Al abrir una copia de sólo lectura, notiene que volver a proteger el documento en el servidor al terminar.Para abrir un documento de sólo lectura:

1. En el menú xPresso, haga clic en Abrir (sólo lectura). Aparece el cuadro de diálogo Servidory en la ficha de exploración aparece la estructura de carpetas del servidor.

2. Busque y seleccione el documento que desea abrir. También podrá buscar un archivo; si deseaobtener más información, consulte Búsqueda de archivos en el servidor.

3. Haga clic en Abrir. El documento se abre en xPresso para Dreamweaver.

Cómo abrir un documento para editar (desprotección)Si desea realizar cambios en un documento almacenado en el servidor, puede abrir el documentopara editarlo, o desprotegerlo. Cuando un usuario abre un documento para editarlo, los otros usuariossólo podrán abrirlo en el modo de sólo lectura. Si abre el documento para editar, necesitará volver aprotegerlo al terminar, o lo que es lo mismo, cancelar la desprotección.Para abrir un documento para editar:

1. En el menú xPresso, haga clic en Editar (desproteger). Aparece el cuadro de diálogo Servidory en la ficha de exploración aparece la estructura de carpetas del servidor.

2. Busque y seleccione el documento que desea abrir. También podrá buscar un archivo; si deseaobtener más información, consulte Búsqueda de archivos en el servidor.

3. Haga clic en Editar. El documento se abre en xPresso para Dreamweaver.

Cancelación de una desprotecciónSi desprotege un documento para editarlo y posteriormente decide que no desea realizar cambios oque no desea mantener los cambios que ha realizado, puede cancelar la desprotección. Al cancelar ladesprotección se elimina el indicador de desprotección del documento en el servidor. El documentopermanece en el servidor con el mismo estado que tenía al desprotegerlo y queda disponible paraque lo desprotejan otros usuarios. En xPresso para Adobe InDesign sigue abierta una copia deldocumento, pero ahora es completamente independiente del documento que reside en el servidor.

Para cancelar una desprotección, en el menú xPresso, haga clic en Cancelar Desproteger. xPressopara Dreamweaver Word cierra el documento en el equipo cliente y ya no estará marcado comodesprotegido en el servidor.

Protección de un documentoDespués de crear un documento o de realizar cambios en un documento desprotegido, debe protegerel documento en el servidor. Cada vez que se protege un documento en el servidor, xPression creaun paquete de documentos. Puede decidir que desea crear un paquete listo para su publicación quese pueda publicar en el servidor de xPression o bien, puede crear un paquete que no está listo para lapublicación y no es válido para la publicación pero que contiene todos los archivos necesarios paratrabajar con el documento en xPresso para Dreamweaver. Una vez protegido el documento en el

32


servidor, se incluye en el repositorio del servidor y está disponible para que otros lo vean o editeno, en el caso de los paquetes listos para publicación, lo publiquen. Para obtener más información,consulte Empaquetado de documentos.

El proceso de protección es ligeramente diferente en función de si el documento se protegió o noen el servidor previamente.

Protección de un nuevo documentoAl proteger un nuevo documento, debe determinar donde desea que se almacene el documento enel servidor y debe especificar el nombre del documento. También tiene la opción de almacenar eldocumento en un paquete listo para publicar o en un paquete no preparado para publicar.

Para proteger un nuevo documento:

1. En el menú xPresso, haga clic en Proteger como. Aparece el cuadro de diálogo Servidor y enla ficha de exploración aparece la estructura de carpetas del servidor.

2. Localice la ubicación donde desea almacenar el archivo en el servidor.

3. Escriba un nombre para el archivo. El tipo de archivo será un paquete de documentos, ya quetodos los documentos se empaquetan antes de colocarse en el servidor.

4. Active la casilla de verificación Marcar plantilla como Listo para publicar para crear unpaquete que se pueda publicar en el servidor de xPression. Si deja la casilla de verificacióndesactivada, se creará un paquete no listo para publicar que no será válido la publicación en elservidor, pero que contendrá todos los archivos necesarios para trabajar con el documento enxPresso para Dreamweaver. Esta opción sólo aparece si el documento que protege contieneelementos de xPresso. Para obtener más información, consulte Empaquetado de documentos.

5. Haga clic en Proteger. xPresso para Dreamweaver cierra automáticamente el documentocuando finaliza el proceso de protección.

Nota

La opción Listo para publicar del menú Esquema no tiene efecto cuando el documento se protege enun servidor de ECM a través del modo en línea. Debe seleccionar la opción Marcar plantilla comoListo para publicar en el cuadro de diálogo de protección del servidor independientemente de quehaya seleccionado la opción Listo para publicar en el menú Esquema.

33


Protección de un documento editadoAl proteger un documento que ha desprotegido y editado, debe seleccionar un número de versiónpara la copia editada del documento. No necesita especificar dónde se almacenará el documentoen el servidor ni el nombre del documento, ya que esta información será la misma que existía aldesproteger el documento. Podrá almacenar el documento en un paquete listo para publicar o en unpaquete no listo para publicar.

Para proteger un documento editado:

1. En el menú xPresso, haga clic en Proteger. Aparece el cuadro de diálogo Definir versión.

2. Seleccione la versión de la plantilla: misma versión, una nueva versión secundaria o unanueva versión principal.

3. Active la casilla de verificación Marcar plantilla como Listo para publicar para crear unpaquete que se pueda publicar en el servidor de xPression. Si deja la casilla de verificacióndesactivada, se creará un paquete no listo para publicar que no será válido la publicación en elservidor, pero que contendrá todos los archivos necesarios para trabajar con el documento enxPresso para Dreamweaver. Esta opción sólo aparece si el documento que protege contieneelementos de xPresso. Para obtener más información, consulte Empaquetado de documentos.

4. Haga clic en Aceptar. xPresso para Dreamweaver cierra automáticamente el documentocuando finaliza el proceso de protección.

Nota

La opción Listo para publicar del menú Esquema no tiene efecto cuando el documento se protegeen un servidor de ECM a través del modo en línea. Debe seleccionar la opción Marcar plantillacomo Listo para publicar en el cuadro de diálogo Definir versión independientemente de que hayaseleccionado la opción Listo para publicar en el menú Esquema.

Trabajo con otros archivos del servidorAdemás de trabajar con archivos de documento del servidor, también puede trabajar con diferentestipos de archivos de datos que puede utilizar con el documento. Esto permite volver a utilizar ycompartir estos archivos de forma sencilla. Siempre que haya iniciado sesión en el servidor, podrá:

• Importar conjuntos de definiciones de variable al servidor (para obtener más información,consulte Importación de definiciones de variables)

• Exportar conjuntos de definiciones de variable del servidor (para obtener más información,consulte Exportación de definiciones de variables)

• Importar conjuntos de propiedades de documento al servidor (para obtener másinformación, consulte Importación de propiedades de documento)

• Exportar conjuntos de propiedades de documento del servidor (para obtener másinformación, consulte Exportación de propiedades de documento)

• Cargar un esquema del servidor (para obtener más información, consulte Carga de suesquema)

34


• Aplicar datos XML del servidor (para obtener más información, consulte Consulta de datosde variables en el documento)

• Consultar una vista previa de un documento utilizando datos del servidor (para obtener másinformación, consulte Cómo obtener una vista previa del documento)

Simplemente seleccione la opción "servidor" disponible en cada función para acceder al servidor yguardar o seleccionar archivos.

Búsqueda de archivos en el servidorEl cuadro de diálogo Servidor ECM contiene una ficha Buscar, con la cual podrá buscar los archivosalmacenados en el servidor de xPression. Podrá realizar una búsqueda sencilla o avanzada, que lepermitirá incorporar varios parámetros de búsqueda diferentes.

Búsqueda sencillaUna búsqueda sencilla no incorpora ningún parámetro de búsqueda, sólo una cadena de búsqueda, yse realizará en toda la base de datos del servidor. Las búsquedas sencillas son útiles si la clave quese utiliza para la búsqueda es muy específica y no se localiza en demasiados archivos del servidor.Para realizar una búsqueda sencilla:

1. Haga clic en la ficha Buscar del cuadro de diálogo Servidor EMC.2. Escriba la cadena de búsqueda en el campo Nombre. La cadena de búsqueda distingue

mayúsculas de minúsculas.3. Haga clic en Buscar. Los archivos que encuentre se mostrarán en la lista de archivos en la

parte derecha del cuadro de diálogo.

Búsqueda avanzadaUna búsqueda avanzada le permite ser más específico en la búsqueda e incorporar varios parámetrosque le ayudarán a limitar los resultados. Gracias a esta búsqueda, podrá controlar los directorios delservidor en los que se realizará la búsqueda y podrá definir las propiedades de los archivos que leayudarán a identificar los archivos que busca.Para realizar una búsqueda avanzada:

1. Haga clic en la ficha Buscar en el cuadro de diálogo del servidor EMC.2. Escriba la cadena de búsqueda en el campo Nombre. La cadena de búsqueda distingue

mayúsculas de minúsculas.3. Haga clic en Búsqueda avanzada. Aparecerán más opciones en la ficha Buscar.4. Seleccione las ubicaciones del servidor donde desee realizar la búsqueda:

• Haga clic en Base de documentos de xPression para buscar en todos losdirectorios del servidor.

• Haga clic en Base de documentos de xPression y, a continuación, haga clic enEditar para seleccionar los directorios donde desee realizar la búsqueda. Apareceráel cuadro de diálogo Cambiar fuentes de búsqueda.

35


– Desplácese hasta éste y seleccione un directorio. Haga clic en Agregar.

– Repita este paso para todos los directorios donde desee realizar la búsqueda.

– Haga clic en Aceptar. Todos los directorios seleccionados aparecerán en elcuadro de edición en la parte inferior de la sección Ubicaciones.

• Haga clic en Sólo ubicación actual para buscar sólo el directorio centrado en laficha Buscar del cuadro de diálogo Servidor ECM. Cuando seleccione esta opción, eldirectorio actual aparecerá en el cuadro de texto debajo de la opción.

5. Seleccione una propiedad de la lista desplegable: Creador, Última modificación de, Autor oVersión.

6. Seleccione una acción para la propiedad en la lista desplegable: contiene, comienza por,no contiene, termina por, en, no en, no es nulo o es nulo.

7. Escriba un valor para la propiedad en el cuadro de texto. El valor distingue entre mayúsculasy minúsculas.

8. Haga clic en Agregar para agregar otra propiedad. Repita los pasos 5–8 para definir todaslas propiedades que desee.

9. Seleccione una acción de fecha: Modificación, Creación, Acceso, o Fecha de bloqueo.

10. Seleccione un rango de fecha para la búsqueda:

• Seleccione un período de tiempo de la lista desplegable: Cualquier período,Durante el día anterior, Durante la semana anterior, Durante el mes anterior,Durante el año anterior.

• Seleccione Desde/hasta y, a continuación, las fechas que desee.

11. Seleccione un tamaño de archivo: Cualquier tamaño, Menor que 100 KB, Menor que 1 MB,Menor que 10 MB, Mayor que 10 MB o Mayor que 100 MB.

12. Active la casilla de verificación Buscar todas las versiones si desea que la búsqueda muestrela versión de los archivos que encuentre.

13. Haga clic en Buscar. Los archivos que encuentre se mostrarán en la lista de archivos en laparte derecha del cuadro de diálogo.

36

Creación de documentosxPresso 4

Creación de documentos xPresso

Existen varios pasos de creación de un documento xPresso. En este capítulo se describe lo quenecesita conocer para utilizar xPresso para Dreamweaver con objeto de crear un documento, comoasociar datos a un documento, crear el contenido, especificar los criterios para controlar la inclusiónde contenido y agregar variables.

Asociación de datos con documentosLos datos condicionan en última instancia el aspecto final de un documento. Es vital que estosdatos se preparen correctamente antes de crear el documento a fin de evitar posibles problemas aldesplazar su documento a producción.

Debería tener un archivo de esquema de datos y un archivo XML que contenga la informaciónespecífica del documento que está creando. Estos archivos deberían ser accesibles desde el equipocliente de xPresso para Dreamweaver. Actualmente, xPresso no admite varios archivos de esquema.Los archivos de esquema utilizados en xPresso para Dreamweaver deberían ser específicos parael correo electrónico o página HTML que está diseñando o para un grupo de correos electrónicoso páginas similares.

Asegúrese de que el esquema y los archivos XML se adhieren a los estándares de xPresso antes deempezar a utilizarlos para crear su documento. Para obtener más información, consulte Preparaciónde archivos de datos. Los archivos de datos XML que se implementen en el servidor y se utilicen en lapublicación no pueden incluir los siguientes caracteres en sus nombres: &^=#@$%‘*,/?/"+|{}<>;:

37

Capítulo 4 — Creación de documentos xPresso

Carga de su esquemaEl esquema se carga en xPresso para Dreamweaver a través del panel Esquema de datos de xPresso.Este panel le permite trabajar con el archivo de esquema de datos mientras se crea el documento.

Para cargar un esquema de datos:

1. Localice el panel Esquema de datos de xPresso en el área de trabajo. Si el panel no estámostrando, en el Dreamweaver el menú de xPresso, haga clic en Esquema de datos.

2. Haga clic en Cargar esquema en el panel o la barra de inserción de xPresso o, Cargaresquema o Cargar esquema desde servidor (si su esquema se encuentra en el servidor dexPression) en el menú Esquema de datos. Aparece el cuadro de diálogo del servidor o Cargaresquema.

3. Busque y seleccione el archivo XSD que contiene su esquema. Haga clic en Aceptar oCargar (para el servidor).

4. Si el esquema contiene más de un elemento raíz, xPresso le pregunta qué elemento deseausar como raíz. Seleccione el elemento de repetición y haga clic en Aplicar. La raíz del registrode repetición debería ser el elemento de nivel superior que represente el registro de repeticiónde los datos. El esquema de datos aparece en la paleta en una estructura jerárquica. Loselementos de la lista desplegable Seleccionar elemento raíz se muestran en orden alfabético,no en el orden que los elementos aparecen en el esquema. Ésta es una limitación impuesta porDreamweaver.

5. Haga clic en la vista Dividir o en el botón Mostrar vista de Código de Dreamweaver ydesplácese a la parte inferior de la ventana del visor. Verá que xPresso para Dreamweaver hainsertado los elementos desde el esquema cargado. Esta estructura del esquema se almacenaaquí temporalmente; no aparecerá en el código HTML final generado.

Ahora que ya tiene cargado el esquema, está listo para utilizar los datos mientras crea su documento.Puede acceder a los campos de esquema para usarlos en la definición de criterios y puede utilizarlos campos como variables en el documento.

Si está listo para empezar a crear variables, consulte Uso de variables. Si va a crear grupos decontenido e instancias, continúe leyendo.

Creación del contenidoDespués de haber "conectado" los datos al documento, ya está preparado para agregar elementosdinámicos de xPresso a los documentos estáticos. Si ha planificado el documento de antemano,debería saber qué áreas van a ser dinámicas y qué áreas aparecerán estáticamente en todas lassalidas del documento.

Nota

Los grupos de contenido y las instancias de contenido no pueden tener comentarios HTML dentro deltexto. Todos los comentarios encontrados en el texto se procesarán como texto convencional. Porejemplo: Mi texto  Aparecerá en el documento como: Mi texto Mi Comentario

38


Se pueden crear grupos e instancias de contenido utilizando las funciones Crear grupo de contenido yAgregar instancia de contenido o utilizar el Asistente de grupo de contenido. Al utilizar el asistente,puede crear grupos de contenido y todas las instancias de contenido a la vez, incluso agregar elcontenido y definir los criterios. Si no utiliza el asistente, tendrá que seguir cada paso por separado.Las secciones siguientes describen los pasos independientes. Para obtener más información sobre elAsistente de grupo de contenido, consulte Utilización del Asistente de grupo de contenido.

Grupos de contenidoUn grupo de contenido es un contenedor de contenido dinámico. Cada variación del contenido seincluye en una instancia de contenido dentro del grupo de contenido. Los grupos de contenidopueden contener una sola instancia de contenido o pueden contener muchas instancias. Los gruposde contenido de instancias únicas incluyen contenido sin variaciones, pero que se puede incluir oexcluir dinámicamente de la salida de documento. Debería tener un grupo de contenido para cadasección dinámica del documento.

Creación de un grupo de contenidoPuede crear un grupo de contenido "vacío" y, a continuación, agregar contenido o bien puedeseleccionar contenido existente para crear un grupo de contenido.

Para crear un grupo de contenido vacío:

1. Coloque su cursor en la página de documentos en vista de diseño donde desea que comienceel grupo de contenido.

2. Haga clic en Crear grupo de contenido en el panel o la barra de inserción de xPresso. Acontinuación, xPresso para Dreamweaver:

• Agrega un nuevo elemento al esquema con el nombre predeterminado Grupo decontenido y agrega una instancia de contenido llamada Instancia de contenido bajoel nuevo grupo de contenido que represente el contenido seleccionado.

• Agrega una etiqueta de grupo e instancia de xPresso al código HTML.

• Agrega los marcadores de comienzo de grupo y fin de grupo a la página.

3. Reemplace la frase Agregar contenido aquí que aparece entre las etiquetas {G }{I } e {/I}{/G}con el contenido que desee. Asegúrese de que el contenido se encuentra entre las etiquetas decomienzo y de final.

Para crear un grupo de contenido usando contenido existente:

1. Seleccione el contenido que desea incluir en la primera instancia del grupo de contenido.Se recomienda seleccionar el contenido en la vista de código e incluir también las etiquetasde fuente y párrafo.

Selección del contenido que se va a incluir en un grupo de contenido.

2. Haga clic en Crear grupo de contenido en el panel o la barra de inserción de xPresso.

39


3. A continuación, xPresso para Dreamweaver:

• Agrega un nuevo elemento al esquema con el nombre predeterminado Grupo decontenido y agrega una instancia de contenido llamada Instancia de contenido bajoel nuevo grupo de contenido que representa el contenido seleccionado.

• Agrega una etiqueta de grupo y una etiqueta de instancia de xPresso al códigoHTML.

• Agrega marcadores de comienzo y final de grupo a la página.

Ahora, el contenido es una instancia de contenido específica, incluida dentro de un grupo decontenido. El grupo de contenido debe contener las distintas versiones del contenido. Sólo deberíaaparecer una instancia de contenido en un grupo de contenido en un documento final. Los criterioscolocados en el grupo de contenido determinan si éste debería incluirse en el documento y, acontinuación, el criterio colocado en cada instancia de contenido determina qué instancia aparece enla salida. Obtendrá más información sobre los criterios en Adición de criterios al contenido dinámico.

Copia de un grupo de contenidoCuando se haya creado un grupo de contenido, se puede copiar el grupo para crear otro grupo.

Para copiar un grupo de contenido:

1. Seleccione el grupo de contenido del esquema.

2. Haga clic en el menú Esquema y seleccione Copiar grupo de contenido.

3. Coloque el cursor de la plantilla de documento en la ubicación donde desea que se muestre elnuevo grupo de contenido y haga clic en xPresso-Pegar en el panel o la barra de inserción.

40


Instancias de contenidoxPresso para Dreamweaver agrega automáticamente una instancia de contenido al crear un grupode contenido. Puede crear más instancias de contenido dentro del grupo de contenido a fin de queincluya versiones alternativas del texto.

Creación de una instancia de contenidoAgregue tantas instancias de contenido como necesite a cualquier grupo de contenido. Recuerde:sólo debe aparecer una instancia de un grupo de contenido en el resultado final.

Para crear una instancia de contenido:

1. Seleccione el grupo de contenido en el esquema al que desea agregar la instancia.

2. Haga clic en Agregar instancia de contenido en el panel o la barra de inserción de xPresso.

3. A continuación, xPresso para Dreamweaver:

• Agrega un nuevo elemento al esquema con el nombre predeterminado Instancia decontenido bajo el grupo de contenido.

• Agrega nuevas etiquetas de instancia ({I} y {/I}) dentro de las etiquetas de grupoen el código HTML.

• Agrega nuevos marcadores de comienzo y fin a la página. Ya no aparece el texto dela primera instancia de contenido.

4. Reemplace el texto "Agregar contenido aquí", en la vista Diseño o Código, con el contenido desu nueva instancia.

Clonación de instancias de contenidoSi tiene que crear varias instancias que son prácticamente iguales, puede comenzar con una instanciay clonarla tantas veces como necesite para crear nuevas instancias. Todos los aspectos de lainstancia original se mantienen en los clones, incluso las variables.

Para clonar una instancia de contenido:

1. Seleccione la instancia en el esquema.

2. Haga clic en el menú Esquema y seleccione Clonar instancia de contenido. Una nuevainstancia aparece en el grupo de contenido con el nombre de clon del nombre de instanciaoriginal.

3. Seleccione el nuevo clon en el esquema y cambie el nombre de la instancia de contenido.

4. Haga clic en Guardar.

Adición de criterios al contenido dinámicoUna vez haya empezado a crear el contenido dinámico, tendrá que agregar los criterios para controlarsu inclusión en la salida de documento.

41


Nota

Necesitará tener su esquema de datos cargado en xPresso para Dreamweaver antes de poder definirlos criterios. Para obtener más información, consulte Contenido del documento.

Para cada grupo de contenido, puede especificar criterios de activación y desactivación quedeterminen si se considera el grupo de contenido para su inclusión en la salida de documento.Además, puede definir criterios de tipo If-Else o Switch para determinar qué elemento de contenidodel grupo de contenido aparece en la salida.

Los criterios de cambio se pueden utilizar si tiene elementos de contenido que deban aparecer cuandoun único campo de datos contiene un valor concreto. Por ejemplo, digamos que tiene contenido quedifiere en función del área geográfica en la que vive el destinatario. Puede definir los criterios decambio de ese grupo de contenido mediante la selección del campo, como Región, y la definición delos valores que desencadenarán cada instancia de contenido, como Sur, Norte o Suroeste, etc. Loscriterios de cambio se seleccionan y definen en el nivel de grupo de contenido.

Para requisitos de criterios más complicados, debería utilizar criterios If-Else. Los criterios If-Elsele permiten crear una expresión que se utilice para determinar si debe aparecer una instancia decontenido. En la expresión, se puede utilizar la lógica booleana y comparar las variables con loscampos o valores. Puede definir una expresión para cada instancia de contenido dentro del grupo decontenido. Los criterios If-Else se seleccionan en el nivel de grupo de contenido, aunque los criteriosse definen en el nivel de instancia de contenido.

Nota

Si elimina la lógica del criterio asociada a un elemento, no podrá deshacer la eliminación.

42


Definición de criterios de activación/desactivaciónSi tiene un grupo de contenido que puede que no se utilice en todos los documentos, puede activarloo desactivarlo para una salida determinada con Activar/desactivar criterios. Por ejemplo, si tienecontenido que sólo es válido para los destinatarios del estado de California, podría especificarActivar/desactivar criterios para que se desactivara el grupo de contenido, de forma que no se tengaen cuenta para la inclusión, si el valor de estado de los datos no es igual a California.

Para definir los criterios de activación/desactivación:

1. Seleccione el grupo de contenido del esquema. La información del grupo de contenido apareceen el área de atributos, situada en la parte inferior del panel del esquema.

2. Haga clic en el botón de exploración situado junto al campo ACTIVAR/DESACTIVAR. Apareceel cuadro de diálogo Activar/desactivar criterios. El cuadro de diálogo Activar/desactivar criteriosle permite generar una expresión que defina los criterios para la inclusión de un elemento.

3. Haga clic en Agregar fila y, a continuación, cree la expresión de criterios.

• Para agregar una variable: haga clic en el botón de exploración que se encuentrajunto a Variable para abrir el cuadro de diálogo Seleccionar variable. Seleccione lavariable que desee agregar de la lista y haga clic en Aceptar.

• Para agregar un operador: seleccione a un operador de la lista desplegable Es.

• Para agregar un valor: haga clic en Valor y escriba el valor en el cuadro de texto.

• Para agregar un campo: haga clic en Campo y, a continuación, haga clic en elbotón de exploración para abrir el cuadro de diálogo Seleccionar variable. Seleccionela variable que desee agregar de la lista y haga clic en Aceptar.

• Haga clic en los botones (, ), AND y OR para agregar los operadores adecuados ala expresión.

4. Haga clic en Insertar para agregar la expresión de criterios a la lista.

5. (Opcional) Haga clic en Borrar fila para borrar el contenido de la fila seleccionada o haga clicen Borrar todo para borrar el contenido de todas las filas del cuadro de diálogo.

6. Haga clic en Aceptar cuando termine de definir la expresión de criterios y volverá al panelDefinición de variable.

7. Haga clic en Guardar en el panel Definición de variable para agregar la expresión.

Nota

Si está comparando valores de fecha, el valor debe estar en formato AAAA-MM-DD.

43


Definición de criterios de cambioSi tiene un solo campo en sus datos que contenga valores usados para controlar la inclusión decontenido, puede especificar un criterio de cambio (Switch). Un criterio de cambio es una sencillaprueba de verdadero o falso, sobre si el valor coincide y la instancia de contenido se ha incluido o biensi el valor no coincide y la instancia no está incluida. Puede definir una de las instancias de contenidocomo instancia predeterminada y aparecerá en la salida si el resto de instancias no satisfacen loscriterios. Los criterios de cambio están configurados completamente en el nivel de grupo de contenido.

Sólo los campos de cadenas pueden contener valores nulos para criterios de cambio. A continuaciónse muestra cómo xPresso para Dreamweaver resuelve los criterios de cambio de la cadena:

• Si el valor de campo es nulo:

– Mostrar la primera instancia con un valor de campo vacío.

– Si ningún valor de campo está vacío, mostrar la instancia especificada comopredeterminada.

– Si no hay ninguna instancia predeterminada, desactiva el grupo de contenido.

• Si el valor de campo no es nulo:

– Muestra la primera instancia cuyo valor de campo coincida con el valor de campode los datos.

– Si no coincide ninguna instancia, muestra la instancia que se haya especificadocomo predeterminada.

– Si no hay ninguna instancia predeterminada, desactiva el grupo de contenido.

Para campos que no sean de cadena, el valor del campo de instancia de contenido debeser del mismo tipo que el valor del campo de datos. Para los campos que no son decadena, xPresso para Dreamweaver resuelve los criterios de cambio de esta manera:

• Muestra la primera instancia cuyo valor de campo coincida con el valor de campo de losdatos.

• Si no coincide ninguna instancia, muestra la instancia que se haya especificado comopredeterminada.

• Si no hay ninguna instancia predeterminada, desactiva el grupo de contenido.

44


Para definir criterios de cambio:

1. Seleccione el grupo de contenido del esquema. La información del grupo de contenido apareceen el área de atributos del esquema de xPresso, situada en la parte inferior del panel Esquema.

2. Seleccione Cambio simple en la lista desplegable Tipo de selección.

3. Haga clic en el botón de exploración situado junto al campo Lógica. Aparece el cuadro dediálogo Condición de cambio. El cuadro de diálogo Condición de cambio permite seleccionaruna variable de campo y a continuación, definir los valores para la inclusión para cada elementode contenido.

4. Haga clic en el botón de exploración que se encuentra junto a Variable. Aparece el cuadro dediálogo Definición de variable de xPresso.

5. Seleccione el campo que desee utilizar para controlar la inclusión de este contenido y hagaclic en Aceptar.

6. Escriba el valor junto a cada instancia de contenido que debe aparecer en el camposeleccionado para que esa instancia de contenido se incluya en la salida.

7. (Opcional) Seleccione la casilla de verificación situada a la derecha del cuadro de valor paradefinir la instancia de contenido como predeterminada. Sólo puede definir una instancia comopredeterminada.

8. Haga clic en Insertar. Repita los pasos del 4 al 8 para cada instancia.

9. Haga clic en Aceptar.

45


Definición de criterios If-ElseSi necesita que sus criterios sean más que una simple prueba de cambio de verdadero o falso,utilice un criterio If-Else y defina una expresión de condición. En la expresión If-Else, se puedenseleccionar variables para comparar con un valor o un campo y utilizar operadores booleanos paracombinar instrucciones de criterios.

Para definir sus criterios:

1. Seleccione el grupo de contenido del esquema. La información del grupo de contenido apareceen el área de atributos del esquema de xPresso, situada en la parte inferior del panel Esquema.

2. Seleccione Varios If-Else en la lista desplegable Tipo de selección.

3. Seleccione una instancia de contenido dentro del grupo de contenido para el que desea definircriterios. La información de la instancia de contenido aparece en el área de atributos delesquema de xPresso, situada en la parte inferior del panel Esquema.

4. Haga clic en el botón de exploración situado junto al campo Lógica. Aparece el cuadrode diálogo Expresión If-Else. El cuadro de diálogo Expresión If-Else le permite generar unaexpresión que defina los criterios para la inclusión de un elemento.

5. Haga clic en Agregar fila y, a continuación, cree la expresión de criterios.

• Para agregar una variable: haga clic en el botón de exploración debajo de Variablepara abrir el cuadro de diálogo Definición de variable de xPresso. Seleccione lavariable que desee agregar de la lista y haga clic en Aceptar.

• Para agregar un operador: seleccione un operador de la lista desplegable Es:igual (=), mayor o igual que (>=), menor o igual que (<=), distinto de (<>), menorque (<), mayor que (>).

46



• Para agregar un campo: haga clic en Campo y, a continuación, haga clic enel botón de exploración para abrir el cuadro de diálogo Definición de variable dexPresso. Seleccione la variable que desee agregar de la lista y haga clic en Aceptar.



7. (Opcional) Haga clic en Borrar fila para borrar el contenido de la fila seleccionada o haga clicen Borrar todo para borrar el contenido de todas las filas del cuadro de diálogo.

8. Haga clic en Aceptar cuando termine de definir la expresión de criterios y volverá al panelDefinición de variable.

9. Haga clic en Guardar en el panel Definición de variable para agregar la expresión.

10. Repita el procedimiento para todas las instancias de contenido del grupo de contenido.

Nota


Edición de los criterios existentesSi necesita realizar cambios en los criterios existentes, puede editarlos.

Para editar los criterios existentes:

1. Seleccione el elemento de xPresso Schematic que contenga los criterios que desea editar.

2. Haga clic en el botón de exploración situado junto al campo Lógica de los criterios If-Else o decambio o bien en el campo Activar/Desactivar para los criterios de activación y desactivación.Aparece el cuadro de diálogo Activar/Desactivar criterios, Condición de cambio o ExpresiónIf-Else.

3. Realice sus cambios en la expresión de criterios.


Utilización del Asistente de grupo de contenidoEl Asistente de grupo de contenido le guía a través del proceso de creación de un grupo de contenidoy las instancias de contenido dentro del grupo. Puede definir también los criterios a través delasistente y agregar el contenido para cada instancia.

Para utilizar el asistente para crear su grupo de contenido e instancias:

1. Haga clic en Asistente de grupo de contenido en el panel o la barra de inserción de xPresso.Se muestra el Asistente de grupo de contenido.

2. Escriba el nombre del grupo de contenido.

47


3. Seleccione el tipo de lógica de selección que desea usar con este grupo de contenido: VariosIf-Else o Cambio simple.

4. Escriba el número de instancias de contenido que desea incluir en el grupo de contenido.

5. Si se selecciona Cambio simple para el tipo lógico, haga clic en el botón de exploración situadojunto al campo Lógica. Aparece el cuadro de diálogo Condición de cambio. Defina la lógicade cambio y haga clic en Aceptar. Para obtener más información, consulte Definición decriterios de cambio.

6. Si desea definir criterios de activación/desactivación para controlar la inclusión del grupode contenido en el resultado, haga clic en el botón de exploración situado junto al campoActivar/Desactivar. Aparece el cuadro de diálogo Activar/desactivar criterios. Defina loscriterios de activación/desactivación y haga clic en Aceptar. Para obtener más información,consulte Definición de criterios de activación/desactivación.

7. Haga clic en Siguiente. Se muestra la página Configuración de instancia. Esta página aparecede forma diferente dependiendo del tipo de lógica de selección que haya seleccionado en lapágina anterior.

48


Configuración de instancia de varios If-ElseSi ha seleccionado Varios If-Else como tipo de lógica de selección en la página anterior, aparece lapágina siguiente Configuración de instancia. Si también ha definido varios criterios if-else en la páginaanterior, esta página mostrará los criterios definidos para esta instancia de contenido.

Para definir una instancia de contenido:

1. Escriba el nombre de la instancia.

2. Si no ha definido los criterios de varios if-else en la página anterior, defínalos ahora haciendoclic ahora en Agregar fila. A continuación, cree su expresión de criterios:

• Para agregar una variable: haga clic en el botón de exploración debajo de Variablepara abrir el cuadro de diálogo Definición de variable de xPresso. Seleccione lavariable que desee agregar de la lista y haga clic en Aceptar.

• Para agregar un operador: seleccione un operador de la lista desplegable Es:igual (=), mayor o igual que (>=), menor o igual que (<=), distinto de (<>), menorque (<), mayor que (>).


• Para agregar un campo: haga clic en Campo y, a continuación, haga clic enel botón de exploración para abrir el cuadro de diálogo Definición de variable dexPresso. Seleccione la variable que desee agregar de la lista y haga clic en Aceptar.



4. Haga clic en Siguiente. Aparece otra página de configuración de instancia, en la que seagrega el contenido.

Nota


49


Configuración de instancia de Cambio simpleSi ha seleccionado Cambio simple como tipo de lógica de selección en la página anterior, aparece lapágina siguiente Configuración de instancia. Si también ha definido sus criterios de cambio simple enla página anterior, esta página mostrará los criterios definidos para esta instancia de contenido.

Para definir una instancia de contenido:1. Escriba el nombre de la instancia.

2. Si no ha definido los criterios de cambio simple en la página anterior, defínalos ahora haciendoclic en el botón de exploración que se encuentra junto al campo Variable.

3. Seleccione la variable que contiene los datos que desea utilizar para decidir la instancia decontenido de este grupo de contenido que se elige. Haga clic en Aceptar.

4. Especifique el valor de la variable que significa la inclusión de esta instancia determinada. Obien, active la casilla de verificación después del campo Valor para indicar que esta instanciaes la instancia predeterminada que aparecerá cuando ninguna instancia se califique para lainclusión. Haga clic en Insertar.

5. Haga clic en Siguiente. Aparece otra página de configuración de instancia, en la que seagrega el contenido.

Adición de contenido a una instanciaUna vez definida la instancia, ya puede agregarle contenido. Puede copiar y pegar el contenido,incluso etiquetas HTML, en el cuadro de la página. Cualquier edición posterior del contenido se puederealizar en la vista Diseño cuando finaliza el asistente.Para agregar contenido a una instancia:

1. Pegue el contenido de esta instancia en el cuadro de la página. O bien, escriba directamenteel contenido en el cuadro.

2. Haga clic en Siguiente. Se muestra la página Configuración de instancia para la siguienteinstancia de contenido del grupo. Repita los pasos anteriores para definir la lógica y elcontenido de todas las instancias del grupo. Cuando se define la última instancia, haga clicen Finalizar. Una vez finalizado el asistente, el nuevo grupo de contenido y las instancias seagregan al esquema, a la vista Código y a la vista Diseño.

Bucles de contenidoSi los datos poseen información que desea consultar para crear el contenido del documento, puedeagregar un bucle de contenido en xPresso para Dreamweaver. Un bucle de contenido le permiteseleccionar un rango de texto y variables y hacer que el contenido se repita en el documento con unnuevo contenido de variable mientras xPresso para Dreamweaver recorre los datos. Por ejemplo,puede que desee crear una lista de variables de elementos en el documento. Si crea un bucle decontenido que contiene una línea de la lista con datos variables, xPresso para Dreamweaver recorrerálos datos y creará tantas líneas como sea preciso para finalizar la lista.

Puede anidar varios bucles de contenido uno dentro de otro; sin embargo, un bucle anidado no sepuede asociar al elemento principal del elemento asociado al bucle exterior. Por ejemplo, si los datos

50


tienen un "Elemento principal 1", con un elemento secundario "Secundario 1", no puede anidar unbucle asociado a "Elemento principal 1" en un bucle asociado a "Secundario 1".

También puede agregar un bucle de contenido a las filas de la tabla para rellenar las filas. Paraobtener más información, consulte Creación de una tabla dinámica usando bucles de contenido.

Creación de bucles de contenidoPuede utilizar un bucle de contenido para repetir un fragmento de contenido (texto o variables)en el documento.Para crear bucles de contenido:

1. Cree una matriz que contenga todas las variables que desea incluir en el bucle de contenido.Para obtener más información, consulte Creación de matrices.

2. Coloque el cursor en la página del documento donde desea que aparezca el contenido del bucle.3. Haga clic en Crear bucle de contenido en el panel o la barra de inserción de xPresso.

Aparece el cuadro de diálogo Definición de variable de xPresso.4. Seleccione la matriz que desea utilizar para crear el bucle de contenido y haga clic en Aceptar.

El bucle de contenido aparece en el esquema y los marcadores del bucle de contenidoaparecen en la página del documento.

5. Sitúe el cursor entre los marcadores {L} y {/L} y agregue el contenido del bucle.6. Pruebe el bucle de contenido aplicando algunos datos. Haga clic en el menú Definición de

variable y seleccione Aplicar datos de variable. Seleccione un archivo de datos y haga clicen Cargar. Cuando aplica los datos, el bucle debería crear tantas líneas de texto como seanecesario para el registro de datos.

Copia de un bucle de contenidoPuede copiar un bucle de contenido para crear otro bucle con los mismos atributos y contenido.Para copiar un bucle de contenido:

1. Seleccione el bucle de contenido en el esquema.2. Haga clic en el menú Esquema y seleccione Copiar variable de bucle.3. Sitúe el cursor en la página de la ubicación en la que desea que aparezca el nuevo bucle y

haga clic en xPresso - Pegar en el panel o la barra de inserción. El nuevo bucle aparece en lapágina y en el esquema.

Tablas dinámicasLas tablas dinámicas son una gran forma visual de incluir información en el documento, en un formatode fácil lectura. Las tablas dinámicas crecen y se comprimen según la cantidad de datos que se van amostrar y tienen un número diferente de filas para cada registro de los datos. Existen dos manerasde incluir una tabla dinámica en el documento:

• Utilice una matriz para crear una variable de tabla.• Cree una tabla estática en Dreamweaver y aplique bucles de contenido a las filas.

51


Usar una variable de tabla es una manera simple y eficaz de agregar una tabla al documento. Esbueno utilizar las variables de tabla cuando la estructura de datos coincide en gran medida con las filasy las columnas que desea incluir en la tabla. Todos los valores de los datos de variables aparecen enla tabla. Todos los datos de la variable de tabla deben proceder del mismo campo de datos principal.

Crear una tabla en Dreamweaver y asignar a continuación bucles de contenido a las filas para rellenarla tabla le da más control sobre el formato y flujo de contenido. Puede elegir los campos que vanen las columnas o en las filas (ya que puede recorrer varias filas). También puede incluir datos quepuede que no se encuentren en el mismo campo de datos principal de la misma tabla, ya que puedecrear varios bucles en una tabla. En cierto sentido, le permite asignar campos que pueden estar en unorden diferente y en filas distintas a una estructura de tabla para que se publique.

Para obtener más información sobre cómo crear variables de tabla, consulte Cómo trabajar conmatrices. Para obtener más información sobre cómo crear una tabla dinámica usando una tabla deDreamweaver y bucles de contenido, siga leyendo.

Creación de una tabla dinámica usando bucles de contenidoEl primer paso para crear una tabla dinámica con los bucles de contenido es agregar una tabla aldocumento utilizando la funcionalidad de tabla de Dreamweaver. Una vez que se ha colocado la tablaen la ubicación correcta de la página del documento, puede empezar a agregar las variables a la tablaque rellenará las celdas de la tabla con datos. A continuación, puede seleccionar una o varias filasy asignar un bucle de contenido. Puede tener varias filas en un bucle de contenido y puede tenervarios bucles de contenido en la tabla.Para crear tablas dinámicas de bucle de contenido:

1. Sitúe una tabla en el documento utilizando el comando Insertar tabla en el menú Tabla deDreamweaver. Aparece el cuadro de diálogo Insertar tabla.

2. Seleccione el número de filas de cuerpo que necesita para crear los bucles. No es preciso tenerfilas suficientes en la tabla para acomodar los datos generados, xPresso para Dreamweaveragregará tantas filas como sea necesario para alojar a todos los datos. Seleccione el númerode columnas y las filas de pie de página y encabezado.

3. Coloque el cursor en la primera celda de la tercera fila y haga clic en Agregar variable de textoen el panel o la barra de inserción de xPresso.

4. Coloque las variables en el panel Definición de variable en las celdas adecuadas de la tabla.5. Agregue los encabezados de columna y cualquier pie de página que necesite para la tabla.

Cuando los encabezados y el contenido de variables se hayan distribuido en la tabla, está listopara crear los bucles de tabla de contenido.

6. Seleccione la fila, o varias filas, que desea incluir en el bucle7. Haga clic en Crear bucle de contenido en el panel o la barra de inserción de xPresso y

seleccione la matriz de variables que desea asociar al bucle.8. Cambie a la vista Código y observe cómo xPresso ha agregado una etiqueta de bucle dentro

de la etiqueta de la tabla HTML. Consulte el ejemplo de código siguiente.9. Pruebe la tabla mediante la aplicación de algunos datos. Haga clic en el menú Definición de

variable y seleccione Aplicar datos de variable. Seleccione un archivo de datos y haga clicen Cargar. La tabla se debería expandir y rellenar con los datos del archivo de datos.

52


<tr><td colspan=2><table width="620" border="1">

<tr bgcolor="#336699"><td width="100" background:#336699><span class="style13">DATE</span></td><td width="292"><span class="style13">STOCK/FUND NAME </span></td><td width="100"><div align="right" class="style13">UNITS </div></td><td width="100"><div align="right" class="style13">UNIT PRICE</div></td>

</tr>

<xPresso type="loop" id="52913185110" name="TRADE" variable="TRADE" vid="11">{Loop Begin}<tr>

<td background:#336699><span class="style19"><xPresso type="text"id="52913145868" name="TRADE:TRADE_DATE" variable="TRADE:TRADE_DATE">{TRADE:TRADE_DATE}</xPresso></span></td><td><span class="style19"><xPresso type="text" id="52913151316"name="TRADE:FUND_NAME" variable="TRADE:FUND_NAME">{TRADE:FUND_NAME}</xPresso></span></td><td><div align="right" class="style19"><xPresso type="text" id="52913153654"name="TRADE:UNITS" variable="TRADE:UNITS">{TRADE:UNITS}</xPresso></div></td><td><div align="right" class="style19"> <xPresso type="text" id="52913164111"name="TRADE:UNIT_PRICE" variable="TRADE:UNIT_PRICE">{TRADE:UNIT_PRICE}</xPresso></div></td>

</tr>{Loop End}</xPresso>

Compare esta tabla con el tipo de tabla creado a partir de una matriz y empezará a ver parte de laflexibilidad que puede ofrecer un bucle de contenido de xPresso.

Cómo agregar contenido externo al documentoPuede incluir un archivo HTML externo al documento de xPresso para Dreamweaver. Este archivopodría contener la información que necesita incluir en varios documentos y no desea tener querepetirla cada vez que la incluye, como una directiva de privacidad. El contenido del archivo secolocará en el documento en la ubicación designada durante la publicación.

Nota

Un archivo incluido como archivo externo en un documento no puede contener una referencia a unarchivo externo; por consiguiente, no se pueden anidar archivos externos.

Puede asignar las variables que aparecen en el archivo de contenido externo a las variables delarchivo principal para que las variables se resuelvan correctamente al publicar el documento. Tambiénpuede editar fácilmente el contenido externo en xPresso para Dreamweaver si tiene que realizar algúncambio en él antes de utilizarlo en el documento.

53


Para incluir el contenido desde un archivo externo:

1. Sitúe el cursor en el documento donde desea colocar el contenido externo.

2. Haga clic en Insertar variable de contenido externo en el panel o la barra de inserción dexPresso.

3. Desplácese para localizar y seleccionar el archivo HTML que desea insertar en el archivoprincipal y haga clic en Abrir. La variable de contenido externa aparece en el documento y unavariable de contenido externa también aparece en el esquema.

4. Seleccione la variable en el esquema. Los atributos de la variable aparecen en la parte inferiordel panel del esquema.

5. Haga clic en Asignación de variables. Se muestra el cuadro de diálogo Asignación decontenido externo. Para que las variables se resuelvan correctamente en el contenido externo,hay que asignar las variables a las variables contenidas en el documento principal.

6. Seleccione una variable en la lista Variables de contenido externo y seleccione la variableen la lista Variables de documento maestro que desea asignar. Automáticamente se asignacualquier variable coincidente que aparezca en ambos documentos.

7. Haga clic en Asignar. La asignación de variables aparece en el cuadro de la parte inferiordel cuadro de diálogo.

8. Repita los pasos 6 y 7 hasta que haya asignado todas las variables del contenido externo alas variables del documento principal. Haga clic en Aceptar.

9. (Opcional) Haga clic en Editar contenido externo para abrir el archivo HTML de contenidoexterno en xPresso para Dreamweaver, si desea hacer modificaciones en él. Realice loscambios y guárdelos y, a continuación, cierre el documento.

Puede probar su variable de contenido externo realizando una vista previa del documento. Elcontenido externo debería estar incluido en la ubicación que lo colocó, y todas las variables sedeberían resolver correctamente.

Copia de contenido externoPuede copiar el contenido externo que ya existe en el documento para agregar fácilmente en otroslugares el contenido o contenido similar si lo edita.

Para copiar el contenido externo:

1. Seleccione la variable de contenido externo en el esquema.

2. Haga clic en el menú Esquema y seleccione Copiar contenido externo.

3. Sitúe el cursor en la ubicación de la plantilla de documento donde desea colocar la nuevavariable de contenido externo y haga clic en xPresso - Pegar en el panel o la barra de inserción.La variable aparece en la plantilla en la ubicación del cursor y también aparece en el esquema.

54

Uso de variables 5Uso de variables

Agregar variables y matrices de variables a su documento le permite controlar el contenido, las tablasy las imágenes que se incluyen en la salida creada. Este tipo de flexibilidad le permite personalizarcada documento para el destinatario previsto. Puede optimizar su mensaje para que incluya sóloinformación pertinente al destinatario concreto que recibe el documento.

Breve información sobre variablesLas variables se crean y se almacenan en el panel Definición de variable. El panel Definición devariable funciona conjuntamente con el panel Esquema de datos y le permite crear y definir variablesde texto e imagen, así como matrices, para su uso en documentos. Se pueden utilizar las matrices alcrear las variables de tabla y los bucles de contenido.

• Las variables insertan texto concreto o imágenes externas en la salida final.• Las matrices controlan los bucles de contenido e insertan las tablas en la salida final que

contiene la información específica del destinatario.

Para las variables de texto, xPresso para Dreamweaver le permite también dar formato a la variable,para poder controlar su aspecto en la salida.

Las variables se pueden crear desde cero y el usuario puede incluir funciones y expresiones paracalcular el valor de la variable. También puede utilizar un campo de datos del esquema paraproporcionar el valor de la variable. Puede arrastrar los campos del panel del esquema de datos alpanel Definición de variable o bien puede utilizar el menú Definición de variable para crear variablesmediante los campos de datos.

Para utilizar una variable en el documento, primero debe crearla, definirla y, a continuación, colocarlaen el documento.

Etiquetas HTML en datos XMLxPresso para Dreamweaver permite incluir etiquetas HTML en los datos XML que utilice con losdocumentos de xPresso. Se pueden aplicar etiquetas HTML o bien se pueden generar en textosin formato. La cadena HTML debe tener el formato que se muestra en el ejemplo siguiente:"<b>hola</b>";. En función de la configuración, esa cadena se puede generar como holao como <b>hola</b>.

Actualmente se admiten las siguientes etiquetas HTML:• Elementos de fuentes de estilo (B, I, S, STRIKE y U)• Subíndice (SUB) y superíndice (SUP)

55

Capítulo 5 — Uso de variables

• En línea (SPAN)• Salto de línea (BR)• Párrafo (P)• Delimitador (A)• Elementos de frase (EM y STRONG)

Se omitirá toda etiqueta HTML que sea diferente a las indicadas anteriormente y se mostrará unerror en el archivo de registro.

El procesamiento de etiquetas HTML se puede configurar en un nivel global en el archivo xPRSConfigy variable por variable en el cuadro de diálogo Formato de cadena (que omite la configuración globalde una variable específica). Para obtener más información sobre cómo configurar el procesamientode etiquetas HTML en el nivel de variable, consulte Cadena.

Configuración de procesamiento de etiquetas HTML de manera globalPuede configurar cómo desea procesar las etiquetas HTML globalmente para todos los documentosde xPresso para Dreamweaver si configura la opción HTMLFormat en el archivo xPRSConfig. Estaconfiguración se puede reemplazar en el nivel de variable si activa o desactiva la opción FormatoHTML en el cuadro de diálogo Formato de cadena (para obtener más información, consulte Cadena).

El archivo xPRSConfig reside en el equipo cliente y en el servidor. Tendrá que cambiar laconfiguración en ambas ubicaciones para poder ver los resultados en xPresso para Dreamweaver yen la salida publicada.Para realizar la configuración globalmente:

1. Desplácese hasta el [Directorio de instalación de xPresso para Dreamweaver]\xPresso enel Explorador de Windows del equipo cliente de xPresso para Dreamweaver.

2. Abra el archivo xPRSConfig.xml en un editor de texto.3. Localice la sección <category name="DCPI"> del archivo.4. Busque la entrada <prop name="HTMLFormatting" value="false" visible="false"/>.5. Establezca HTMLFormating en "true" si desea que todos los valores de variable del

documento se muestren utilizando el formato HTML contenido en los datos XML. Establezca elvalor en "false" si desea que todas las etiquetas HTML incluidas en los valores de variable semuestren como texto sin formato.

6. Guarde el archivo y ciérrelo.7. Localice el archivo xPRSConfig.xml en el servidor de xPression ([Directorio de instalación del

servidor de xPression]\xPRS\Conf en una máquina con Windows).8. Repita los pasos del 2 al 6 para cambiar la configuración en el archivo del servidor.

Importación de definiciones de variablesPuede importar las definiciones de variables en el documento xPresso para Dreamweaver que haexportado desde otro documento xPresso. Las definiciones pueden proceder de un documentoxPresso para Adobe InDesign, xPresso para Dreamweaver o xPresso para Word. Esto le permitecompartir definiciones de variables entre documentos y ahorrarse el esfuerzo de volver a crear lasvariables utilizadas normalmente en cada nuevo documento.

56


Para importar definiciones de variables

1. Haga clic en el menú Definición de variable y seleccione Importar definiciones de variable oImportar definiciones de variable desde servidor.

2. Busque y seleccione el archivo XML de exportación que contiene las definiciones de variableque desea importar y haga clic en Abrir o Aceptar (desde servidor). Si el documento contieneun elemento con el mismo nombre que un elemento que se esté importando, aparece el cuadrode mensaje Importación de variable.

Si dos elementos tienen el mismo nombre, pero son tipos diferentes, xPresso paraDreamweaver muestra un mensaje de error. Necesitará hacer que el tipo sea el mismo paraambos elementos y, a continuación, realizar la importación de nuevo.

3. Seleccione cómo desea tratar este nombre de variable duplicado o todos los nombres devariable duplicados y haga clic en Continuar importación. También puede hacer clic enCancelar importación.

Si su documento utiliza el mismo esquema que el documento del que se exportaron las definiciones,se asignarán automáticamente a los datos del documento. Si los documentos utilizan archivos deesquema diferentes, puede asignar las definiciones manualmente una vez estén importadas.

Opciones de importación de variablesEl cuadro de mensaje Importación de variable contiene las opciones siguientes.

Opción DescripciónMantener las variablesexistentes en eldocumento

Seleccione esta opción para mantener la variable existente en el documento y nosobrescribirla con la variable del archivo que tiene el mismo nombre. Haga clic enContinuar importación. Si se encuentra otro nombre de variable duplicado, el cuadrode mensaje aparecerá de nuevo.

Mantener todas lasvariables existentesen el documento

Seleccione esta opción para mantener todas las variables existentes en el documento yno sobrescribirlas con las variables del archivo que tengan el mismo nombre. Haga clicen Continuar importación. xPresso para Dreamweaver no le volverá a avisar si seencuentra con otro nombre de variable duplicado; utilizará esta opción para procesarlo.

Utilizar la variable delarchivo

Seleccione esta opción para importar la variable duplicada del archivo y sobrescribirla variable existente en el documento. Haga clic en Continuar importación. Si seencuentra otro nombre de variable duplicado, el cuadro de mensaje aparecerá de nuevo.

Utilizar todas las variablesdel archivo

Seleccione esta opción para importar todas las variables duplicadas del archivoy sobrescribir cualquier variable existente con nombres duplicados. Haga clic enContinuar importación. xPresso para Dreamweaver no le volverá a avisar si seencuentra con otro nombre de variable duplicado; utilizará esta opción para procesarlo.

Continuar importación Haga clic en Continuar importación para utilizar la opción seleccionada y continuar elproceso de importación.

Cancelar importación Haga clic en Cancelar importación para detener el proceso de importación y noimportar ninguna variable más. Cualquier variable importada antes de hacer clic enel botón permanecerá en el documento.

57


Exportación de definiciones de variablesPuede exportar las definiciones de variables que se definen actualmente en el documento, para quese puedan utilizar en otros documentos xPresso para Adobe InDesign, xPresso para Dreamweavery xPresso para Word. El proceso de exportación crea un archivo XML que se puede importar aotro documento.

Para exportar las definiciones de variables:

1. Haga clic en el menú Definición de variable y seleccione Exportar definiciones de variable oExportar definiciones de variable a servidor.

2. Desplácese a la ubicación local donde desea almacenar el archivo de exportación y escriba unnombre para el archivo. Si guarda en el servidor, simplemente escriba el nombre de archivo.Los nombres de archivo deben tener menos de 200 caracteres y no pueden contener ningunode los siguientes caracteres: < > & \ " ’ : @ ! ? * # \\ $ / [ ] { } ( )


Copia de variablesCuando crea un texto, imagen o variable de hipervínculo, puede copiar la variable para crear variasvariables idénticas.

Para copiar una variable:

1. Seleccione la variable en el esquema.

2. Haga clic en el menú Esquema y seleccione Copiar variable de tipo.

3. Coloque el cursor en la plantilla de documento en la ubicación donde desea colocar la nuevavariable y haga clic en xPresso-Pegar en el panel o la barra de inserción. La nueva variableaparece en la plantilla en la ubicación del cursor y en el esquema.

Cómo trabajar con variablesLas variables se crean en el panel Definición de variable y pueden estar basadas en texto o enimagen. Las variables de texto se utilizan para introducir datos personales en el documento, como elnombre y la dirección del destinatario.

Las variables de texto pueden ser numéricas (flotante, doble, booleana, entera), de datos, de hora, defecha y hora o de cadena. Los campos de fecha, hora y fecha y hora deben aparecer en sus datosen un formato determinado:

• Date: aaaa-mm-dd (por ejemplo: 2003-05-19)

• Time: hh:mm:ss (por ejemplo: 11:22:50)

• DateTime: aaaa-mm-ddThh:mm:ss (por ejemplo: 2002-01-05T03:15:30)

58


Nota

Si el tipo de datos de la variable es numérico, su valor no puede ser nulo. Si intenta aplicardatos al documento que contiene un valor nulo para una variable de tipo numérico, xPresso paraDreamweaver genera un error.

Las imágenes utilizadas en correos electrónicos con muchos gráficos se almacenan normalmente enuna ubicación en un servidor web. Las variables de imagen le permiten incluir una imagen externa ensu documento, que puede diferir en función de los datos. Los datos contienen la ruta y el nombrede la imagen, la variable de imagen extrae la imagen de la ruta de acceso definida en los datos y lacoloca en la página del documento.

Creación de variablesPuede crear variables de texto e imagen de dos maneras distintas. Puede utilizar un campo de datosde su esquema como punto de partida para la variable o puede crear una variable desde cero:

• Si desea utilizar un campo de datos en el esquema como punto de partida, seleccione elcampo en el panel Esquema de datos, haga clic en el menú Definición de variable yseleccione Definir variable a partir de esquema. Si está creando una variable de imagen,asegúrese de que el campo que seleccione contiene la información de la ruta de la imagen.La variable aparece en el panel Definición de variable con el mismo nombre del atributoo campo de datos.

• Si desea crear una variable desde cero, haga clic en el menú Definición de variable yseleccione Definir variable. Una variable aparece en la parte inferior del panel Definiciónde variable denominado "Nueva variable". Definirá el contenido de la variable en el pasosiguiente.

Nota

Si selecciona un campo de datos en el panel Esquema de datos y, a continuación, selecciona un áreaen blanco del panel para "borrar" su selección, el panel todavía considerará el campo seleccionadohasta que seleccione un nuevo campo. Asegúrese de que ha seleccionado el campo correcto en elpanel Esquema de datos antes de crear una variable en el panel Definición de variable.

59


Definición de atributos de variableDespués de crear la variable de texto o de imagen en el panel Definición de variable, puede usar elárea de propiedades de variables en la parte inferior del panel para definir los atributos de la variable.

Para definir la variable:

1. Seleccione la variable en el panel Definición de variable. La información de la variable apareceen el área de propiedades de variables.

2. Escriba un nombre para la variable en el campo Nombre, si fuera necesario.

3. Seleccione el tipo de valor de esta variable en la lista desplegable.

4. Seleccione el tipo de asignación para esta variable: Campo de esquema o Expresión.

5. Haga clic en el botón de exploración situado junto al campo Asignación. Si ha seleccionadoel campo de esquema en el paso 4, aparece el cuadro de diálogo Seleccionar campos deesquema. Seleccione el campo de esquema que desea utilizar para rellenar esta variable yhaga clic en Aceptar. Vaya al paso 7.

Si ha seleccionado Expresión en el paso 4, aparece el cuadro de diálogo Expresión de variable.

6. Escriba su expresión en el cuadro, en la parte superior del cuadro de diálogo. Para ayudarle acrear su expresión, puede:

• Seleccione un tipo de función para ver las funciones disponibles. Haga clic en unafunción de la lista para ver una descripción de la función del cuadro, en la parteinferior del cuadro de diálogo. Haga doble clic en una función de la lista para queaparezca en el cuadro de expresión donde pueda editarla.

• Haga clic en Seleccionar variable para seleccionar una variable para su uso enla expresión.

• Haga clic en Comprobar para verificar que la expresión es válida.

7. Haga clic en Aceptar cuando haya terminado de crear su expresión. Para obtener másinformación, consulte Creación de expresiones de variables.

Nota

(1) Cuando haya utilizado una variable en el documento, o en los criterios, no podrá cambiar el nombrede la variable. (2) No se admite el formato numérico alemán en una variable de tipo Expresión. Porejemplo, no se admite un número con formato 1.000,00, debe darle el formato 1,000.00.

60


Colocación de variables de texto en el documentoPara obtener una variable de texto del panel Definición de variable en el documento, deberá utilizar laopción Agregar variable de texto en el panel o la barra de inserción de xPresso. La variable apareceen la página, en la ubicación del cursor, y también aparece en el esquema.

Para situar una variable de texto:

1. Coloque el cursor en la página del documento, en la ubicación donde desea que aparezcala variable.

2. Haga clic en Agregar variable de texto en el panel o la barra de inserción de xPresso.

3. Seleccione la variable adecuada en el panel Definición de variable y haga clic en Aceptar.

4. La variable aparece en el esquema bajo la Carpeta de variable global y en la página dedocumentos de la ubicación del cursor.

Opciones de atributos de esquema de variables de textoPuede definir las siguientes opciones de atributos en el área de atributos del esquema para unavariable de texto seleccionada.

Atributo DescripciónTipo Muestra el tipo del elemento seleccionado (Variable de texto). Este campo es de sólo

lectura.

Nombre Escriba un nombre para la variable.

Referencia Haga clic en el botón de exploración para abrir el cuadro de diálogo Seleccionar variabledonde puede seleccionar una nueva variable a la que asignar esta variable de texto.

Tipo de valor Muestra el tipo de valor de la variable de texto. Este campo es de sólo lectura.

Quitar línea vacía Seleccione True para indicar a XPresso para Dreamweaver que quite la línea dondeaparece la variable si no existe ningún valor para ella en los datos. Esto resulta útilpara elementos tales como bloques de direcciones, donde no todas las direccionescontienen la misma cantidad de líneas y no desea que aparezca una línea en blancocuando no hay datos para esa línea de la dirección. Seleccione False para mostrar lalínea de variable independientemente de que la variable cuente con un valor o no.

Para obtener más información, consulte Eliminación de líneas vacías en bloques detexto.

Nota: el motor de publicación es el encargado de procesar esta opción que, por tanto,sólo se aplicará al crear una vista previa de PDF del documento o bien al publicar eldocumento en el servidor. No verá los resultados de esta opción al aplicar los datos.

Formato Haga clic en el campo Formato y, a continuación, haga clic en el botón de exploraciónque aparece para abrir el cuadro de diálogo de formato para el tipo de la variableseleccionada. Para obtener más información, consulte .

61


Formato de variables de textoPuede aplicarles formato a las variables de texto para controlar su aspecto en la salida. Por ejemplo,puede que desee que una variable de fecha aparezca en la salida como 01/05/2002, puede que deseeagregar un separador de miles o un símbolo de moneda a la salida de variable numérica o puede quedesee que aparezca una variable de cadena en la salida, en mayúsculas, independientemente decómo se introduzca la cadena.

Fecha, hora o fecha y horaPara aplicarle formato una variable Date, Time o DateTime:

1. Seleccione la variable en el esquema. La información de la variable aparece en el área deatributos del esquema situada en la parte inferior del panel.

2. Haga clic en el botón de exploración situado junto al campo Formato. Aparece el cuadro dediálogo Formato de fecha/hora. Las opciones disponibles varían en función del tipo de variableseleccionada.

3. Seleccione una configuración regional en la lista desplegable. Las opciones mostradas en lalista desplegable Formato de fecha y Formato de hora cambian en función de su selección.

4. (Fecha o fecha y hora) Seleccione un formato en la lista desplegable Formato de fecha. Porejemplo, si selecciona aaaa-MM-dd, 05-19-2003 aparece como 2003-05-19 en la salida.

5. (Fecha o fecha y hora) Seleccione un formato en la lista desplegable Formato de hora. Porejemplo, si selecciona h:mm a, 12:00:09 aparece como 12:00 PM en la salida.


Nota

Si cambia la configuración de zona horaria del equipo, tendrá que reiniciarlo antes de ver el cambio enlas variables de hora o de fecha y hora.

NuméricoPara aplicarle formato a una variable numérica:


2. Haga clic en el botón de exploración situado junto al campo Formato. Aparece el cuadro dediálogo Formato de número.

3. Seleccione la configuración regional que desee utilizar para especificar el formato para estenúmero. El separador de miles y el símbolo de moneda se asocian a esta configuración.

4. Active la casilla de verificación Utilizar separador de miles (,) para incluir una coma comoseparador de miles en la salida de variable (). Por ejemplo, 5000 aparece como 5,000.

5. Active la casilla Utilizar porcentaje (%) para mostrar la variable numérica como porcentaje enla salida. Por ejemplo, 5000 aparece como 500000%

6. Introduzca el número de posiciones decimales para mostrar la variable numérica con posicionesdecimales. Por ejemplo, si ha introducido 3, 5000 aparecen como 5000,000.

62


7. Seleccione la ubicación del símbolo de moneda en la lista desplegable: Antes o Después. Laconfiguración regional que seleccione determina el símbolo. Por ejemplo, si selecciona Inglés(Estados Unidos) para la configuración regional y Antes de para la ubicación del símbolo,5000 aparecen como $5000.

8. Active la casilla de verificación Configurar precisión de redondeo para redondear elnúmero cuando aparezca en el documento. Introduzca el número de dígitos que desea quese devuelvan; el recuento de dígitos se inicia a partir del dígito distinto de cero del extremoizquierdo del resultado exacto.

9. Seleccione el modo de redondeo que desea utilizar:

• Redondeo de Excel. Utilice el protocolo de redondeo de Microsoft Excel.

• Máximo. Redondea hacia infinito positivo.

• Hacia abajo. Redondea hacia el cero.

• Mínimo. Redondea hacia abajo hacia negativo infinito.

• A la mitad hacia abajo. Redondea al valor más cercano a menos que seaequidistante, en cuyo caso se redondea hacia abajo.

• A la mitad igual. Redondea al valor más cercano a menos que sea equidistante, encuyo caso se redondea al valor igual.

• A la mitad hacia arriba. Redondea al valor más cercano a menos que seaequidistante, en cuyo caso se redondea hacia arriba.

• Hacia arriba. Redondea a un valor alejado de cero.


CadenaPara aplicarle formato a una variable de cadena:


2. Haga clic en el botón de exploración situado junto al campo Formato. Aparece el cuadro dediálogo Formato de cadena.

3. Seleccione el formato entre los siguientes:

• MAYÚSCULA: ’Nombre de agente’ aparece como ’NOMBRE DE AGENTE’

• minúscula: ’Nombre de agente’ aparece como ’Nombre de agente’

• Tipo título: ’Nombre de agente’ aparece como ’Nombre de Agente’

• Ninguno: ’Nombre de agente’ aparece como ’Nombre de agente’ (sin cambios)

4) Seleccione Formato HTML si los datos XML contienen etiquetas HTML que desea aplicar enla salida del texto de variable. Si la casilla de verificación está desactivada (sin seleccionar),toda etiqueta HTML que se encuentre al publicar se generará como texto sin formato (porejemplo, <b>hola</b> en lugar de hola).


63


Colocación de variables de imagen en el documentoPara obtener una variable de imagen del panel Definición de variable en el documento, deberá utilizarla opción Agregar variable de imagen en el panel o la barra de inserción de xPresso.

Para colocar variables de imagen:

1. Coloque el cursor en la página del documento, en la ubicación donde desea que aparezcala variable.

2. Haga clic en Agregar variable de imagen en el panel o la barra de inserción de xPresso.

3. Haga clic en el botón de exploración y, a continuación, seleccione la variable que desea asociarcon la variable de imagen.

4. Haga clic en Aceptar. La variable aparece en el campo Enlace.

5. Haga clic en Aceptar. En la página se muestra un icono de marcador de posición de imagen yun código similar al siguiente se coloca en el HTML.<xPresso type="text" id="52020443193" name="LEVEL" variable="LEVEL">

<img src="http://localhost:8080/{LEVEL}.jpg" width=129 height=77hspace=20 vspace=10 align=absmiddle alt="Level">

Creación de expresiones de variablesAl crear una variable o un elemento de matriz, tiene la opción de seleccionar un campo de datosexistente o definir una expresión con la que asociarlo. Tener la opción de definir una expresiónsignifica que puede hacer que su variable represente mucho más que un simple campo de datos.Puede comparar campos de datos, puede realizar cálculos y puede utilizar las funciones y que elresultado aparezca en la salida de documento. Esto le proporciona mucha flexibilidad.

Todas las expresiones se crean en el cuadro de diálogo Expresión de variable, al que puede accedersi selecciona Expresión como Tipo de asignación de la variable y haciendo clic a continuación en elbotón de exploración que se encuentra junto a Asignación en el área de atributos de variable. Elcuadro de diálogo Expresión de variable contiene herramientas y opciones para ayudarle a crear unaexpresión para su variable.

En el cuadro de la parte superior es donde se crea su expresión. Puede incluir campos de esquema yfunciones en la expresión y utilizar los operadores booleanos siguientes: > (mayor que), < (menorque), > = (mayor o igual que), < = (menor o igual que) y != (no igual a). Las expresiones se deberíandefinir en uno de los formatos siguientes:

if((3-2)!=(5-8)) return true; else return false;if($fullname$=="abc") return false; else return true;

O bien, puede especificar verdadero o falso como un valor booleano. El ejemplo siguiente noes válido: (3-2)!=(5-8)

Si la expresión es más larga que el espacio de la primera línea del cuadro de expresión de variable, laexpresión no se ajustará en la línea siguiente y sólo se podrá ver la parte de la expresión que cabe

64


en la primera línea. Se procesará en la expresión completa. También podrá realizar los siguientescálculos en la expresión:

integer + integer, float, or doubleinteger - integer, float, or doubleinteger * integer, float or doubleinteger / float or doubleinteger % float or doublefloat + float or doublefloat - float or doublefloat * float or doublefloat / float or doublefloat % float or doubledouble + doubledouble - doubledouble * doubledouble % doublestring + string

Nota

(1) No se admite el formato numérico alemán en una variable Expresión. Por ejemplo, no se admiteun número con formato 1.000,00, debe darle el formato 1000.00. (2) Debe escribir una "f" junto concualquier valor flotante que esté utilizando en un cálculo. Por ejemplo:

$Pay:Price$*0.15f-(1.0f/3.0f)*1600

VariablesPara incluir una variable en la expresión, haga clic en Seleccionar variable y seleccione el campoen el cuadro de diálogo Definición de variable de xPresso. La variable seleccionada aparece enel cuadro con este formato:

$DataPath:FieldName$

A continuación, puede agregar un operador si lo desea. Por ejemplo, para crear una variabledenominada "TotalAmountDue", podríamos especificar:

$Pay:BalanceForward$+$Pay:AmtDue$

No se pueden anidar las matrices utilizadas en definiciones de variables.

65


FuncionesPara incluir una función en la expresión, primero haga clic en un botón de opción para ver lasfunciones que están disponibles: Funciones de número, Funciones lógicas, Funciones de grupo,Funciones de cadena o Funciones de fecha y hora. Puede hacer clic en una función de la lista paraver una descripción de la función en la parte inferior del cuadro de diálogo. Haga doble clic en unafunción de la lista para que aparezca en el cuadro de expresión donde pueda editarla. Por ejemplo:

addDay( datetime_or_date_value , numeric_value )

Seleccione cada argumento y sustitúyalo mediante la selección de un campo de esquema o mediantela introducción de un valor. Por ejemplo, para crear una variable denominada "DatePastDue",podríamos especificar:

addDay($GenlInfo:DateDue$, 7)

Para obtener más información sobre las funciones disponibles, consulte Funciones de expresión.

Instrucciones If/ElsePuede utilizar la lógica If/Else en las expresiones de variables para crear instrucciones más complejas.Se admiten los siguientes formatos de instrucciones:

if ("a"=="a") return "a"; if ("a"=="b") return "b"; else return "c"if ($variable$=="a") return "a"; if ($variable$=="b") return "b"; else return "c"if ("a"=="a") {if ("c"=="c") return "b"; if ("d"=="e") return "d"; else return"a";} else return "c"

Por ejemplo:

if ($CollateralType$=="00") return "Improve your customer communications"; if($CollateralType$=="30") return "Improve your policyholder communications"; if($CollateralType$=="31") return "Improve your P&C forms management process"; elsereturn "Improve your client communications";

Verificación de expresionesUna vez finalizada su expresión, debe comprobarla para asegurarse de que funcione y de que es unaexpresión válida. Para comprobar su expresión, haga clic en Comprobar. Aparece un mensaje en elcuadro de diálogo bajo el cuadro de expresión para indicarle los resultados de la comprobación.

Creación de una sencilla variable de dirección de origen/destinoAl enviar los correos electrónicos a los clientes, quizá desee utilizar una dirección de origen odestino intuitiva, como Juan García ([email protected]) o EMC Document Sciences Corp([email protected]). Puede utilizar una variable de expresión para crear la variable de direcciónde origen o destino intuitiva. Tendrá que definir la variable como una propiedad de documento,para que se pueda utilizar en xAdmin como una variable de salida y, a continuación, especificarlacomo un parámetro de correo electrónico al crear el perfil del correo electrónico. Para obtener másinformación, consulte Cómo trabajar con propiedades del documento.

66


Puede utilizar el paréntesis (()) o corchetes ([]) para rodear la dirección de correo electrónico real desu dirección de origen o destino intuitiva. No se admiten los corchetes angulares (<>).

A continuación se muestran algunos ejemplos de expresiones que generan direcciones de origen odestino intuitivas:

$FIRST_NAME$+" "+$LAST_NAME$+" "+"("+$CustomerEmail$+")"

Juan García ([email protected])

"EMC Document Sciences ([email protected])"

EMC Document Sciences ([email protected])

$ORGANIZATION:NAME$+" "+"("+$ORGANIZATION:EMAIL$+")"

Objectiva Software Solutions ([email protected])

También puede utilizar variables de expresión para crear una línea de asunto "intuitiva", combinandouna variable con algún texto estático. Por ejemplo:

$FIRST_NAME$+","+" "+"Your Statement is Ready"

Juan, la instrucción está preparada

Eliminación de líneas vacías en bloques de textoSi tiene una variable en la que puede que no exista un valor para cada registro de datos y no deseaque aparezca una línea en blanco para esa variable de los documentos en los registros que notienen ningún valor, puede utilizar la función Quitar línea vacía. Resulta útil para contenido como, losbloques de direcciones, en los que los registros de datos distintos pueden tener un número diferentede líneas. Al utilizar la función Quitar líneas vacías puede asegurarse de que todas las direcciones seimpriman como bloques sólidos, sin líneas vacías.

La opción Quitar líneas vacías se define en las variables, en el área de atributos de las variables detexto del esquema del documento.

Nota

El motor de publicación es el encargado de procesar esta opción que, por tanto, sólo se aplicará alcrear una vista previa de la plantilla o bien, al publicar la plantilla en el servidor. No verá los resultadosde esta opción al aplicar los datos.

67


Para quitar las líneas vacías de una variable:

1. Seleccione en el esquema la variable de texto para la que no desea que aparezcan líneas vacíasen el documento. Los atributos de variable se muestran en el área de atributos del esquema.

2. Seleccione True en el campo Quitar línea vacía. Esto indica a xPression que debe quitar lalínea correspondiente a esta variable en documentos cuyos datos no contienen un valor parala variable.

Al generar la salida para el documento, si un registro no contiene datos para la variable, la línea seexcluirá de la salida para que no haya ninguna línea vacía. Por ejemplo:

Estos datos:

<CustomerFName>Elizabeth</CustomerFName><CustomerLName>Steele</CustomerLName><CustomerAddress1>38792 S. West Blvd.</CustomerAddress1><CustomerAddress2>Apartment 1824</CustomerAddress2><CustomerCity>Andover</CustomerCity><CustomerState>CT</CustomerState><CustomerZip>06123</CustomerZip><CustomerZip4>5154</CustomerZip4>

Generan esta salida:Elizabeth Steele38792 S. West Blvd.Apartment 1824Andover, CT 06123 5154

Y estos datos:<CustomerFName>John</CustomerFName>

<CustomerLName>Smith</CustomerLName><CustomerAddress1>123 Main St.</CustomerAddress1><CustomerAddress2></CustomerAddress2><CustomerCity>Hartford</CustomerCity><CustomerState>CT</CustomerState><CustomerZip>06040</CustomerZip><CustomerZip4>1234</CustomerZip4>

Generan esta salida:John Smith123 Main St.Hartford, CT 06040 1234

Cómo trabajar con propiedades del documentoPuede asociar una variable existente a una propiedad de documento dentro del documento, que sepuede definir después como una variable de salida en servidor de XPression. Asegúrese de que

68


cualquier variable que asocie a una propiedad de documento se resuelva en valores que sean únicospara cada registro del archivo de datos. Si un valor no es único, y lo utiliza en una convenciónde nomenclatura del archivo de salida, se arriesga a crear nombres de archivo duplicados, lo queproducirá un error. Asegúrese también de que el valor no incluye ninguno de estos caracteres: \, /,:, *, ?, ", <, >, |.

Las propiedades de documento se almacenan y definen en el panel Propiedad de documento. Puedehacer visible el panel propiedades del documento seleccionando Propiedad de documento enel menú de xPresso.

Puede importar al documento las propiedades de documento que se han definido en otrosdocumentos xPresso haciendo clic en el menú Propiedades de documento y seleccionandoImportar propiedades de documento. Las propiedades de documento pueden proceder dedocumentos xPresso para Adobe InDesign, xPresso para Dreamweaver o xPresso para Word 2007.

Creación de propiedades de documentoPara definir una variable como una propiedad de documento:

1. Seleccione la variable que desea definir como una propiedad de documento en el panelDefinición de variable.

2. Haga clic en el menú Propiedad de documento y seleccione Agregar propiedad dedocumento. La variable aparece en el panel Propiedades de documento.

3. (Opcional) Cambie el nombre de la propiedad de documento en el área de atributos de la parteinferior del panel. El nombre sólo puede contener caracteres ingleses. Para obtener másinformación, consulte Opciones de atributos de propiedad de documento.

Una vez definida, la propiedad de documento estará disponible en xPression Documentum EditionServer para su uso en la definición de variables de salida, en expresiones y en plantillas de nombresde archivo asociadas a este documento.

69


Opciones de atributos de propiedad de documentoPuede definir las siguientes opciones de atributos en el panel Propiedad de documento para unapropiedad de documento seleccionada.

Atributo DescripciónNombre Escriba un nuevo nombre para la propiedad de documento. Los nombres de propiedad

de documento deben contener como mínimo una letra y todos deben ser letras,números o caracteres de subrayado (_). No se admiten espacios. El nombre debe teneral menos 50 caracteres y sólo puede contener caracteres ingleses.

Para utilizar la propiedad en xAdmin, tendrá que crear una variable de salidaexactamente con el mismo nombre. Puede ver una lista de propiedades de documentoincluida en un documento haciendo clic en el nombre del documento de la lista dedocumentos de categorías en xAdmin. Para obtener más información, consulte la Guíadel usuario de xAdmin Documentum Edition.

Referencia Haga clic en el botón de exploración para abrir el cuadro de diálogo Definición devariable de xPresso. Seleccione una nueva variable para asociársela a la propiedadde documento y haga clic en Aceptar.

Tipo de variable Muestra el tipo de variable actualmente asociado con la propiedad de documento.Este campo es de sólo lectura.

Importación de propiedades de documentoPuede importar las propiedades del documento al documento de xPresso para Dreamweaver quehaya exportado desde otro documento de xPresso. Las propiedades pueden proceder de undocumento xPresso para Adobe InDesign, xPresso para Dreamweaver o xPresso para Word. Esto lepermite compartir las propiedades de documento entre los documentos y ahorrarse el esfuerzo devolver a crear las propiedades utilizadas normalmente en cada nuevo documento.

Para importar las propiedades de documento:

1. Haga clic en el menú Propiedad de documento y seleccione Importar propiedades dedocumento o Exportar propiedades de documento desde servidor.

2. Busque y seleccione el archivo XML de exportación que contiene las propiedades de documentoque desea importar y haga clic en Abrir o Aceptar (desde servidor). Si el documentocontiene una propiedad con el mismo nombre que una propiedad que se está importando, sesobrescribirá la propiedad del documento.

Si su documento utiliza el mismo esquema que el documento del que se exportaron las propiedades,se asignarán automáticamente a los datos del documento. Si los documentos utilizan archivos deesquema diferentes, puede asignar las propiedades manualmente una vez estén importadas.

70


Exportación de propiedades de documentoPuede exportar las definiciones de documento que se definen actualmente en el documento, para quese puedan utilizar en otros documentos xPresso para Adobe InDesign, xPresso para Dreamweavery xPresso para Word. El proceso de exportación crea un archivo XML que se puede importar aotro documento.

Para exportar sus propiedades de documento:

1. Haga clic en el menú Propiedad de documento y seleccione Exportar propiedades dedocumento o Exportar propiedades de documento a servidor.

2. Desplácese a la ubicación local donde desea almacenar el archivo de exportación y escriba unnombre para el archivo. Si guarda en el servidor, simplemente escriba el nombre de archivo.Los nombres de archivo deben tener menos de 200 caracteres y no pueden contener ningunode los siguientes caracteres: < > & \ " ’ : @ ! ? * # \\ $ / [ ] { } ( )


Cómo trabajar con hipervínculos de variablexPresso para Dreamweaver le permite crear hipervínculos que contienen variables. Puede agregarvariables para crear enlaces a sitios web generados dinámicamente o a archivos PDF.

Cómo colocar hipervínculos de variable en el documentoPara colocar un hipervínculo de variable en el documento, deberá utilizar la opción Agregar variablede hipervínculo en el panel o la barra de inserción de xPresso.

Para colocar un hipervínculo de variable:

1. Coloque el cursor en la página del documento, en la ubicación donde desea que aparezcael hipervínculo.

2. Haga clic en Agregar variable de hipervínculo en el panel o la barra de inserción de xPresso.

71


3. Escriba el texto del enlace para el hipervínculo. Éste podría ser la dirección URL a un sitio web.También puede agregar variables en el texto del enlace, como un número del cliente quecompletaría el enlace a un sitio web personalizado. Para agregar una variable, haga clic en elbotón de exploración que se encuentra junto al campo Enlace y, a continuación, seleccionela variable que desea agregar al enlace. Por ejemplo, este enlace abre una página webpersonalizada identificada por la variable UniqueID en los datos:

http://www.docscience.com/demo/xpresso/images/custompage{UniqueID}.html

4. En el campo Título, escriba el texto que desea que aparezca como un hipervínculo en eldocumento.

5. Haga clic en Aceptar. El texto que ha escrito el campo Título aparece en la página como unenlace y en el HTML se incluye un código similar al siguiente.<xPresso type="text" id="6815544944" name="ACCOUNT_NUMBER"variable="ACCOUNT_NUMBER"><a href="http://localhost:8080/LandingPage/LandingPage_{ACCOUNT_NUMBER}.html">Click here for Account Login</a></xPresso>

Cómo trabajar con matricesUna matriz es un campo de datos padre que contiene campos hijo (denominados elementos dematriz). Puede crear directamente una matriz a partir de un campo padre del esquema de datos opuede crear uno desde cero e incluir campos que aparezcan en cualquier parte del esquema paraque sean elementos de la matriz. Esto le permite crear una matriz con los campos que aparecenen las distintas áreas del esquema. Las matrices se pueden utilizar como variables de tabla y paracontrolar los bucles de contenido.

Al colocar una matriz en la página, xPresso para Dreamweaver siempre crea una tabla en eldocumento con la información contenida en los campos hijo de la matriz.

Cuando sitúa una variable de tabla, puede dar formato a la tabla para que resulte más atractivavisualmente utilizando las opciones de formato de tabla de Dreamweaver.

72


Creación de matricesPuede crear una matriz de dos maneras. Puede utilizar un campo de datos padre del esquema comopunto de partida para la variable o puede crear la matriz desde cero:

• Si desea utilizar un campo de datos padre en el esquema como una matriz, seleccione elcampo en el panel Esquema de datos, haga clic en el menú Definición de variable yseleccione Definir matriz a partir de esquema. La variable aparece en el panel Definiciónde variable con el mismo nombre del campo de datos padre.Si desea agregar un campo hijo a la matriz, seleccione el campo hijo en el panel Esquemade datos y, a continuación, seleccione la matriz en el panel Definición de variable. Hagaclic en el menú Definición de variable y seleccione Definir elemento de matriz a partirde esquema. Un nuevo elemento aparece bajo la matriz con el mismo nombre que elcampo hijo seleccionado.

• Si desea crear una matriz desde cero, haga clic en el menú Definición de variable yseleccione Definir matriz. Una matriz aparece en la parte inferior del panel Definiciónde variable denominado "Nueva variable".Si desea agregar un campo secundario a la matriz, seleccione la matriz en el panelDefinición de variable, haga clic en el menú Definición de variable y seleccione Definirelemento de matriz. Aparece un nuevo elemento bajo la matriz denominado "Nuevoelemento".

Definición de atributos de matrizDespués de crear una matriz en el panel Definición de variable, puede usar el área de propiedades devariables en la parte inferior del panel para definir los atributos de la matriz.

Para definir la matriz:

1. Seleccione la matriz en el panel Definición de variable. La información aparece en el área depropiedades de variables.

2. Escriba un nombre para la matriz en el campo Nombre, en caso de necesidad.

3. Haga clic en el botón de exploración situado junto al campo Asignación. Aparece el cuadro dediálogo Seleccionar campo de esquema. Seleccione el campo de datos principal que deseautilizar para rellenar esta variable y haga clic en Aceptar.

Definición de los atributos de elementos de matrizDespués de crear un elemento de matriz en el panel Definición de variable, puede usar el área depropiedades de variables en la parte inferior del panel para definir los atributos de la matriz.

Para definir el elemento de matriz:

1. Seleccione el elemento de matriz en el panel Definición de variable. La información aparece enel área de propiedades de variables.

2. Escriba un nombre para el elemento de matriz en el campo Nombre, en caso de necesidad.

3. Seleccione el tipo de valor de esta variable en la lista desplegable.

4. Seleccione el tipo de asignación para este elemento de matriz: Campo de esquema oExpresión.

73


5. Haga clic en el botón de exploración situado junto al campo Asignación.• Si se ha seleccionado Campo de esquema en el paso anterior, se muestra el cuadro

de diálogo Campo de esquema de xPresso.• Si ha seleccionado Expresión en el paso anterior, aparece el cuadro de diálogo

Expresión de variable.6. Escriba su expresión en el cuadro, en la parte superior del cuadro de diálogo. Para ayudarle a

crear su expresión, puede:• Seleccione un tipo de función para ver las funciones disponibles. Haga clic en una

función de la lista para ver una descripción de la función del cuadro, en la parteinferior del cuadro de diálogo.

• Haga clic en Seleccionar campo de esquema para seleccionar un campo delesquema para utilizarlo en la expresión.

• Haga clic en Comprobar para verificar que la expresión es válida.

Haga clic en Aceptar cuando haya terminado de crear su expresión. Para obtener másinformación, consulte Creación de expresiones de variables.

NotaNo se admite el formato numérico alemán en una variable de tipo Expresión. Por ejemplo, no seadmite un número con formato 1.000,00, debe darle el formato 1000.00.

Colocación de variables de tabla en el documentoAhora que ya ha creado y definido una matriz, puede colocarla en el documento y crear una variablede tabla.Para colocar una matriz como variable de tabla:

1. Coloque el cursor en la página, en la ubicación donde desea que aparezca la tabla.2. Haga clic en Agregar variable de tabla en el panel o la barra de inserción de xPresso.3. Seleccione una matriz en el panel Definición de variable y haga clic en Aceptar.4. La variable aparece en el esquema y la tabla aparece en la página del documento, en la

ubicación del cursor.5. Puede utilizar la matriz completa de Dreamweaver de herramientas de formato de tablas HTML

para modificar la tabla en función de sus necesidades.

Consulta de datos de variables en el documentoPuede aplicar los datos de variables al documento para ver cómo funciona el documento y suaspecto con datos reales. Los datos de variables no rellenarán sólo sus variables, sino que tambiénsatisfarán los criterios que controlan la inclusión del contenido dinámico. Esto le permite probar laspartes dinámicas y variables de su documento. La aplicación de datos al documento se realiza através del panel Definición de variable.

74


Al aplicar datos a todo su documento, aparecen controles de navegación de registro de datos en laparte superior del panel Definición de variable. Se muestra el número de registro actual, así como elnúmero total de registros del archivo de datos. Puede escribir un número en el cuadro de registroactual para saltar a un registro de datos concreto. También puede utilizar las flechas para desplazarsea través del archivo de datos: la flecha izquierda retrocede un registro en el archivo, la flecha izquierdacon una línea retrocede al primer registro del archivo, la flecha derecha avanza un registro y la flechaderecha con una línea se desplaza al último registro del archivo.

Para cargar un archivo de datos de variable:

1. Haga clic en el menú Definición de variable y seleccione Aplicar datos de variable o Aplicardatos de variable desde servidor.

2. Localice y seleccione el archivo de datos de variable y haga clic en Abrir o en Cargar (desdeservidor).

3. Utilice los controles de desplazamiento para elegir un registro y hacer clic en Cargar. xPressopara Dreamweaver aplica el archivo de datos de variable seleccionado al documento y lomuestra en una nueva ficha en su espacio de trabajo.

75

Cómo crear un resultado 6Cómo crear un resultado

Cuando haya terminado de desarrollar el documento, está listo para generar la salida del documento.La publicación del documento de volumen alto se realiza en xPression Server. Puede ofrecer unavista previa del resultado en equipo cliente de xPresso para Dreamweaver. Cuando implementael documento en el servidor, puede generar una salida HTML o de correo electrónico través dexDashboard.

En este capítulo se describen todas las opciones de salida del documento, como generar una vistaprevia de su documento, empaquetar el documento y hacer que esté disponible para su publicación ycómo crear una versión de texto sin formato de la salida.

Cómo obtener una vista previa del documentoAntes de publicar el documento en el servidor, debería crear una vista previa de él en el equipo clientede xPresso para Dreamweaver. La vista previa produce el mismo resultado que se verá cuandose publique en el servidor.

Si la configuración regional del sistema en su equipo cliente no utiliza la codificación UTF-8, veráun error cuando intente obtener una vista previa del documento. Seleccione la codificación UTF-8para HTML para utilizar la función de vista previa. Puede cambiar el valor de juego de caracteres enxPresso para Dreamweaver localizando la línea siguiente en la vista Código (en la parte superiordel documento):

<meta http-equiv=Content-Type content="text/html; charset=value">

Escriba UTF-8 para el valor del juego de caracteres.

Para ofrecer una vista previa de un documento:

1. Abra la plantilla del documento en xPresso para Dreamweaver.

2. Haga clic en el menú Definición de variable y seleccione Vista previa o Vista previa desdeservidor (si su archivo de datos se encuentra en el servidor de xPression). Se muestra elcuadro de diálogo del servidor o Seleccionar datos del cliente.

3. Busque y seleccione el archivo de datos de variable que desea utilizar para ofrecer una vistaprevia del documento.

4. Haga clic en Abrir o en Cargar (desde servidor). xPresso para Dreamweaver abre eldocumento en una ventana del explorador independiente. Utilizará los datos contenidos en

76

Capítulo 6 — Cómo crear un resultado

el primer registro del archivo de datos seleccionado para resolver las variables y cualquierotro contenido dinámico.

5. Cierre la ventana del explorador cuando haya finalizado con la vista previa.

Nota

Si ofrece una vista previa de un documento que contiene imágenes referenciadas por enlacesestáticos, las imágenes no aparecerán en la vista previa.

Utilización de la utilidad de envío de correoelectrónicoxPresso para Dreamweaver permite realizar comprobación más exhaustivas de los documentosprototipo para utilizar el sistema de correo electrónico para enviar mensajes de prueba.

El cuadro de diálogo Enviar correo electrónico contiene esta configuración.

Nombre de elemento DescripciónDirección de origen Su dirección de correo electrónico o la dirección de correo electrónico de la

entidad que envía el mensaje de correo electrónico.

Dirección de destino La dirección de correo electrónico del destinatario previsto.

Responder a Si desea que el destinatario responda a una dirección diferente que la queaparece en el campo "Dirección destino", escríbala aquí.

Asunto El título del mensaje de correo electrónico. Este texto aparecerá en la columna"Asunto" de la mayoría de los programas de correo electrónico.

Dirección IP del servidor SMTP Póngase en contacto con el administrador del sistema para obtener este valor.

Enviar como datos adjuntos Seleccione esta opción para anexar el documento al mensaje de correoelectrónico, en lugar de colocar el documento dentro del mensaje de correoelectrónico.

Creación de un correo electrónico multipartePuede crear correos electrónicos multiparte con la plantilla de correo electrónico de xPresso paraDreamweaver. Los correos electrónicos multiparte agrupan un texto sin formato y una versiónHTML del mismo correo electrónico, que se envían como paquete. A continuación, el cliente decorreo electrónico receptor decide qué versión mostrar en función de las preferencias de la cuentade correo electrónico.

En xPresso para Dreamweaver puede crear su versión de texto sin formato en una de las dos manerassiguientes. Puede desarrollar un archivo de texto sin formato independiente y, a continuación,seleccionar dicho archivo al empaquetar la versión HTML del documento. O bien, puede hacer

77


que el motor de publicación xPublish genere automáticamente una versión de texto sin formato deldocumento durante el proceso de publicación.

Creación de un archivo de texto sin formato independienteSi está creando su versión de texto sin formato como un archivo independiente, puede desarrollar eldocumento en un editor de texto y abrirlo a continuación en xPresso para Dreamweaver para agregarcontenido dinámico, incluso instancias de contenido y variables. O bien puede convertir un archivoHTML existente en xPresso para Dreamweaver en un archivo de texto sin formato, que puede editar acontinuación. En cualquier caso, el archivo de texto sin formato debe tener la extensión .html.

Le recomendamos que diseñe el archivo en el Bloc de notas y, a continuación, lo abra en xPressopara Dreamweaver para agregar variables y contenido dinámico. De esta forma se asegura de que nose incluyen elementos que no funcionarán en un correo electrónico de texto sin formato, como tablaso viñetas. Si el documento utiliza un formato complejo, le recomendamos que permita al motor depublicación generar la versión de texto sin formato automáticamente. Para obtener más información,consulte Creación de una versión de texto sin formato durante la publicación

Tenga presente que tendrá que deletrear las URL en los enlaces que se incluyan en la versión detexto sin formato, porque los enlaces no se admiten. Si utiliza la conversión a texto sin formato dexPresso para Dreamweaver, tendrá que editar el archivo una vez convertido. No se aplicará ningúnformato al texto y tendrá que agregar cualquier variable, ya que sólo el nombre se transfiere a laversión de texto sin formato, no la variable real. La conversión sólo le ahorra el paso de volver a creartodo el contenido, por lo que todavía tendrá que realizar algunas modificaciones.

Al crear un archivo de texto sin formato independiente, tendrá que indicarle a xPresso paraDreamweaver que incluya la versión de texto sin formato en el archivo empaquetado al empaquetarel documento. Para obtener más información, consulte Cómo empaquetar al crear el archivo detexto sin formato.

Conversión de HTML a texto sin formatoPara convertir automáticamente HTML en texto sin formato:

1. Abra xPresso para Dreamweaver.

2. Haga clic en Convertir en texto en el panel o la barra de inserción de xPresso. Se muestrael cuadro de diálogo Seleccionar HTML en texto sin formato.

3. Busque y seleccione el archivo HTML que desea convertir en texto sin formato y haga clicen Abrir. El contenido del archivo aparece en texto sin formato en una nueva ventana deDreamweaver.

4. Edite el contenido, si fuera necesario, asegurándose de que agrega las variables adecuadas,cree los grupos de contenido e instancias necesarios y dé el formato correcto a las direccionesURL.

5. Guarde la versión de texto sin formato.

Cómo empaquetar al crear el archivo de texto sin formatoPara empaquetar un documento de correo electrónico multiparte:

1. Abra el documento en xPresso para Dreamweaver.

78


2. Haga clic en el menú Esquema y seleccione Listo para publicar. Aparece el cuadro dediálogo Establecer listo para publicar.

3. Seleccione Listo para publicar y haga clic en Aceptar.

4. En el menú Archivo de Dreamweaver, haga clic en Guardar como. Aparecerá el cuadro dediálogo Seleccionar carpeta de paquete.

5. Busque y seleccione el directorio en el que desea almacenar el paquete.

6. Escriba un nombre de archivo para el paquete. Los nombres de archivos para el paquetedeben tener de 1 a 215 caracteres ingleses y sólo pueden contener caracteres alfanuméricos(A-Z, a-z, 0-9), paréntesis (()), apóstrofes (’), comillas simples (’), caracteres de subrayado(_), guiones (-) y espacios.

7. Seleccione Paquete de xPresso (* .pkg) en la lista desplegable Guardar como tipo.

8. Haga clic en Guardar. Se muestra el cuadro de diálogo Texto sencillo.

9. Haga clic en Examinar para buscar y seleccionar la versión de texto sin formato del correoelectrónico. Haga clic en Abrir. Se muestra la ruta de acceso del archivo en el campo Textosin formato.

10. Haga clic en Asignación de variables para asignar las variables de la versión de texto sinformato a las variables de la versión HTML. Todas las variables coincidentes de texto sinformato y HTML se asignan automáticamente. El cuadro de diálogo Asignación de variable decorreo electrónico de texto sin formato le permite asignar variables de la versión de texto sinformato a la versión HTML. La asignación de variables garantiza que las variables se resuelvencorrectamente en la salida.

11. Seleccione la variable en la lista de variables de correo electrónico de texto sin formato y,a continuación, seleccione la variable que desea asignar en lista de variables de correoelectrónico HTML y haga clic en Asignar. El par asignado aparece en la tabla de la parteinferior del cuadro de diálogo.

12. Repita el paso 8 para todas las variables que haya que asignar.


14. Haga clic en Aceptar. Cuando el proceso finaliza, xPresso para Dreamweaver muestra unmensaje de confirmación

xPresso para Dreamweaver ejecuta de forma automática la utilidad de validación de etiquetasal crear un paquete. Si encuentra un error, recibirá un mensaje de error. Para obtener másinformación, consulte Validación de etiquetas de xPresso.

79


Creación de una versión de texto sin formato durante la publicaciónSi sólo desea crear una versión de texto sin formato del documento HTML sin realizar ningunamodificación, puede indicar el motor de publicación xPublish que cree una versión de texto sin formatodurante el proceso de publicación. Esto se lleva a cabo durante el proceso de empaquetado. Tengaen cuenta que la versión de texto sin formato generada en el servidor es igual a la generada mediantela función Convertir HTML, y no tendrá ningún formato aplicado (sin embargo, se resolverán lasvariables y el contenido dinámico). Recomendamos que esta función se utilice únicamente cuandoel documento sea muy sencillo. En el caso de documentos complejos, debería crear un archivo detexto sin formato independiente que pueda editar y dar formato.

Para crear una versión de texto sin formato durante el proceso de publicación:

1. Abra el documento en xPresso para Dreamweaver.


3. Seleccione Listo para publicar y haga clic en Aceptar.4. En el menú Archivo de Dreamweaver, haga clic en Guardar como. Aparecerá el cuadro de

diálogo Seleccionar carpeta de paquete.

5. Busque y seleccione el directorio en el que desea almacenar el paquete.

6. Escriba un nombre de archivo para el paquete. Los nombres de archivos para el paquetedeben tener de 1 a 215 caracteres ingleses y sólo pueden contener caracteres alfanuméricos(A-Z, a-z, 0-9), paréntesis (()), apóstrofes (’), comillas simples (’), caracteres de subrayado(_), guiones (-) y espacios.

7. Seleccione Paquete de xPresso (* .pkg) en la lista desplegable Guardar como tipo.

8. Haga clic en Guardar. Se muestra el cuadro de diálogo Texto sencillo.

9. Active la casilla de verificación Enviar correo electrónico como multiparte.

10. Haga clic en Aceptar. Cuando el proceso finaliza, xPresso para Dreamweaver muestra unmensaje de confirmación.

xPresso para Dreamweaver ejecuta de forma automática la utilidad de validación de etiquetasal crear un paquete. Si encuentra un error, recibirá un mensaje de error. Para obtener másinformación, consulte Validación de etiquetas de xPresso.

Al publicar el documento en xDashboard, el motor de publicación xPublish creará automáticamenteuna versión de texto sin formato del documento HTML y los empaquetará juntos para su distribuciónpor correo electrónico.

Empaquetado de documentosLos paquetes de documentos son la manera de reunir en un archivo todos los elementos necesariospara crear un documento de xPresso. Hay dos tipos de paquetes de documento: paquetes listospara publicar y paquetes no listos para publicar. Los paquetes listos para publicar contienen todala información necesaria para que el motor de publicación xPublish publique el documento. Lospaquetes no listos para publicar contienen todos los archivos necesarios para trabajar con el

80


documento en xPresso para Dreamweaver, pero no son válidos para la publicación en el servidor.Dado que los paquetes no listos para publicar no contienen toda la información necesaria parapublicar el documento, su tamaño de archivo es menor que los paquetes listos para publicar y suprocesamiento es más rápido.

Ambos tipos de paquetes de documento se crean mediante las funciones Guardar y Guardar comoque aparecen en el menú de archivo de Dreamweaver. Si ha cargado un esquema en el documento,la opción Paquete de xPresso estará disponible en la lista desplegable Guardar como tipo.

Si está creando correos electrónicos multiparte, el proceso de empaquetado es ligeramente diferente.Siga los pasos de Creación de un correo electrónico multiparte en lugar de los pasos de las seccionessiguientes.

Marcado de una plantilla como Listo para publicarUna plantilla lista para publicar es un documento que contiene elementos de xPresso (como mínimotiene un esquema cargado) que se desean empaquetar para publicar en el servidor de xPression."Listo para publicar" no significa que el documento esté terminado o sea final, sino que se trata de unestado en el que se puede publicar en el servidor de xPression.

Para marcar una plantilla como lista para publicar:

1. Asegúrese de que el documento que desea marcar como listo para publicar está abierto ydestacado en xPresso para Dreamweaver.


3. Seleccione Listo para publicar.

4. Haga clic en Aceptar.Después de marcar un documento como listo para publicar, cada vez que se guarda crea de manerapredeterminada un paquete listo para publicar. Para obtener más información, consulte Creación deun paquete listo para publicar.

Nota

La opción Listo para publicar no tiene efecto cuando el documento se protege en un servidor de ECMa través del modo en línea. El cuadro de diálogo de protección incluye una opción Marcar plantillacomo Listo para publicar que se debe seleccionar independientemente de que se haya seleccionadola opción Listo para publicar del menú Esquema. Para obtener más información, consulte Protecciónde un documento.

81


Creación de un paquete no listo para publicarLos paquetes no listos para publicar contienen solamente los archivos necesarios para trabajar conel documento en XPresso para Dreamweaver; no son válidos para la publicación en el servidor.Puede utilizar paquetes listos para publicar para colaborar en un documento con varios usuarios.Los paquetes no listos para publicar constituyen un método sencillo para almacenar documentos dexPresso y transferirlos entre diferentes usuarios.

Si trabaja en modo en línea, puede almacenar el paquete en el sistema de ECM como un paquete nolisto para publicar. Para obtener más información, consulte Protección de un documento.

Para empaquetar un documento no listo para publicar:

1. Asegúrese de que el documento que desea empaquetar está abierto en xPresso paraDreamweaver.


3. Seleccione Listo para publicar y haga clic en Aceptar.

4. En el menú Archivo de Dreamweaver, haga clic en Guardar o Guardar como. Aparece elcuadro de diálogo Guardar como.

5. Desplácese hasta el directorio en el que desea almacenar el paquete.

6. Escriba un nombre de archivo para el paquete.

7. Seleccione Paquete de xPresso en la lista desplegable Guardar como tipo.

8. Haga clic en Guardar. Ahora dispone de un paquete de documento que puede almacenar ocompartir.

82


Creación de un paquete listo para publicarLos paquetes listos para publicar contienen toda la información necesaria para que el motor depublicación de xPublish publique el documento, incluyendo el documento HTML, la lógica deensamblaje, el esquema, una vista en miniatura del documento y otros documentos que necesitael motor de publicación. Si ha incluido el contenido externo del documento, el archivo de contenidoexterno también se incluye en el paquete. Solamente se pueden utilizar paquetes listos para publicarcuando se publica en el servidor de xPression.

Si utiliza xPression Documentum Edition Server, deberá asegurarse de que el paquete listo parapublicar está almacenado en la ubicación adecuada de Documentum para que esté disponible en elservidor. Puede utilizar el modo en línea para guardar el paquete en Documentum. Para obtener másinformación, consulte Protección de un documento.

Para empaquetar un documento listo para publicar:

1. Asegúrese de que el documento que desea empaquetar está abierto en xPresso paraDreamweaver.


3. Seleccione No listo para publicar y haga clic en Aceptar.

4. En el menú Archivo de Dreamweaver, haga clic en Guardar o Guardar como. Aparece elcuadro de diálogo Guardar como.

5. Desplácese hasta el directorio en el que desea almacenar el paquete.

6. Escriba un nombre de archivo para el paquete. Los nombres de archivos para el paquete listopara publicar deben tener de 1 a 255 caracteres ingleses y sólo pueden contener caracteresalfanuméricos (A-Z, a-z, 0-9), paréntesis (()), apóstrofes (’), comillas simples (’), caracteres desubrayado (_), guiones (-) y espacios.

7. Seleccione Paquete de xPresso en la lista desplegable Guardar como tipo.

8. Haga clic en Guardar. Ahora dispone de un paquete de documento que puede almacenar,compartir o publicar.

xPresso para Dreamweaver ejecuta de forma automática la utilidad de validación de etiquetas al crearun paquete. Si encuentra un error, recibirá un mensaje de error. Para obtener más información,consulte Validación de etiquetas de xPresso.

Cómo adjuntar archivos externos a un correoelectrónicoPuede adjuntar archivos externos a los correos electrónicos creados usando paquetes de xPressopara Dreamweaver en xPression Server. Los archivos se pueden generar dinámicamente desde otrotrabajo de publicación (como una instrucción de cuenta desde un trabajo de xPresso para AdobeInDesign) o bien pueden ser archivos estáticos (como un comunicado de prensa o declaración deprivacidad). Los adjuntos de archivo definen en perfiles de correo electrónico en xAdmin. Para

83


obtener más información, consulte la Guía del usuario de xAdmin Documentum Edition o la Guía delusuario de xAdmin Enterprise Edition.

Archivos generados dinámicamenteEn el caso de archivos generados dinámicamente, asegúrese de que se utiliza una variable de salidapara crear el nombre del archivo que desea adjuntar. La salida se debería contener en archivosindividuales y colocarse en el directorio de salida predeterminado en el servidor. La salida puedeproceder de trabajo de publicación de xPresso para Adobe InDesign o xPresso para Word 2007 quepreviamente se ha completado. La salida debe residir en el directorio de salida predeterminado.

Por ejemplo, puede ejecutar un trabajo de xPresso para Adobe InDesign que genere desde unpaquete los archivos de salida de instrucciones de cuenta PDF individuales con una propiedad dedocumento de AccountNumber. Se utiliza la variable de salida AccountNumber para denominarcada archivo individual y hay que asegurarse de que la salida se dirige al directorio de salidapredeterminado. Para incluir esas instrucciones como adjuntos a correos electrónicos de alerta de lainstrucción de cliente, habría que definir un perfil de correo electrónico y agregar un adjunto utilizandola variable de salida AccountNumber. Cuando el motor de publicación xPublish genera los correoselectrónicos, buscará en el directorio predeterminado un archivo PDF que coincida con el valor deAccountNumber de todos los correos electrónicos.

Archivos estáticosEn el caso de archivos estáticos, asegúrese de que están ubicados en el directorio siguiente:

[xPression Installation Directory]\xPRS_Home\email_attachment

84

Especificaciones de lasetiquetas de xPresso A

Especificaciones de las etiquetas de xPresso

xPresso para Dreamweaver le permite codificar a mano partes de los documentos, cuando lo precise.En este apéndice se describen los atributos comunes de las etiquetas de xPresso.

Atributos generales de etiquetas de xPressoTodas las etiquetas de xPresso tienen los atributos siguientes. Todos los valores se indican entrecomillas.

xPresso type="value" id="integer" name="value"

type El tipo de etiqueta de xPresso. Los valores posibles son: grupo, instancia, texto o bucle.

id Debe tener un valor entero. Este valor debe ser único en relación a otras etiquetas dexPresso, pero sin incluir la etiqueta de variable.

name Debe ser un valor alfanumérico.

Atributos de etiquetas de grupoLas etiquetas de grupo de contenido, group, debe incluir las etiquetas hijo y las etiquetas hijo debenser las etiquetas de instancia de contenido. Las etiquetas de grupo de contenido tienen estosatributos adicionales.

<xPresso type="group" id="integer" name="value" selecttype="value" logic="value"

85

Apéndice A — Especificaciones de las etiquetas de xPresso

onoff=value>selecttype Los valores posibles son: if-else o de cambio.

logic Se puede dejar en blanco.

• Si selectype=switch, este valor sólo puede ser el nombre de unavariable.

• Si selecttype=ifelse, este valor debe dejarse en blanco.

onoff Se puede dejar en blanco. El valor debería ser una expresión válida. Una expresiónválida significa que incluye un nombre de variable y operador y un valor; también puedeincluir "and" u "or" para las condiciones múltiples, como "nombre" == "Victor" y edad> 30 o "dirección" == "{name}". En la que el nombre, la dirección y la edad deberíanser nombres de variables válidas de VarDefs. Si el nombre de variable aparece a laderecha del operador, necesita ir entre "{}". Para la función de validación de etiquetaspersonalizadas, también hay que comprobar la función de validación de lógica deselección.

Los siguientes son ejemplos de la etiqueta de grupo:

<xPresso type="group" id="14" name="CSS" selecttype="switch" logic="international"onoff=""><xPresso type="instance" id="15" name="general" logic="PEK"></xPresso></xPresso>

<xPresso type="group" id="16" name="banner" selecttype="ifelse" logic=""onoff=""name"==" test""><xPresso type="instance" id="17" name="general"logic=’"name"=="test"’></xPresso></xPresso>

Atributos de etiquetas de contenidoLa etiqueta de instancia debe tener una etiqueta padre, que debe ser una etiqueta de grupo decontenido.

<xPresso type="instance" id="integer" name="value" logic="value"></xPresso>

logic El valor depende del selecttype del grupo padre.

• Si selecttype=switch y si la lógica de grupo no está en blanco, estevalor tiene que ser un valor válido para el tipo de variable; sólo parala variable de tipo de cadena, este valor podría estar en blanco. Sila lógica de grupo está en blanco, el valor debe estar en blanco.

• Si selecttype=ifelse, este valor podría estar en blanco o unaexpresión válida.

Los siguientes son ejemplos de la etiqueta de instancia:

86


<xPresso type="instance" id="15" name="general" logic="PEK"></xPresso>

<xPresso type="instance" id="19" name="general" logic=’"international"=="PEK"’ ></xPresso>

Atributos de etiquetas de textoEn las etiquetas de texto, la etiqueta padre podría ser una instancia de contenido o un bucle o ungrupo exterior y no puede tener ninguna etiqueta hijo. El HTML interno de una variable de textodebería llevar "{}" para rodear el nombre de la variable.

<xPressotype="text" id="integer" name="name" variable="tag_name" vid="integer"></xPresso>

variable El nombre de etiqueta de VarDef.

vid El número del Id. de la etiqueta VarDef.

El siguiente es un ejemplo de la etiqueta de texto:

<xPresso type="text" id="9" name="destination" type="text" variable="desc"vid="4">{desc}</xPresso>

Atributos de etiqueta de bucleEn las etiquetas de bucle, la etiqueta padre podría ser una instancia de contenido o un bucle oun grupo exterior y puede tener etiquetas hijo.

<xPresso type="loop" id="integer" name="name" variable="TableDef Tag Name"vid="integer"></xPresso>

variable Este valor debe ser el nombre de etiqueta de TableDef.

vid Este valor debe ser el número de Id. de la etiqueta TableDef.

El siguiente es un ejemplo de la etiqueta de bucle:

<xPresso type="loop" id="10" name="triptable" variable="trip" vid="7"></xPresso>

Atributos de etiquetas de VarDefEn las etiquetas de VarDef, la etiqueta padre debe ser VarDef y tiene algunos atributos. Todos losvalores deben estar entre comillas.

87


<VarDef name="name" id="integer" type="value" expType="value"expression="value" position="integer"></VarDef>

name Debe ser un nombre único.

id Debe tener un valor de entero y el valor debe ser único en relación a otras etiquetasVarDef.

type Los valores posibles son: string, integer, double, float, date, time o dateTime.

expType Los valores posibles son: esquema o expresión.

expression El valor requerido debe ser un valor de xPath del esquema o una expresión.

position El valor de entero necesario es el número de ordenación de la etiqueta VarDef.

El siguiente es un ejemplo de una etiqueta VarDef:

<VarDef name="international" id="1" type="string" expType="schema"expression="/root/campaign/city/international" position="2"></VarDef>

Atributos de etiqueta de TableDefEn la etiqueta TableDef, la etiqueta padre debe ser TableDef, puede incluir algunas etiquetas VarDef ytener algunos atributos. Todos los valores deben estar entre comillas.

<TableDef name="name" id="integer" expType="schema" expression="value"position="integer"> </TableDef>

name Debe tener un valor, que debe ser único en relación a otras etiquetas TableDef.

id Debe tener un valor de entero y el valor debe único en relación a otras etiquetas VarDefy TableDef.

expType El valor necesario es "schema".

expression Debe tener un valor, que debe ser un valor xPath de esquema.

position Debe tener un valor de entero, que es el número de ordenación de etiquetas de variable.

El siguiente es un ejemplo de una etiqueta TableDef:

<TableDef>

<TableDef name="region" id="6" expType="schema"expression="/root/campaign/recommendations/region" position="6"></TableDef>

<TableDef name="trip" id="7" expType="schema"expression="/root/campaign/recommendations/region/trip" position="8">

<VarDef name="date" id="8" type="string" expType="schema"

88


expression="/root/campaign/recommendations/region/trip/date" position="9"></VarDef>

</TableDef>

</TableDefs>

89

Funciones de expresión BFunciones de expresión

Al crear las variables en xPresso para Dreamweaver, puede utilizar funciones en las definicionesde variable. En este capítulo se describen las funciones disponibles que se pueden utilizar enexpresiones de variables. A menos que se especifique lo contrario, las funciones pueden utilizar uncampo de esquema o literal como argumento.

Funciones numéricasSe pueden utilizar las siguientes funciones numéricas al crear una expresión de variable. Lasfunciones numéricas no pueden utilizar campos de esquema ni xPath en los argumentos; sóloaceptan entradas numéricas.

absLa función abs acepta un valor doble para el argumento numeric_value y devuelve un valor doble.

abs(numeric_value)

Devuelve el valor absoluto de numeric_value.

Ejemploabs(-2)

Devuelve 2.

floorLa función floor acepta un valor doble para el argumento numeric_value y devuelve un valor doble.

floor(numeric_value)

Devuelve el valor de punto flotante mayor (más próximo a infinito positivo) que no sea mayor quenumeric_value y que sea igual a un número entero matemático.

Ejemplofloor(2.3)

Devuelve 2.

90

Apéndice B — Funciones de expresión

ceilLa función ceil acepta un valor doble para el argumento numeric_value y devuelve un valor doble.

ceil (numeric_value)

Devuelve el valor de punto flotante menor (más próximo a infinito negativo) que no sea menor quenumeric_value y que sea igual a un número entero matemático.

Ejemploceil(2.3)

Devuelve 3.

roundLa función round acepta un valor doble para el argumento numeric_value y devuelve un valor doble.

round(numeric_value)

Devuelve un número entero.

Ejemploround(1.678)

Devuelve 2.

stringToIntegerLa función stringToInterger acepta un valor de cadena para el argumento valor_cadena y devuelveun valor de número entero.

stringToInteger(string_value)

Convierte el valor de número entero de valor_cadena.

EjemplostringToInteger("124")

Devuelve 124.

Funciones de lógicaSe pueden utilizar las siguientes funciones lógicas al crear una expresión de variable.

false

Constante lógica.

true

Constante lógica.

91


Funciones de grupoLas funciones de grupo no pueden utilizar literales en los argumentos; sólo aceptan variables. Sepueden utilizar las siguientes funciones de grupo al crear una expresión de variable.

groupCountLa función groupCount acepta un campo XML para el argumento variable_scope y devuelve unvalor de número entero.

groupCount(variable_scope)

Devuelve el número total de registros en variable_scope.

En el ejemplo siguiente, $QuarterPeriod:InvestmentA$ es una variable con un tipo de valor de númeroentero y los valores 1.000, 2.000 y 4.000. $QuarterPeriod$ es el ámbito.

EjemplogroupCount($QuarterPeriod$)

Devuelve 3.

groupSumLa función groupSum acepta un campo XML tanto para el argumento variable_field como para elargumento variable_scope, y devuelve un valor del mismo tipo que variable_field.

groupSum(variable_field, variable_scope)

Devuelve la suma de variable_field en variable_scope.


EjemplogroupSum($QuarterPeriod:InvestmentA$, $QuarterPeriod$)Devuelve 7,000.

Uso de groupSum en bucles anidadosSi desea utilizar la función groupSum para calcular la suma de cada bucle dentro del bucle anidado,necesita crear varias expresiones de una manera concreta.

Para calcular la suma de todos los elementos "Premium" dentro del elemento de bucle anidado"\nestedLoop\Data\Table\Premium", necesita hacer lo siguiente:

1. Arrastre "\nestedLoop" del panel Esquema de datos al panel Definición de variable para crearuna matriz "nestedLoop".

2. Arrastre "\nestedLoop\Data" al panel Definición de variable para crear una matriz "Data".

92


3. Arrastre "\nestedLoop\Data\Table" al panel para crear una matriz "Table".4. Cree una nueva variable en el panel Definición de variable, "NewVariable1" y especifique el

tipo de asignación como Expresión.5. Asigne la variable mediante la creación de esta expresión:

groupSum($Table:Premium$, $Table$)6. Cree una nueva variable en el panel Definición de variable, "NewVariable2" y especifique el


groupSum($NewVariable1$, $Data$)8. Cree una nueva variable en el panel Definición de variable, "NewVariable3" y especifique el


groupSum($NewVariable2$, $nestedLoop$)A continuación, puede utilizar NewVariable3 en el documento para colocar la suma de Premium.

groupMaxLa función groupMax acepta un campo XML para tanto el argumento variable_field como para elargumento variable_scope y devuelve un valor del mismo tipo que variable_field.groupMax(variable_field, variable_scope)

Devuelve el valor máximo de variable_field en variable_scope.


EjemplogroupMax($QuarterPeriod:InvestmentA$, $QuarterPeriod$)

Devuelve 4,000.

groupMinLa función groupMin acepta un campo XML tanto para el argumento variable_field como para elargumento variable_scope, y devuelve un valor del mismo tipo que variable_field.groupMin(variable_field, variable_scope)

Devuelve el valor mínimo de variable_field en variable_scope.


EjemplogroupMin($QuarterPeriod:InvestmentA$, $QuarterPeriod$)

Devuelve 1,000.

93


Funciones de cadenaSe pueden utilizar las siguientes funciones de cadena al crear una expresión de variable.

lengthLa función length acepta un valor de cadena para el argumento valor_cadena y devuelve un valorde cadena.

length(string_value)

Devuelve el número de caracteres de valor_cadena.

En el ejemplo siguiente, $GenlInfo:AccNum$ es una variable con un valor "123456789".

Ejemplolength($GenlInfo:AccNum$)

Devuelve 9.

containsLa función contains acepta un valor de cadena para tanto el argumento valor_cadena como para elargumento cadena_para_buscar y devuelve un valor booleano.

contains(string_value, string_to_find)

Devuelve true si valor_cadena contiene cadena_para_buscar y false en caso contrario.


Ejemplocontains($GenlInfo:AccNum$, "456")

Devuelve verdadero.

toLowerCaseLa función toLowerCase acepta un valor de cadena para el argumento valor_cadena y devuelveun valor de cadena.

toLowerCase(string_value)

Convierte todos los caracteres de valor_cadena en minúscula.

En el ejemplo siguiente, $GenlInfo:LastName$ es una variable con el valor "García".

EjemplotoLowerCase($GenlInfo:LastName$)

Devuelve garcía.

94


toUpperCaseLa función toUpperCase acepta un valor de cadena para el argumento valor_cadena y devuelveun valor de cadena.

toUpperCase(string_value)

Convierte todos los caracteres de valor_cadena en mayúsculas.

En el ejemplo siguiente, $GenlInfo:LastName$ es una variable con el valor "García".

EjemplotoUpperCase($GenlInfo:LastName$)

Devuelve GARCÍA

trimLa función trim acepta un valor de cadena para el argumento valor_cadena y devuelve un valorde cadena.

trim(string_value)

Elimina los espacios iniciales y finales, las tabulaciones y los caracteres de nueva línea devalor_cadena.

Ejemplotrim (" Agent ")

Devuelve "Agente".

substringLa función substring acepta un valor de cadena para el argumento valor_cadena, un número enteropara tanto el argumento de inicio como el argumento de finalización, y devuelve un valor de cadena.

substring(string_value, start, end)

Devuelve una subcadena formada por caracteres de inicio–fin, comenzando en el índice de inicio yfinalizando en el índice de fin de valor_cadena.


Ejemplosubstring($GenlInfo:AccNum$,4,6)

Devuelve "56"

95


positionLa función position acepta un valor de cadena para ambos argumentos cadena_para_buscar ydevuelve un número entero.position(string_to_search, string_to_find)

Devuelve la posición de la primera subcadena cadena_para_buscar en la segunda subcadenacadena_para_buscar o -1 si no se encuentra.


Ejemploposition($GenlInfo:AccNum$, "56")

Devuelve 4.

replaceLa función replace acepta un valor de cadena para los argumentos valor_cadena, cadena_para_buscary cadena_sustitución y devuelve un valor de cadena.replace(string_value, string_to_find, replacement_string)

Busca cadena_para_buscar en valor_cadena y sustituye cada caso con cadena_sustitución.


Ejemploreplace($GenlInfo:AccNum$,"12", "99")

Devuelve "993456789".

numericToStringLa función numericToString acepta un valor doble, flotante o entero para el argumento numeric_valuey devuelve un valor de cadena.numericToString(numeric_value)

Convierte un número en una cadena.

EjemplonumericToString( 23.5)

Devuelve "23,5".

Funciones de fecha, hora y fecha y horaLas siguientes funciones se pueden utilizar al crear una expresión de variable. Los campos de fecha,hora y fecha y hora deben aparecer en sus datos en un formato determinado:

• Date: aaaa-mm-dd (por ejemplo: 2003-05-19)• Time: hh:mm:ss (por ejemplo: 11:22:50)

96


• DateTime: aaaa-mm-ddThh:mm:ss (por ejemplo: 2002-01-05T03:15:30)

addYearLa función addYear acepta una variable de fecha y hora o de fecha para el argumentovalor_fecha_o_fechayhora, un número entero para el argumento numeric_value y devuelve un valorde fecha y hora o de fecha según el valor de entrada.addYear(datetime_or_date_value, numeric_value)

Devuelve el valor de fecha y hora o de fecha de adición de numeric_value años alvalor_fechayhora_o_fecha.

En el ejemplo siguiente, $GenlInfo:DateDue$ es una variable con un valor "2006-03-21".

EjemploaddYear($GenlInfo:DateDue$,20)

Devuelve 2026–03–21.

addMonthLa función addMonth acepta una variable de tipo fecha y hora o de fecha para el argumentovalor_fechayhora_o_fecha, un número entero para el argumento numeric_value y devuelve un valorde fecha y hora o fecha según el valor de entrada.addMonth(datetime_or_date_value, numeric_value)

Devuelve el valor de fecha y hora o de fecha de adición de numeric_value meses alvalor_fechayhora_o_fecha.


Ejemplo:addMonth($GenlInfo:DateDue$,2)


addDayLa función addDay acepta una variable de fecha y hora o de fecha para el argumentovalor_fecha_o_fechayhora, un número entero para el argumento numeric_value y devuelve un valorde fecha y hora o de fecha según el valor de entrada.addDay(datetime_or_date_value, numeric_value)

Devuelve el valor de fecha y hora o de fecha de adición de numeric_value días alvalor_fechayhora_o_fecha.


EjemploaddDay($GenlInfo:DateDue$,2)


97


nowLa función now devuelve un valor de fecha y hora.

now()

Devuelve la fecha y hora actuales.

98

© 2011 - 2013 EMC Corporation. All Rights Reserved. EMC believes the information in this publication is accurate as of its publication date. The information is subject to change

without

notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO

REPRESENTATIONS OR

WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND

SPECIFICALLY

DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United State and other

countries.

All other trademarks used herein are the property of their respective owners.

Guía del usuario de xPresso para Dreamweaver · por los programas de software que muestran iconos...

Documents

Transcript of Guía del usuario de xPresso para Dreamweaver · por los programas de software que muestran iconos...