Guia do Usuário do xPresso for Dreamweaver...Dreamweaver, bem como à versão Macromedia...

Guia do Usuário do xPresso for DreamweaverVersão 3.0 SP1

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

Copyright 2005-2008 EMC Corporation. Todos os direitos reservados.

A proteção de copyright reivindicada inclui todos os formatos de material passível de copyright e todas as informações controladas por leis estatutárias ou judiciais, vigentes atualmente ou que passem a vigorar no futuro. Isso inclui, sem limitações, qualquer material gerado pelos programas de software que exibem ícones ou outras interfaces de tela. Você não pode copiar ou transmitir qualquer parte deste documento em formato eletrônico ou impresso sem a permissão expressa por escrito da EMC Corporation. xPression, CompuSet e todos os outros produtos da EMC Corporation mencionados nesta publicação são marcas comerciais da EMC Corporation. Para obter todas as informações sobre copyright, consulte o arquivo xPression Licensing Document.pdf localizado em seu CD eBook Library.

SUMÁRIO

1 Introdução........................................................................................................................................... 6Quem deve ler esta publicação? .................................................................................................... 6Aprendendo a usar o xPresso for Dreamweaver ............................................................................. 6Diferenças do Dreamweaver CS3 .................................................................................................. 7Onde o xPresso for Dreamweaver se localiza? ............................................................................... 7Caixas de informação e barras de revisão ...................................................................................... 7Suporte da solução ....................................................................................................................... 8

2 Visão geral do xPresso for Dreamweaver .............................................................................................. 9Espaço de trabalho do xPresso for Dreamweaver ........................................................................... 9

Exibições do espaço de trabalho do Dreamweaver .................................................................. 10O que você verá na exibição Code ......................................................................................... 10Trabalhando com os painéis do Dreamweaver......................................................................... 12A barra Insert do xPresso....................................................................................................... 12O painel Data Schema do xPresso ......................................................................................... 13O painel Design Schematic do xPresso................................................................................... 13O painel Variable Definition do xPresso................................................................................... 15

Painel Document Property ............................................................................................................. 17O menu Document Properties................................................................................................. 17Área de atributos de propriedades de documento .................................................................... 18

Clicar para atualizar: excluindo itens do xPresso ............................................................................ 18Usando os comandos Undo e Redo do Dreamweaver..................................................................... 18Validação de marcas do xPresso ................................................................................................... 18Exibindo o arquivo de registro do xPresso ...................................................................................... 19Atualizando a licença .................................................................................................................... 19

3 Criando um documento do xPresso ...................................................................................................... 20Conteúdo do documento ............................................................................................................... 20

O que é conteúdo dinâmico? .................................................................................................. 20

SUMÁRIO

O que é conteúdo estático?.................................................................................................... 20Associando dados ao seu documento ............................................................................................ 21

Carregando seu esquema ...................................................................................................... 21Criando seu conteúdo ................................................................................................................... 22

Grupos de conteúdo .............................................................................................................. 22Ocorrências de conteúdo ....................................................................................................... 24

Adicionando critérios ao conteúdo dinâmico ................................................................................... 24Definindo critérios de ativação/desativação ............................................................................. 26Definindo critérios de alternância ............................................................................................ 26Definindo critérios If-Else........................................................................................................ 28Editando critérios existentes ................................................................................................... 29

Usando o Content Group Wizard ................................................................................................... 29Configuração de ocorrência de Multiple If-Else ........................................................................ 30Configuração de ocorrência de alternância simples.................................................................. 31Adicionando conteúdo a uma ocorrência ................................................................................. 31

Loops de conteúdo ....................................................................................................................... 31Criando um loop de conteúdo................................................................................................. 32Copiando um loop de conteúdo .............................................................................................. 32

Tabelas dinâmicas ........................................................................................................................ 32Criando uma tabela dinâmica usando loops de conteúdo ......................................................... 33

Adicionando conteúdo externo ao documento................................................................................. 34Copiando conteúdo externo.................................................................................................... 35

Trabalhando com o Documentum .................................................................................................. 35Adicionando um servidor Documentum ................................................................................... 36Abrindo um arquivo HTML no Documentum ............................................................................ 37Salvando um arquivo HTML no Documentum.......................................................................... 37Inserindo um arquivo HTML externo do Documentum .............................................................. 38

4 Usando variáveis ................................................................................................................................. 39Noções básicas sobre variáveis ..................................................................................................... 39

Importando definições de variáveis ......................................................................................... 39Exportando definições de variáveis ......................................................................................... 41Copiando variáveis ................................................................................................................ 41

Trabalhando com variáveis ............................................................................................................ 41Criando variáveis................................................................................................................... 42Definindo atributos de variáveis .............................................................................................. 43Inserindo variáveis de texto em um documento ....................................................................... 44Formatando variáveis de texto................................................................................................ 44Inserindo variáveis de imagem em um documento................................................................... 46

Criando expressões de variáveis ................................................................................................... 46Variáveis ............................................................................................................................... 47Funções................................................................................................................................ 47Instruções If/Else ................................................................................................................... 48Verificando uma expressão .................................................................................................... 48Criando uma variável de endereço de remetente/destinatário amigável..................................... 48

SUMÁRIO

Trabalhando com propriedades do documento................................................................................ 49Criando uma propriedade de documento................................................................................. 49Opções de atributos de propriedades de documento................................................................ 49Importando propriedades de documento ................................................................................. 50Exportando propriedades de documento ................................................................................. 50

Trabalhando com hiperlinks de variável .......................................................................................... 51Inserindo hiperlinks variáveis no documento............................................................................ 51

Trabalhando com arrays................................................................................................................ 51Criando arrays....................................................................................................................... 52Definindo atributos de array.................................................................................................... 52Definindo atributos de item de array........................................................................................ 53Inserindo variáveis de tabela em um documento...................................................................... 54

Exibindo dados de variáveis em um documento.............................................................................. 54

5 Criando saídas .................................................................................................................................... 55Visualizando o documento............................................................................................................. 55Usando o utilitário Send E-Mail ...................................................................................................... 56Criando um e-mail em várias partes ............................................................................................... 56

Criando um arquivo de texto simples separado........................................................................ 56Criando uma versão de texto simples durante a publicação...................................................... 59

Empacotando o documento ........................................................................................................... 59Anexando arquivos externos em um e-mail .................................................................................... 60

Arquivos gerados dinamicamente ........................................................................................... 61Arquivos estáticos.................................................................................................................. 61

A Especificação de marca do xPresso...................................................................................................... 62Atributos de marca gerais do xPresso ............................................................................................ 62

Sintaxe ................................................................................................................................. 62tipo ....................................................................................................................................... 62id .......................................................................................................................................... 62nome .................................................................................................................................... 62

Atributos de marca de grupo.......................................................................................................... 62Sintaxe ................................................................................................................................. 63

Atributos da marca de conteúdo..................................................................................................... 63Sintaxe ................................................................................................................................. 64

Atributos de marca de texto ........................................................................................................... 64Sintaxe ................................................................................................................................. 64

Atributos de marca de loop ............................................................................................................ 65Sintaxe ................................................................................................................................. 65

Atributos da marca VarDef............................................................................................................. 65Sintaxe ................................................................................................................................. 66

Atributos da marca TableDef.......................................................................................................... 66Sintaxe ................................................................................................................................. 67

B Funções de expressão......................................................................................................................... 68

SUMÁRIO

Funções numéricas....................................................................................................................... 68abs ....................................................................................................................................... 68Sintaxe ................................................................................................................................. 68floor ...................................................................................................................................... 68Sintaxe ................................................................................................................................. 68ceil........................................................................................................................................ 68Sintaxe ................................................................................................................................. 69round .................................................................................................................................... 69Sintaxe ................................................................................................................................. 69stringToInteger....................................................................................................................... 69Sintaxe ................................................................................................................................. 69

Funções lógicas............................................................................................................................ 69Funções de grupo ......................................................................................................................... 70

groupCount ........................................................................................................................... 70Sintaxe ................................................................................................................................. 70groupSum ............................................................................................................................. 70Sintaxe ................................................................................................................................. 71groupMax.............................................................................................................................. 71Sintaxe ................................................................................................................................. 72groupMin............................................................................................................................... 72Sintaxe ................................................................................................................................. 72

Funções de string ......................................................................................................................... 72length.................................................................................................................................... 72Sintaxe ................................................................................................................................. 72contains ................................................................................................................................ 72Sintaxe ................................................................................................................................. 73toLowerCase ......................................................................................................................... 73Sintaxe ................................................................................................................................. 73toUpperCase ......................................................................................................................... 73Sintaxe ................................................................................................................................. 73trim ....................................................................................................................................... 73Sintaxe ................................................................................................................................. 73substring ............................................................................................................................... 74Sintaxe ................................................................................................................................. 74position ................................................................................................................................. 74Sintaxe ................................................................................................................................. 74replace.................................................................................................................................. 74Sintaxe ................................................................................................................................. 74numericToString..................................................................................................................... 74Sintaxe ................................................................................................................................. 75

Funções de data e hora, data e hora .............................................................................................. 75addYear ................................................................................................................................ 75Sintaxe ................................................................................................................................. 75addMonth.............................................................................................................................. 75Sintaxe ................................................................................................................................. 75

SUMÁRIO

addDay ................................................................................................................................. 76Sintaxe ................................................................................................................................. 76now ...................................................................................................................................... 76Sintaxe ................................................................................................................................. 76

Introdução 1Introdução

Bem-vindo ao xPresso for Dreamweaver. Este aplicativo faz parte do pacote de produtos xPressione foi desenvolvido para ajudar você a criar páginas da Web em HTML gráficas e personalizadasou mensagens de e-mail que contêm uma variedade de conteúdo. O conteúdo pode variar desdecorrespondências que contenham conteúdo de marketing gráfico e imagens de marcas, até alertas ouinstruções de contas que encaminham o destinatário para um site personalizado também criado noxPresso for Dreamweaver.

Quem deve ler esta publicação?O Guia do Usuário do xPresso for Dreamweaver contém as informações de que um usuário avançadodo Dreamweaver precisa para usar o xPresso for Dreamweaver. Espera-se que você já saibatrabalhar com o Dreamweaver e esteja familiarizado com os dados XML que usará nos documentosque criar com o xPresso for Dreamweaver.

Este guia não fornece instruções sobre como usar os recursos básicos do Dreamweaver, excetoquando forem específicas ao modo como você usa o recurso com o xPresso for Dreamweaver. Estedocumento não ensina como criar os dados, mas inclui diretrizes para criar dados compatíveis com oxPresso e inclui informações sobre como usar esses dados.

Aprendendo a usar o xPresso for DreamweaverJunto com este guia do usuário, também é fornecido um tutorial do xPresso for Dreamweaver que oguiará durante as tarefas associadas à criação de um documento. Para acessar o documento dotutorial, clique em Tutorial no menu xPresso. O xPresso for Dreamweaver também inclui Ajudaonline. Para acessá-la, clique em Help no menu xPresso.

Se você é um usuário principiante do Dreamweaver ou se apenas precisa de uma atualização, aDocument Sciences recomenda estes recursos de aprendizagem:

• Se você instalou o Dreamweaver, no menu Help, selecione Getting Started withDreamweaver. Os tutoriais neste guia orientam você pelo processo de criação de um sitesimples, mas funcional.

• O Centro de Recursos de Documentação do Dreamweaver está disponível online em:http://www.adobe.com/support/documentation/en/dreamweaver/.

6

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

Capítulo 1 — Introdução

Diferenças do Dreamweaver CS3Esta versão do xPresso for Dreamweaver oferece suporte à versão Adobe Creative Suite 3 doDreamweaver, bem como à versão Macromedia Dreamweaver 8. No Dreamweaver 8, a configuraçãopadrão da barra Insert é menus e no Creative Suite 3, o padrão é guias. As capturas de tela nesteguia foram tiradas da versão Dreamweaver 8 do software. Se você estiver usando o CS3, a barraInsert pode ser um pouco diferente.

Onde o xPresso for Dreamweaver se localiza?O xPresso for Dreamweaver é um componente de design do pacote de produtos xPression quepermite criar documentos dinâmicos do Dreamweaver que podem ser publicados no xPression Server.

O xPresso for Dreamweaver fica localizado na área Document Design do pacote de produtosxPression.

Caixas de informação e barras de revisãoQuando uma das seguintes caixas aparecer em uma página, você receberá um alerta cominformações especiais.

ATENÇÃOA caixa de cuidado informa que um erro fatal, uma saída insatisfatória ou perda de dados podeocorrer se você não seguir as orientações cuidadosamente.

7

Capítulo 1 — Introdução

Dica

Uma dica oferece sugestões para simplificar uma tarefa ou descreve um atalho útil. Ela também podedescrever um modo alternativo de usar as técnicas descritas no texto.

Observação

Uma observação fornece informações que enfatizam ou complementam pontos importantes dotexto principal.

As barras de revisão ajudam você a localizar informações novas ou alteradas. Procure essas barrasde revisão na margem direita de cada página alterada.

Suporte da soluçãoPara obter mais informações ou solucionar um problema, entre em contato com o Suporte da soluçãoda Document Sciences de um dos seguintes modos:

Telefone +1 (760) 602-1500

Fax +1 (760) 602-1515

Site http://support.docscience.com

E-mail [email protected]

8

http://support.docscience.com

Visão geral do xPresso forDreamweaver 2

Visão geral do xPresso for Dreamweaver

Este capítulo é uma visão geral da interface do usuário do xPresso for Dreamweaver. Esse aplicativose conecta ao Macromedia Dreamweaver 8 ou Adobe Dreamweaver CS3, e funciona perfeitamentecom ambos. Uma instalação do xPresso adiciona a barra inserir do xPresso ao Dreamweaver, bemcomo vários painéis do xPresso.

Espaço de trabalho do xPresso for DreamweaverEstes são os itens que você geralmente verá quando abrir o xPresso for Dreamweaver: uma área detrabalho padrão do Dreamweaver, com o acréscimo de alguns itens do xPresso. As seções a seguirapresentam mais informações sobre a função desses itens.

Após a instalação, você verá que esses componentes do xPresso foram adicionados ao seu espaçode trabalho do Dreamweaver.

9

Capítulo 2 — Visão geral do xPresso for Dreamweaver

Exibições do espaço de trabalho do DreamweaverNo Dreamweaver, você pode exibir seu espaço de trabalho de três maneiras diferentes: exibiçãoDesign, Code ou Split. Ao trabalhar com o xPresso for Dreamweaver, é melhor trabalhar com oespaço de trabalho na exibição Split, para que seja possível ver as exibições Design e Code.

Este gráfico mostra um documento de exemplo no modo de exibição Split.

A exibição Code no xPresso for Dreamweaver mostra o HTML do conteúdo geral do documento etambém o HTML gerado para ações do xPresso. Há algumas ações relacionadas ao xPresso que vocêdeve executar na exibição Code, enquanto outras podem ser executadas na exibição Design. Vocêpode mudar de uma exibição para outra usando os botões na parte superior do espaço de trabalho.

O que você verá na exibição CodeO xPresso for Dreamweaver coloca marcas no código HTML à medida que você executa funçõesrelacionadas ao xPresso no documento, por exemplo, criar grupos de conteúdo ou inserir variáveis.Quando você seleciona itens na exibição Design, o código correspondente é realçado na exibiçãoCode.

10


Veja a seguir uma lista das marcas que você verá à medida que trabalhar no xPresso forDreamweaver, junto com um exemplo de cada:

• Marca 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>

• Marca Content

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

• Marca Text

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

• Marca Loop

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

• Marca VarDef

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

• Marca TableDef

<TableDef> <TableDef name="region" id="6" expType="schema" expression="/root/cam-paign/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 obter mais informações, consulte Especificação de marca do xPresso.

Observação

Se você selecionar um intervalo de texto na exibição Design e a primeira marca <xPresso> parao intervalo não estiver selecionada na exibição Code, ative o realce de marcas de terceiros parahabilitar a seleção. Para obter mais informações, consulte Realçando elementos do xPresso.

Selecionando texto na exibição CodeQuando você seleciona conteúdo na exibição Code que deseja incluir em um grupo ou uma ocorrênciade conteúdo, verifique se selecionou as marcas de início e fim de parágrafo e fonte, além do conteúdo.

11


ATENÇÃOQuando uma ocorrência inteira de conteúdo está selecionada na exibição Code, qualquer açãoexecutada sobregravará a ocorrência. Aplicar uma cor usando o Color Picker, em Code Hint Tools,por exemplo, substitui a ocorrência de conteúdo (junto com todas as marcas xPresso) pelo númeroda cor, removendo a ocorrência do documento.

Realçando elementos do xPressoComo você verá em seções e capítulos subseqüentes deste guia, o xPresso for Dreamweaverpermite adicionar elementos de conteúdo dinâmico aos documentos do Dreamweaver. Para que oDreamweaver identifique esses elementos do xPresso:

1. No menu Edit, selecione Preferences.

2. Selecione Highlighting na lista Categoria.

3. Clique na caixa de seleção Show ao lado de Third-Party Tags e em OK.

Trabalhando com os painéis do DreamweaverO Dreamweaver permite agrupar painéis em combinações lógicas de acordo com o modo como vocêtrabalha. Também é possível fazer isso com os painéis do xPresso. Para agrupar um ou mais painéisdo xPresso for Dreamweaver, clique no botão de menu do painel e selecione Group [nome do paineldo xPresso] with. Escolha o painel com o qual deseja agrupar o painel selecionado.

A barra Insert do xPressoVocê pode mostrar ou ocultar, recolher ou expandir a barra Insert do Dreamweaver conforme anecessidade. Também é possível exibir as diferentes categorias da barra Insert. Algumas categoriasda barra Insert têm botões que contêm menus com comandos comuns. A extensão do xPresso forDreamweaver adiciona um item xPresso na barra de inserção. Se você não encontrar a barra Insert,clique no menu Window do Dreamweaver e selecione Insert. A barra Insert pode ser exibida comomenus ou guias. No Dreamweaver 8, a configuração padrão é menus e no Creative Suite 3, o padrãoé guias. Para exibir a parte do xPresso da barra Insert, execute um destes procedimentos:

• Clique na seta ao lado do nome da categoria à esquerda da barra Insert e selecionexPresso no menu pop-up.

• Clique na guia xPresso.

A barra Insert do xPresso contém botões de atalho para as funções do xPresso for Dreamweaver.Quando você passa o ponteiro sobre um botão, uma dica de ferramenta é exibida com o nomedo botão.

A tabela a seguir mostra e descreve cada botão.

Botão Ação Botão AçãoCarregar um arquivode esquema de dados.

Inserir uma variável dehiperlink.

Criar um grupo deconteúdo.

Inserir uma variável deconteúdo externo.

12


Botão Ação Botão AçãoAdicionar umaocorrência deconteúdo a um grupode conteúdo.

Excluir os itensselecionados dos painéisdo xPresso.

Iniciar o Content GroupWizard.

Converter um arquivoHTML em texto simples.

Adicionar um loop deconteúdo para criaruma tabela dinâmica.

Criar um pacote dedocumentos.

Criar uma tabela deum array no painel dedefinição de variáveis.

Restaurar as exibiçõesnos painéis do xPresso.

Inserir uma variávelde texto do painel dedefinição de variáveis.

Colar o último itemcopiado do xPresso naesquemática no local docursor no documento.

Inserir uma variável deimagem.

O painel Data Schema do xPressoO painel Data Schema do xPresso exibe os dados de variáveis, como contidos no seu esquema dedados. Não consegue ver isso no seu espaço de trabalho? No menu xPresso, selecione DataSchema. O menu Data Schema permite carregar um esquema em seu documento. Quando vocêcarrega um esquema de dados no painel, o xPresso for Dreamweaver mostra a estrutura do esquemaem uma estrutura hierárquica. Você só pode carregar um arquivo XSD. Se não tiver um arquivo deesquema, será preciso criar um a partir do arquivo de dados XML.

Quando você seleciona um campo no painel Data Schema, o tipo de dados do campo aparece naparte inferior do painel. Estas informações são somente leitura.

O menu Data Schema do xPressoO menu Data Schema permite carregar um esquema em seu documento.

O painel Design Schematic do xPressoO painel Design Schematic do xPresso mostra a estrutura, a lógica e a variação de conteúdo daspartes dinâmicas do documento, em uma estrutura de tópicos. Não consegue ver isso no seu espaçode trabalho? No menu xPresso, selecione Design Schematic Browser. Pense nele como o planoestrutural da variabilidade do documento, mostrando todas as partes variáveis que podem ser usadaspara criar a saída final, bem como os critérios que regem a inclusão delas.

O Design Schematic do xPresso consiste em uma estrutura de tópicos que mostra a estrutura deconteúdo variável, e a área Schematic Attribute do xPresso que mostra os atributos do item daesquemática selecionado.

13


Por meio de uma esquemática do xPresso, você pode criar grupos e ocorrências de conteúdo paraserem usados no documento. Também é possível definir os critérios para a inclusão de conteúdoespecífico.

Os itens listados na esquemática correspondem ao conteúdo variável na página do Dreamweaver.Quando você seleciona um grupo ou ocorrência de conteúdo na Estrutura, o conteúdo correspondenteé selecionado na página do documento. Se você selecionar uma ocorrência de conteúdo que nãoesteja ativa no momento, ela será exibida e realçada. Isto permite alternar entre ocorrências deconteúdo para ver como aparecem na página ou fazer alterações. Quando você seleciona conteúdona página do documento, o xPresso realça a ocorrência de conteúdo correspondente na esquemática.

A área Atributo esquemático do xPressoA área Schematic Attribute do xPresso aparece na parte inferior do painel Schematic do xPresso eexibe informações sobre o item selecionado na esquemática. Você pode fazer alterações em qualqueratributo editável exibido na área. É possível renomear todos os grupos de conteúdo, as ocorrênciasde conteúdo ou as variáveis contidas na esquemática editando o nome exibido na área SchematicAttribute do xPresso. Você não pode renomear o Schematic ou a Pasta de variáveis globais. Asinformações exibidas no painel variam de acordo com o tipo de item selecionado.

O menu Schematic do xPressoO menu Schematic do xPresso contém os comandos necessários para trabalhar com os itens variáveisna esquemática. As seleções de menu variam de acordo com o item selecionado na esquemática.

14


Opção DescriçãoExcluir Excluir o item selecionado na esquemática e removê-lo do documento

de modelo.

Marcas de bordas doxPresso ativadas

Exibir as marcas de início e fim de comandos do xPresso nas exibiçõesCode e Design.

Marcas de bordas doxPresso desativadas

Ocultar as marcas de início e fim de comandos do xPresso nasexibições Code e Design.

Copy Item Copiar o item selecionado no momento na esquemática. Você podecopiar os seguintes itens da esquemática: grupos de conteúdo,variáveis, loops de conteúdo e variáveis de conteúdo externo. Use obotão xPresso Paste na barra de inserção para colar o item copiadono modelo de documento.

Classificar ocorrência Classificar em ordem alfabética as ocorrências contidas no grupo deconteúdo selecionado no momento na esquemática.

Clonar ocorrência deconteúdo

Criar um clone da ocorrência de conteúdo selecionada no momento naesquemática. As novas ocorrências aparecem na esquemática abaixoda ocorrência original com o nome Clone NomeItemOriginal.

O painel Variable Definition do xPressoO painel Variable Definition funciona com o painel Data Schema e permite criar com facilidade edefinir variáveis e arrays para uso no documento. Não consegue ver isso no seu espaço de trabalho?No menu xPresso, selecione Variable Definition. O painel permite adicionar variáveis, arrays,elementos filho a arrays, além de modificar as propriedades dos itens. A parte principal do painelVariable Definition é a estrutura das variáveis, onde são listadas as variáveis e os arrays definidos. Naestrutura, uma pasta ( ) representa um array e um ícone de página ( ) representa uma variável.Abaixo da estrutura de tópicos fica a área de atributos de variável. Quando você seleciona um item naestrutura de tópicos, pode definir ou editar seus atributos na área de atributos de variáveis.

Quando você aplica dados de variáveis ao documento, o xPresso for Dreamweaver exibe um rótulo "nof m" e um conjunto de setas na parte superior do painel Variable Definition para permitir a navegaçãonos registros no seu arquivo de dados.

O rótulo n of m mostra o número do registro em que você está no momento (n) e quantos registros oarquivo contém (of m). Clique nas setas para percorrer os registros do documento. Clique em Loadpara aplicar os dados em um determinado registro ao seu trabalho. Os resultados serão exibidosno seu navegador padrão da Web.

O menu Variable DefinitionClique na seta no canto direito do painel Variable Definition para acessar o menu.

O menu Variable Definition contém os comandos necessários para você trabalhar com suas variáveise os dados relacionados. As seleções de menu variam de acordo com o item selecionado no painel.

15


Opção DescriçãoDefinir variável Adicionar uma variável de texto ou de imagem ao painel Variable

Definition. Para obter mais informações, consulte Criando variáveis.

Definir array Adicionar uma variável de array ou de tabela ao painel VariableDefinition. Para obter mais informações, consulte Criando arrays.

Definir variável a partirde esquema

Adicionar uma variável de texto ou imagem ao painel Variable Definitionusando o campo selecionado no painel Data Schema. Selecione ocampo no painel Data Schema antes de escolher esta opção. Paraobter mais informações, consulte Criando variáveis.

Definir array a partir deesquema

Adicionar uma variável de array ou tabela ao painel Variable Definitionusando o campo pai selecionado no painel Data Schema. Selecione ocampo pai no painel Data Schema antes de escolher esta opção. Paraobter mais informações, consulte Criando arrays.

Exportar definições devariáveis

Criar um arquivo XML que contém todas as definições de variáveis nopainel Variable Definition. Você pode importar esse arquivo em outrodocumento do xPresso.

Importar definições devariáveis

Importe um arquivo de exportação de Definição de variáveis quecontém definições de variáveis definidas em um documento diferentedo xPresso, para ser usado neste documento. Todas as definiçõescontidas no arquivo serão exibidas no painel Variable Definition.

Excluir item Excluir o item selecionado do painel Variable Definition. Se a variávelaparece no seu documento, você não pode excluí-la do painel.Primeiro, você deve excluir a variável da página do documento.

Aplicar dados devariáveis

Abra uma caixa de diálogo onde você pode selecionar um arquivo XMLa ser usado para seus dados de variáveis. Quando você seleciona umarquivo, o xPresso for Dreamweaver atualiza o documento usando osdados do arquivo XML selecionado.

Redefinir dados devariáveis

Redefina todas as variáveis do seu documento para o estado original,removendo dados de variáveis. Todas as variáveis exibem o nome davariável em vez dos dados reais da variável.

Visualizar Exibir no navegador padrão da Web seu trabalho com os dadosaplicados. Para obter mais informações, consulte Visualizando odocumento.

Visualizar log Para exibir o arquivo xPresso.log. Para obter mais informações,consulte Exibindo o arquivo de registro do xPresso.

16


Painel Document PropertyO painel Document Property exibe todas as propriedades de documento definidas no documento. Aspropriedades de documento estão associadas a um documento específico e estão disponíveis noxAdmin para serem definidas como variáveis de saída, bem como para serem usadas em expressõese em modelos de nomenclatura de arquivo. No xPresso for Dreamweaver, você pode especificar umavariável existente como uma propriedade de documento e, assim, associar a variável ao documento.

Verifique se todas as propriedades de documento que serão usadas em modelos de nomenclatura dearquivo estão associadas a variáveis cujos valores serão exclusivos para cada registro no arquivo dedados. Se um valor não for exclusivo, você correrá o risco de criar nomes de arquivos duplicados,o que gerará um erro. Além disso, verifique se o valor não inclui nenhum destes caracteres: \, /,:, *, ?, ", <, >, |.

A parte principal do painel Document Property é a estrutura, na qual são listadas as propriedadesde documento definidas. Abaixo da estrutura de tópicos fica a área de atributos de propriedades dedocumento. Quando você seleciona um item na estrutura de tópicos, pode definir ou editar seusatributos nessa área.

O menu Document PropertiesO menu Document Properties contém os comandos que você precisa para adicionar propriedades dedocumento no documento.

Selecione estaopção

Para

Adicionarpropriedade dedocumento

Adicionar a variável selecionada no painel Variable Definition aopainel Document Property. Você deve selecionar uma variável nopainel Variable Definition para poder usar esta opção.

Excluirpropriedade dedocumento

Excluir do painel a propriedade de documento selecionada eremover a associação dela ao documento.

Importarpropriedades dedocumento

Importe um arquivo de exportação de propriedades de documentoque contém propriedades de documento definidas em outrodocumento do xPresso para ser usado neste documento. Todasas propriedades contidas no arquivo serão exibidas no painelDocument Property.

Exportarpropriedades dedocumento

Criar um arquivo XML que contém todas as propriedades dedocumento no painel Document Property. Você pode importaresse arquivo em outro documento do xPresso.

17


Área de atributos de propriedades de documentoA área de atributos de propriedade de documento aparece na parte inferior do painel DocumentProperty e exibe informações de atributos sobre o item selecionado no painel.

Na área de atributos, você pode:

• Renomear a propriedade de documento. Os nomes da propriedade de documento devemconter pelo menos uma letra e todos os caracteres devem ser letras do alfabeto inglês,números ou sublinhados (_). Espaços não são permitidos. O nome deve ter no máximo200 caracteres e não pode conter caracteres que não façam parte do alfabeto inglês.

• Alterar o mapeamento da variável de propriedade

• Ver o tipo de variável (somente leitura)

Clicar para atualizar: excluindo itens do xPressoO xPresso for Dreamweaver permite remover variáveis do painel Variable Definition do xPresso,bem como ocorrências e grupos de conteúdo do painel Design Schematic do xPresso, por meioda seleção do menu Delete. Você também pode remover esses itens das exibições Design eCode do Dreamweaver. No entanto, quando excluir itens dessas exibições, os painéis do xPressopodem não ser atualizados imediatamente, fazendo com que um item excluído ainda apareça emum painel. Para ter certeza de que tudo está sincronizado da maneira apropriada, clique no botãoRefresh na barra Insert do xPresso.

Usando os comandos Undo e Redo do DreamweaverOs comandos Undo e Redo do Dreamweaver em geral não funcionam bem com as ações doxPresso. Essa é uma limitação do Dreamweaver. Se você usar o comando Undo, ele pode nãoremover todas as marcas do xPresso do item que você está desfazendo. Se usar o comando Undopara criar um grupo de conteúdo, será preciso clicar em Undo duas vezes para desfazer as duasações que ocorrem durante o processo de criação do grupo de conteúdo. É recomendável excluir oitem em vez de usar o comando Undo.

Validação de marcas do xPressoO xPresso usa a função Site Reports do Dreamweaver para validar as marcas que adiciona aoseu documento. Para verificar o documento do xPresso, no menu Site, selecione Reports. Ouclique no botão Reports ( ) na guia Site Reports. É exibida a caixa de diálogo Reports. SelecionexPresso Validation e clique em Run para gerar um relatório. É exibida uma lista de resultadosno painel Site Reports.

18


Exibindo o arquivo de registro do xPressoO arquivo xPRS.log (encontrado no [diretório de instalação do Dreamweaver]\xPresso) contéminformações sobre algumas das funções que o xPresso for Dreamweaver executou. O arquivo deregistro é cumulativo e você precisa rolar até o final do arquivo para encontrar as entradas maisrecentes.

Você deve exibir o arquivo de registro quando receber mensagens de erro e quiser ver maisinformações sobre elas. Procure palavras como "ERROR" ou "WARN" para encontrar os problemas.

Para exibir o arquivo de registro, clique no menu Variable Definition e selecione View Log. O arquivoxPRS.log é aberto no Bloco de Notas. Role até o final do arquivo para ver as entradas mais recentes.

Atualizando a licençaSe você receber uma nova licença do xPresso for Dreamweaver do Atendimento ao cliente daDocument Sciences, poderá ativá-la clicando em Register no menu xPresso. Quando a caixa dediálogo Register aparecer, substitua a chave de licença atual por uma nova e clique em OK.

19

Criando um documento doxPresso 3

Criando um documento do xPresso

Há várias etapas para criar um documento do xPresso. Este capítulo aborda o conhecimentonecessário para usar o xPresso for Dreamweaver para criar um documento, por exemplo, associandoos dados ao documento, criando conteúdo, especificando critérios para controlar a inclusão deconteúdo e adicionando variáveis.

Conteúdo do documentoHá dois tipos básicos de conteúdo que compõem um documento: dinâmico e estático e ambos podemdesempenhar um papel importante na aparência final do documento.

O que é conteúdo dinâmico?O conteúdo dinâmico pode ser alterado para cada versão de um documento e é controlado porcritérios e dados de variáveis. O conteúdo dinâmico do xPresso for Dreamweaver está incluído emgrupos de conteúdo, sendo que cada variação aparece na sua própria ocorrência de conteúdo.

Geralmente, apenas uma ocorrência de conteúdo em um grupo de conteúdo aparece na saída final.Por exemplo, você pode ter dois parágrafos de abertura diferentes em um documento, cada umvoltado para um público-alvo diferente. Você incluiria cada parágrafo como sua própria ocorrência deconteúdo no mesmo grupo de conteúdo e, em seguida, usaria critérios para determinar quando cadaparágrafo deve aparecer na saída.

Os critérios permitem controlar quando o conteúdo dinâmico aparece na saída. Os dados determinamo conteúdo, satisfazendo os critérios definidos. Você pode definir critérios para controlar quais gruposde conteúdo são ativos em seu documento e quais ocorrências de conteúdo nesses grupos deconteúdo aparecem na saída final. Para obter mais informações, consulte Adicionando critériosao conteúdo dinâmico.

O que é conteúdo estático?O conteúdo estático aparece em todas as iterações do documento e, como sua inclusão não écontrolada por critérios, não precisa estar contido em um grupo de conteúdo. Por exemplo, onome e o endereço da sua empresa provavelmente seriam conteúdo estático em seu documento.O procedimento para adicionar conteúdo estático ao documento é semelhante àquele usado paraadicionar qualquer tipo de conteúdo a um documento do Dreamweaver.

O texto estático pode conter variáveis; embora a inclusão do texto propriamente dito seja estática(sempre é incluído na saída), você pode usar variáveis para fazer parte do conteúdo dinâmico.

20

Capítulo 3 — Criando um documento do xPresso

Associando dados ao seu documentoSeus dados controla a aparência final de seu documento. É fundamental que estes dados sejamconfigurados corretamente antes de você criar seu documento para evitar possíveis problemas aomover o documento durante a produção.

Você deve ter um arquivo de esquema de dados e um arquivo XML contendo as informaçõesespecíficas ao documento que está criando. Esses arquivos devem estar acessíveis ao computadorcliente do xPresso for Dreamweaver. No momento, o xPresso não oferece suporte a vários arquivosde esquema. Os arquivos de esquema usados no xPresso for Dreamweaver devem ser específicospara o e-mail ou a página HTML que está sendo criada, ou para um grupo de e-mails ou páginassemelhantes.

Verifique se seus arquivos de esquema e XML cumprem os padrões do xPresso antes de começara usá-los para criar seu documento. Os arquivos de dados XML usados com o xPresso for AdobeInDesign devem usar a codificação UTF-8. Os arquivos de dados XML que serão implantadosno servidor e usados na publicação não podem ter os caracteres a seguir em seus nomes:&^=#@$%‘*,/?/"+|{}<>;:

Carregando seu esquemaO esquema é carregado no xPresso for Dreamweaver por meio do painel Data Schema do xPresso.Esse painel permite que você trabalhe com o arquivo de esquema de dados enquanto cria odocumento.

Para carregar um esquema de dados:

1. Localize o painel Data Schema do xPresso no seu espaço de trabalho. Se o painel não estiversendo exibido, no menu xPresso do Dreamweaver, clique em Data Schema.

2. Clique em Load Schema na barra Insert do xPresso ou em Load Schema no menu DataSchema. É exibida a caixa de diálogo Load Schema.

3. Localize e selecione o arquivo XSD que contém seu esquema. Clique em OK.

4. Se seu esquema contiver mais de um elemento raiz, o xPresso perguntará qual elementovocê deseja como raiz. Selecione o elemento repetido e clique em Apply. A raiz de registrorepetida deve ser o elemento de nível mais alto que representa o registro de repetição dosdados. O esquema de dados aparece na paleta em uma estrutura hierárquica. Os elementosna lista suspensa Select Root Element estão em ordem alfabética e não na ordem em que oselementos aparecem no esquema. Essa é uma limitação imposta pelo Dreamweaver.

5. Clique no botão Split ou Show Code View do Dreamweaver e role para baixo na janela dovisualizador. Você verá que o xPresso for Dreamweaver inseriu os elementos do esquemacarregado. Essa estrutura de esquema é armazenada temporariamente; ela não será exibidano HTML gerado no final.

Agora que você carregou seu esquema, está pronto para usar seus dados para criar seu documento.Você pode acessar os campos de esquema para usá-los na definição de critérios e usar os camposcomo variáveis em seu documento.

Se você está pronto para começar a criar variáveis, consulte Usando variáveis. Se preferir criargrupos e ocorrências de conteúdo, continue lendo.

21

Criando seu conteúdoDepois de "conectar" os dados ao documento, você está pronto para adicionar elementos do xPressoaos seus documentos estáticos. Se você tiver planejado seu documento com antecedência, devesaber quais áreas são dinâmicas e quais áreas aparecerão estaticamente em toda a saída dodocumento.

Observação

Os grupos e as ocorrências de conteúdo não podem conter comentários HTML no texto. Todosos comentários encontrados no texto serão processados como texto simples. Por exemplo: Mytext aparecerá no documento assim: My text My Comment

Você pode criar grupos e ocorrências de conteúdo usando as funções Create Content Group e AddContent Instance, ou pode usar o Content Group Wizard. Quando você usa o assistente, pode criarum grupo de conteúdo e todas as ocorrências de conteúdo de uma só vez, incluindo a adição doconteúdo e a definição dos critérios. Se você não usar o assistente, precisará executar cada etapaseparadamente. As seções a seguir descrevem as etapas separadas. Para obter informações sobreo Content Group Wizard, consulte Usando o Content Group Wizard.

Grupos de conteúdoUm grupo de conteúdo é um recipiente de conteúdo dinâmico. Cada variação do conteúdo estácontida em uma ocorrência de conteúdo dentro do grupo de conteúdo. Os grupos de conteúdopodem conter uma única ou várias ocorrências de conteúdo. Os grupos de conteúdo de uma únicaocorrência possuem conteúdo que não tem nenhuma variância, mas que pode ser incluído ouexcluído dinamicamente da saída do documento. Você deve ter um grupo de conteúdo para cadaseção dinâmica de seu documento.

Criando um grupo de conteúdoVocê pode criar um grupo de conteúdo "vazio" e, então, adicionar conteúdo, ou pode selecionarconteúdo existente para criar um grupo de conteúdo.

Para criar um grupo de conteúdo vazio:

1. Na exibição de design, coloque o cursor na página do documento onde deseja que o grupode conteúdo comece.

2. Clique em Create Content Group na barra Insert do xPresso. O xPresso for Dreamweaverentão:

• Adiciona um novo item à esquemática com o nome padrão Content Group e adicionauma ocorrência de conteúdo chamada Content Instance no novo grupo de conteúdopara representar o conteúdo selecionado.

• Adiciona uma marca de grupo e de ocorrência do xPresso ao HTML.

• Adiciona marcadores Group Begin e Group End à página.

3. Substitua a expressão Add content here que aparece entre as marcas {G}{I} e {/I}{/G} peloconteúdo. Verifique se o conteúdo está dentro de marcas de início e fim.

22


Para criar um grupo de conteúdo usando conteúdo existente:

1. Selecione o conteúdo que deseja incluir na primeira ocorrência do grupo de conteúdo. Érecomendável selecionar o conteúdo na exibição de código e incluir as marcas de fonte eparágrafo também.

Selecionando conteúdo para ser transformado em um grupo de conteúdo.

2. Clique em Create Content Group na barra Insert do xPresso.

3. O xPresso for Dreamweaver então:

• Adiciona um novo item à esquemática com o nome padrão Content Group e adicionauma ocorrência de conteúdo chamada Content Instance no novo grupo de conteúdopara representar o conteúdo selecionado.

• Adiciona uma marca group e instance do xPresso ao HTML.

• Adiciona marcadores de início e fim de ocorrência e grupo à página.

Seu conteúdo agora é uma ocorrência de conteúdo especificada, contida em um grupo de conteúdo.O grupo de conteúdo deve conter todas as versões diferentes do conteúdo. Só uma ocorrência deconteúdo em um grupo de conteúdo deve aparecer em um documento final. Os critérios colocados nogrupo de conteúdo determinam se o grupo de conteúdo deve ser incluído no documento, e os critérioscolocados em cada ocorrência de conteúdo determinam qual ocorrência aparece na saída. Para obtermais informações sobre critérios, consulte Adicionando critérios ao conteúdo dinâmico.

Copiando um grupo de conteúdoDepois de criar um grupo de conteúdo, você pode copiá-lo para criar outro.

Para copiar um grupo de conteúdo:

1. Selecione o grupo de conteúdo na estrutura.

2. Clique no menu Schematic e selecione Copy Content Group.

3. Coloque o cursor no modelo de documento no local em que deseja que o novo grupo deconteúdo apareça e clique em xPresso Paste na barra de inserção.

23


Ocorrências de conteúdoO xPresso for Dreamweaver adiciona automaticamente uma ocorrência de conteúdo quando vocêcria um grupo de conteúdo. Você pode criar mais ocorrências de conteúdo dentro do grupo deconteúdo para conter versões alternativas do texto.

Criando uma ocorrência de conteúdoAdicione quantas ocorrências de conteúdo forem necessárias a um grupo de conteúdo. Lembre-se deque somente uma ocorrência de um grupo de conteúdo deve aparecer na saída final.

Para criar uma ocorrência de conteúdo:1. Selecione o grupo de conteúdo na esquemática à qual deseja adicionar a ocorrência.2. Clique em Add Content Instance na barra Insert do xPresso.3. O xPresso for Dreamweaver então:

• Adiciona um novo item à esquemática com o nome padrão Content Instance nogrupo de conteúdo.

• Adiciona novas marcas instance ({I} e {/I}) dentro das marcas group no HTML.• Adiciona à página novos marcadores de início e fim. O texto da primeira ocorrência

de conteúdo não aparece mais.4. Substitua o texto "Add content here", na exibição Design ou Code, pelo conteúdo da nova

ocorrência.

Clonando uma ocorrência de conteúdoSe você precisar criar várias ocorrências que, em geral, são idênticas, pode começar com umaocorrência e cloná-la quantas vezes precisar para criar novas ocorrências. Todos os aspectos daocorrência original são preservados nos clones, incluindo as variáveis.

Para clonar uma ocorrência de conteúdo:1. Selecione a ocorrência na esquemática.2. Clique no menu Schematic e selecione Clone Content Instance. Uma nova ocorrência

aparece no grupo de conteúdo com o nomeClone nome da ocorrência original.3. Selecione o novo clone na esquemática e renomeie a ocorrência de conteúdo.4. Clique em Save.

Adicionando critérios ao conteúdo dinâmicoQuando você começa a criar seu conteúdo dinâmico, precisa adicionar os critérios para controlarsua inclusão na saída do documento.

Observação

Será preciso que o esquema de dados esteja carregado no xPresso for Dreamweaver para poderdefinir critérios. Para obter mais informações, consulte Conteúdo do documento.

24


Para cada grupo de conteúdo, você pode especificar critérios de ativação/desativação quedeterminam se o grupo de conteúdo é considerado para inclusão na saída do documento. Alémdisso, você pode definir critérios If-Else ou de alternância para determinar qual item de conteúdo nogrupo de conteúdo aparece na saída.

Os critérios de alternância podem ser usados se houver itens de conteúdo que devem aparecerquando um único campo de dados contiver um valor específico. Por exemplo, você tem conteúdoque é diferente de acordo com a região geográfica em que mora o destinatário. Você pode definiros critérios Switch para esse grupo de conteúdo selecionando o campo, por exemplo, Região, eespecificando os valores que devem acionar cada ocorrência de conteúdo, como sudeste, nordeste,sul etc. Os critérios de alternância são selecionados e definidos no nível do grupo de conteúdo.

Para requisitos de critérios mais complicados, você pode usar os critérios If-Else. Esses critériospermitem criar uma expressão que é usada para determinar quando uma ocorrência de conteúdodeve aparecer. Em sua expressão, você pode usar a lógica booleana e comparar variáveis comcampos ou valores. Você pode definir uma expressão para cada ocorrência de conteúdo dentro dogrupo de conteúdo. Os critérios If-Else são selecionados no nível do grupo de conteúdo, mas oscritérios são definidos no nível da ocorrência de conteúdo.

Observação

Se você excluir a lógica de critérios associada a um item, não poderá desfazer a exclusão.

25


Definindo critérios de ativação/desativaçãoSe houver um grupo de conteúdo que pode não ser usado em todo documento, você poderá ativá-loou desativá-lo para uma saída específica com os critérios de On/Off. Por exemplo, se você tiverconteúdo que só é válido para destinatários no estado da Califórnia, especifique os critérios On/Offpara desativar o grupo de conteúdo, assim, ele não será considerado para inclusão, se o valor doestado nos dados não for igual para a Califórnia.

Para definir critérios de ativação/desativação:

1. Selecione o grupo de conteúdo na estrutura. As informações sobre o grupo de conteúdo sãoexibidas na área de atributos, na parte inferior do painel Schematic.

2. Clique no botão procurar ao lado do campo ON/OFF. A caixa de diálogo On/Off Criteria éexibida. Essa caixa de diálogo permite criar uma expressão que define os critérios para ainclusão de um item.

3. Clique em Add Row e crie a expressão de critérios.

• Para adicionar uma variável: Clique no botão procurar ao lado de Variable paraabrir a caixa de diálogo Select Variable. Selecione a variável que você desejaadicionar na lista e clique em OK.

• Para adicionar um operador: Selecione um operador na lista suspensa Is.

• Para adicionar um valor: clique em Value e digite o valor na caixa de texto.

• Para adicionar um campo: clique em Field e Clique no botão procurar para abrira caixa de diálogo Select Variable. Selecione a variável que você deseja adicionarna lista e clique em OK.

• Clique nos botões (, ), AND e OR para adicionar os operadores apropriados àexpressão.

4. Clique em Insert para adicionar a expressão de critérios à lista.

5. (Opcional) Clique em Clear Row para limpar o conteúdo da linha selecionada ou clique emClear All para desmarcar o conteúdo de todas as linhas na caixa de diálogo.

6. Clique em OK quando terminar de definir a expressão de critérios para retornar ao painelVariable Definition.

7. Clique em Save no painel Variable Definition para adicionar a expressão.

Observação

Se você estiver comparando valores de data, o valor deverá estar no formato AAAA-MM-DD.

Definindo critérios de alternânciaSe você tiver um único campo em seus dados que contém valores usados para controlar a inclusãode conteúdo, você pode especificar critérios de alternância. Os critérios de alternância são umsimples teste de verdadeiro ou falso, o valor coincide e a ocorrência de conteúdo é incluída ou o valornão coincide e a ocorrência não é incluída. Você pode definir uma das ocorrências de conteúdo como

26


a ocorrência padrão, que aparecerá na saída se todas as outras ocorrências não satisfizerem oscritérios. Os critérios de alternância são completamente configurados no nível do grupo de conteúdo.

Apenas os campos de seqüência de caracteres podem conter valores nulos para critérios dealternância. Veja como o xPresso for Dreamweaver resolve os critérios Switch de string:

• Se o valor do campo for nulo:– Mostra a primeira ocorrência com um valor de campo vazio.– Se nenhum valor de campo é vazio, mostra a ocorrência especificada como padrão.– Se não há uma ocorrência padrão, desativa o grupo de conteúdo.

• Se o valor do campo não for nulo:– Mostra a primeira ocorrência cujo valor de campo corresponde ao valor do campo

dos dados.– Se nenhuma ocorrência corresponde, mostra a ocorrência especificada como

padrão.– Se não há uma ocorrência padrão, desativa o grupo de conteúdo.

Para campos que não são de seqüência de caracteres, o valor de campo da ocorrência deconteúdo deve ser do mesmo tipo do valor do campo de dados. Para campos não string, oxPresso for Dreamweaver resolve os critérios switch desta maneira:

• Mostra a primeira ocorrência cujo valor de campo corresponde ao valor do campo dosdados.

• Se nenhuma ocorrência corresponde, mostra a ocorrência especificada como padrão.• Se não há uma ocorrência padrão, desativa o grupo de conteúdo.

Para definir critérios de alternância:1. Selecione o grupo de conteúdo na estrutura. As informações do grupo de conteúdo são

exibidas na área Schematic Attribute do xPresso, na parte inferior do painel Schematic.

2. Selecione Simple Switch na lista suspensa Selection Type.3. Clique no botão procurar ao lado do campo Logic. A caixa de diálogo Switch Condition é

exibida. Essa caixa de diálogo permite selecionar uma variável de campo e definir os valorespara inclusão de cada item de conteúdo.

4. Clique no botão procurar ao lado de Variable. É exibida a caixa de diálogo Variable Definitiondo xPresso.

5. Selecione o campo que você deseja usar para controlar a inclusão deste conteúdo e cliqueem OK.

6. Digite o valor próximo a cada ocorrência de conteúdo que deve aparecer no campo selecionadopara que essa ocorrência de conteúdo seja incluída na saída.

7. (Opcional) Selecione a caixa de seleção à direita da caixa de valor para definir essa ocorrênciade conteúdo como a ocorrência padrão. Você pode definir somente uma ocorrência comoo padrão.

8. Clique em Insert. Repita as etapas 4 a 8 para cada ocorrência.

27


9. Clique em OK.

Definindo critérios If-ElseSe seus critérios precisarem ser mais do que um simples teste de alternância de verdadeiro oufalso, use critérios If-Else e defina uma expressão de condição. Na expressão If-Else, você podeselecionar variáveis a serem comparadas a um valor ou um campo e usar operadores booleanospara combinar instruções de critérios.

Para definir seus critérios:

1. Selecione o grupo de conteúdo na estrutura. As informações do grupo de conteúdo sãoexibidas na área Schematic Attribute do xPresso, na parte inferior do painel Schematic.

2. Selecione Multiple If-Else na lista suspensa Selection Type.

3. Selecione uma ocorrência de conteúdo no grupo de conteúdo para o qual você deseja definircritérios. As informações sobre a ocorrência de conteúdo são exibidas na área SchematicAttribute do xPresso, na parte inferior do painel Schematic.

4. Clique no botão procurar ao lado do campo Logic. A caixa de diálogo If-Else Expression éexibida. A caixa de diálogo If-Else Expression lhe permite criar uma expressão que defina oscritérios para a inclusão de um item.

5. Clique em Add Row e crie a expressão de critérios.

• Para adicionar uma variável: Clique no botão procurar em Variable para abrira caixa de diálogo Variable Definition do xPresso. Selecione a variável que vocêdeseja adicionar na lista e clique em OK.

• Para adicionar um operador: selecione um operador na lista suspensa É: Igual(=), Maior que ou igual a (> =), Menor que ou igual a (<=), Diferente (<>), Menorque (<), Maior que (>).


• Para adicionar um campo: Clique em Field e, em seguida, no botão browse paraabrir a caixa de diálogo Variable Definition do xPresso. Selecione a variável que vocêdeseja adicionar na lista e clique em OK.



7. (Opcional) Clique em Clear Row para limpar o conteúdo da linha selecionada ou clique emClear All para desmarcar o conteúdo de todas as linhas na caixa de diálogo.

8. Clique em OK quando terminar de definir a expressão de critérios para retornar ao painelVariable Definition.

9. Clique em Save no painel Variable Definition para adicionar a expressão.

10. Repita para cada ocorrência de conteúdo no grupo de conteúdo.

28


Observação


Editando critérios existentesSe você precisar fazer alterações em critérios existentes, poderá editar os critérios.

Para editar critérios existentes:

1. Selecione o item na estrutura de xPresso que contém os critérios que deseja editar.

2. Clique no botão procurar próximo ao campo Logic para critérios If-Else ou de alternância ou aocampo On/Off para critérios de ativação/desativação. A caixa de diálogo On/Off Criteria, SwitchCondition ou If-Else Expression é exibida.

3. Faça as alterações na expressão de critérios.

4. Clique em OK.

Usando o Content Group WizardO Content Group Wizard orienta você pelo processo de criação de um grupo de conteúdo e dasocorrências de conteúdo dentro do grupo. Você também pode definir critérios usando o assistente eadicionar conteúdo para cada ocorrência.

Para usar o assistente e criar ocorrências e grupos de conteúdo:

1. Clique em Content Group Wizard na barra Insert. É exibido o Content Group Wizard.

2. Digite o nome do grupo de conteúdo.

3. Escolha o tipo de lógica de seleção que deseja usar com o grupo de conteúdo: Multiple If-Elseou Simple Switch.

4. Digite o número de ocorrências de conteúdo que deseja incluir no grupo.

5. Se selecionou Simple Switch como o tipo lógico, clique em browse ao lado do campo Logic. Acaixa de diálogo Switch Condition é exibida. Defina a lógica de alternância e clique em OK.Para obter mais informações, consulte Definindo critérios de alternância.

6. Se quiser definir critérios de ativação/desativação para controlar a inclusão do grupo deconteúdo na saída, clique em browse ao lado do campo ON/OFF. A caixa de diálogo On/OffCriteria é exibida. Defina os critérios de ativação/desativação e clique em OK. Para obter maisinformações, consulte Definindo critérios de ativação/desativação.

7. Clique em Next. É exibida a página Instance Setup. A aparência dessa página é um poucodiferente dependendo do tipo de seleção lógica escolhido na página anterior.

29


Configuração de ocorrência de Multiple If-ElseSe você escolheu Multiple If-Else para o tipo de lógica de seleção na página anterior, é exibida aseguinte página Instance setup. Se você também definiu critérios if-else múltiplos na página anterior,essa página mostra os critérios definidos para essa ocorrência de conteúdo.

Para definir uma ocorrência de conteúdo:

1. Digite o nome da ocorrência.

2. Se você não definiu critérios if-else múltiplos na página anterior, defina-os agora clicando emAdd Row. Em seguida, crie a expressão de critérios:

• Para adicionar uma variável: Clique no botão procurar em Variable para abrira caixa de diálogo Variable Definition do xPresso. Selecione a variável que vocêdeseja adicionar na lista e clique em OK.

• Para adicionar um operador: selecione um operador na lista suspensa É: Igual(=), Maior que ou igual a (> =), Menor que ou igual a (<=), Diferente (<>), Menorque (<), Maior que (>).


• Para adicionar um campo: Clique em Field e, em seguida, no botão browse paraabrir a caixa de diálogo Variable Definition do xPresso. Selecione a variável que vocêdeseja adicionar na lista e clique em OK.



4. Clique em Next. Será exibida a página Another Instance Setup, na qual você pode adicionar oconteúdo.

Observação


30


Configuração de ocorrência de alternância simplesSe você escolheu Simple Switch para o tipo de lógica de seleção na página anterior, é exibida aseguinte página Instance setup. Se você também definiu critérios de alternância simples na páginaanterior, essa página mostra os critérios definidos para essa ocorrência de conteúdo.

Para definir uma ocorrência de conteúdo:1. Digite o nome da ocorrência.2. Se você não definiu critérios de alternância simples na página anterior, defina-os agora clicando

em browse ao lado do campo Variable.3. Selecione a variável que contém os dados que deseja usar para decidir qual ocorrência de

conteúdo desse grupo de conteúdo é escolhida. Clique em OK.4. Digite o valor da variável que significa a inclusão desta ocorrência específica. Ou clique na

caixa de seleção depois do campo de valor para indicar a ocorrência como o padrão queaparecerá quando nenhuma outra ocorrência se qualificar para inclusão. Clique em Insert.

5. Clique em Next. Será exibida a página Another Instance Setup, na qual você pode adicionar oconteúdo.

Adicionando conteúdo a uma ocorrênciaDepois de definir a ocorrência, você está pronto para adicionar o conteúdo à ocorrência. Você podecopiar e colar o conteúdo, incluindo marcas HTML, na caixa na página. Outros tipos de edição doconteúdo podem ser feitos na exibição Design depois que você concluir o assistente.

Para adicionar conteúdo a uma ocorrência:1. Cole o conteúdo da ocorrência na caixa na página. Ou digite o conteúdo diretamente na caixa.2. Clique em Next. É exibida a página Instance Setup para a próxima ocorrência de conteúdo no

grupo. Repita as etapas anteriores para definir a lógica e o conteúdo de todas as ocorrênciasno grupo. Quando a última ocorrência for definida, clique em Finish. Depois de concluídoo assistente, o novo grupo de conteúdo e as ocorrências serão adicionados às exibiçõesSchematic, Code e Design.

Loops de conteúdoSe você tiver informações nos seus dados nas quais deseja circular para criar conteúdo nodocumento, poderá adicionar um loop de conteúdo no xPresso for Dreamweaver. Um loop deconteúdo permite selecionar um intervalo de texto e variáveis, e fazer esse conteúdo ser repetidono documento com o novo conteúdo de variável enquanto o xPresso for Dreamweaver circula pelosdados. Por exemplo, talvez você queira criar uma lista variável de itens no documento. Se criarum loop de conteúdo que contém uma lista da lista com os dados variáveis nela, o xPresso forDreamweaver circulará nos dados e criará quantas linhas forem necessárias para completar a lista.

Você pode aninhar vários loops de conteúdo entre si; no entanto, um loop aninhado não pode serassociado ao elemento pai do elemento associado ao loop externo. Por exemplo, se os dados tiveremo "Elemento pai 1", com um elemento filho "Filho 1", não será possível aninhar um loop associado ao"Elemento pai 1" em um loop associado ao "Filho 1".

31


Também é possível adicionar um loop de conteúdo a linhas de tabela para preenchê-las. Para obtermais informações, consulte Criando uma tabela dinâmica usando loops de conteúdo.

Criando um loop de conteúdoVocê pode usar um loop de conteúdo para repetir um trecho do conteúdo (texto ou variáveis) nodocumento.

Para criar um loop de conteúdo:1. Crie um array contendo todas as variáveis que você deseja incluir no loop de conteúdo. Para

obter mais informações, consulte Criando arrays.

2. Coloque o cursor na página do documento em que deseja que o conteúdo em loop apareça.3. Clique em Add Content Loop. É exibida a caixa de diálogo Variable Definition do xPresso.4. Selecione o array que deseja usar para criar o loop de conteúdo e clique em OK. O loop de

conteúdo aparece na esquemática e os marcadores de loop de conteúdo aparecem na páginado documento.

5. Coloque o cursor entre os marcadores {L} e {/L} e adicione o conteúdo do loop.6. Para testar o loop de conteúdo, aplique alguns dados. Clique no menu Variable Definition e

selecione Apply Variable Data. Selecione um arquivo de dados e clique em Load. Depois deaplicar os dados, o loop deve criar quantas linhas de texto forem necessárias para o registrode dados.

Copiando um loop de conteúdoVocê pode copiar um loop de conteúdo para criar outro loop com os mesmos atributos e o mesmoconteúdo.

Para copiar um loop de conteúdo:

1. Selecione o loop de conteúdo na esquemática.2. Clique no menu Schematic e selecione Copy Loop Variable.3. Coloque o cursor na página no ponto em que deseja que o novo loop apareça e clique em

xPresso Paste na barra de inserção. O novo loop aparece na página e na esquemática.

Tabelas dinâmicasTabelas dinâmicas são um excelente modo visual de incluir informações em um documento, em umformato fácil de ler. Elas aumentam e diminuem de acordo com a quantidade de dados a seremexibidos e têm um número diferente de linhas para cada registro dos dados. Há duas maneirasde incluir uma tabela dinâmica no documento:

• Usar um array para criar uma variável de tabela.• Criar uma tabela estática no Dreamweaver e aplicar loops de conteúdo às linhas.

Usar uma variável de tabela é um modo simples e eficaz de adicionar uma tabela a um documento. Éconveniente usar variáveis de tabela quando a estrutura de dados corresponde estritamente às linhas

32


e às colunas que você deseja inserir na tabela. Todos os valores dos dados de variáveis aparecem natabela. Todos os dados da variável de tabela devem vir do mesmo campo de dados pai.

Para ter mais controle sobre o formato e o fluxo do conteúdo, você deve criar uma tabela noDreamweaver e, depois, atribuir loops de conteúdo às linhas para preencher a tabela. Você podeescolher quais campos serão inseridos em quais colunas ou linhas (uma vez que você pode efetuarloop em várias linhas). Você também pode incluir dados que podem não estar no mesmo campode dados pai da mesma tabela, pois é possível criar vários loops em uma tabela. De certo modo,isso lhe permite mapear campos que podem estar em uma ordem diferente e em linhas diferentesem uma estrutura de tabela para publicação.

Para obter mais informações sobre como criar variáveis de tabela, consulte Trabalhando comarrays. Para obter mais informações sobre como criar uma tabela dinâmica usando uma tabela doDreamweaver e loops de conteúdo, continue lendo.

Criando uma tabela dinâmica usando loops de conteúdoA primeira etapa na criação de uma tabela dinâmica usando loops de conteúdo é adicionar umatabela ao documento usando a funcionalidade de tabela do Dreamweaver. Quando a tabela estiverposicionada no local correto na página do documento, você poderá começar a adicionar à tabelaas variáveis que preencherão as células da tabela com dados. Em seguida, você pode selecionaruma ou várias linhas e atribuir um loop de conteúdo. Um loop de conteúdo pode ter várias linhase a tabela pode ter vários loops de conteúdo.

Para criar uma tabela dinâmica com loops de conteúdo:

1. Insira uma tabela no documento usando o comando Insert Table no menu Table doDreamweaver. A caixa de diálogo Insert Table é exibida.

2. Selecione o número de linhas do corpo que são necessárias para criar um ou mais loops. Nãoé preciso ter muitas linhas na tabela para acomodar os dados gerados, pois o xPresso forDreamweaver adicionará as linhas necessárias para todos os dados. Selecione o número decolunas e de linhas de cabeçalho e de rodapé.

3. Coloque o cursor na primeira célula da terceira linha e clique em Insert Text Variable.

4. Insira variáveis do painel Variable Definition nas células apropriadas na tabela.

5. Adicione os cabeçalhos de coluna e todos os rodapés necessários à tabela. Depois de disporos cabeçalhos e o conteúdo variável na tabela, você está pronto para criar o loop ou os loopsde conteúdo da tabela.

6. Selecione a linha, ou várias linhas, que deseja incluir no loop

7. Clique em Add Content Loop e selecione o array de variável que deseja associar ao loop.

8. Alterne para a exibição Code e observe que o xPresso adicionou uma marca loop dentro damarca de tabela HTML. Consulte o exemplo de código a seguir.

9. Aplique alguns dados à tabela para testá-la. Clique no menu Variable Definition e selecioneApply Variable Data. Selecione um arquivo de dados e clique em Load. A tabela deverá serexpandida e preenchida com os dados do arquivo de dados.

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

33


<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">{LoopBegin}<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 essa tabela com o tipo de tabela criada a partir de um array e você poderá ver o nível deflexibilidade que um loop de conteúdo do xPresso pode oferecer.

Adicionando conteúdo externo ao documentoVocê pode incluir um arquivo HTML externo ao documento do xPresso for Dreamweaver. Essearquivo pode conter informações que você precisa incluir em vários documentos e não quer ter querepetir sempre que incluí-las, por exemplo, uma política de privacidade. O conteúdo do arquivo serácolocado no documento no local designado durante a publicação.

Observação

Um arquivo incluído como um arquivo externo em um documento não pode conter uma referência aum arquivo externo; portanto, você não pode aninhar arquivos externos.

É possível mapear as variáveis que aparecem no arquivo de conteúdo externo para variáveis noarquivo mestre, de modo que as variáveis sejam resolvidas corretamente quando você publicar odocumento. Também é fácil editar o conteúdo externo no xPresso for Dreamweaver se você precisarfazer alterações nele antes de usar o documento.

34


Para incluir conteúdo de um arquivo externo:

1. Coloque o cursor no documento no ponto em que deseja que o conteúdo externo seja inserido.

2. Clique em Insert External Content Variable na barra Insert do xPresso.

3. Procure e selecione o arquivo HTML que deseja inserir no arquivo mestre e clique em Open. Avariável de conteúdo externo aparece no documento e também na esquemática.

4. Selecione a variável na esquemática. Os atributos da variável aparecem na parte inferiordo painel Schematic.

5. Clique em Variable Mapping. É exibida a caixa de diálogo External Content Mapping. Paraque as variáveis sejam resolvidas corretamente no conteúdo externo, você precisa mapear assuas variáveis para aquelas contidas no documento mestre.

6. Selecione uma variável na lista External Content Variables e, na lista Master DocumentVariables, escolha a variável para a qual deseja mapeá-la. Todas as variáveis correspondentesque aparecem nos dois documentos são mapeadas automaticamente.

7. Clique em Map. O mapeamento da variável aparece na caixa na parte inferior na caixa dediálogo.

8. Repita as etapas 6 e 7 até que tenha mapeado todas as variáveis no conteúdo externo avariáveis no documento mestre. Clique em OK.

9. (Opcional) Clique em Edit External Content para abrir o arquivo HTML de conteúdo externono xPresso for Dreamweaver para fazer alterações nele. Altere-e o salve as alterações e,em seguida, feche o documento.

Para testar a variável de conteúdo externo, visualize o documento. O conteúdo externo deve serincluído no local em que você o inseriu e todas as variáveis devem ser resolvidas corretamente.

Copiando conteúdo externoVocê pode copiar conteúdo externo já existente no documento para adicionar com facilidade oconteúdo, ou conteúdo semelhante se editá-lo, em outros lugares.

Para copiar conteúdo externo:

1. Selecione a variável de conteúdo externo na esquemática.

2. Clique no menu Schematic e selecione Copy External Content.

3. Coloque o cursor no modelo de documento no local em que deseja que a nova variável deconteúdo externo seja inserida e clique em xPresso Paste na barra de inserção. A variávelaparece no modelo na posição do cursor e também na esquemática.

Trabalhando com o DocumentumO xPresso for Dreamweaver permite interagir com seu sistema Documentum existente. Se vocêusa o Documentum para armazenar documentos, pode salvar e abrir arquivos HTML em váriosDocumentum Docbases usando a interface do xPresso for Dreamweaver.

35


Adicionando um servidor DocumentumAntes de conectar-se a um servidor Documentum usando o xPresso for Dreamweaver, você deveprimeiro adicioná-lo à lista de servidores disponíveis. Talvez você precise entrar em contato com oadministrador do sistema para obter as informações do servidor, a fim de definir a conexão.

Para adicionar um servidor:

1. No menu xPresso, selecione Open From, Save ou Save As. Se nenhum servidor estiverdefinido, as caixas de diálogo do servidor Documentum aparecerão vazias.

2. Clique em Server. A caixa de diálogo Documentum Server lista o nome e o endereço decada servidor definido no momento.

3. Clique em Add. A caixa de diálogo Add Server é exibida e permite que você defina aspropriedades do novo servidor Documentum que está adicionando.

4. Digite a URL do host, o Nome de usuário e a Senha do novo servidor. Em seguida, digite asenha novamente para confirmá-la. Talvez você precise entrar em contato com o administradordo sistema para obter essas informações. A URL do host deve ter o seguinte formato:

http://<host>:<porta>/<servlet>/<contexto>/<docbase:>/

Em que:

• host é o endereço IP ou o nome do host do servidor Documentum intermediário.

• port é a porta http do servidor Documentum.

• servlet é o nome do servlet do serviço webdav do Documentum. O valor padrão é"dmwebdav".

• context é o nome de conteúdo do Documentum. O valor padrão é "files".

• docbase é o nome do banco de documentos Documentum, que diferencia maiúsculasde minúsculas. Os caracteres :/ devem seguir o nome do banco de documentos enão podem ser omitidos.

Por exemplo:

http://documentum:8080/dmwebdav/files/xPressoDocBase:/

5. Clique em OK. Agora o servidor aparece na lista Current Server.

36


Abrindo um arquivo HTML no DocumentumVocê usar o xPresso for Dreamweaver para abrir um arquivo HTML armazenado no momento nosistema Documentum.

Para abrir um arquivo HTML armazenado no Documentum:

1. No menu xPresso, selecione Open From. É exibida a caixa de diálogo Document Server.

2. Selecione um servidor na lista Current Server. Se o servidor não estiver listado, consulteAdicionando um servidor Documentum. O xPresso for Dreamweaver conecta-se com o sistemaDocumentum e retorna uma lista de arquivos localizados no diretório especificado.

3. Para ajustar o tipo de arquivo exibido, selecione um tipo de arquivo na lista suspensa Files oftype.

4. Digite ou selecione o nome do arquivo HTML que deseja abrir.

5. Clique em Open. O xPresso for Dreamweaver abre o arquivo do Documentum na máquina local.Quando terminar de trabalhar no documento, você pode selecionar Save ou Save As no menuxPresso para salvar o arquivo novamente no Documentum. Para obter mais informações, consulte .

Observação

Se você fechar um arquivo aberto no Documentum sem salvar as alterações antes, será exibida umamensagem solicitando que as alterações sejam salvas. Se clicar em Sim na mensagem, o arquivoserá salvo em uma pasta na máquina local, não no Documentum Docbase. Para salvar o arquivonovamente no Documentum, use a função Salvar ou Salvar como.

Salvando um arquivo HTML no DocumentumHá duas maneiras de salvar um arquivo HTML no sistema Documentum existente: Salvar e Salvarcomo. A função Save salva um arquivo aberto no Documentum novamente no Documentum. Afunção Save As salva o arquivo como um novo arquivo no Documentum.

Para salvar um arquivo HTML no Documentum:

1. Abra o arquivo.

2. No menu xPresso, selecione Save ou Save As. É exibida a caixa de diálogo DocumentumServer.

3. Selecione um servidor na lista Current Server. Se o servidor desejado não estiver nalista, consulte Adicionando um servidor Documentum. O xPresso se conectará ao sistemaDocumentum e retornará uma lista dos arquivos localizados no diretório especificado.

4. (Somente Salvar como) Digite o nome que você deseja usar para o arquivo ao salvá-lo noDocumentum.

5. Clique em Save. O xPresso for Dreamweaver salva o documento no sistema Documentum.

37


Inserindo um arquivo HTML externo do DocumentumVocê pode inserir um arquivo HTML externo armazenado no sistema Documentum no documentodo xPresso for Dreamweaver usando a opção Place from, no menu xPresso. Essa operação ésemelhante ao uso da função Insert External Content Variable na barra Insert do xPresso. Vocêpode usar essa função para inserir conteúdo compartilhado no documento, como uma política deprivacidade.

Para inserir um arquivo HTML do Documentum:

1. Abra o arquivo no qual deseja inserir o arquivo e coloque o cursor na localização correta.

2. No menu xPresso, selecione Place from. É exibida a caixa de diálogo Documentum Server.

3. Selecione um servidor na lista Current Server. Se o servidor desejado não estiver nalista, consulte Adicionando um servidor Documentum. O xPresso se conectará ao sistemaDocumentum e retornará uma lista dos arquivos localizados no diretório especificado.

4. Selecione o arquivo que deseja inserir no documento.

5. Clique em Place. O xPresso for Dreamweaver coloca o arquivo no documento.

38

Usando variáveis 4Usando variáveis

A adição de variáveis e arrays de variável ao seu documento permite que você controle o conteúdo,as tabelas e as imagens que são incluídos na saída criada. Essa flexibilidade permite que vocêpersonalize cada documento para o destinatário pretendido. Você pode otimizar sua mensagem paraincluir apenas informações pertinentes para a pessoa específica que recebe o documento.

Noções básicas sobre variáveisAs variáveis são criadas e armazenadas no painel Variable Definition. O painel Variable Definitionfunciona com o painel Data Schema e permite criar e definir variáveis de texto e imagem, e arrays parauso no documento. Os arrays podem ser usados ao criar variáveis de tabela e loops de conteúdo.

• As variáveis inserem texto ou imagens externas específicos na saída final.• Os arrays levam aos loops de conteúdo e às tabelas de inserção na saída final que contêm

informações específicas do destinatário.

Para variáveis de texto, o xPresso for Dreamweaver também permite que você formate a variável, oque dá controle sobre o modo como ela aparece na saída.

Você pode criar uma variável do nada e incluir funções e expressões para calcular o valor da variável.Se preferir, você pode usar um campo de dados de seu esquema para fornecer o valor da variável.Também é possível arrastar campos do painel Data Schema até o painel Variable Definition ou usar omenu Variable Definition para criar variáveis usando campos de dados.

Para usar uma variável no documento, é necessário primeiro criá-la, defini-la e depois inseri-lano documento.

Importando definições de variáveisVocê pode importar definições de variáveis no documento do xPresso for Dreamweaver que foiexportado de outro documento do xPresso. As definições podem ser de um documento do xPresso forAdobe InDesign, do xPresso para Dreamweaver ou do xPresso para Word. Isto permite compartilhardefinições de variáveis entre documentos e economiza o tempo necessário para recriar variáveisgeralmente usadas em cada novo documento.

Para importar definições de variáveis

1. Clique no menu Variable Definition e selecione Import Variable Definitions.

2. Localize e selecione o arquivo XML de exportação que contém as definições de variáveis quevocê deseja importar e clique em Open. Se o seu documento contiver uma variável com

39

Capítulo 4 — Usando variáveis

o mesmo nome de uma variável que está sendo importada, a caixa de mensagem Importarvariável aparecerá.

3. Selecione como você deseja lidar com este nome de variável duplicado específico, ou com todosos nomes duplicados, e clique em Continue Import. Se preferir, clique em Cancel Import.

Se seu documento usar o mesmo esquema do documento do qual as definições foram exportadas,essas definições serão mapeadas automaticamente para os dados do documento. Se os documentosusarem arquivos de esquema diferentes, você poderá mapear as definições manualmente quandoforem importadas.

Opções de importação de variáveisA caixa de mensagem Importar variável contém as seguintes opções.

Opção DescriçãoManter a variávelexistente nodocumento

Selecione esta opção para manter a variável existente no documento e nãosubstituí-la pela variável no arquivo que tem o mesmo nome. Clique emContinue Import. Se outro nome de variável duplicado for encontrado, a caixade mensagem aparecerá novamente.

Manter todasas variáveisexistentes nodocumento

Selecione esta opção para manter todas as variáveis existentes no documentoe não substituí-las por variáveis no arquivo que tem o mesmo nome. Cliqueem Continue Import. O xPresso for Dreamweaver não avisará novamentese encontrar outro nome de variável duplicado; ele usará esta opção paraprocessá-lo.

Usar a variável doarquivo

Selecione esta opção para importar a variável duplicada do arquivo e substituira variável existente no documento. Clique em Continue Import. Se outronome de variável duplicado for encontrado, a caixa de mensagem apareceránovamente.

Usar todas asvariáveis doarquivo

Selecione esta opção para importar todas as variáveis duplicadas do arquivoe substituir todas as variáveis existentes com nomes duplicados. Cliqueem Continue Import. O xPresso for Dreamweaver não avisará novamentese encontrar outro nome de variável duplicado; ele usará esta opção paraprocessá-lo.

Continuarimportação

Clique em Continue Import para usar a opção selecionada e continuar oprocesso de importação.

Cancelarimportação

Clique em Cancel importação para parar o processo de importação e nãoimportar mais nenhuma variável. Todas as variáveis importadas antes de vocêclicar no botão permanecerão no documento.

40


Exportando definições de variáveisVocê pode exportar as definições de variáveis que estão configuradas atualmente em um documento,para que elas possam ser usadas em outros documentos do xPresso for Adobe InDesign, do xPressofor Dreamweaver e do xPresso for Word. O processo de exportação cria um arquivo XML que poderáser importado depois para outro documento.

Para exportar as definições de variáveis:

1. Clique no menu Variable Definition e selecione Export Variable Definitions.

2. Procure o local onde você deseja armazenar o arquivo de exportação e digite um nome parao arquivo.

3. Clique em Save.

Copiando variáveisDepois de criar uma variável de texto, imagem ou hiperlink, você pode copiá-la para criar diversasvariáveis idênticas.

Para copiar uma variável:

1. Selecione a variável na esquemática.

2. Clique no menu Schematic e selecione Copy Type Variable.

3. Coloque o cursor no modelo de documento no local em que deseja que a nova variável sejacolocada e clique em xPresso Paste na barra de inserção. A nova variável aparece no modelona posição do cursor e na esquemática.

Trabalhando com variáveisAs variáveis são criadas no painel Variable Definition e podem ser baseadas em texto ou imagem.Variáveis de texto são usadas para inserir informações pessoais, como o nome e o endereço dodestinatário, em um documento.

As variáveis de texto podem ser Numeric (Float, Double, Boolean, Integer), Data, Time, DateTime ouString. Os campos Date, Time e DateTime devem aparecer nos dados em um determinado formato:

• Data: aaaa-mm-dd (por exemplo: 2003-05-19)• Hora: hh:mm:ss (por exemplo: 11:22:50)• Data e hora: aaaa-mm-ddThh:mm:ss (por exemplo: 2002-01-05T03:15:30)

Observação

Se o tipo de dados da variável for numérico, seu valor não poderá ser nulo. Se você tentar aplicardados ao documento que contenham um valor nulo para uma variável de tipo numérico, o xPresso forDreamweaver gerará um erro.

As imagens usadas em e-mails com gráficos em geral são armazenadas em um local em um servidorda Web. As variáveis de imagem, que podem diferir em função dos dados, permitem que você

41


inclua uma imagem externa em um documento. Se os dados contiverem o nome e o caminho daimagem, a variável de imagem receberá a imagem do caminho definido nos dados e a colocará napágina do documento.

Criando variáveisExistem duas maneiras de criar variáveis de texto e de imagem. Você pode usar um campo de dadosdo esquema como ponto de partida para a variável ou criar uma variável:

• Se você deseja usar um campo de dados pai em seu esquema como ponto de partida,selecione o campo no painel Data Schema, clique no menu Variable Definition e selecioneDefine Variable from Schema. Se você estiver criando uma variável de imagem, verifiquese o campo selecionado contém as informações de caminho da imagem. A variávelaparece no painel Variable Definition com o mesmo nome que o campo de dados.

• Se você quiser criar uma variável desde o início, clique no menu Variable Definition eselecione Define Variable. Na parte inferior do painel Variable Definition, aparece umavariável chamada "New Variable". Você definirá o conteúdo da variável na próxima etapa.

Observação

Se você selecionar um campo de dados no painel Data Schema e, depois, selecionar uma área embranco do painel para "limpar" a seleção, o painel considerará o campo selecionado até que vocêselecione outro campo. Verifique se selecionou o campo correto no painel Data Schema antes decriar uma variável no painel Variable Definition.

42


Definindo atributos de variáveisDepois de criar a variável de texto ou imagem no painel Variable Definition, você pode usar a área depropriedades da variável na parte inferior do painel para definir os atributos da variável.

Para definir uma variável:

1. Selecione a variável no painel Variable Definition. As informações da variável aparecem naárea de propriedades de variáveis.

2. Digite um nome para a variável no campo Name, se necessário.

3. Selecione o tipo de valor para a variável na lista suspensa.

4. Selecione o tipo de mapeamento para a variável: Campo de esquema ou Expressão.

5. Clique no botão procurar ao lado do campo Mapping. Se você selecionou Schema Field naetapa 4, será exibida a caixa de diálogo Select Schema Field. Selecione o esquema de dadosque deseja usar para preencher a variável e clique em OK. Vá para a etapa 7.

Se você selecionou Expression na etapa 4, será exibida a caixa de diálogo Variable Expression.

6. Digite a expressão na caixa localizada na parte superior da caixa de diálogo. Para ajudar acriar uma expressão, você pode:

• Selecionar um tipo de função para ver as funções disponíveis. Clique em uma funçãona lista para ver uma descrição dela na caixa localizada na parte inferior da caixa dediálogo. Clique duas vezes em uma função da lista para que ela apareça na caixa deexpressão, onde você poderá editá-la.

• Clique em Select Variable a fim de selecionar uma variável para usar na expressão.

• Clique em Verify para conferir se a expressão é válida.

7. Quando terminar de criar a expressão, clique em OK. Para obter mais informações, consulteCriando expressões de variáveis.

Observação

(1) Depois de usar uma variável no documento ou em critérios, você não pode alterar o nomeda variável. (2) Não há suporte para a formatação de números alemã em uma variável do tipoExpression. Por exemplo, um número formatado como 1,000.00 não é aceito; é necessário formatá-locomo 1.000,00.

43


Inserindo variáveis de texto em um documentoPara colocar uma variável de texto do painel Variable Definition no documento, use o botão InsertText Variable na barra de inserção do xPresso. A variável aparece na página na posição do cursore também aparece na Esquemática.

Para inserir uma variável de texto:

1. Coloque o cursor no local onde você deseja que a variável apareça na página do documento.

2. Clique em Insert Texto Variable.

3. Selecione a variável no painel Variable Definition e clique em OK.

4. A variável aparece na esquemática na pasta de variáveis globais e na página do documentona posição do cursor.

Formatando variáveis de textoVocê pode formatar as variáveis de texto para controlar como elas aparecem na saída. Por exemplo,é possível exibir uma variável Date na saída como 01/05/2002, adicionar um separador de milhar ouum símbolo de moeda à saída da variável Numeric ou exibir uma variável String na saída com todosos caracteres em letras maiúsculas, não importa como a string for digitada.

Data, Hora ou Data e horaPara formatar uma variável Date, Time ou DateTime:

1. Selecione a variável na esquemática. As informações da variável são exibidas na área deatributos Schematic na parte inferior do painel.

2. Clique no botão procurar ao lado do campo Format. A caixa de diálogo Date & Time Formattingé exibida. As opções disponíveis variam em função do tipo da variável selecionada.

3. Selecione uma localidade na lista suspensa. As opções exibidas nas listas suspensas DateFormat and Time Format mudam de acordo com a seleção feita.

4. (Data ou Data e hora) Selecione um formato na lista suspensa Date Format. Por exemplo, sevocê selecionar aaaa-MM-dd, 05-19-2003 aparecerá como 2003-05-19 na saída.

5. (Hora ou Data e hora) Selecione um formato na lista suspensa Time Format. Por exemplo, sevocê selecionar h:mm a, 12:00:09 aparecerá como 12:00 PM na saída.

6. Clique em OK.

Observação

Se você alterar a configuração de fuso horário no seu computador, será preciso reinicializá-lo paraque a alteração apareça nas variáveis Time ou DateTime.

NuméricoPara formatar uma variável Numeric:


44


2. Clique no botão procurar ao lado do campo Format. A caixa de diálogo Number Formattingé exibida.

3. Marque a caixa de seleção Usar separador de milhar (.) para incluir um ponto como umseparador de milhares na saída variável. Por exemplo, 5000 aparece como 5.000.

4. Marque a caixa de seleção Usar porcentagem (%) para exibir a variável numérica como umaporcentagem na saída. Por exemplo, 5000 aparece como 500000%.

5. Digite o número de casas decimais para exibir a variável numérica com casas decimais. Porexemplo, se você digitar 3, 5000 aparecerá como 5000.000.

6. Selecione um símbolo de moeda na lista suspensa para exibir a variável como moeda nasaída. Por exemplo, se você selecionar o $ americano (Estados Unidos), 5000 aparecerãocomo $5000.

7. Clique em OK.

StringPara formatar uma variável String:


2. Clique no botão procurar ao lado do campo Format. A caixa de diálogo String Formattingé exibida.

3. Selecione o formato nas seguintes opções:

• MAIÚSCULAS: ’Nome do agente’ aparece como ’NOME DO AGENTE’.

• minúsculas: ’Nome do agente’ aparece como ’nome do agente’.

• Maiúsculas/minúsculas no título: ’Nome do agente’ aparece como ’Nome doAgente’.

• Nenhum: ’Nome do agente’ aparece como ’Nome do agente’ (sem alteração).

4. Clique em OK.

45


Inserindo variáveis de imagem em um documentoPara obter uma variável de imagem do painel Variable Definition para seu documento, você usaráo botão Insert Image Variable na barra de inserção do xPresso.

Para inserir uma variável de imagem:

1. Coloque o cursor no local onde você deseja que a variável apareça na página do documento.

2. Clique em Insert Image Variable.

3. Clique no botão procurar e selecione a variável que deseja associar à variável de imagem.

4. Clique em OK. A variável é exibida no campo Link.

5. Clique em OK. Um ícone de espaço reservado da imagem aparece na página e o códigosemelhante ao seguinte é inserido no HTML.<xPresso type="text" id="52020443193" name="LEVEL" variable="LEVEL"><imgsrc="http://localhost:8080/{LEVEL}.jpg" width=129 height=77 hspace=20vspace=10 align=absmiddle alt="Level">

Criando expressões de variáveisAo criar uma variável ou um item de array, você terá a opção de selecionar um campo de dadosexistente ou definir uma expressão a ser associada a ele. Ter a opção de definir uma expressãosignifica que você pode fazer com que a variável represente muito mais do que apenas um campo dedados. Você pode comparar campos de dados, fazer cálculos e usar funções para que o resultadoapareça na saída do documento. Isso lhe proporciona muita flexibilidade.

Todas as expressões são criadas na caixa de diálogo Variable Expression, que pode ser acessadaao selecionar Expression para o Mapping Type da variável e depois clicar no botão browse aolado de Mapping na área de atributos da variável. A caixa de diálogo Variable Expression contémferramentas e opções que ajudam você a construir uma expressão para uma variável.

A caixa na parte superior é onde você constrói a expressão. Você pode incluir campos de esquemase funções na expressão e usar os seguintes operadores booleanos: > (maior do que), < (menor doque), >= (maior do que ou igual a), <= (menor do que ou igual a), e != (diferente de). As expressõesdevem ser definidas em um dos seguintes formatos:

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

Ou você pode inserir verdadeiro ou falso como um valor booleano.

O exemplo a seguir não é válido: (3-2)!=(5-8)

Se a expressão não for maior do que o espaço da primeira linha da caixa de expressão variável, aexpressão não quebrará para a próxima linha e você não poderá ver a parte da expressão que seajusta à primeira linha. A expressão será processada por inteiro.

Você também pode executar os seguintes cálculos na expressão:

46


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

Observação(1) A formatação alemã de números não é aceita em uma expressão de variável. Por exemplo, umnúmero formatado como 1,000.00 não é aceito; é necessário formatá-lo como 1.000,00. (2) Digite um"f" junto com qualquer valor flutuante que você esteja usando em um cálculo. Por exemplo:

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

VariáveisPara incluir uma variável em sua expressão, clique em Select Variable e selecione o campo da caixade diálogo Variable Definition do xPresso. A variável selecionada aparece na caixa com este formato:

$DataPath:FieldName$

Você poderá adicionar um operador, se desejar. Por exemplo, para criar uma variável chamada"TotalAmountDue", poderíamos especificar:$Pay:BalanceForward$+$Pay:AmtDue$Os arrays usados em definições de variáveis não podem estar aninhados.

FunçõesPara incluir uma função em uma expressão, primeiro clique em um botão de opção para ver asfunções que estão disponíveis: Number Functions, Logic Functions, Group Functions, StringFunctions ou Datetime Functions. Você pode clicar em uma função da lista para ver uma descriçãodela na parte inferior da caixa de diálogo. Clique duas vezes em uma função da lista e ela aparecerána caixa de expressão, onde você poderá editá-la. Por exemplo:

addDay( datetime_or_date_value , numeric_value )

Selecione cada argumento e substitua-o selecionando um campo de esquema ou digitando um valor.Por exemplo, para criar uma variável chamada "DatePastDue", poderíamos especificar:addDay($GenlInfo:DateDue$, 7)Para obter mais informações sobre as funções individuais disponíveis, consulte Funções deexpressão.

47


Instruções If/ElseVocê pode usar a lógica if/else em expressões de variáveis para formar instruções mais complexas.Os seguintes formatos de instruções são aceitos:

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 exemplo: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";

Verificando uma expressãoDepois de concluir a expressão, você deverá verificá-la para se certificar de que funcionará e de queé uma expressão válida. Para verificar uma expressão, clique em Verify. Uma mensagem apareceráabaixo da caixa de expressão na caixa de diálogo para informar os resultados da verificação.

Criando uma variável de endereço de remetente/destinatário amigávelAo enviar e-mails para clientes, você pode usar um endereço "amigável" de remetente ou destinatário,como Bob Smith ([email protected]) ou Document Sciences Corp ([email protected]). Vocêpode usar a variável de expressão para criar a variável de endereço de/para amigável. Você precisarádefinir a variável como uma propriedade de documento, de forma que também possa ser usada emxAdmin como uma variável de saída e depois especificada como um parâmetro de e-mail ao criar operfil de e-mail. Para obter mais informações, consulte Trabalhando com propriedades do documento.

Você pode usar parênteses (()) ou colchetes ([]) para incluir o endereço de e-mail real do seuendereço de ou para amigável. Não há suporte para colchetes angulares (<>).

Os seguintes são exemplos de expressões que produzem endereços de ou para amigáveis:

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

Bob Smith ([email protected])"Document Sciences Corp ([email protected])"Document Sciences Corp ([email protected])$ORGANIZATION:NAME$+" "+"("+$ORGANIZATION:EMAIL$+")"Objectiva Software Solutions ([email protected])

Você também pode usar variáveis de expressão para criar uma linha de assunto "amigável"combinando uma variável com texto estático. Por exemplo:$FIRST_NAME$+","+" "+"Your Statement is Ready"Bob, sua proposta está pronta

48


Trabalhando com propriedades do documentoVocê pode associar uma variável existente a uma propriedade do documento no documento, quepode ser definida posteriormente como uma variável de saída no servidor xPression WorkgroupEdition. Verifique se as variáveis que associadas a uma propriedade de documento resolvemvalores exclusivos para cada registro no arquivo de dados. Se um valor não for exclusivo e forusado em uma convenção de nomenclatura de arquivo de saída, você corre o risco de criar nomesde arquivo duplicados, o que gerará um erro. Além disso, verifique se o valor não inclui nenhumdestes caracteres: \, /, :, *, ?, ", <, >, |.

As propriedade de documento são armazenada e definida no painel Document Property. Você podetornar o painel Document Property visível ao selecionar Document Property do menu xPresso.

Você pode importar propriedade de documento no seu documento que foram definidas em outrosdocumentos do xPresso clicando no menu Document Property e selecionando Import DocumentProperties. As propriedades de documento podem ser provenientes de documentos do xPresso forAdobe InDesign, do xPresso for Dreamweaver ou do XPresso for Word 2007.

Criando uma propriedade de documentoPara definir uma variável como uma propriedade de documento:

1. Selecione a variável que você deseja definir como uma propriedade de documento no painelVariable Definition.

2. Clique no menu Document Property e selecione Add Document Property. A variável apareceno painel Document Properties.

3. (Opcional) Renomeie a propriedade de documento na área Atributos, localizada na parteinferior do painel. O nome pode conter apenas caracteres do alfabeto inglês. Para obter maisinformações, consulte Opções de atributos de propriedades de documento.

Uma vez definida, a propriedade do documento estará disponível no xPression Workgroup EditionServer para ser usada na definição de uma variável de saída, em expressões e nos modelos denomenclatura de arquivo associados a este documento.

Opções de atributos de propriedades de documentoVocê pode definir as opções de atributos a seguir no painel Document Properties para umapropriedade selecionada do documento.

Atributo DescriçãoNome Digite um outro nome para a propriedade de documento. Os nomes de

propriedades de documento devem conter pelo menos uma letra e todos oscaracteres devem ser letras, números ou sublinhados (_). Espaços não sãopermitidos. O nome deve ter no máximo 50 caracteres e só pode contercaracteres que façam parte do idioma inglês.

Para usar a propriedade no xAdmin, você precisará criar uma variável desaída com exatamente o mesmo nome. Para exibir uma lista das propriedadesde um documento, clique no nome do documento na lista de documentos

49


Atributo Descriçãoda categoria no xAdmin. Para obter mais informações, consulte o Guia doUsuário do xAdmin Workgroup Edition.

Referência Clique no botão procurar para abrir a caixa de diálogo Variable Definitiondo xPresso. Selecione uma nova variável para associar à propriedade dedocumento e clique em OK.

Tipo de variável Exibe o tipo de variável associado à propriedade de documento no momento.Esse campo é somente leitura.

Importando propriedades de documentoVocê pode importar propriedade de documento em seu documento do xPresso for Dreamweaverque foi exportado de outro documento xPresso. As propriedades podem vir de um documentodo xPresso for Adobe InDesign, do xPresso for Dreamweaver ou do xPresso for Word. Isso lhepermite compartilhar propriedades de documento entre documentos e elimina o esforço de recriarpropriedades comumente usadas em cada novo documento.

Para importar propriedades de documento:

1. Clique no menu Document Propertye selecione Import Document Properties.

2. Localize e selecione o arquivo XML de exportação que contém as propriedades de documentoque você deseja importar e clique em Open. Se o documento contiver uma propriedade com omesmo nome de uma propriedade que estiver sendo importada, a propriedade de documentoserá substituída.

Se o documento usar o mesmo esquema que o documento do qual as propriedades foram exportadas,elas serão mapeadas automaticamente para os dados do documento. Se os documentos usaremarquivos de esquema diferentes, você poderá mapear as propriedades manualmente depois queelas forem importadas.

Exportando propriedades de documentoVocê pode exportar as propriedades de documento que estão definidas atualmente em umdocumento, de forma que elas possam ser usadas em outros documentos do xPresso for AdobeInDesign, do xPresso for Dreamweaver e do xPresso for Word. O processo de exportação cria umarquivo XML que poderá ser importado depois para outro documento.

Para exportar as propriedades de documento:

1. Clique no menu Document Property e selecione Export Document Properties.

2. Procure o local onde você deseja armazenar o arquivo de exportação e digite um nome parao arquivo.

3. Clique em Save.

50


Trabalhando com hiperlinks de variávelO xPresso for Dreamweaver permite que você crie hiperlinks que contêm variáveis. Você podeadicionar variáveis para criar links para sites gerados dinamicamente ou arquivos PDF.

Inserindo hiperlinks variáveis no documentoPara inserir um hiperlink variável no documento você usará o botão Insert Hyperlink Variable nabarra de inserção do xPresso.

Para inserir um hiperlink variável:

1. Coloque o cursor na página do documento, na posição em que deseja que o hiperlink apareça.

2. Clique em Insert Hyperlink Variable.

3. Digite o texto de link text para o hiperlink. Isso pode ser a URL para um site. Você tambémpode adicionar variáveis no texto de link, como um número de cliente que completa o link paraum site personalizado. Para adicionar uma variável, Clique no botão procurar próximo docampo Link e depois selecione a variável que você deseja adicionar ao link. Por exemplo, estelink abre uma página da web personalizada identificada pela variável UniqueID nos dados:

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

4. No campo Title, digite o texto que você deseja que apareça como um hiperlink no documento.

5. Clique em OK. O texto que você digitou no campo Title aparece na página como um link e ocódigo semelhante ao seguinte é inserido no HTML.<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>

Trabalhando com arraysUm array é o campo de dados pai que contém campos filhos (chamados de itens de array). Vocêpode criar um array diretamente de um campo pai em seu esquema de dados ou criar um e incluircampos que aparecem em qualquer lugar do esquema para serem itens de array do array. Isso lhepermite criar um array usando campos que aparecem em áreas diferentes do esquema. Os arrayspodem ser usados como variáveis de tabela e para controlar loops de conteúdo.

Quando você insere um array em uma página, o xPresso for Dreamweaver sempre cria uma tabela nodocumento com as informações contidas nos campos filho do array.

Uma vez que uma variável de tabela é inserida, você pode formatar a tabela para obter um apelovisual melhor usando as opções de formatação de tabela do Dreamweaver.

51


Criando arraysExistem duas maneiras de criar um array. Você pode usar um campo de dados pai do seu esquemacomo ponto de partida da variável ou criar o array:

• Se você deseja usar um campo de dados pai em seu esquema como um array,simplesmente selecione o campo no painel Data Schema, clique no menu VariableDefinition e selecione Define Array from Schema. A variável aparece no painel VariableDefinition com o mesmo nome que o campo de dados pai.

Se você deseja adicionar um campo filho ao array, selecione o campo filho no painelData Schema e selecione o array no painel Variable Definition. Clique no menu VariableDefinition e selecione Define Array Item from Schema. Um novo item aparece no arraycom o mesmo nome que o campo filho selecionado.

• Se você quiser criar um array desde o início, clique no menu Variable Definition eselecione Define Array. Na parte inferior do painel Variable Definition, aparece um arraychamado "New Variable".

Se você deseja adicionar um campo filho ao array, selecione o array no painel VariableDefinition, clique no menu Variable Definition e selecione Define Array Item. Um novoitem aparece abaixo do array com o nome "Novo item".

Definindo atributos de arrayDepois de criar um array no painel Variable Definition, você pode usar a área de propriedades davariável na parte inferior do painel para definir os atributos do array.

Para definir o array:

1. Selecione o array no painel Variable Definition. As informações aparecem na área depropriedades de variáveis.

2. Digite um nome para o array no campo Name, se necessário.

3. Clique no botão procurar ao lado do campo Mapping. A caixa de diálogo Select SchemaField é exibida. Selecione o campo de dados pai que você deseja usar para preencher essavariável e clique em OK.

52


Definindo atributos de item de arrayDepois de criar um item de array no painel Variable Definition, você pode usar a área de propriedadesda variável na parte inferior do painel para definir os atributos do item.

Para definir um item de array:

1. Selecione o item do array no painel Variable Definition. As informações aparecem na área depropriedades de variáveis.

2. Digite um nome para o item de array no campo Name, se necessário.

3. Selecione o tipo de valor para a variável na lista suspensa.

4. Selecione o tipo de mapeamento para esse item de array: Campo de esquema ou Expressão.

5. Clique no botão procurar ao lado do campo Mapping.

• Se você selecionou Schema Field na etapa anterior, será exibida a caixa de diálogoSchema Field do xPresso.

• Se você selecionou Expression na etapa anterior, será exibida a caixa de diálogoVariable Expression.

6. Digite a expressão na caixa localizada na parte superior da caixa de diálogo. Para ajudar acriar uma expressão, você pode:

• Selecionar um tipo de função para ver as funções disponíveis. Clique em umafunção na lista para ver uma descrição dela na caixa localizada na parte inferior dacaixa de diálogo.

• Clique em Select Schema Field para selecionar um campo do esquema para usarna expressão.

• Clique em Verify para conferir se a expressão é válida.

Quando terminar de criar a expressão, clique em OK. Para obter mais informações, consulteCriando expressões de variáveis.

Observação

A formatação alemã de números não é aceita em uma variável de tipo Expressão. Por exemplo, umnúmero formatado como 1,000.00 não é aceito; é necessário formatá-lo como 1.000,00.

53


Inserindo variáveis de tabela em um documentoAgora que você criou e definiu um array, poderá colocá-lo em seu documento e criar uma variávelde tabela.

Para inserir um array como uma variável de tabela:

1. Coloque o cursor na página no local no qual você deseja que a tabela apareça.

2. Clique em Add Content Table.

3. Selecione um array do painel Variable Definition e clique em OK.

4. A variável aparece na Esquemática e a tabela aparece na posição do cursor na página dodocumento.

5. Você pode usar toda o array de ferramentas HTML de formatação de tabela do Dreamweaverpara modificar a tabela de forma a atender aos seus requisitos.

Exibindo dados de variáveis em um documentoVocê pode aplicar dados de variáveis a um documento, para que possa ver o funcionamento e aaparência do documento com dados reais. Os dados de variáveis não só preenchem as variáveis,mas também satisfazem critérios que controlam a inclusão de conteúdo dinâmico. Isso lhe permitetestar as partes dinâmicas e variáveis do documento. A aplicação de dados ao documento inteiro éfeita através do painel Variable Definition.

Para carregar um arquivo de dados variáveis:

1. Clique no menu Variable Definition e selecione Apply Variable Data.

2. Procure e selecione o arquivo de dados variáveis e clique em Open.

3. Use as setas de rolagem para escolher um registro e clique em Load. O xPresso forDreamweaver aplica o arquivo de dados variáveis selecionado no documento e o exibe em umanova guia no espaço de trabalho.

Observação

Ao aplicar dados variáveis em um documento, o Dreamweaver fecha todos os painéis do xPresso.Após concluir, será necessário reabri-los a partir do menu do xPresso.

54

Criando saídas 5Criando saídas

Quando terminar de desenvolver o documento, você estará pronto para gerar a saída do documento.A publicação de documentos de alto volume é feita no xPression Server. Você pode visualizar a saídano computador do cliente do xPresso for Dreamweaver. Depois que o documento for implantado noservidor, você pode produzir uma saída HTML ou de e-mail através do xDashboard.

Este capítulo compreende todas as suas opções de saída de documento, incluindo a produçãoda visualização do documento, como empacotar o documento e disponibilizá-lo, assim como criaruma versão de texto simples da saída.

Visualizando o documentoAntes de publicar o documento no servidor, você deve criar uma visualização deste no computador docliente do xPresso for Dreamweaver. O processo de visualização produz a mesma saída que vocêverá ao publicar no servidor.

Se a localidade do sistema no computador do cliente não usa codificação UTF-8, você verá um erroao tentar visualizar seu documento. Selecione UTF-8 da codificação HTML para usar a funçãovisualizar. Você pode alterar o valor do conjunto de caracteres no xPresso for Dreamweaver aolocalizar a seguinte linha na exibição Code (na parte superior do documento):

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

Digite UTF-8 para obter o value do conjunto de caracteres.

Para visualizar um documento:

1. Abra o modelo do documento no xPresso for Dreamweaver.

2. Clique no menu Variable Definition e selecione Preview. É exibida a caixa de diálogo SelectCustomer Data.

3. Procure para localizar e selecionar o arquivo de dados variáveis que você deseja usar paravisualizar o documento.

4. Clique em Open. O xPresso for Dreamweaver abre seu documento em uma janela separadado navegador. Os dados contidos no primeiro registro do arquivo de dados selecionado serãousados para resolver as variáveis e outros tipos de conteúdo dinâmico.

5. Feche a janela do navegador ao concluir a visualização.

55

Capítulo 5 — Criando saídas

Observação

Se você visualizar um documento que contém imagens referenciadas por links estáticos, as imagensnão aparecerão na visualização.

Usando o utilitário Send E-MailO xPresso for Dreamweaver permite que você teste ainda mais seus protótipos de documentos parausar seu sistema de e-mail para enviar mensagens de teste.

A caixa de diálogo Send Email contém estas configurações.

Nome do elemento DescriçãoEndereço de origem Seu endereço de e-mail ou o endereço da entidade que está enviando

a mensagem.

Endereço de destino O endereço de e-mail do destinatário pretendido.

Responder a Se você deseja que o destinatário responda para um endereçodiferente do que o fornecido no campo "Endereço de origem", insira-oaqui.

Assunto O título da mensagem. Este texto aparecerá na coluna "Assunto" damaioria dos programas de e-mail.

Endereço IP doservidor SMTP

Entre em contato com o administrador do sistema para obter estaconfiguração.

Enviar como anexo Selecione esta opção para anexar o documento à mensagem dee-mail, em vez de inserir o documento dentro da mensagem.

Criando um e-mail em várias partesVocê pode criar e-mails de várias partes com o modelo de e-mail do xPresso for Dreamweaver. Ose-mails em várias partes agrupam uma versão de texto simples e de HTML do mesmo e-mail e asenviam como um pacote. O cliente de e-mail que recebe decide qual versão deve ser exibida combase nas preferências da conta de e-mail.

No xPresso for Dreamweaver, você pode criar sua versão de texto simples de duas maneiras. Vocêpode desenvolver um arquivo de texto simples separado e depois selecionar o arquivo ao criar umpacote com a versão HTML do documento. Ou o mecanismo de publicação xPublish pode gerarautomaticamente a versão de texto simples do documento durante o processo de publicação.

Criando um arquivo de texto simples separadoSe você está criando a versão de texto simples como um arquivo separado é possível desenvolvero documento em um editor de texto e depois abri-lo no xPresso for Dreamweaver para adicionarqualquer conteúdo dinâmico, incluindo ocorrências de conteúdo e variáveis. Ou você pode converter

56


um arquivo HTML existente no xPresso for Dreamweaver para um arquivo de texto simples quepode ser editado posteriormente. O arquivo de texto simples requer uma extensão .html em ambosos casos.

Recomenda-se que o arquivo seja desenvolvido no bloco de notas e depois aberto no xPresso forDreamweaver para a adição de variáveis e de conteúdo dinâmico. Isso ajuda a garantir que não serãoincluídos itens que não funcionarão em um e-mail de texto simples como tabelas ou marcadores. Seo documento usa um formato complexo, recomenda-se que você deixe o mecanismo de publicaçãogerar a versão de texto simples automaticamente. Para obter mais informações, consulte Criandouma versão de texto simples durante a publicação

Lembre-se de que será necessário verificar a saída de quaisquer URLs para links que você venha aincluir na versão de texto simples, pois não há suporte para links. Se você usar a conversão paratexto simples do xPresso for Dreamweaver, será necessário editar o arquivo depois de convertido.Nenhuma formatação será aplicada ao texto e será necessário adicionar variáveis, pois somente onome é transferido na versão de texto simples e não a variável real. A conversão só pula a etapa derecriar todo o conteúdo, mas ainda será necessário fazer edições.

Ao criar um arquivo de texto simples separado será necessário dizer ao xPresso for Dreamweaverpara incluir a versão de texto simples do arquivo de pacote ao finalizar o pacote do documento. Paraobter mais informações, consulte Empacotamento ao criar o arquivo de texto simples.

Convertendo HTML em texto simplesPara converter HTML para texto simples automaticamente:

1. Abra o xPresso for Dreamweaver.

2. Clique em Convert HTML na barra de inserção do xPresso. É exibida a caixa de diálogoSelect Plain Text HTML.

3. Localize e selecione o arquivo HTML que você deseja converter para texto simples e cliqueem Open. O conteúdo do arquivo aparece como texto simples em uma nova janela doDreamweaver.

4. Edite o conteúdo como necessário, verificando se está adicionando as variáveis apropriadas,criando os grupos de conteúdo e as ocorrências necessários e formatando as URLscorretamente.

5. Salve a versão de texto simples.

Empacotamento ao criar o arquivo de texto simplesComo empacotar um documento de e-mail de várias partes:

1. Abra o documento no xPresso for Dreamweaver.

2. Na barra de inserção do xPresso, clique em Create Package. É exibida a caixa de diálogoCreate Package.

3. Clique em Browse para ir até o diretório em que deseja armazenar o pacote. Esse diretóriodeve ser acessível a partir do xPression Server. Caso não seja, você precisará mover o arquivode pacote para um diretório que seja acessível antes de implantá-lo no servidor e publicá-lo.

4. Digite um nome de arquivo para o pacote. Os nomes de arquivos de pacote devem ter nomáximo 255 caracteres do alfabeto inglês e podem conter apenas caracteres alfanuméricos

57


(A-Z, a-z, 0-9), parênteses (()), apóstrofos (’), aspas simples (’), sublinhados (_), traços (-) eespaços.

5. Clique em Save. O caminho do arquivo de pacote é exibido no campo Create Package.

6. Clique em Browse para localizar e selecionar a versão de texto simples do seu e-mail. Cliqueem Open. O caminho do arquivo aparecerá no campo Plain Text.

7. Clique em Variable Mapping para mapear quaisquer variáveis na versão de texto simples paravariáveis na versão HTML. Quaisquer variáveis correspondentes entre o texto simples e asversões HTML versions mapeiam automaticamente. A caixa de diálogo Plain Text E-mailVariable Mapping permite que você mapeie as variáveis na versão de texto simples paravariáveis na versão HTML. O mapeamento de variáveis garante que as variáveis resolvamcorretamente na saída.

8. Selecione a variável na lista Plain Text E-mail Variables e depois selecione a variável que vocêdeseja mapear na lista HTML E-mail Variables e clique em Map. O par mapeado aparece natabela na parte inferior na caixa de diálogo.

9. Repita a etapa 8 para todas as variáveis que necessitam ser mapeadas.

10. Clique em OK.

11. Clique em Create. Quando o processo é concluído, o xPresso for Dreamweaver exibe umamensagem de confirmação

O xPresso for Dreamweaver executa automaticamente o utilitário de verificação de marcasquando você cria um pacote. Se encontrar um erro, você receberá uma mensagem de erro.Para obter mais informações, consulte Validação de marcas do xPresso.

58


Criando uma versão de texto simples durante a publicaçãoSe você apenas deseja criar uma versão de texto simples do documento HTML document semfazer quaisquer modificações, é possível instruir o mecanismo de publicação xPublish para criaruma versão de texto simples durante o processo de publicação. Isso é feito durante o processo deempacotamento. Lembre-se de que a versão de texto simples produzida no servidor é a mesma quea produzida usando a função Convert HTML e não terá formatação aplicada (no entanto, as variáveise o conteúdo dinâmico serão resolvidos). Recomenda-se usar este recurso somente quando odocumento for simples. Para documentos mais complexos você deve criar um arquivo de textosimples separado que possa ser editado e formatado.

Para criar uma versão de texto simples durante o processo de publicação:


2. Clique em Create Package na barra de inserção do xPresso. É exibida a caixa de diálogoCreate Package.


4. Digite um nome de arquivo para o pacote. Os nomes de arquivos de pacote devem ter nomáximo 255 caracteres do alfabeto inglês e podem conter apenas caracteres alfanuméricos(A-Z, a-z, 0-9), parênteses (()), apóstrofos (’), aspas simples (’), sublinhados (_), traços (-) eespaços.


6. Marque a caixa de seleção Send Email As Multipart.

7. Clique em Create. Quando o processo é concluído, o xPresso for Dreamweaver exibe umamensagem de confirmação.


Ao publicar um documento no xDashboard, o mecanismo de publicação xPublish criaráautomaticamente uma versão de texto simples do documento HTML e empacote-os juntos paradistribuição por e-mail.

Empacotando o documentoAntes que um documento possa ser publicado pelo xDashboard, este deve ser empacotado nocomputador do cliente do xPresso for Dreamweaver, salvo em um local acessível do xPressionServer e depois implantado em uma categoria no xAdmin. Depois que o documento residir em umacategoria do xAdmin no servidor, você poderá publicar o documento no xDashboard. Você não poderáfazer nenhuma alteração no documento no servidor. Se for necessário alterar o documento, vocêdeve fazer a alteração no xPresso for Dreamweaver, empacotá-lo novamente e implantar a versãoatualizada no xAdmin. Para obter mais informações sobre a implantação de documentos, consulte oGuia do Usuário do xAdmin Workgroup Edition ou o Guia do Usuário do xAdmin Enterprise Edition.

59


Um pacote de documentos xPRS contém todas as informações necessárias para que o mecanismode publicação xPublish publique o documento, incluindo o documento HTML, a lógica do assembly,o esquema, uma miniatura do documento e alguns outros arquivos necessários para o mecanismode publicação. Se você incluiu um conteúdo externo no documento, o arquivo de conteúdo externotambém é incluído no pacote.

Se você está criando e-mails em várias partes, o processo de empacotamento é um pouco diferente.Seguindo as etapas em Criando um e-mail em várias partes em vez das etapas abaixo.

Para empacotar um documento:


2. Na barra de inserção do xPresso, clique em Create Package. É exibida a caixa de diálogoCreate Package.


4. Digite um nome de arquivo para o pacote. Os nomes de arquivos de pacote devem ter nomáximo 255 caracteres do alfabeto inglês e podem conter apenas caracteres alfanuméricos(A-Z, a-z, 0-9), parênteses (()), apóstrofos (’), aspas simples (’), sublinhados (_), traços (-) eespaços.


6. Clique em Create. Quando o processo é concluído, o xPresso for Dreamweaver exibe umamensagem de confirmação.


Anexando arquivos externos em um e-mailÉ possível anexar arquivos externos em e-mails criados por você usando os pacotes do xPresso forDreamweaver no xPression Server. Os arquivos podem ser gerados dinamicamente de outro trabalhode publicação (como um demonstrativo de conta de trabalho do xPresso for Adobe InDesign) oupodem ser arquivos estáticos (como um comunicado à imprensa ou uma declaração de privacidade).Os anexos são definidos em perfis de e-mail no xAdmin. Para obter mais informações, consulte oGuia do Usuário do xAdmin Workgroup Edition ou o Guia do Usuário do xAdmin Enterprise Edition.

60


Arquivos gerados dinamicamentePara os arquivos gerados dinamicamente, garanta que uma variável de saída será usada paracriar o nome do arquivo que você deseja anexar. A saída deve ser contida em arquivos individuaise inserida no diretório de saída padrão no servidor. A saída pode vir de um trabalho de publicaçãodo xPresso for Adobe InDesign ou do xPresso for Word 2007 que foi previamente concluído. Asaída deve residir no diretório de saída padrão.

Por exemplo, você pode executar um trabalho do xPresso for Adobe InDesign que produz arquivosde saída individuais do demonstrativo de contas em PDF de um pacote com uma propriedade dedocumento de AccountNumber. Você usa a variável de saída AccountNumber para nome cadaarquivo individual e para garantir que a saída vá para o diretório de saída padrão. Para incluir essesdemonstrativos como anexos em e-mails de alerta de demonstrativo do cliente, você definiria umperfil de e-mail e adicionaria uma anexo usando a variável de saída AccountNumber. Quando omecanismo de publicação xPublish produz e-mails, este procurará no diretório padrão um arquivoPDF que corresponde a cada valor AccountNumber de e-mail.

Arquivos estáticosPara arquivos estáticos, garanta que estejam localizados no seguinte diretório:

[xPression Installation Directory]\xPRS_Home\email_attachment

61

Especificação de marca doxPresso A

Especificação de marca do xPresso

O xPresso for Dreamweaver permite que você codifique manualmente partes de seus documentosconforme for necessário. Este apêndice descreve os atributos comuns da marca xPresso.

Atributos de marca gerais do xPressoTodas as marcas do xPresso têm esses atributos. Todos os valores são colocados entre aspas.

SintaxexPresso type="value" id="integer" name="value"

tipoO tipo da marca do xPresso. Os valores possíveis são:

• grupo

• ocorrência

• texto

• loop

idPrecisa conter um valor inteiro. Este valor deve ser único em relação à outra marca do xPresso,mas não incluir uma marca variável.

nomeEste Precisa ser um valor alfanumérico.

Atributos de marca de grupoMarcas de grupo de conteúdo, grupo, devem incluir marcas filho e estas devem conter marcas deocorrência. As marcas de grupo de conteúdo têm estes atributos adicionais.

62

Apêndice A — Especificação de marca do xPresso

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

onoff=value>

selecttype

Os valores obrigatórios são:

• ifelse

• switch

lógica

Pode ser deixado em branco.

• Se selectype=switch, este valor só poderá ser o nome de uma variável.

• Se selecttype=ifelse, este valor deve ser deixado em branco.

onoff

Pode ser deixado em branco. O valor deve ser uma expressão válida. Uma expressão válida significaque inclui nome e operador de variável, assim como um valor, podendo incluir também "e" ou "ou"para vários condicionais como "nome" == "Victor" e idade > 30 ou "endereço" == "{nome}". Em qualnome, endereço e idade o nome deve ser uma variável válida de marcas VarDefs. Se o nome devariável aparece no lado direito do operador, será necessário colocar "{}" em volta. Para a funçãode validação de marca personalizada também será necessário verificar da função de validaçãoda lógica de seleção.

Exemplos<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 da marca de conteúdoA marca de ocorrência deve ter uma marca pai e deve ser um grupo de conteúdo.

63


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

lógica

O valor depende do selecttype do grupo pai.

• Se selecttype=switch e se a lógica do grupo não estiver em branco, será necessárioque este valor seja válido para o tipo de variável somente para a variável de tipo destring, este valor pode estar em branco. Se a lógica do grupo estiver em branco, entãoeste valor deve estar em branco.

• Se o selecttype=ifelse, então este valor pode estar em branco ou ser uma expressãoválida.

Exemplos<xPresso type="instance" id="15" name="general" logic="PEK"></xPresso>

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

Atributos de marca de textoPara marca de texto, a tag pai pode ser de ocorrência de conteúdo ou loop ou grupo externo enão pode ter qualquer marca filho. E a HTML interna do variável de texto deve ter "{}" em voltado nome da variável.

Sintaxe<xPresso type="text" id="integer" name="name" variable="tag_name"vid="integer"></xPresso>

variável

O nome da marcaVarDef.

vid

O número da ID da marca VarDef.

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

64


Atributos de marca de loopPara marca de loop, a tag pai pode ser de ocorrência de conteúdo ou loop ou grupo externo e podeter qualquer marca filho.

Sintaxe<xPresso type="loop" id="integer" name="name" variable="TableDefTag Name" vid="integer"></xPresso>

variável

Este valor deve ser o nome da marca TableDef.

vid

Este valor deve ser o número da ID da marca TableDef.

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

Atributos da marca VarDefPara a marca VarDef, a marca pai deve ser VarDefs e tem alguns atributos. Todos os valores devemser colocados entre aspas.

65


Sintaxe<VarDef name="name" id="integer" type="value" expType="value"expression="value" position="integer"></VarDef>

nome

Deve ser um nome exclusivo.

id

Precisa ter uma valor inteiro e este deve ser exclusivo de outras marcas VarDef.

tipo

Os valores obrigatórios são:• string• inteiro• duplo• flutuante• data• hora• data e hora

expType

Os valores obrigatórios são:• esquema• expressão

expressão

O valor necessário deve ser um valor Xpath do esquema ou uma expressão.

position

O valor inteiro necessário é o número de classificação da marca VarDef.

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

Atributos da marca TableDefPara a marca TableDef, a marca pai deve ser TableDefs e pode incluir algumas marcas VarDef e temalguns atributos. Todos os valores devem ser colocados entre aspas.

66


Sintaxe<TableDef name="name" id="integer" expType="schema" expression="value"position="integer"> </TableDef>

nome

Precisa ter um valor e deve ser exclusivo de outras marcas TableDef.

id

Precisa ter uma valor inteiro e este deve ser exclusivo de outras marcas VarDef e TableDef.

expType="schema"

O valor necessário é "schema".

expressão

Precisa ter uma valor que deve ser um valor xpath do esquema.

position

Precisa ter uma valor inteiro que é o número de classificação de marcas variáveis.

Exemplo<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>

67

Funções de expressão BFunções de expressão

Ao criar variáveis no xPresso for Dreamweaver você pode usar funções em suas definições devariáveis. Este capítulo descreve as funções disponíveis para uso em expressões de variáveis. Amenos que indicado de outra forma, as funções podem usar um literal ou um campo de esquemacomo argumento.

Funções numéricasAs funções numéricas a seguir podem ser usadas durante a criação de uma expressão de variável.Funções numéricas não podem usar campos de esquema nem xPaths nos argumentos; elas sóaceitam entrada numérica.

absA função abs aceita um valor duplo para o argumento numeric_value e retorna um valor duplo.

Sintaxeabs(numeric_value)

Retorna o valor absoluto de numeric_value.

Exemplo: abs(-2) Retorna: 2

floorA função floor aceita um valor duplo para o argumento numeric_value e retorna um valor duplo.

Sintaxefloor(numeric_value)

Retorna o maior valor de ponto flutuante (mais próximo ao infinito positivo) que não seja maior quenumeric_value e seja igual a um inteiro matemático.

Exemplo: floor(2.3) Retorna: 2

ceilA função ceil aceita um valor duplo para o argumento numeric_value e retorna um valor duplo.

68

Apêndice B — Funções de expressão

Sintaxeceil (numeric_value)

Retorna o menor valor de ponto flutuante (mais próximo ao infinito negativo) que não seja menor quenumeric_value e seja igual a um inteiro matemático.

Exemplo: ceil(2.3) Retorna: 3

roundA função round aceita um valor duplo para o argumento numeric_value e retorna um valor duplo.

Sintaxeround(numeric_value)

Retorna um número inteiro.

Exemplo: round(1.678) Retorna: 2

stringToIntegerA função stringToInterger aceita um valor de string para o argumento string_value e retorna umvalor inteiro.

SintaxestringToInteger(string_value)

Converte o valor inteiro de string_value.

Exemplo: stringToInteger("124") Retorna: 124

Funções lógicasAs funções lógicas a seguir podem ser usadas durante a criação de uma expressão de variável.

false

Constante lógica.true

Constante lógica.

69


Funções de grupoAs funções de grupo não podem usar literais em seus argumentos; elas só aceitam variáveis. Asfunções de grupo a seguir podem ser usadas durante a criação de uma expressão de variável.

groupCountA função groupCount aceita uma variável para o argumento variable_scope e retorna um valor inteiro.

SintaxegroupCount(variable_scope)

Retorna o número total de registros em variable_scope.

No exemplo a seguir, $QuarterPeriod:InvestmentA$ é uma variável com um tipo de valor inteiro evalores de 1.000, 2.000 e 4.000. $QuarterPeriod$ é o escopo.

Exemplo: groupCount($QuarterPeriod$) Retorna: 3

groupSumA função groupSum aceita uma variável para os argumentos variable_field e variable_scope e retornaum valor do mesmo tipo que variable_field.

70


SintaxegroupSum(variable_field, variable_scope)

Retorna o somatório de variable_field em variable_scope.


Exemplo: groupSum($QuarterPeriod:InvestmentA$,$QuarterPeriod$) Retorna: 7,000

Usando groupSum em um loop aninhadoSe quiser usar a função groupSum para calcular a soma de cada loop dentro do loop aninhado, vocêprecisará criar várias expressões de um modo específico.

Para calcular a soma de todos os elementos "Premium" dentro do elemento de loop aninhado"\nestedLoop\Data\Table\Premium", você precisa fazer o seguinte:

1. Arrastar o "\nestedLoop" da paleta do Esquema de dados para a paleta de Definição devariáveis para criar um array "nestedLoop".

2. Arrastar "\nestedLoop\Data" para a paleta de Definição de variáveis para criar um array "Data".

3. Arrastar "\nestedLoop\Data\Table" para a paleta para criar um array "Table".

4. Criar uma nova variável na paleta de Definição de variáveis, "NewVariable1" e especificar o tipode mapeamento como Expressão.

5. Mapeie a variável criando esta expressão:

groupSum($Table:Premium$, $Table$)



groupSum($NewVariable1$, $Data$)



groupSum($NewVariable2$, $nestedLoop$)Depois, você poderá usar NewVariable3 no documento para inserir a soma dos elementos Premium.

groupMaxA função groupMax aceita uma variável para os argumentos variable_field e variable_scope e retornauma valor do mesmo tipo de variable_field.

71


SintaxegroupMax(variable_field, variable_scope)

Retorna o valor de máximo de variable_field em variable_scope.


Exemplo: groupMax($QuarterPeriod:InvestmentA$,$QuarterPeriod$) Retorna: 4.000

groupMinA função groupMin aceita uma variável para os argumentos variable_field e variable_scope e retornaum valor do mesmo tipo que variable_field.

SintaxegroupMin(variable_field, variable_scope)

Retorna o valor mínimo de variable_field em variable_scope.


Exemplo: groupMin($QuarterPeriod:InvestmentA$,$QuarterPeriod$) Retorna: 1.000

Funções de stringAs funções de string a seguir podem ser usadas durante a criação de uma expressão de variável.

lengthA função length aceita um valor de string para o argumento string_value e retorna um valor de string.

Sintaxelength(string_value)

Retorna o número de caracteres de string_value.

No exemplo a seguir, $GenlInfo:AccNum$ é uma variável com um valor de "123456789".

Exemplo: length($GenlInfo:AccNum$) Retorna: 9

containsO função contains aceita um valor de string para ambos os argumentos string_value e string_to_find eretorna um valor booleano.

72


Sintaxecontains(string_value, string_to_find)

Retornará true se string_value contiver string_to_find; caso contrário, retornará false.


Exemplo: contains($GenlInfo:AccNum$,"456") Retorna: true

toLowerCaseA função toLowerCase aceita um valor de string para o argumento string_value e retorna um valorde string.

SintaxetoLowerCase(string_value)

Converte em minúsculas todos os caracteres em string_value.

No exemplo a seguir, $GenlInfo:LastName$ é uma variável com um valor de "Smith".

Exemplo: toLowerCase($GenlInfo:LastName$) Retorna: smith

toUpperCaseA função toUpperCase aceita um valor de string para o argumento string_value e retorna um valorde string.

SintaxetoUpperCase(string_value)

Converte em maiúsculas todos os caracteres em string_value.

No exemplo a seguir, $GenlInfo:LastName$ é uma variável com um valor de "Smith".

Exemplo: toUpperCase($GenlInfo:LastName$) Retorna: SMITH

trimA função trim aceita um valor de string para o argumento string_value e retorna um valor de string.

Sintaxetrim(string_value)

Remove espaços à direita e à esquerda, tabulações e caracteres de nova linha de string_value.

Exemplo: trim (" Agente ") Retorna: "Agente"

73


substringA função substring aceita um valor de string para o argumento string_value, um inteiro para osargumentos start e end e retorna um valor de string.

Sintaxesubstring(string_value, start, end)

Retorna uma substring que consiste em caracteres end–start , começando com o índice start eterminando com o índice end de string_value.


Exemplo: substring($GenlInfo:AccNum$,4,6) Retorna: "56"

positionA função position aceita um valor de string para ambos os argumentos string_to_search estring_to_find e retorna um inteiro.

Sintaxeposition(string_to_search, string_to_find)

Retorna a posição da substring string_to_find em string_to_search ou -1 se não for localizada.


Exemplo: position($GenlInfo:AccNum$,56) Retorna: 5

replaceA função replace aceita um valor de string para os argumentos string_value, string_to_find ereplacement_string e retorna um valor de string.

Sintaxereplace(string_value, string_to_find, replacement_string)

Procura string_to_find em string_value e substitui cada ocorrência por replacement_string.


Exemplo: replace($GenlInfo:AccNum$,12,99) Retorna: "993456789"

numericToStringA função numericToString aceita um valor duplo, flutuante ou inteiro para o argumento numeric_valuee retorna um valor de string.

74


SintaxenumericToString(numeric_value)

Converte um número em uma string.

Exemplo: numericToString( 23.5) Retorna: "23.5"

Funções de data e hora, data e horaAs funções de data e hora, data e hora a seguir podem ser usadas durante a criação de umaexpressão de variável. Os campos Date, Time e DateTime devem aparecer nos dados em umdeterminado formato:

• Data: aaaa-mm-dd (por exemplo: 2003-05-19)• Hora: hh:mm:ss (por exemplo: 11:22:50)• Data e hora: aaaa-mm-ddThh:mm:ss (por exemplo: 2002-01-05T03:15:30)

addYearA função addYear aceita uma variável do tipo data e hora ou data para o argumentodatetime_or_date_value, um inteiro para o argumento numeric_value e retorna um valor de data oude data e hora, dependendo do valor de entrada.

SintaxeaddYear(datetime_or_date_value, numeric_value)

Retorna uma data e hora ou data da adição de numeric_value anos a datetime_or_date_value.

No exemplo a seguir, $GenlInfo:DateDue$ é uma variável com o valor "2006-03-21".

Exemplo: addYear($GenlInfo:DateDue$,20) Retorna: 2026-03-21

addMonthA função addMonth aceita uma variável do tipo data e hora ou data para o argumentodatetime_or_date_value, um inteiro para o argumento numeric_value e retorna um valor de data oude data e hora, dependendo do valor de entrada.

SintaxeaddMonth(datetime_or_date_value, numeric_value)

Retorna uma data e hora ou data da adição de numeric_value meses a datetime_or_date_value.

No exemplo a seguir, $GenlInfo:DateDue$ é uma variável com um valor de "2006-03-21".

Exemplo: addMonth($GenlInfo:DateDue$,2) Retorna: 2006-05-21

75


addDayA função addDay aceita uma variável do tipo data e hora ou data para o argumentodatetime_or_date_value, um inteiro para o argumento numeric_value e retorna um valor de data oude data e hora, dependendo do valor de entrada.

SintaxeaddDay(datetime_or_date_value, numeric_value)

Retorna uma data e hora ou data da adição de numeric_value dias a datetime_or_date_value.

No exemplo a seguir, $GenlInfo:DateDue$ é uma variável com um valor de "2006-03-21".

Exemplo: addDay ($GenlInfo:DateDue$,2) Retorna: 2006-03-23

nowA função now retorna um valor de data e hora.

Sintaxenow()

Retorna a data e a hora atuais.

76

© 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.

Guia do Usuário do xPresso for Dreamweaver...Dreamweaver, bem como à versão Macromedia...

Documents

Transcript of Guia do Usuário do xPresso for Dreamweaver...Dreamweaver, bem como à versão Macromedia...