· sommario prefazione...

347
EMC ® Document Sciences ® xPresso ® for Word Versione 4.6 SP1 Guida per l’utente EMC Computer Systems Italia S.p.A. Direzione e Filiale di Milano Via Giovanni Spadolini, 5 - Edificio A 20141 Milano tel. +39 02 409081 fax +39 02 48204686 italy.emc.com

Upload: others

Post on 21-Mar-2020

19 views

Category:

Documents


0 download

TRANSCRIPT

Page 1:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

EMC® Document Sciences®

xPresso® for WordVersione 4.6 SP1

Guida per l’utente

EMC Computer Systems Italia S.p.A.Direzione e Filiale di Milano

Via Giovanni Spadolini, 5 - Edificio A20141 Milano

tel. +39 02 409081fax +39 02 48204686

italy.emc.com

Page 2:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Nota legale

Copyright © 2006-2016 EMC Corporation. All Rights Reserved.

EMC ritiene che le informazioni presenti in questa pubblicazione siano esatte alla data della pubblicazione. Le informazionisono soggette a modifica senza preavviso.

LE INFORMAZIONI IN QUESTA PUBBLICAZIONE SONO FORNITE COSÌ COME SONO. EMC CORPORATION NONRILASCIA DICHIARAZIONI E GARANZIE DI ALCUN TIPO IN MERITO ALLE INFORMAZIONI CONTENUTE INQUESTA PUBBLICAZIONE E NEGA SPECIFICAMENTE GARANZIE IMPLICITE DI COMMERCIABILITÀ O DI IDONEITÀPER UNO SCOPO PARTICOLARE.

L’utilizzo, la copia e la distribuzione di qualunque software di EMC descritto in questa pubblicazione richiede una licenza disoftware applicabile.

Per un elenco più aggiornato dei nomi dei prodotti EMC, consultare la sezione relativa ai marchi di EMC Corporation suEMC.com. Adobe e Adobe PDF Library sono marchi o marchi registrati di Adobe Systems Inc. negli Stati Uniti e negli altripaesi. Tutti gli altri marchi qui utilizzati sono di proprietà dei rispettivi titolari.

Commenti e suggerimenti sulla documentazione

L’opinione dell’utente è di fondamentale importanza. I commenti dell’utente in relazione alla documentazione del prodottosono particolarmente graditi. È possibile inviare eventuali commenti e suggerimenti su come migliorare la documentazione osemplificarne l’utilizzo direttamente all’indirizzo [email protected]

Page 3:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Prefazione ........................................................................................................................... 17

Capitolo 1 Introduzione a xPresso for Word ................................................................. 19Aggiornamento della licenza ............................................................................. 19Informazioni sui documenti di xPresso for Word ................................................ 19Documenti creati in una versione precedente.................................................. 20

Directory di configurazione............................................................................... 20Avvio di xPresso for Word ................................................................................ 21Blocco di Microsoft Word all’avvio................................................................. 21Voce di xPresso mancante nel menu File ........................................................ 21

Utilizzo di xPresso for Word 4.2 sulla stessa workstation..................................... 22Utilizzo del server xPression ............................................................................. 22Repository di xPression................................................................................. 23Definizione delle versioni del repository xPression ..................................... 23Elaborazione data di validità ................................................................. 24Data di ritiro .................................................................................... 25

Strategie organizzative e di gestione ...................................................... 25Trunk e versioni derivate................................................................... 25Collegamento al contenuto di xPresso mediante versione .................... 26Ritiro di modelli ............................................................................... 26

Definizione delle versioni del repository xPression Documentum ................ 26Recupero di file sul server in un’applicazione diversa da xPresso ..................... 27Connessione al server ................................................................................... 27Definizione di un server ............................................................................ 28Accesso a un server................................................................................... 28

Gestione dei documenti xPresso .................................................................... 29Modifica della visualizzazione delle informazioni....................................... 30Filtraggio dei documenti ........................................................................... 31Utilizzo delle versioni documento ............................................................. 31Definizione delle date di validità e di ritiro................................................. 31Spostamento dei documenti all’interno del workflow.................................. 32Visualizzazione della cronologia flusso di lavoro ........................................ 33Esecuzione dell’anteprima online............................................................... 33Esecuzione dell’analisi sull’impatto............................................................ 33

Utilizzo dei modelli del documento ................................................................... 34Apertura di un modello esistente....................................................................... 35Accesso ai modelli locali ............................................................................... 35Accesso a modelli recenti .............................................................................. 35Utilizzo dei modelli memorizzati nel repository xPression .............................. 35Utilizzo dei modelli in sola lettura ............................................................. 36

Salvataggio dei modelli per il lavoro offline.................................................... 37Utilizzo di modelli memorizzati nel Repository xPressionDocumentum ............................................................................................... 37Ricerca nel Repository xPression Documentum .......................................... 38Utilizzo della ricerca semplice ............................................................... 38Utilizzo della ricerca avanzata ............................................................... 38

3

Page 4:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Annullamento di un’estrazione...................................................................... 39Apertura di un documento da Documentum .................................................. 40

Utilizzo della scheda Progettazione di xPresso for Word ..................................... 40Utilizzo del pannello Esplora............................................................................. 40Utilizzo di Esplora modelli............................................................................ 41Elementi modello non validi...................................................................... 41

Utilizzo di Esplora variabili ........................................................................... 42Elementi variabile non validi ..................................................................... 43Icone........................................................................................................ 43

Utilizzo di Esplora layout HTML ................................................................... 44Utilizzo di contenuto nel canvas ........................................................................ 44Funzione di annullamento nel contenuto dinamico ......................................... 45

Cleanup dei controlli di contenuto orfani ........................................................... 45

Capitolo 2 Pianificazione del documento ..................................................................... 47Contenuto del documento ................................................................................. 48Contenuto dinamico ..................................................................................... 48Esempio................................................................................................... 48

Contenuto statico ......................................................................................... 49Output del documento...................................................................................... 49Considerazioni sull’output PostScript ............................................................ 49Impostazione della lingua del documento per output PDF/UA ........................ 50Output DOCX e iDOCX ................................................................................ 50Output di imposizione multipla .................................................................... 50

Considerazioni sulla progettazione del documento ............................................. 51Considerazioni sulla formattazione di testo .................................................... 51Considerazioni sulla formattazione di tabelle ................................................. 52

Impostazione e layout della sezione ................................................................... 52Creazione di definizioni di pagina ................................................................. 52Utilizzo di intestazioni e piè di pagina ........................................................... 54Creazione di intestazioni e piè di pagina .................................................... 54Modifica di intestazioni e piè di pagina all’interno di un modello ................ 55Intestazioni e piè di pagina “flessibili” ....................................................... 55

Considerazioni sui caratteri............................................................................... 56Caratteri supportati negli output PostScript e PDF .......................................... 57Informazioni sui caratteri AFP....................................................................... 57Caratteri grandi supportati............................................................................ 58Tipografia asiatica supportata ....................................................................... 58

Considerazioni sulla sillabazione ....................................................................... 59Modifica dei dizionari di sillabazione............................................................. 60Specifica di dizionari delle lingue diversi ....................................................... 61Creazione della variabile di output LOCALE.............................................. 62Passaggio del codice della lingua attraverso un campo dati ......................... 63Passaggio del codice della lingua attraverso una variabile codificata ............ 63

Limitazioni ...................................................................................................... 64Lingue supportate ........................................................................................ 64Impostazioni di visualizzazione di Windows.................................................. 64La funzione di annullamento......................................................................... 64Stile Word PlaceholderText............................................................................ 65Interruzioni di sezione .................................................................................. 65Documenti di sola lettura .............................................................................. 65Verifica e visualizza anteprima ...................................................................... 65Testo nascosto .............................................................................................. 65Mantieni con il successivo ............................................................................. 66Tasti di scelta rapida ..................................................................................... 66

4

Page 5:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Capitolo 3 Utilizzo dei dati ............................................................................................ 67Preparazione dei file di dati............................................................................... 67Tipi di schema supportati.............................................................................. 69Utilizzo di istruzioni Include nello schema ..................................................... 69Aggiunta di interruzioni di riga a campi XML ................................................ 70Tag HTML nei dati XML ............................................................................... 70Proprietà CSS supportate .......................................................................... 72Configurazione dell’elaborazione dei tag HTML a livello globale ................. 73

Utilizzo dello schema........................................................................................ 74Caricamento dello schema............................................................................. 74Caricamento dello schema......................................................................... 75Creazione di una mappatura di variabile................................................ 76Creazione di una mappatura di variabile personalizzata ......................... 76Esempio............................................................................................... 76

Esplora variabili ........................................................................................... 84

Capitolo 4 Utilizzo di variabili ....................................................................................... 85Informazioni sulle variabili ............................................................................... 85Nomi variabile ............................................................................................. 86

Aggiunta di variabili al modello ........................................................................ 86Variabili di testo ............................................................................................... 87Visualizzazione di variabili testo nel documento............................................. 87Definizione dei formati globali delle variabili ................................................. 88Formattazione delle variabili testo ................................................................. 89Definizione di un formato predefinito ........................................................ 89Definizione di un formato per una variabile specifica .................................. 89Formattazione di variabili di tipo data, ora o data e ora ............................... 90Aggiunta di formati personalizzati ........................................................ 90

Formattazione di variabili numeriche......................................................... 91Formattazione di variabili stringa .............................................................. 92

Rimozione delle righe vuote nei blocchi di testo ............................................. 92Creazione di variabili personalizzate.................................................................. 94Variabili JavaScript ....................................................................................... 94Inserimento di variabili in espressioni JavaScript ........................................ 95Inserimento di funzioni in espressioni JavaScript ........................................ 95Inserimento di istruzioni If/Else in espressioni JavaScript ............................ 96Verifica dell’espressione JavaScript ............................................................ 96Esempio di espressione JavaScript ............................................................. 96

Variabili Funzione xPresso ............................................................................ 97Inserimento di variabili in espressioni Funzione xPresso ............................. 98Inserimento di funzioni in espressioni Funzione xPresso ............................. 98Inserimento di istruzioni If/Else in espressioni Funzione xPresso ................. 98Verifica dell’espressione Funzione xPresso ................................................. 99

Variabili xPath .............................................................................................. 99Inserimento di variabili in espressioni xPath............................................... 99Inserimento di funzioni in espressioni xPath .............................................. 99Verifica dell’espressione xPath ................................................................. 100

Utilizzo di JavaScript ...................................................................................... 100Javascript globale ....................................................................................... 100Creazione di script JavaScript globali ....................................................... 100Utilizzo di percorsi relativi per JavaScript globali...................................... 101

Utilizzo di Java ........................................................................................... 101Esempio di utilizzo di uscite utente Java .................................................. 102

Variabili d’ambiente di sistema ........................................................................ 103Caricamento di variabili d’ambiente di sistema ............................................. 103

5

Page 6:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Utilizzo della funzionalità Trova e sostituisci .................................................... 104Utilizzo di codici di caratteri non jolly.......................................................... 106Utilizzo di caratteri jolly.............................................................................. 106

Array............................................................................................................. 107Filtro di un array ........................................................................................ 108Riferimento a un’istanza di variabile specifica all’interno di un array ............. 108

L’insieme delle definizioni di variabili.............................................................. 108Importazione di definizioni di variabili ........................................................ 109Opzioni di importazione delle variabili .................................................... 109

Esportazione di definizioni di variabili......................................................... 110Proprietà documento ...................................................................................... 111Creazione di una proprietà del documento................................................... 111Importazione delle proprietà del documento ................................................ 112Opzioni relative all’importazione di proprietà .......................................... 112

Esportazione delle proprietà del documento................................................. 113

Capitolo 5 Aggiunta di funzionalità ai modelli ............................................................ 115Utilizzo delle caselle di testo di Microsoft Word................................................ 115Inserimento dal menu Forme....................................................................... 116Inserimento dal menu Casella di testo.......................................................... 116Formattazione di una casella di testo............................................................ 117Riempimento forma................................................................................ 117Contorno forma...................................................................................... 118Formattazione della forma ...................................................................... 118Orientamento testo - Installazioni non in lingua inglese ........................ 118

Posizione ............................................................................................... 119Disposizione testo................................................................................... 119

Utilizzo delle cornici ................................................................................... 120Gruppo .................................................................................................. 120Tabelle contenute nelle cornici ................................................................. 121

Caselle di testo/cornici e contenuto dinamico................................................ 121Tecniche di formattazione del testo .................................................................. 122Numeri di pagina ....................................................................................... 122Date aggiornate dinamicamente .................................................................. 122Elenchi puntati ........................................................................................... 123Elenchi numerati complessi......................................................................... 123Controllo Righe isolate paragrafo avanzato .................................................. 123

Riferimenti incrociati ...................................................................................... 124Opzioni relative ai riferimenti incrociati ....................................................... 125

Sommari ........................................................................................................ 125Opzioni sommario...................................................................................... 126Modifica degli stili .................................................................................. 127

Inserimento di un Sommario ....................................................................... 127Generazione di un Sommario utilizzando dei campi ..................................... 127Inserimento di un Sommario con codici di campo TC e TOC ......................... 128

Indicizzazione del documento ......................................................................... 129Contenuto dinamico in un indice ................................................................. 129Applicazione di stili alle voci di indice ......................................................... 129Finestra di dialogo Segna voce di indice analitico.......................................... 130Finestra di dialogo Indice ............................................................................ 130Nuove opzioni degli stili ......................................................................... 130Colonne ................................................................................................. 131

Creazione di intestazioni di indice ............................................................... 131Utilizzo delle funzionalità PDF ........................................................................ 132Creazione di segnalibri PDF ........................................................................ 132

6

Page 7:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Impostazione di livelli di struttura su un paragrafo................................... 132Collegamenti ipertestuali in PDF ................................................................. 133Inserimento di segnalibri come destinazioni di collegamentiipertestuali ............................................................................................. 133Inserimento di collegamenti ipertestuali PDF nel documento .................... 133Aggiunta di collegamenti ipertestuali URL dinamici ................................. 134Aggiunta di testo alternativo ai collegamenti ipertestuali .......................... 134

Progettazione di documenti PDF compilabili................................................ 135Aggiunta di un controllo modulo al documento ....................................... 136

Aggiunta di firme digitali............................................................................ 138Creazione di segnaposto di firma............................................................. 138Creazione di firme .................................................................................. 138

Aggiunta del testo alternativo ......................................................................... 140Utilizzo di indicatori per l’elaborazione del documento..................................... 140Caricamento dell’elenco degli indicatori ....................................................... 140Inserimento di un indicatore nel documento................................................. 141Forzatura del recto di una nuova pagina ...................................................... 141

Aggiunta di una descrizione di modello........................................................... 142

Capitolo 6 Aggiunta della variabilità ai modelli .......................................................... 143Filtri .............................................................................................................. 143Logica del gruppo di contenuti.................................................................... 144Definizione della logica delle espressioni condizionali .................................. 144Definizione della logica del semplice confronto ............................................ 145

Creazione di un gruppo di contenuti ............................................................... 146Definizione di criteri per un gruppo di contenuti .......................................... 146Gruppi di contenuti nidificati ...................................................................... 147

Creazione di istanze di contenuto .................................................................... 147Aggiunta di un’istanza di contenuto ............................................................ 148Definizione dei criteri per le istanze di contenuto.......................................... 148Duplicazione di un’istanza di contenuto ...................................................... 149Visualizzazione di un contenuto specifico nel modello .................................. 149

Utilizzo di selezioni rapide e di varianti ........................................................... 149Impostazione di selezioni rapide in un modello ............................................ 150Creazione di varianti .................................................................................. 151Gestione di set di selezioni rapide nel modello ............................................. 152

Loop di contenuto .......................................................................................... 153Definizione di un loop di contenuto ............................................................. 153Creazione di loop di contenuto nidificati .................................................. 154

Criteri di filtro loop..................................................................................... 154

Capitolo 7 Utilizzo di immagini ................................................................................... 157Supporto delle immagini................................................................................. 157Formati immagine non supportati ............................................................... 158Impostazione dell’opzione di preferenza immagine .................................. 159

Scelta del formato di immagine corretto ....................................................... 160Immagini PDF ........................................................................................ 161Immagini EPS ........................................................................................ 161Immagini JPEG....................................................................................... 162Immagini TIFF ....................................................................................... 162Immagini WMF ...................................................................................... 163Supporto profili colore ICC ..................................................................... 164

Opzioni di formattazione supportate ........................................................... 164Utilizzo degli ancoraggi .............................................................................. 165

Preparazione delle immagini per l’utilizzo nei documenti ................................. 165

7

Page 8:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Tipi di immagine di xPresso ............................................................................ 166Variabili immagine ......................................................................................... 166Definizione di un percorso di immagine relativo o assoluto ........................... 167Definizione del percorso di un’immagine tramite un’espressione ................... 167

Immagini di contenuto universale ................................................................... 168Aggiunta di testo alternativo alle immagini ...................................................... 169Utilizzo di immagini all’interno di output PostScript ........................................ 170Utilizzo di immagini nell’output PDF e PPML .................................................. 171

Capitolo 8 Utilizzo delle tabelle .................................................................................. 173Supporto alle tabelle di Word .......................................................................... 173Impostazioni di tabella................................................................................ 173

Definizione delle proprietà della tabella ........................................................... 174Intestazioni e piè di pagina di tabella ........................................................... 175Righe isolate nella tabella ............................................................................ 175

Utilizzo delle funzioni di tabella ...................................................................... 176Utilizzo di tabelle dinamiche ........................................................................... 177Variabili tabella .......................................................................................... 177Definizione degli attributi della variabile tabella ....................................... 178

Limiti della cella ......................................................................................... 179Creazione di una tabella dinamica con loop di contenuto .............................. 179

Capitolo 9 Utilizzo di contenuto riutilizzabile .............................................................. 181Vantaggi dell’utilizzo del contenuto riutilizzabile ............................................. 182Inserimento di contenuto riutilizzabile............................................................. 182Aggiornamento del contenuto riutilizzabile...................................................... 184Creazione di contenuto riutilizzabile all’interno del modello ............................. 184

Capitolo 10 Utilizzo di contenuto universale ................................................................ 187Vantaggi dell’utilizzo di contenuto universale .................................................. 187Tipi di contenuto universale ............................................................................ 188Posizioni supportate per il contenuto universale ............................................... 188Inserimento di contenuto in intestazioni e piè di pagina di tabella.................. 189

Aggiunta di contenuto universale a un modello principale ................................ 190Creazione di un sommario combinato .......................................................... 191Aggiunta di contenuto del tipo di documento xPresso .................................. 191Valori di variabili tra documenti .............................................................. 194

Aggiunta di contenuti di tipo PDF o TIFF..................................................... 195Aggiunta di contenuto di tipo .docx di Word ................................................ 196Opzioni di layout ....................................................................................... 198Formattazione di riferimenti file variabili ..................................................... 200Selezione del contenuto in un altro repository .............................................. 201

Contenuto universale nell’output PDF/UA ....................................................... 201Visualizzare o nascondere il contenuto universale di xPresso for Word .............. 202Apertura di contenuto universale .................................................................... 203Aggiornamento del contenuto universale ......................................................... 203Creazione di contenuto universale ................................................................... 204

Capitolo 11 Utilizzo di grafici dinamici ......................................................................... 207Informazioni sui grafici dinamici ..................................................................... 207

8

Page 9:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Utilizzo di grafici da una versione precedente di xPresso .............................. 208Tipi di grafico supportati ............................................................................ 208Caratteri per grafici..................................................................................... 209Dati del grafico........................................................................................... 211Dati dinamici e statici ............................................................................. 212

Creazione di un modello di grafico .................................................................. 212Supporto colore .......................................................................................... 213Formato data usato nei grafici ..................................................................... 213

Inserimento di un elemento grafico dinamico ................................................... 214Importazione di un modello di grafico ............................................................. 214Esportazione di un modello di grafico.............................................................. 214Specifica della definizione dei dati ................................................................... 215Specifica dei dati per i grafici cumulativi ...................................................... 215Specifica dei dati per i grafici XY e temporali ................................................ 217Specifica dei dati per i grafici indicatore ....................................................... 219Specifica dei dati per i grafici azionari .......................................................... 221Specifica dei dati per altri tipi di grafici ........................................................ 221

Aggiunta di testo alternativo a grafici dinamici................................................. 223

Capitolo 12 Impostazione di artefatti per i documenti PDF/UA ..................................... 225Impostazione dei paragrafi come artefatti......................................................... 225Impostazione dei paragrafi secondari come artefatti.......................................... 226Visualizzazione degli artefatti paragrafo nel documento ................................... 227Rimozione delle impostazioni degli artefatti paragrafo...................................... 227

Capitolo 13 Verifiche e controlli dei modelli ................................................................. 229Informazioni di diagnostica............................................................................. 229Analisi di impatto........................................................................................... 230Verifica del modello ........................................................................................ 230Verifica dei dati campione ........................................................................... 231Verifica dei canali ....................................................................................... 231Verifica delle selezioni rapide ...................................................................... 232

Archiviazione di un modello ........................................................................... 232Archiviazione nel repository xPression ........................................................ 232Archiviazione nel repository xPression Documentum ................................... 233Archiviazione di un nuovo documento .................................................... 233Archiviazione di un documento modificato .............................................. 234

Problemi con l’archiviazione di documenti ................................................... 234Modelli di assemblaggio ................................................................................. 234

Capitolo 14 Utilizzo di modelli precedenti alla versione 4.5 .......................................... 237Modifiche introdotte dall’aggiornamento ......................................................... 237Risultati diversi di calcoli numerici per le variabili funzione xPresso .............. 241Fedeltà....................................................................................................... 242Impostazione del grassetto ...................................................................... 242Valori RGB dei colori .............................................................................. 242Spaziatura dei caratteri ........................................................................... 242Mantieni con il successivo ....................................................................... 242Formattazione diretta in un contenuto universale ..................................... 242Istanze di contenuto................................................................................ 243

Aggiornamento di un modello di una versione precedente alla 4.5..................... 243

9

Page 10:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Estrazione di un modello di una versione precedente alla 4.5 come laversione precedente ........................................................................................ 244Archiviazione di un modello di una versione precedente alla 4.5 comela versione precedente .................................................................................... 245Aggiunta di un modello di una versione precedente alla 4.5 al server................. 246

Capitolo 15 Visualizzazione in anteprima del documento ............................................ 247Anteprima con il primo record ........................................................................ 247Anteprima con più record ............................................................................... 248Specifica di un altro file di dati ........................................................................ 248

Capitolo 16 Creazione di output multicanale ................................................................ 251Associazione di canali a un modello................................................................. 251Aree modelli .................................................................................................. 252Modifica delle dimensioni dell’area.............................................................. 252Associazione di canali a un’area................................................................... 253

Utilizzo dei canali nel modello ........................................................................ 253Associazione di punti di inserimento a un’area ............................................. 253

Associazione di canali a flussi di output ........................................................... 254

Capitolo 17 Protezione ................................................................................................. 255Impostazione della protezione sola lettura in xPresso for Word ......................... 256Impostazione della protezione modulo in xPresso for Word .............................. 256Limitazioni per l’impostazione dell’intervallo di documentomodificabile in Microsoft Word ....................................................................... 256

Appendice A Funzioni xPath .......................................................................................... 259Funzioni stringa ............................................................................................. 259concat(string, string, string*) ....................................................................... 259contains() ................................................................................................... 260normalize-space(string)............................................................................... 260starts-with(string, string)............................................................................. 260string(object) .............................................................................................. 260string-length(string).................................................................................... 261substring(string, number, number) .............................................................. 261substring-after(string, string)....................................................................... 262substring-before(string, string) .................................................................... 262translate(string, to-match, replace-with) ....................................................... 262

Funzioni booleane .......................................................................................... 263boolean(object) ........................................................................................... 263false()......................................................................................................... 263lang(string) ................................................................................................ 263not(boolean)............................................................................................... 264true() ......................................................................................................... 264

Funzioni numeriche........................................................................................ 264ceiling(number) .......................................................................................... 264floor(number)............................................................................................. 264number(object) ........................................................................................... 264round(number)........................................................................................... 265sum(node-set) ............................................................................................ 265

Funzioni dei set di nodi................................................................................... 265count(node-set) .......................................................................................... 266last() .......................................................................................................... 266

10

Page 11:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

local-name(node-set)................................................................................... 266name(node-set)........................................................................................... 266namespace-uri(node-set) ............................................................................. 266position() ................................................................................................... 267

Appendice B Funzioni xPresso ....................................................................................... 269Funzioni numeriche........................................................................................ 269abs............................................................................................................. 269floor........................................................................................................... 270ceil ............................................................................................................ 270round ........................................................................................................ 270stringToInteger........................................................................................... 270

Funzioni logiche ............................................................................................. 270Campi vuoti e dati assenti ........................................................................... 271

Funzioni group .............................................................................................. 271groupCount ............................................................................................... 271groupSum.................................................................................................. 272Utilizzo di groupSum in un loop nidificato............................................... 272

groupMax .................................................................................................. 272groupMin .................................................................................................. 273

Funzioni stringa ............................................................................................. 273length ........................................................................................................ 273contains ..................................................................................................... 274toLowerCase .............................................................................................. 274toUpperCase .............................................................................................. 274trim ........................................................................................................... 274substring.................................................................................................... 275position ..................................................................................................... 275replace ....................................................................................................... 275numericToString......................................................................................... 275

Funzioni Datetime, Date e Time....................................................................... 276addYear ..................................................................................................... 276addMonth .................................................................................................. 276addDay...................................................................................................... 276now ........................................................................................................... 277

Appendice C Funzioni JavaScript ................................................................................... 279Funzioni object ............................................................................................... 279toString() ................................................................................................... 279toLocaleString() .......................................................................................... 280valueOf().................................................................................................... 280

Funzioni numeriche........................................................................................ 280Math.abs(number) ...................................................................................... 281Math.acos(number)..................................................................................... 281Math.asin(number) ..................................................................................... 281Math.atan(number)..................................................................................... 282Math.ceil(number) ...................................................................................... 282Math.cos(number) ...................................................................................... 282Math.exp(number)...................................................................................... 283Math.floor(number) .................................................................................... 283Math.log(number) ...................................................................................... 283Math.max(number1, number2) .................................................................... 284Math.min(number1, number2) .................................................................... 284Math.pow(base, exponent) .......................................................................... 284Math.random() ........................................................................................... 285Math.round(number) .................................................................................. 285

11

Page 12:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Math.sin(number)....................................................................................... 286Math.sqrt(number) ..................................................................................... 286Math.tan(number) ...................................................................................... 286eval(x)........................................................................................................ 286isNaN(testValue) ........................................................................................ 287parseInt(string [,radix]) ............................................................................... 287parseFloat(string) ....................................................................................... 287isFinite(number) ......................................................................................... 287toFixed(fractionDigits) ................................................................................ 288toExponential(fractionDigits) ...................................................................... 288toPrecision(precision) ................................................................................. 288

Funzioni stringa ............................................................................................. 288charAt(index) ............................................................................................. 289charCodeAt(pos) ........................................................................................ 289concat( [string1 [, string2 [, ]]]) ..................................................................... 289indexOf(searchValue, [fromIndex]) .............................................................. 290lastIndexOf(searchValue, [fromIndex])......................................................... 290localeCompare(that) ................................................................................... 290match(regexp) ............................................................................................ 291replace(searchValue, replaceValue) .............................................................. 291substring(indexA, indexB)........................................................................... 292search(regexp)............................................................................................ 292slice(start, end) ........................................................................................... 293split(separator, limit) .................................................................................. 293toLowerCase() ............................................................................................ 294toLocaleLowerCase() .................................................................................. 294toUpperCase() ............................................................................................ 294toLocaleUpperCase() .................................................................................. 295length ........................................................................................................ 295

Funzioni DataOra ........................................................................................... 295Date.parse(dateString) ................................................................................ 296getDate() .................................................................................................... 296getYear() .................................................................................................... 296getMonth() ................................................................................................. 296getDay()..................................................................................................... 296getTime() ................................................................................................... 297getHours() ................................................................................................. 297getMinutes()............................................................................................... 297getSeconds()............................................................................................... 297getTimezoneOffset() ................................................................................... 297setDate(dayValue) ...................................................................................... 297setHours(hoursValue) ................................................................................. 297setMinutes(minutesValue)........................................................................... 298setMonth(monthValue) ............................................................................... 298setSeconds(value) ....................................................................................... 298setTime(value)............................................................................................ 298setYear(value)............................................................................................. 298toGMTString()............................................................................................ 298toLocaleString() .......................................................................................... 298Date.UTC(year, month, day [, hrs] [, min] [, sec]) .......................................... 299

Funzioni array................................................................................................ 299toString() ................................................................................................... 299toLocaleString() .......................................................................................... 300concat( [item1 [, item2 [, ]]])......................................................................... 300join(separator) ............................................................................................ 300pop() ......................................................................................................... 300push( [item1 [, item2 [, ]]]) ........................................................................... 301reverse()..................................................................................................... 301

12

Page 13:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

shift()......................................................................................................... 301slice() ......................................................................................................... 301sort().......................................................................................................... 302splice(start, deleteCount [, item1 [, item2 [, ]]]) .............................................. 302unshift( [item1 [, item2 [, ]]])........................................................................ 302length ........................................................................................................ 303

Appendice D Formattazione a livello di pagina ............................................................... 305Opzioni di impostazione della pagina .............................................................. 305Opzioni relative ai margini.......................................................................... 306Opzioni relative alla carta ........................................................................... 306Alimentazione........................................................................................ 306

Opzioni di layout ....................................................................................... 307Allineamento verticale ............................................................................ 307

Opzioni relative alle interruzioni di pagina e di sezione .................................... 307Gestione delle definizioni di sezione ............................................................ 308

Opzioni relative alle colonne ........................................................................... 308Bilanciamento colonne ................................................................................ 309Inserimento di un colonna nel documento.................................................... 309

Opzioni di data e ora ...................................................................................... 309Opzioni relative all’intestazione e al piè di pagina ............................................ 309Opzioni di numerazione pagine....................................................................... 310Opzioni di formattazione dei numeri di pagina ............................................ 313Inserimento del numero di pagina ............................................................... 313Inserimento del numero di pagine con il campo NUMPAGES ....................... 314Inserimento di Pagina X di Y in intestazioni e piè di pagina ........................... 314Riavvio della numerazione pagine per il contenuto universale................... 314

Campi di Microsoft Word................................................................................ 315

Appendice E Formattazione a livello di paragrafo .......................................................... 317Configurazione della formattazione a livello di paragrafo ................................. 317Opzioni dei paragrafi: Rientri e spaziatura ................................................... 317Allineamento giustificato ........................................................................ 318Rientro................................................................................................... 318Capolettera ............................................................................................ 318

Opzioni dei paragrafi: Tabulazioni .............................................................. 319Opzioni dei paragrafi: Distribuzione testo.................................................... 319Bordi ......................................................................................................... 319

Sillabazione.................................................................................................... 320Trattini supportati ...................................................................................... 320Opzioni di sillabazione ............................................................................... 320Forzatura della sillabazione automatica ....................................................... 321

Tabelle ........................................................................................................... 321Opzioni per l’inserimento di tabelle ............................................................. 322Proprietà tabella: opzioni della scheda Tabella.............................................. 322Proprietà tabella: opzioni della scheda Riga ................................................. 323Ripeti come riga di intestazione in ogni pagina ......................................... 323

Proprietà tabella: opzioni della scheda Colonna............................................ 323Proprietà tabella: opzioni della scheda Cella................................................. 323Allineamento del contenuto delle celle ..................................................... 324

Opzioni di stile delle tabelle ........................................................................ 324Opzioni di bordi e sfondo ........................................................................... 324Creazione di tabelle .................................................................................... 324

Bordi e sfondo ................................................................................................ 325Finestra di dialogo Bordi e sfondo ............................................................... 325

13

Page 14:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Opzioni della scheda Bordi ..................................................................... 325Stili supportati per i bordi ................................................................... 326Posizione bordo.................................................................................. 326

Opzioni di Bordo testo ............................................................................ 326Opzioni della scheda Bordi pagina........................................................... 326Opzioni della scheda Sfondo ................................................................... 327

Linee orizzontali......................................................................................... 327Elenchi puntati ............................................................................................... 327Opzioni degli elenchi puntati ...................................................................... 328Punti elenco immagine............................................................................ 328

Creazione di un semplice elenco puntato ..................................................... 328Creazione di elenchi puntati con stili Microsoft ............................................ 329Creazione di elenchi puntati per output AFP ................................................ 329

Elenchi numerati ............................................................................................ 329Opzioni degli elenchi numerati.................................................................... 330Opzioni delle strutture di elenchi numerati .................................................. 330Menu Proprietà elenchi numerati ................................................................ 331Creazione di un semplice elenco numerato................................................... 331Creazione di elenchi numerati con il campo Seq ........................................... 332Elenchi numerati a su più livelli con il campo Seq ......................................... 332Riavvio della numerazione negli elenchi Seq ............................................ 333

Appendice F Formattazione a livello di carattere ........................................................... 335Configurazione della formattazione a livello di carattere ................................... 335Opzioni relative al carattere......................................................................... 335Sottolineatura e barrato........................................................................... 336Apice e pedice ........................................................................................ 337

Effetti di testo ............................................................................................. 337Opzioni relative al carattere: Avanzate ......................................................... 337Scala ...................................................................................................... 338Spaziatura e crenatura ............................................................................ 338

Opzioni aggiuntive per i caratteri ................................................................ 339Caratteri speciali............................................................................................. 339Supporto dei caratteri speciali di Microsoft Word ......................................... 339Glossario.................................................................................................... 340ALT + combinazioni di numeri .................................................................... 340

WordArt ........................................................................................................ 340Capolettera .................................................................................................... 340Riga della firma .............................................................................................. 341Object ............................................................................................................ 341Equazione ...................................................................................................... 341

Appendice G Funzionalità speciali di Microsoft Word .................................................... 343Creazione di righelli orizzontali e verticali ....................................................... 343Opzioni dei righelli orizzontali e verticali: colori delle linee e stili .................. 344Opzioni dei righelli orizzontali e verticali: Dimensioni.................................. 344Opzioni dei righelli orizzontali e verticali: disposizione testo ........................ 345Opzioni dei righelli orizzontali e verticali: posizione..................................... 345

Filigrana ........................................................................................................ 346Temi .............................................................................................................. 346Sfondo pagina ................................................................................................ 346Caselle di testo e cornici .................................................................................. 346Colore............................................................................................................ 346

14

Page 15:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Sommario ...................................................................................................... 346Note a piè di pagina........................................................................................ 346Controlli per sviluppatori................................................................................ 347Riga della firma .............................................................................................. 347Object ............................................................................................................ 347Smart Art ....................................................................................................... 347

15

Page 16:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Sommario

Elenco delle figure

Figura 1. Cartella Variabili cliente legacy............................................................................ 238

16

Page 17:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Prefazione

Benvenuti in xPresso for Word. xPresso for Word consente di utilizzare i dati delle variabili eMicrosoft Word per creare proposte, contratti, fatture e corrispondenza professionali ed estremamentepersonalizzati.

DestinatariLa guida per l’utente di xPresso for Word contiene le informazioni necessarie a un utente di MicrosoftWord esperto per utilizzare xPresso. L’utente deve avere una conoscenza operativa di MicrosoftWord 2010 o 2013 e avere dimestichezza con i dati XML che verranno impiegati nei documenticreati con xPresso for Word.

In questa guida non vengono fornite istruzioni sull’utilizzo delle funzionalità di base di Word, ameno che tali funzionalità non presentino caratteristiche specifiche in caso di utilizzo con xPressofor Word. Non vengono inoltre fornite istruzioni sulla creazione dei dati. Sono tuttavia fornitelinee guida per la creazione di dati compatibili con xPresso, nonché informazioni sull’utilizzo deidati con xPresso for Word.

ConvenzioniIn questo documento sono state utilizzate le seguenti convenzioni:

Tipo dicarattere

Significato

grassetto Elementi dell’interfaccia grafica dell’utente associati a un’azione

corsivo Titoli di libri, testo enfatizzato o variabili segnaposto per le quali è necessariospecificare determinati valori

monospace Comandi all’interno di un paragrafo, URL, codici negli esempi, testo visualizzatosullo schermo o immesso dall’utente

xPressionHome

Il termine "xPressionHome" fa riferimento al percorso di installazione di xPression sul server. Suiserver Windows, il percorso predefinito è C:\xPression

17

Page 18:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Prefazione

Cronologia revisioniA questo documento sono state apportate le modifiche elencate di seguito.

Data della revisione Descrizione

Novembre 2016 Prima pubblicazione

18

Page 19:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 1Introduzione a xPresso for Word

L’interfaccia di xPresso si integra con Microsoft Word e include la pagina di backstage di xPresso e lascheda Progettazione di xPresso for Word nella barra multifunzione di Word. Per iniziare a lavorarein xPresso for Word, vedere le sezioni seguenti:• Aggiornamento della licenza, pagina 19

• Informazioni sui documenti di xPresso for Word, pagina 19

• Directory di configurazione, pagina 20

• Avvio di xPresso for Word, pagina 21

• Utilizzo del server xPression, pagina 22

• Utilizzo dei modelli del documento, pagina 34

• Apertura di un modello esistente, pagina 35

• Utilizzo della scheda Progettazione di xPresso for Word, pagina 40

• Utilizzo del pannello Esplora, pagina 40

• Utilizzo di contenuto nel canvas, pagina 44

Aggiornamento della licenzaSe si riceve una nuova licenza di xPresso for Word da EMC Licensing, è possibile effettuare laregistrazione della nuova licenza facendo clic su Imposta chiave di licenza nella pagina di backstagedi xPresso (File > xPresso). Quando viene visualizzata la finestra di dialogo Informazioni sullalicenza, sostituire la chiave di licenza corrente con la nuova. La finestra di dialogo Informazionisulla licenza consente di visualizzare tutte le informazioni sulla registrazione e la licenza associataall’installazione di xPresso for Word.

Informazioni sui documenti di xPresso forWordUn documento xPresso for Word è un documento di Microsoft Word con funzionalità avanzate checonsentono di rendere il documento variabile e dinamico. La struttura del documento xPresso viene

19

Page 20:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

realizzata nel modello di xPresso for Word, che contiene tutte le possibili combinazioni di contenutoper il documento finale. Un singolo modello può produrre più documenti, ciascuno dei quali concontenuto differente. Un normale documento di Word non consente una tale variabilità e consente dicreare solo un documento con un unico set di contenuti.

È possibile utilizzare un normale documento di Word come base per il modello xPresso for Word.Se si apre un modello di xPresso in un normale documento di Word, tutte le caratteristiche divariabilità andranno perdute.

Quando i modelli di xPresso for Word vengono salvati in locale mantengono l’estensione .docx del filedi Word. È inoltre possibile salvare i modelli di xPresso for Word in un formato chiamato pacchetto,supportato per la pubblicazione. Quando viene salvato in locale, un pacchetto presenta un’estensionefile .xword. Quando i modelli vengono archiviati in un repository del server, xPression salva i filecome pacchetti ma senza alcuna estensione file.

Documenti creati in una versione precedente

La versione 4.5 di xPresso for Word e le versioni successive hanno subito modifiche significativerispetto alle versioni precedenti. Per questo motivo, i documenti di xPresso for Word creati in unaversione di xPression precedente alla 4.5 non sono supportati in questa versione di xPresso for Word.È possibile aggiornare i documenti di una versione precedente alla 4.5 alla versione più recente eaprirli in un client della versione corrente.

Dopo l’aggiornamento, tuttavia, i documenti potrebbero presentare alcune differenze rispettoalla versione originale e richiedere un aggiornamento manuale. Per ulteriori informazionisull’aggiornamento dei modelli di una versione precedente alla 4.5 e sulle differenze dopol’aggiornamento, vedere Capitolo 14, Utilizzo di modelli precedenti alla versione 4.5.

Se è necessario apportare modifiche ad un documento di una versione precedente alla 4.5 e non sidesidera aggiornarlo, è possibile estrarre il documento dal server attraverso la versione più recentedel client e salvarlo in locale. Aprire il documento e apportare le modifiche nella versione precedentedel client, quindi archiviare il documento mediante la versione più recente. Per informazioni sucome estrarre e archiviare i documenti di una versione precedente alla 4.5 con la versione piùrecente del client, vedere Estrazione di un modello di una versione precedente alla 4.5 come laversione precedente, pagina 244 e Estrazione di un modello di una versione precedente alla 4.5 comela versione precedente, pagina 244.

Directory di configurazioneQuando xPresso for Word è installato, viene creata una directory di configurazione nel sistema in cuisono memorizzati alcuni file di programma. Quando si avvia xPresso for Word per la prima volta,questi file vengono copiati nella directory dell’utente. Ciò si verifica ogni volta che l’applicazioneviene avviata da un utente diverso, pertanto ogni utente avrà la propria directory di configurazionesu un computer specifico.

20

Page 21:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Al momento dell’installazione, la directory di configurazione è:• Your_Drive:\ProgramData\xPresso\Version\Unity Designer\Config

Quando xPresso for Word viene avviato da un utente per la prima volta, i file vengono copiati in:• Your_Drive:\Users\User\AppData\Roaming\xPresso\Version\Unity Designer\

Avvio di xPresso for WordxPresso for Word è un componente aggiuntivo di Microsoft Word e viene caricato durante il processodi avvio di Microsoft Word. È possibile accedere alle funzionalità di xPresso for Word mediante lacreazione di un nuovo modello dalla pagina di backstage di xPresso o l’apertura di un modellodi documento esistente di xPresso for Word versione 4.5 o successive. Se si utilizza un normaledocumento di Word, sarà possibile visualizzare l’opzione xPresso nel menu File di Word.

A seconda dell’impostazione di sicurezza della macro di Microsoft Word, è possibile ricevere unavviso di protezione in cui si indica che le macro sono state disabilitate quando si apre un documentodi xPresso for Word. Per risolvere il problema, selezionare File > Info > Abilita contenuto > Opzioniavanzate e selezionare Considera attendibili tutti i documenti che provengono da questo autore.

Nota: non aprire più modelli di documento di xPresso for Word da Esplora risorse selezionandoli efacendo clic su Apri o suModifica dal menu di scelta rapida. Per aprire più modelli, utilizzare lafunzione Apri nel menu File di Word.

Blocco di Microsoft Word all’avvio

Se il processo di avvio di Microsoft Word si blocca durante il caricamento di xPresso for Word, aprirela Gestione attività di Windows e terminare i seguenti processi:• xPressoPInvokeProxy.exe *32

• WINWORD.EXE

Dopo avere interrotto i processi, riavviare Microsoft Word.

Voce di xPresso mancante nel menu File

In alcuni casi, è possibile che la voce di xPresso non venga visualizzata nel menu File di Word inseguito all’avvio, anche al termine di una corretta installazione di xPresso for Word. In tal caso,attenersi alla procedura riportata di seguito.

Attivazione del componente aggiuntivo xPresso for Word

1. Fare clic su File > Opzioni. Viene visualizzata la finestra di dialogo Opzioni di Word.

2. Fare clic su Componenti aggiuntivi nel riquadro di spostamento. Viene visualizzata la paginaVisualizzazione e gestione dei componenti aggiuntivi di Microsoft Office.

21

Page 22:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

3. Nell’elenco a discesa Gestisci, selezionare Elementi disabilitati e fare clic su Vai. Vienevisualizzata la finestra di dialogo Elementi disabilitati. Verificare che xWord Designer NON siapresente nell’elenco. In caso contrario, abilitare xWord Designer selezionandolo nell’elencoe facendo clic su Abilita.

4. Selezionare Componenti aggiuntivi COM dall’elenco a discesa di gestione alla fine della pagina,quindi fare clic su Vai. Viene visualizzata la finestra di dialogo Componenti aggiuntivi COM.

5. Fare clic su xWord Designer, quindi su OK. Dopo alcuni istanti viene visualizzata la finestra didialogo e la voce di xPresso sarà visibile nel menu File di Word.

Utilizzo di xPresso for Word 4.2 sulla stessaworkstationxPresso for Word 4.6 e 4.2 possono essere installati sulla stessa workstation. xPresso for Word 4.6viene avviato quando si avvia Microsoft Word, si apre un normale documento Word o si apreun documento xPresso 4.6. Con xPresso for Word 4.6, è possibile connettersi a un server 4.6 eutilizzare documenti 4.6, ma non è possibile connettersi a un server 4.2 o creare un modello basatosu un documento 4.2. xPresso for Word 4.2 viene avviato quando si apre un documento 4.2 daEsplora risorse. Utilizzando xPresso for Word 4.2, è possibile connettersi a un server 4.2 e utilizzaredocumenti 4.2; non è tuttavia possibile connettersi a un server 4.6.

Nota: Se nessun documento 4.2 è salvato sui dischi locali, per avviare xPresso forWord 4.2 è possibile utilizzare i documenti di esempio forniti. Tali documenti sitrovano in your_drive:\ProgramData\xPresso\your_xPresso_version\UnityDesigner\Packages.

Se vengono aperti sia il documento 4.6 che il documento 4.2, potrebbe verificarsi un ritardo nelpassaggio dal documento 4.6 al documento 4.2. Quando si passa da un documento all’altro laconnessione al server 4.2 viene perduta. Se un documento 4.2 viene estratto e la connessione al serverviene perduta, accedere al server con lo stesso account utente per estrarre di nuovo il file oppureannullare l’estrazione. Tutte le modifiche apportate andranno perdute.

Attenzione: Non estrarre e modificare un documento 4.2 quando un documento 4.6 è aperto.In caso contrario, se si passa da un documento 4.2 a un documento 4.6 e viceversa, tutte lemodifiche apportate andranno perse. Aprire il documento 4.2 in modalità di sola lettura.

Utilizzo del server xPressionI repository xPression sul server xPression consentono di memorizzare i documenti di xPresso e direnderli disponibili per la pubblicazione, nonché come contenuto riutilizzabile o universale. Mediantei processi di archiviazione ed estrazione, xPression garantisce a un unico utente alla volta la possibilitàdi apportare modifiche a una versione specifica di un documento. I repository forniscono inoltre unsistema di controllo delle versioni affinché le revisioni dei documenti siano facilmente tracciabili.

22

Page 23:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Repository di xPression

Per impostazione predefinita, il server xPression utilizza il repository xPression come area diarchiviazione principale per modelli di documenti, set di definizioni delle variabili, set di proprietàdei documenti e immagini. Il server xPression può anche essere concesso in licenza separatamente perutilizzare un repository docbase Documentum come un’area di archiviazione alternativa (denominataRepository xPression Documentum), in cui è possibile memorizzare modelli documento, set didefinizioni della variabile, set di proprietà del documento e immagini, nonché file di schema e datiXML e contenuto esterno. Questa funzionalità con licenza separata è denominata DocumentumEdition.

Se si dispone di una licenza per entrambi i repository, è possibile definire il repository che si desiderautilizzare come predefinito durante l’esecuzione delle azioni del server in xPresso for Word. Èpossibile impostare il repository predefinito nella pagina di backstage di xPresso (File > xPresso)selezionandolo dall’elenco nell’area Connessione server.

xPression applica la definizione delle versioni ai documenti quando vengono archiviati nel server.La definizione delle versioni viene gestita in maniera diversa tra i due repository. Con il repositoryxPression, i documenti utilizzano un sistema numerico per identificare le versioni documento. Con ilrepository xPression Documentum, il documento utilizza la definizione delle versioni normalmentedisponibile per gli elementi in un repository Documentum.

Oltre ai due repository principali, se il server xPression è configurato per accedere a un sistemaDocumentum o FileNet, risorse quali immagini, contenuto esterno e file di dati possono esserememorizzate in repository docbase Documentum o FileNet, a cui è possibile accedere tramite xPressofor Word. Non è possibile memorizzare o recuperare modelli di documento da questi repositoryaggiuntivi tramite xPresso for Word.

In caso di dubbi sulla configurazione del server xPression a cui è possibile accedere, rivolgersiall’amministratore di sistema. Le opzioni visualizzate quando si accede al server tramite xPresso forWord dipendono dalla configurazione server.

Definizione delle versioni del repository xPression

I documenti memorizzati nel repository xPression utilizzano un sistema numerico per identificare leversioni documento. A un documento archiviato per la prima volta viene sempre attribuita la versione1.0. Alle successive archiviazioni, il numero di versione viene incrementato nei modi seguenti:

• Se la versione minore successiva è disponibile (e non esiste già nel sistema), è possibile archiviareil documento come la versione minore successiva o la versione maggiore successiva disponibile.

Ad esempio, se il documento estratto è un documento versione 1.0 e nel sistema non esistealcuna versione 1.1 oppure 2.0, è possibile archiviare il documento come un documento versione1.1 oppure 2.0.

• Se la versione minore successiva è già in uso, è possibile archiviare il documento come una nuovaversione derivata, come la versione minore successiva disponibile o come la versione maggioresuccessiva disponibile.

Ad esempio, se il documento estratto è un documento versione 1.0 e nel sistema esistono già unaversione 1.1 e una versione 1.2, è possibile archiviare il documento come un documento versione1.0.1.0, 1.3 oppure 2.0.

23

Page 24:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Se la versione più recente non è quella desiderata, è possibile tornare ad una versione precedente.Ad esempio, se si dispone di un modello versione 1.4, estrarre il modello ed archiviarlo di nuovocome versione 1.5. Se successivamente vengono rilevati problemi con la versione 1.5 e non siindividua la causa, è possibile estrarre di nuovo la versione 1.4, modificare il modello e archiviarlocome versione 1.6.

Una volta che un modello viene archiviato nel repository, non è possibile archiviare una versionesenza prima averne estratto una. In questo modo, l’utente che estrae il modello fa in modo che ilmodello sia bloccato, il che impedisce che venga aggiornato da più utenti contemporaneamente.Quando si archivia un modello, il modello deve avere lo stesso nome file del modello che è statoestratto. Ciò impedisce di archiviare accidentalmente il modello sbagliato. Tuttavia, se è necessarioarchiviare un modello diverso, è possibile ridenominare il modello come quello che è stato estrattoe archiviare il modello appena ridenominato.

Quando si importa un pacchetto PDPX nel repository xPression, al modello xPresso deve essereassegnata una versione. In caso contrario, archiviare il modello xPresso mediante xPresso for Word.Ai documenti importati nella versione 4.5 e successive del repository xPression da una versioneprecedente di xPression viene automaticamente assegnato il numero di versione 1.0. Per ulterioriinformazioni sulla migrazione dei documenti, vedere la Guida per l’utente di xAdmin.

Oltre alla versione numerica, è possibile applicare facoltativamente ai documenti l’elaborazionedella data di validità.

Elaborazione data di validità

La data di validità di un documento rappresenta la data in cui il documento diventa valido per ladistribuzione ai clienti. Le date di validità vengono impostate a livello di versione principale (trunk)e si applicano a tutte le versioni documento contenute nel trunk. È possibile attivare o disattivarel’elaborazione della data di validità da xPresso for Word o in xAdmin; tuttavia, le date di validitàpossono essere specificate solo da xPresso for Word.

Quando nel Server xPression viene pubblicato un documento abilitato per l’elaborazione della datadi validità per un cliente, la versione corretta del documento viene selezionata paragonando ladata di validità memorizzata alla data di validità elencata nel record cliente, un valore specificodefinito per la categoria nella quale risiede il documento, o all’ora di sistema. Il tipo di mappaturadelle date di validità viene definito per la categoria in xAdmin. Per ulteriori informazioni, vedere laGuida per l’utente di xAdmin.

Per poter essere selezionata, la data di validità del documento deve essere precedente alla data divalidità definita nella categoria. xPression determina il trunk valido della versione, quindi selezionala versione idonea più recente da tale trunk. Se sono disponibili più trunk, xPression seleziona iltrunk di versione più elevato. Se per la categoria viene definito un workflow, xPression consideraanche lo stato del workflow durante la determinazione della versione da selezionare.

Ad esempio, poniamo che l’account del cliente sia valido in data 1 gennaio 2010 e il repositoryxPression contenga tre versioni principali del documento con date di validità differenti: la versione3.x valida in data 1 febbraio 2010, la versione 2.x valida in data 1 dicembre 2009 e la versione 1.xvalida in data 6 marzo 2009. Il documento con data 1 febbraio 2010 della versione 3.x non è validoper questo cliente, in quanto la data di validità è successiva alla data di validità del cliente. Lerestanti due versioni del documento sono entrambe precedenti alla data di validità del cliente, ma inxPression verrà utilizzata la versione 2.x del trunk, poiché è la più recente. Si tratta del documentoche era disponibile e in uso alla data di disponibilità del cliente.

24

Page 25:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

L’utilizzo dell’elaborazione delle date di validità deve basarsi sulle seguenti condizioni per funzionarein modo adeguato:• Il documento deve essere archiviato in una categoria che contiene la mappatura per l’elaborazionedella data di validità e la categoria deve utilizzare un gruppo di origini dati xPresso. Per ulterioriinformazioni, vedere la Guida per l’utente di xAdmin.

• È necessario che il documento sia abilitato per le date di validità e che gli sia stata assegnatauna data di validità.

Data di ritiro

La data di ritiro è un attributo facoltativo che è possibile applicare a un documento abilitato perl’elaborazione della data di validità. La data di ritiro viene impostata con la data di validità a livellodi versione principale (trunk) e si applica a tutte le versioni documento contenute nel trunk. Ladata di ritiro rappresenta la data in cui il documento non è più valido. Quando viene applicata aun documento, questa data viene utilizzata in xPression per determinare quale documento è validoper uno specifico cliente. Poniamo lo stesso esempio utilizzato durante la spiegazione della data divalidità in Elaborazione data di validità, pagina 24, quindi che la data di validità del cliente sia l’1gennaio 2010 e che il repository xPression contenga tre versioni principali del documento con datedi validità differenti: la versione 3.x valida in data 1 febbraio 2010, la versione 2.x valida in data1 dicembre 2009 e la versione 1.x valida in data 6 marzo 2009. Il documento con data 1 febbraio2010 della versione 3.x continua a non essere valido in quanto la data di validità è successiva alladata di validità del cliente.

Delle due versioni rimanenti, si supponga che le date di ritiro siano impostate nel seguente modo:

• Data di validità della versione 2.x: 1 dicembre 2009; Data di ritiro: 30 dicembre 2009

• Data di validità della versione 1.x: 6 marzo 2009; Data di ritiro: 6 giugno 2010

Se non fosse specificata la data di ritiro, in xPression verrebbe selezionata la versione 2.x con data 1dicembre 2009, poiché è la versione più recente e dispone della data di validità più recente. Tuttavia,quando si utilizza la data di ritiro, la versione con data 1 dicembre viene esclusa in quanto ildocumento viene ritirato prima della data di validità del cliente. In questo esempio, in xPressionverrebbe selezionata la versione 1.x con data 6 marzo 2009, in quanto si tratta dell’unica versione inuso alla data di validità del cliente.

Strategie organizzative e di gestione

È consigliabile pianificare tutte le metodologie xPresso in base alle versioni numeriche. A tale scopo,utilizzare le funzionalità disponibili che supportano le varie strategie.

Trunk e versioni derivate

I tronchi sono le versioni derivate principali, ad esempio, 1.x, 2.x, 3.x e così via. La diramazione puòverificarsi da qualsiasi nodo della struttura delle versioni, generando versioni come la 1.2.1.5.6.0. Ladiramazione può verificarsi a qualsiasi livello richiesto, ma in genere deve essere più profonda diun solo livello.

25

Page 26:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

L’utilizzo di strategie dopo che, ad esempio, una versione viene rilasciata per la produzione, avviaun nuovo tronco per i successivi cicli di sviluppo. In questo modo viene mantenuta una chiaradistinzione tra le differenze esistenti fra i modelli ed è possibile correggere facilmente la versione inproduzione con un semplice aggiornamento di versione, ad esempio da 1.12 a 1.13.

Collegamento al contenuto di xPresso mediante versione

Quando si creano collegamenti al contenuto di xPresso, è possibile scegliere di eseguire ilcollegamento mediante la versione più recente o mediante una versione specifica. Quando ilcontenuto viene collegato mediante la versione più recente, il sistema risolve la versione più recentemediante il tronco oppure la versione derivata, in base all’approvazione e all’elaborazione della datadi validità. Per utilizzare questa funzionalità, è necessario pianificare a lungo termine se e quandocreare una versione derivata o un nuovo truck.

Poiché è sempre possibile correggere un modello in produzione quando il modello è collegatomediante la versione più recente, il collegamento mediante la versione più recente è spesso l’approcciopreferibile per collegare i modelli. Quando si aggiorna un modello, viene sempre selezionata laversione più recente. Le funzionalità di diramazione e definizione delle versioni consentono diaggiornare una versione specifica di qualsiasi modello mediante diramazione e di aggiungere ilmodello al sistema di produzione solo con la modifica desiderata. Se un modello viene collegatomediante una versione specifica, qualsiasi aggiornamento al modello non è incluso nell’output.

Ritiro di modelli

Se non si desidera utilizzare la versione più recente di un modello e si desidera utilizzare la versioneprecedente, è possibile ritirare la versione più recente. La versione ritirata non potrà essere selezionataper la pubblicazione. L’elaborazione della data di validità presenta una procedura diversa, anche seuna data di fine (data di ritiro) può essere utilizzata anche nell’elaborazione della data di validità. Perulteriori informazioni sul ritiro di un documento e del workflow, vedere Spostamento dei documentiall’interno del workflow, pagina 32.

Definizione delle versioni del repository xPression Documentum

Nel repository xPression Documentum, una versione rappresenta una copia di un file nel momentospecifico in cui il file è stato archiviato nel repository. Si può creare una nuova versione ogni volta chesi archivia il file. Le versioni consentono di tenere traccia delle modifiche apportate a un file. Quandosi crea o si importa un nuovo file nel repository, il numero di versione assegnato è 1.0. Quando siarchivia un file, si può decidere se creare una nuova versione del file o se sovrascrivere la versioneesistente. Per eseguire queste operazioni, è necessario disporre delle autorizzazioni appropriate.

• Se si crea una nuova versione, il file avrà un numero di versione più alto rispetto a quello cheaveva al momento dell’estrazione. Nel repository verrà comunque conservata una copia dellaversione precedente.

• Se si sovrascrive la versione esistente, il numero di versione del file non cambierà e non verràconservata alcuna copia della versione precedente.

26

Page 27:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

È possibile aumentare il numero di versione di un numero intero o semplicemente di un puntodecimale, ovvero un decimo. L’operazione di incremento del numero di versione in base a un numerointero è considerata una revisione principale, mentre quella di incremento del numero di versione inbase a un numero decimale è considerata una revisione secondaria. Ad esempio, estraendo la versione1.0 di un file e archiviandola come revisione di minore importanza, il file verrà memorizzato comeversione 1.1. Se si ripete la procedura, il file verrà successivamente memorizzato come versione 1.2.Se si decide poi di estrarre il file e di archiviarlo come revisione principale, il numero di versionedel file cambierà da 1.2 a 2.0. Il file archiviato più di recente è contrassegnato come CORRENTE. Glielenchi di file visualizzano sempre la versione corrente dei file, a meno che non sia stata selezionata lavisualizzazione di tutte le versioni.

Recupero di file sul server in un’applicazione diversada xPresso

Se il server xPression è configurato per utilizzare anche il repository xPression Documentum,i modelli documento possono essere archiviati nel repository xPression Documentum tramiteDocumentumWebtop o Documentum Administrator. Selezionare Documento (xprs_document) peril tipo quando si importa il file tramite Documentum.

Nota: Se si esegue la copia di file di pacchetto (.xword) tramite DocumentumWebtop o DocumentumAdministrator, accertarsi che il nome file sia univoco nella cartella di destinazione.

È possibile inoltre accedere a file di dati e di schema che si trovano sul server tramite xPresso forWord; tuttavia, non è possibile inserirli nel server tramite xPresso. I file di dati possono essere salvatinel repository xPression Documentum tramite DocumentumWebtop o Documentum Administrator,oppure in qualsiasi altro repository Documentum accessibile dal server, o tramite FileNet in qualsiasirepository FileNet. I file di dati non possono essere memorizzati nel repository xPression.

Set di definizioni della variabile e set di proprietà del documento possono essere salvati nei repositoryxPression e xPression Documentum solo tramite xPresso for Word; non è possibile importare questifile nei repository in modalità non in linea.

Connessione al server

Per connettersi al server xPression occorre eseguire l’accesso mediante xPresso for Word. Una voltaeseguito l’accesso e finché si utilizza il client xPresso for Word è possibile eseguire funzioni server.Non sarà necessario eseguire nuovamente l’accesso ogni volta che si desidera eseguire una nuovaoperazione server.

Per poter accedere a un server, è necessario prima definirlo. Per definire un server, è necessarioconoscere l’URL del server. Per accedere al server occorre conoscere il nome utente e la passwordutilizzati per il server.

Nota: Se si apre una finestra di dialogo Server selezionando una funzione online, assicurarsi dichiudere la finestra di dialogo eseguendo una selezione di file oppure facendo clic su Annulla.Lasciare aperta una finestra di dialogo Server mentre si lavora in xPresso for Word potrebbe causaredei problemi all’interno del software.

27

Page 28:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Definizione di un server

È possibile definire più server ai quali accedere tramite xPresso for Word. Per poter accedere a unserver, è necessario prima definirlo.

1. Visualizzare la pagina di backstage di xPresso selezionando File > xPresso in Microsoft Word.

2. Fare clic su Accedi nell’area Connessione server della pagina. Verrà visualizzata la finestra didialogo Accedi.

3. Fare clic sul pulsante Sfoglia nel campo Alias server. Viene visualizzata la finestra di dialogoGestisci elenco server.

4. Immettere il nome del server nella prima casella di modifica nella parte inferiore della finestra didialogo. L’alias è semplicemente un nome descrittivo per le impostazioni.

5. Immettere l’URL del server nella seconda casella di modifica. La sintassi per l’URL è la seguente:http://nomeserver:porta/xFramework

6. Fare clic su Aggiungi. Il server è ora visualizzato nell’elenco.

7. Fare clic su OK. Il server è ora disponibile per l’accesso.Se occorre aggiornare una definizione esistente del server, selezionare il server nell’elenco di aliase modificarne la definizione nelle caselle di modifica nella parte inferiore della finestra di dialogo.Al termine, fare clic su Aggiorna. Per rimuovere un server dall’elenco, selezionare il server e fareclic su Rimuovi.

Suggerimento: Se nella finestra di dialogo Accedi si seleziona l’elenco di server, sarà possibileutilizzare i tasti di scelta rapida riportati di seguito.• CTRL+B per aprire la finestra di dialogo Gestisci elenco server.

• CTRL+freccia GIÙ per visualizzare gli elementi contenuti nell’elenco.

Accesso a un server

Dopo aver definito un server, è possibile accedervi e iniziare ad utilizzarne le risorse.

Accesso a un server

1. Visualizzare la pagina di backstage di xPresso selezionando File > xPresso in Microsoft Word.

2. Fare clic su Accedi nell’area Connessione server della pagina. Verrà visualizzata la finestra didialogo Accedi.

3. Selezionare l’alias del server dall’elenco a discesa.

4. Digitare il nome utente utilizzato per il server. I nomi utente non possono contenere caratteriaccentati.

5. Digitare la password utilizzata per il server.

6. Fare clic su OK. Ciò conclude la procedura di accesso al server xPression. A questo punto sonodisponibili le altre opzioni online della pagina di backstage.

28

Page 29:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Nota: Se la connessione ECM utilizzata per accedere al repository xPression è stata creata su unserver dell’applicazione diverso da quello attualmente in uso, è possibile che si verifichi un erroredi crittografia sulla console del server dell’applicazione dopo che è stato eseguito l’accesso alserver xPression. Per risolvere questo errore, ripristinare il nome utente e la password sul serverdell’applicazione corrente.

Gestione dei documenti xPresso

Il server xPression fornisce un sistema di definizione delle versioni e un processo del workflow per idocumenti xPresso memorizzati nel repository xPression. La gestione delle versioni del documento edel workflow avviene nel dashboard ECM di xPresso for Word.

Per accedere al dashboard, fare clic su Estrai, Visualizza, Crea versione derivata, Flusso di lavoronell’area Connessione server della pagina di backstage di xPresso (File > xPresso).

Nota: tenere presente la possibile differenza di fuso orario tra il computer client e il server che ospitail repository. Quando si filtrano i risultati nel dashboard ECM, assicurarsi di regolare il fuso orario.

Nel dashboard ECM vengono elencati tutti i documenti contenuti nelle categorie a cui si ha accessoed è possibile eseguire le operazioni riportate di seguito.• Modificare la modalità di visualizzazione delle informazioni

• Filtrare l’elenco di documenti

• Utilizzare le versioni del documento

• Definire le date di validità e ritiro

• Spostare un documento all’interno del workflow

• Visualizzare la cronologia del workflow per un documento

• Eseguire un’anteprima online di un documento

• Eseguire un’analisi dell’impatto di un documento

La barra degli strumenti del dashboard ECM fornisce scelte rapide ad alcune operazioni di gestione.

Elemento Descrizione

Categoria Mostra i documenti per categoria.

Una volta selezionata una categoria, ECM Dashboard memorizza laselezione e la utilizza come categoria predefinita per l’apertura successivadel dashboard ECM.

Filtri Elenca i filtri disponibili per l’elenco di documenti.

Crea versionederivataprincipale

Consente di creare una nuova versione derivata principale per il documentoselezionato.

Impostazione eintervallo data

di validità

Consente di definire una data di validità e, facoltativamente, una data diritiro per determinare la data di validità del documento per la distribuzioneai clienti.

29

Page 30:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Elemento Descrizione

Azioni flusso dilavoro

Consente di selezionare un nuovo stato per un documento e di spostarloall’interno del workflowflusso di lavoro.

Azionipacchettolegacy

Consente di estrarre e archiviare un pacchetto di una versione precedentealla 4.5.

Anteprima Consente di eseguire un’anteprima online del documento selezionato.

Analisi diimpatto

Consente di eseguire un’analisi dell’impatto sul documento selezionato, alfine di determinare qualsiasi correlazione tra l’elemento selezionato e altridocumenti.

Cronologiaflusso di

lavoro

Consente di visualizzare una tabella che contiene la cronologia del workflowdel documento selezionato.

Visualizza Consente di controllare le informazioni visualizzate nell’elenco di documenti.

Tipo di filtro Consente di selezionare il tipo di filtro da utilizzare nella riga di filtrodell’elenco di documenti.

Modifica della visualizzazione delle informazioni

Per modificare il tipo di informazioni visualizzate nella tabella del documento, fare clic sul menuVisualizza e selezionare gli elementi riportati di seguito.• Mostra ritirati se si desidera visualizzare tutti i documenti con stato Ritirato nell’elenco didocumenti.

Nota: La versione più recente di un documento viene sempre visualizzata nell’elenco deidocumenti, anche se è stata ritirata e questa opzione non è selezionata.

• Tutte le colonne per visualizzare tutte le possibili colonne di dati.

• Selezionare le colonne di informazioni specifiche che si desidera visualizzare e deselezionarele colonne che non si desidera visualizzare.

Per ordinare l’elenco di documenti in base a colonne specifiche, attenersi alla procedura riportatadi seguito.• Trascinare l’intestazione di colonna all’interno della casella vuota nella parte superiore dellatabella. È possibile trascinare più colonne nella casella e l’elenco verrà ordinato in base all’ordinedi visualizzazione dei nomi di colonna nella casella.

Ad esempio, se si inserisce la colonna Stato, seguita dalla colonna Nome file e dalla colonnaVersione, i documenti vengono elencati prima per gruppi di stato, quindi all’interno di ciascungruppo di stato per nome file e versione.

• Per scegliere l’ordinamento crescente (freccia su) o decrescente (freccia giù), fare clic sullafreccia visualizzata con il nome di colonna. Per tutte le colonne, fatta eccezione per Nome file,

30

Page 31:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

l’intestazione di colonna deve essere posizionata nella casella vuota per l’ordinamento prima divisualizzare la freccia.

• Per rimuovere una colonna dallo schema di ordinamento, selezionare l’intestazione di colonnanella casella vuota, quindi trascinarla nuovamente nella posizione originale all’interno dellatabella.

Filtraggio dei documenti

Sono disponibili diversi modi per filtrare i documenti visualizzati nell’elenco.• È possibile filtrare l’intero elenco per visualizzare solo i documenti pertinenti selezionandouna delle seguenti opzioni dall’elenco di filtri: Lavoro personale, In attesa di approvazione, Inattesa di invio.

• È possibile filtrare una singola colonna digitando all’interno della riga filtro blu, al di sottodell’intestazione di colonna. Il tipo di filtro per questa funzione può essere selezionato dall’elencoTipo di filtro, in alto a destra del dashboard:— Semplice: consente di utilizzare una logica di filtraggio semplice basata su un carattere. Èsufficiente digitare il testo nella casella del filtro e l’elenco viene filtrato durante la digitazione.

— Caratteri jolly: consente di utilizzare i caratteri jolly nelle stringhe filtro. Per un elenco dicaratteri jolly, vedere Utilizzo di caratteri jolly, pagina 106.

— Espressioni regolari: consente di utilizzare espressioni regolari nelle stringhe filtro. Unaespressione regolare corrisponde a un criterio di testo che contiene caratteri ordinari e caratterispeciali denominati metacaratteri.

Utilizzo delle versioni documento

Per impostazione predefinita, l’elenco di documenti consente di visualizzare la versione più recentedel documento. Se sono disponibili più versioni di un documento, al di sotto del nome file vienevisualizzato un testo che specifica il numero di versioni precedenti disponibili insieme a unafreccia a sinistra del nome documento. Per visualizzare le versioni precedenti, fare clic sulla frecciavisualizzata nel campo Nome file.

Nel dashboard ECM è possibile creare una versione derivata del documento. La diramazioneconsente di creare una nuova versione del documento. Ad esempio, se la versione più recente di undocumento è la 2.2, la diramazione consente di creare la versione 2.3 o 3.0. Per creare una versionederivata di un documento, selezionare il documento dall’elenco e fare clic su Crea versione derivataprincipale. È possibile aggiungere un commento da associare alla nuova versione derivata. Leinformazioni su categoria e versione sono automatiche e non possono essere modificate.

Definizione delle date di validità e di ritiro

A tutti i documenti xPresso memorizzati nel repository xPression è possibile assegnare una data divalidità facoltativa. La data di validità di un documento rappresenta la data in cui il documentodiventa valido per la distribuzione ai clienti.

31

Page 32:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Per aggiungere o rimuovere l’elaborazione della data di validità di un documento è possibile utilizzareil dashboard ECM o xAdmin. Per ulteriori informazioni, vedere la Guida per l’utente di xAdmin.

Nel dashboard ECM è possibile applicare l’elaborazione della data di validità a un documentoutilizzando l’icona corrispondente, visualizzata dopo il nome file.

Per rimuovere l’elaborazione della data di validità da un documento, nel dashboard ECM fare clicsu Impostazione e intervallo data di validità oppure su CTRL+D e deselezionare la casella dicontrollo Usa elaborazione data di validità. L’elaborazione della data di validità viene rimossada tutte le versioni del documento.

Definizione dell’elaborazione della data di validità

1. Selezionare il documento dall’elenco e fare clic su Impostazione e intervallo data di validitàoppure premere CTRL+D.

2. Assicurarsi che sia selezionata la casella di controllo Usa elaborazione data di validità.

3. Assicurarsi che sia selezionata la versione corretta del trunk. La data di validità viene applicata atutte le versioni del documento all’interno del trunk selezionato.

4. Digitare la data che indica quando il documento sarà disponibile per l’utilizzo. Fare clic sullafreccia per visualizzare una funzione di calendario.

5. (Facoltativo) Digitare la data che indica quando il documento non sarà più disponibile perl’utilizzo. Fare clic sulla freccia per visualizzare una funzione di calendario.

Spostamento dei documenti all’interno del workflow

In xAdmin è possibile definire un workflow per le categorie di xPression. Tutti i documenti contenutinelle categorie dovranno essere conformi al workflow. Per ulteriori informazioni, vedere la Guidaper l’utente di xAdmin.

Nel dashboard ECM è possibile gestire lo stato del workflow dei documenti. Gli stati in base ai qualiè possibile impostare un documento dipendono dai diritti sul workflow definiti in xAdmin. Perinformazioni sui diritti dei workflow, rivolgersi all’amministratore di sistema xPression.

Nel sistema xPression workflow, quando unMittente (un utente con autorizzazione di scrittura) inviaun documento, lo stato del documento diventa Inviato. Per passare al livello del workflow successivo,un Approvatore (un utente con autorizzazione di approvazione) dovrà approvarne il contenuto.

Tutti i documenti che non dispongono di uno stato del workflow sono elencati come In sospeso. Se undocumento con stato Inviato viene migrato in un altro server, lo stato del documento appena migratotorna a essere In sospeso. Il documento di origine rimane invariato.

In qualità di utente xPresso for Word, è possibile inviare documenti. Se si dispone, inoltre, dei dirittidi approvazione, è possibile approvare o rifiutare i documenti. Con i diritti aggiuntivi appropriati, èpossibile ritirare un documento dal workflow.

Per modificare lo stato del workflow di un documento, selezionare il documento dall’elenco, fareclic su Azioni flusso di lavoro, quindi selezionare lo stato dall’elenco. Saranno disponibili solo glistati validi per l’utente. Se un documento viene rifiutato, per avanzare nel workflow sarà necessarioprocedere a un nuovo invio.

32

Page 33:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Visualizzazione della cronologia flusso di lavoro

È possibile visualizzare la cronologia del workflow di un documento selezionando il documento efacendo clic su Cronologia flusso di lavoro o su CTRL+H. Nell’elenco di documenti, viene visualizzatauna tabella sotto alla voce del documento contenente le informazioni riportate di seguito.• Data: la data in cui si è verificata l’azione.

• Azione: il nome dell’azione del workflow.

• Mittente: il nome dell’utente che ha eseguito l’azione.

• Owner: l’owner del documento.

• Commenti: qualsiasi commento associato all’azione.

Esecuzione dell’anteprima online

È possibile creare un’anteprima PDF del documento selezionando il documento e facendo clic suAnteprima PDF. Utilizzando la funzionalità di anteprima online, è possibile visualizzare l’anteprimanon solo dei documenti versione 4.5 e successive ma anche dei documenti di una versione precedentealla 4.5.

È possibile visualizzare i tag di un output PDF/UA solo con un lettore PDF/UA conforme; in casocontrario, l’output PDF/UA assume lo stesso aspetto di un normale output PDF.

Quando si utilizza la funzione di anteprima online, tutte le risorse provengono dal server. Se ildocumento principale contiene documenti locali come contenuto universale, il contenuto universaledeve essere memorizzato nel server con lo stesso percorso, in caso contrario, il contenuto non saràpresente nell’output di anteprima.

Per impostazione predefinita, se l’output del documenti è vuoto, xPression crea pagine bianchedurante l’anteprima o la pubblicazione. Per disabilitare la visualizzazione delle pagine bianche,impostare la proprietà xPressoSuppressEmptyOutput su true in xPRSconfig.xml. Tuttavia,se un documento xPresso contiene solo varabili di immagini vuote o immagini di contenutouniversale, xPression mostra sempre delle pagine bianche. Per ulteriori informazioni, consultarela guida di amministrazione del server xPression.

Esecuzione dell’analisi sull’impatto

xPresso for Word consente di determinare i documenti interessati dalle modifiche al documentoselezionato. L’analisi sull’impatto mostra quali altri documenti sono collegati al documentoselezionato o inclusi nel documento. Ciò consente di disporre di un quadro completo dell’impattoche un determinato documento ha su contenuti di altro tipo.

Per eseguire un’analisi sull’impatto dal dashboard ECM, selezionare il documento che si desideraanalizzare dall’elenco e fare clic su Analisi di impatto oppure su CTRL+I.

Per una descrizione completa della finestra di dialogo Analisi di impatto, vedere Analisi di impatto,pagina 230.

33

Page 34:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Utilizzo dei modelli del documentoUn modello di documento consente di progettare la rappresentazione visiva e il contenuto deidocumenti. I modelli sviluppati in xPresso for Word si basano sui documenti di Microsoft Word.

Quando si progetta un nuovo modello, sono disponibili le opzioni seguenti:• Creare un nuovo modello

• Utilizzare un modello di xPresso for Word già esistente

• Utilizzare un documento di Microsoft Word già esistente come base per un modello

Per creare un nuovo modello di documento, attenersi alla procedura riportata diseguito.

1. Avviare Microsoft Word.Per ulteriori informazioni, vedere Note di rilascio di xPression per l’elenco delle versioni necessariedi Microsoft Word.

2. Visualizzare la pagina di backstage di xPresso passando a File > xPresso.Se non viene visualizzata la voce di xPresso nel menu File, vedere la sezione Voce di xPressomancante nel menu File, pagina 21.

3. Nella casella Nome dell’area Nuovo modello digitare un nome per il nuovo modello. Il nomemodello non deve superare i 256 caratteri.

4. Cercare e selezionare una directory da usare come directory di lavoro.

5. Selezionare la casella di controllo Cerca documento Word esistente da utilizzare come base pernuovo modello per usare un documento locale di Microsoft Word. Se si lascia deselezionatala casella di controllo, il documento attualmente aperto in Microsoft Word viene utilizzatocome base per il nuovo modello. Se il documento corrisponde a un nuovo documento (o a undocumento vuoto), il nuovo modello sarà vuoto.

6. Selezionare l’opzione Richiedi file schema di dati del cliente all’avvio per abilitare la selezionedi un file di schema durante il processo di creazione del modello. Se si lascia deselezionataquesta casella di controllo, sarà possibile selezionare il file di schema in seguito alla creazionedel modello.

7. Fare clic su Avvia nuovo.xPresso for Word crea il nuovo modello. Durante il processo, attenersi alla procedura riportatadi seguito.• Se è stata selezionata la casella di controllo Cerca documento Word esistente da utilizzarecome base per nuovo modello, viene visualizzata la finestra di dialogo Apri. Selezionare ildocumento Microsoft Word che si desidera utilizzare per il modello e fare clic su Apri.

• Se è stata selezionata la casella di controllo Richiedi file schema di dati del cliente all’avvio,viene visualizzata la finestra di dialogo Schema dati. Individuare e selezionare il file dischema che si desidera utilizzare con il modello, quindi, se necessario, selezionare il recordche si ripete con maggiore frequenza all’interno del file e fare clic su OK.

Al termine del processo, un nuovo modello viene visualizzato in Microsoft Word e la schedaProgettazione di xPresso for Word viene visualizzata nella barra multifunzione di Word.

34

Page 35:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Apertura di un modello esistenteÈ possibile memorizzare i modelli di documento xPresso for Word in locale o sul server. Per aprirei modelli memorizzati localmente, utilizzare lo stesso approccio usato per tutti gli altri documentiin Microsoft Word. Per aprire i modelli memorizzati nel server xPression, utilizzare la pagina dibackstage di xPresso.

Nota: La pagina di backstage consente inoltre di aprire tutti i modelli visualizzati di recente,indipendentemente dalla posizione di memorizzazione.

Accesso ai modelli locali

È possibile accedere ai modelli di xPresso for Word (.docx) memorizzati in locale nel computer clientallo stesso modo di qualsiasi altro documento Microsoft Word:• Facendo doppio clic sul file del modello in Windows Explorer.

• Selezionando la voce di menu File > Apri.

• Selezionando un nome del documento desiderato nella scheda Recente del menu File.

Nota:• Non aprire più modelli di documento xPresso for Word da Windows Explorer selezionandolie facendo clic su Apri oModifica mediante il menu di scelta rapida. Per aprire più modelli,utilizzare la funzione Apri del menu File in Microsoft Word.

• Se si desidera salvare un modello dal server nel disco locale con un nome diverso, utilizzare lavoce di menu File > Salva con nome. Non rinominare il modello utilizzando Windows Explorer,altrimenti si verificherà un errore la volta successiva in cui si accede al server e si apre il modello.In tale caso, disconnettersi dal server, aprire il modello e salvarlo con un nome diverso.

Accesso a modelli recenti

L’areaModelli recenti consente di aprire un modello da un elenco di modelli visualizzati di recente.Per aprire il modello, fare clic sul nome del modello. Se si apre il documento in Microsoft Word, vienevisualizzata la scheda Progettazione di xPresso for Word nella barra multifunzione di Word.

Se non sono disponibili modelli visualizzati di recente, l’area non viene visualizzata nella pagina dibackstage di xPresso for Word.

Utilizzo dei modelli memorizzati nel repositoryxPression

L’area Connessione server della pagina di backstage di xPresso consente di aprire o estrarre unmodello memorizzato sul xPression Server nel xPression Repository.

35

Page 36:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

È possibile aprire i documenti esistenti esclusivamente per la visualizzazione (sola lettura) oppureper la modifica. Se si apre il documento per la visualizzazione, al termine delle operazioni dimodifica non sarà necessario archiviare nuovamente il documento sul server. Se un solo utente apreil documento per la modifica, il documento potrà essere aperto dagli altri utenti esclusivamente insola lettura. Se si apre il documento per la modifica, al termine delle operazioni sarà necessarioarchiviarlo oppure annullare l’estrazione.

Nota: Dati due documenti che risiedono in repository diversi, non è possibile aprirlicontemporaneamente per la modifica. Questa operazione causa problemi quando si cerca diarchiviare nuovamente i documenti. Per evitare questo problema, archiviare il primo documentoprima di estrarre il secondo.

È necessario effettuare l’accesso al server per utilizzare il xPression Repository.

Apertura di un modello memorizzato nel repository xPression

1. Passare al menu File > xPresso per visualizzare la pagina di backstage di xPresso.

2. Nel repository dei contenuti xPression dell’area Connessione server della pagina, fare clic suEstrai, Visualizza, Crea versione derivata, Flusso di lavoro.Viene visualizzato il dashboard ECM. Vengono elencati tutti i modelli di documento per i quali sidispone dei diritti di accesso.

3. Selezionare il modello che si desidera aprire. Se sono disponibili più versioni del modello, perimpostazione predefinita viene elencata la versione più recente. Per visualizzare le versioniprecedenti, fare clic sulla freccia accanto al nome file.

4. Fare clic su Visualizza per aprire il modello in sola lettura oppure su Estrai per aprire il modelloe apportare modifiche. Il modello viene aperto in Microsoft Word e viene visualizzata la schedaProgettazione di xPresso for Word nella barra multifunzione di Word.

Nota: L’estrazione simultanea di più versioni dello stesso modello non è supportata.

Utilizzo dei modelli in sola lettura

Quando si apre un modello per la visualizzazione, il modello di documento viene aperto insola lettura: i pannelli di Explorer vengono visualizzati con l’etichetta Sola lettura e la schedaProgettazione di xPresso for Word disporrà di un numero limitato di opzioni.

Per modificare un modello di sola lettura:

1. Selezionare un modello desiderato.

2. Nella scheda Progettazione di xPresso for Word fare clic su Estrai documento.Il modello viene estratto dal repository e aperto per la modifica in xPresso for Word. Se il modelloè già stato estratto in precedenza, viene aperto il modello attualmente estratto.

36

Page 37:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Salvataggio dei modelli per il lavoro offline

È possibile archiviare un modello come nuova versione derivata, principale o secondaria di unmodello esistente per lo scambio di documenti tra diversi sviluppatori e lavorare con questidocumenti in modalità offline.

Per salvare il modello per il lavoro offline:

1. Aprire un documento che si desidera utilizzare come modello per la modifica.

2. Selezionare File > xPresso.

3. Nell’area Azioni fare clic sul link Archivia come versione visualizzato quando il documentoaperto non è stato estratto in modalità online.

4. Nella finestra di dialogo Seleziona file visualizzata selezionare un file desiderato dal xPressionServer e fare clic su Archivia come.

5. Nella finestra di dialogo Imposta versione visualizzata specificare le proprietà desiderate per unnuovo modello, selezionare una versione del documento dall’elenco a discesa Nuova versionee fare clic su Conserva file estratti se si desidera continuare a lavorare con il file dopo che èstato archiviato nel server.

Nota: Se la versione del documento è stata già estratta da un altro utente, non è possibile selezionarla.

Utilizzo di modelli memorizzati nel RepositoryxPression Documentum

L’area Connessione server della pagina di backstage di xPresso consente di aprire o estrarre unmodello memorizzato sul xPression Server nel xPression Documentum Repository.

È possibile aprire i documenti esistenti esclusivamente per la visualizzazione (sola lettura) oppureper la modifica. Se si apre il documento per la visualizzazione, al termine delle operazioni dimodifica non sarà necessario archiviare nuovamente il documento sul server. Se un solo utente apreil documento per la modifica, il documento potrà essere aperto dagli altri utenti esclusivamente insola lettura. Se si apre il documento per la modifica, al termine delle operazioni sarà necessarioarchiviarlo oppure annullare l’estrazione.

Nota: Dati due documenti che risiedono in repository diversi, non è possibile aprirlicontemporaneamente per la modifica. Questa operazione causa problemi quando si cerca diarchiviare nuovamente i documenti. Per evitare questo problema, archiviare il primo documentoprima di estrarre il secondo.

È necessario effettuare l’accesso al server per utilizzare il xPression Repository.

Apertura di un modello memorizzato nel repository xPression Documentum

1. Selezionare il menu File > xPresso per visualizzare la pagina di backstage di xPresso.

2. Nell’area Connessione server della pagina individuare la sezione Documentum. Fare clic suEstrai per aprire il modello per la modifica oppure suVisualizza per aprire il modello in modalitàdi sola lettura.Viene visualizzata la finestra di dialogo ECM Server.

37

Page 38:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

3. Individuare e selezionare il documento che si desidera aprire. È anche possibile cercare un file.Per ulteriori informazioni, vedere Ricerca nel Repository xPression Documentum, pagina 38.Se nel server sono salvate più versioni di un documento, l’icona accanto al nome documentomostra un cerchio verde al suo interno anziché blu. Fare doppio clic sull’icona con il cerchioverde per visualizzare un elenco a discesa da cui è possibile selezionare la versione da aprire.

4. Fare clic suModifica o Apri.Il documento verrà aperto in xPresso for Word.

Ricerca nel Repository xPression Documentum

La finestra di dialogo ECM Server contiene una scheda Cerca che consente di cercare i filememorizzati sul server xPression mediante la ricerca semplice o la ricerca avanzata.

Utilizzo della ricerca semplice

Una ricerca semplice non incorpora alcun parametro di ricerca, ad eccezione di una stringa di ricerca,e viene eseguita sull’intero database del server. Le ricerche semplici sono utili se la parola chiave èmolto specifica e non restituisce troppi risultati.

Per effettuare una ricerca semplice:

1. Assicurarsi che il repository in cui si desidera svolgere la ricerca sia selezionato nell’elencoa discesa Server corrente.

2. Fare clic sulla scheda Cerca nella finestra di dialogo ECM Server.

3. Nel campo Nome digitare una stringa di ricerca.Si noti che la stringa di ricerca fa distinzione tra maiuscole e minuscole.

4. Fare clic su Cerca.I file trovati vengono visualizzati nell’elenco dei file sul lato destro della finestra di dialogo.

Utilizzo della ricerca avanzata

La ricerca avanzata consente di effettuare una ricerca più specifica e di incorporare più parametri inmodo da limitare i risultati, ad esempio specificando directory del server o proprietà del file.

Esecuzione di una ricerca avanzata:

1. Assicurarsi che il repository in cui si desidera svolgere la ricerca sia selezionato nell’elencoa discesa Server corrente.

2. Fare clic sulla scheda Cerca nella finestra di dialogo ECM Server.

3. Nel campo Nome digitare una stringa di ricerca.Si noti che la stringa di ricerca fa distinzione tra maiuscole e minuscole.

4. Fare clic su Ricerca avanzata per visualizzare ulteriori opzioni nella scheda Cerca.

38

Page 39:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

5. Selezionare le posizioni sul server in cui si desidera svolgere la ricerca:• Fare clic su RepositoryName. RepositoryName è il nome del repository attualmente selezionato.

Se si desidera eseguire una ricerca in directory specifiche all’interno del repository, fare clic suModifica per selezionarle. Verrà visualizzata la finestra di dialogo Cambia origini ricerca.— Individuare e selezionare una directory desiderata, quindi fare clic su Aggiungi.

— Ripetere per tutte le directory in cui si desidera effettuare la ricerca.

— Fare clic su OK. Tutte le directory selezionate verranno visualizzate nella casella dimodifica nella parte inferiore della sezione Posizioni.

• Fare clic su Solo posizione corrente per effettuare la ricerca solo nella directory che ha lo statoattivo nella scheda Sfoglia della finestra di dialogo ECM Server. Quando si seleziona questaopzione, la directory corrente viene visualizzata nella casella di testo al di sotto dell’opzione.

6. Digitare un nome utente per la proprietà Estrai per. Il nome fa distinzione tra maiuscole eminuscole. Se si immette un valore in questo campo, verranno cercati solo i documenti estrattidal nome utente specificato.

7. Digitare l’intervallo dei numeri di versione in cui si desidera effettuare la ricerca.

8. Selezionare un intervallo di date modificato per la ricerca:• Selezionare un periodo di tempo generale dall’elenco a discesa.

• Selezionare Da/A e specificare delle date.

9. Selezionare una dimensione di file.

10. Selezionare la casella di controllo Trova tutte le versioni se si desidera che la ricerca restituiscatutte le versioni di ciascun file trovato.

11. Fare clic su Cerca.I file trovati vengono visualizzati nell’elenco dei file sul lato destro della finestra di dialogo.

Annullamento di un’estrazione

Se dopo aver estratto un documento per la modifica si decide di non apportare alcuna modificao di non mantenere le modifiche apportate, è possibile annullare l’estrazione. L’annullamento diun’estrazione comporta le seguenti operazioni:• Rimuove il flag di estrazione dal documento sul server

• Chiude il documento in xPresso for Word

• Rimuove la copia locale del documento

Il documento rimane nel server nello stesso stato in cui si trovava quando è stato estratto e puòessere estratto da altri utenti.

È possibile annullare l’estrazione di documenti solo mediante lo strumento di progettazione dixPresso:• In Esplora modelli fare clic sul menu a discesa relativo alla radice modello e selezionare Annullaestrazione.

• Nella pagina backstage di xPresso fare clic su Annulla estrazione documento.

39

Page 40:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

xPresso for Word chiude il documento sul computer client e sul server il documento non risulterà piùcontrassegnato come estratto.

Apertura di un documento da Documentum

È possibile aprire un documento memorizzato in Documentum estraendo innanzitutto il documentotramite Documentum Administrator o Webtop e salvandolo nel file system. Dopo che il documento èstato estratto e memorizzato nel file system, è possibile fare doppio clic sul file per aprirlo in xPressofor Word.

Nota: Non è possibile aprire i documenti xPresso facendo doppio clic sugli stessi in DocumentumAdministrator o Webtop oppure utilizzando le opzioni Apri oModifica disponibili in questeapplicazioni.

Utilizzo della scheda Progettazione di xPressofor WordSulla barra multifunzione di Word, è disponibile una scheda Progettazione di xPresso for Word checontiene numerose funzioni di uso comune per l’utilizzo di modelli. L’aspetto della scheda è diversose si sta modificando un modello o visualizzando un modello di sola lettura.

Nota: Quando il cursore viene inserito nell’area del sommario del documento xPresso for Word,la scheda Progettazione di xPresso for Word non viene visualizzata nella barra multifunzione diWord. Per visualizzare la scheda Progettazione di xPresso for Word, fare clic su un punto qualsiasidiverso dall’area del sommario nel documento.

Utilizzo del pannello EsploraxPresso for Word utilizza dei pannelli per contenere le funzioni e i controlli da utilizzare con ilmodello. Il pannello Esplora viene utilizzato per gestire il contenuto variabile del modello. Il pannelloEsplora contiene tre explorer diversi:• Esplora modelli: visualizza il contenuto dinamico all’interno del modello.

• Esplora variabili: visualizza lo schema di dati associato al modello.

• Esplora layout HTML: visualizza i canali associati al modello. Esplora layout HTML vienevisualizzato solo se per il modello sono definiti dei canali.

Per accedere a un pannello Esplora specifico, fare clic sul pulsante appropriato nella parte inferioredel pannello. Viene visualizzata la vista attiva racchiusa in una casella.

40

Page 41:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Utilizzo di Esplora modelli

Esplora modelli è una descrizione ordinata di tutto il contenuto dinamico che si trova all’internodel modello di documento.

Sono disponibili diverse modalità di filtro del contenuto del pannello:• Mostra tutto: mostra tutti gli elementi del modello.

• Elementi non validi: mostra eventuali elementi non validi nel pannello.

• Non aggiornato: mostra solo gli elementi di contenuto riutilizzabile e di contenuto universale lacui versione è precedente alla versione più recente sul server.

• È possibile inoltre utilizzare il campo del filtro per visualizzare tutti gli elementi i cui nomicontengono il testo immesso.

Le azioni in Esplora modelli sono disponibili dai menu a discesa associati a ogni elemento nellastruttura. Le azioni disponibili variano in base al tipo di elemento e vengono descritte nelle sezioniappropriate di questa Guida per l’utente.

Elementi modello non validi

Quando si seleziona il filtro Elementi non validi, il pannello Esplora visualizza solo gli elementi che,per qualche ragione, sono attualmente ritenuti non validi. È possibile che l’elemento non sia validopoiché è stato appena creato e non è stato ancora definito il relativo riferimento oppure che sia statocaricato un nuovo schema che rende il riferimento dell’elemento non valido.

41

Page 42:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

I seguenti elementi possono essere visualizzati come non validi:• Grafici dinamici in cui:

— Non è caricata alcuna definizione di grafico (file .itxml).

— I dati della categoria o della serie non sono definiti.

— Esistono variabili non valide utilizzate nella definizione dati.

• Contenuto esterno in cui:

— Non è definito alcun riferimento.

— L’impostazione di inclusione per tipo è variabile, ma il tipo di valore del riferimento variabileselezionato non è string.

— Il riferimento di contenuto non è mappato.

• Gruppi di contenuti in cui:

— I criteri di attivazione/disattivazione non sono validi (ad esempio, contengono una variabilenon valida).

— La logica switch-type semplice non è valida.

— Il gruppo contiene un’istanza non valida.

• Istanze di contenuto con logica non valida.

• Istanze di contenuto in cui manca la mappatura delle variabili. In Esplora modelli, accanto aglielementi contenuto è visualizzata un’icona cono di costruzione.

• Loop di contenuto con logica di filtro non valida.

È possibile correggere il riferimento o la mappatura dell’elemento in Esplora modelli. Quando unelemento diventa valido non verrà più visualizzato con il filtro Elementi non validi.

Utilizzo di Esplora variabili

Esplora variabili visualizza l’intero schema così come è contenuto nel file di schema selezionato. Èpossibile aggiungere testo, immagini e variabili di tabella al modello in uso direttamente da Esploravariabili.

È possibile filtrare la visualizzazione sul panello utilizzando i seguenti metodi:• Digitare un termine di ricerca nella casella per filtrare l’elenco dinamicamente.

• Selezionare un filtro predefinito dall’elenco a discesa dei filtri:

• Selezionare Crea nuovo dall’elenco a discesa dei filtri per creare e salvare un filtro personalizzato:— Digitare un nome descrittivo per il filtro.

— Selezionare tutti gli elementi dati, variabili personalizzate e variabili d’ambiente di sistema chesi desidera visualizzare quando si seleziona il filtro.

Nota: Se si digita un termine di ricerca nella casella di filtro e il termine corrisponde a un nome filtropredefinito o personalizzato, verranno visualizzati i risultati del filtro predefinito o personalizzatoanziché i risultati dinamici del termine di ricerca.

42

Page 43:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Azioni variabili sono disponibili nei menu a discesa associati a ogni elemento elencato sul pannello.Le azioni disponibili variano in base al tipo di elemento e vengono descritte nelle sezioni appropriatedi questa Guida per l’utente.

Elementi variabile non validi

Quando si seleziona il filtro Elementi non validi, nel pannello Esplora variabili vengono visualizzatisolo gli elementi che, per qualche ragione, sono attualmente ritenuti non validi.

I seguenti elementi possono essere visualizzati come non validi:

• Variabili personalizzate non definite (l’espressione è vuota).

• Variabili che contengono un carattere non supportato ($:@/\!?*#[](){}&<>"’) nel nome.

• Variabili personalizzate di tipo xPath in cui:

— xPath è complesso e non supera la convalida grammaticale.

— xPath è semplice e non è possibile individuare un elemento dati corrispondente in base axPath. Questo può verificarsi se non è caricato nessuno schema.

— xPath è semplice e un elemento dati corrispondente è stato trovato, ma i tipi di valore nonsono compatibili.

• Variabili personalizzate tipo funzione xPresso in cui:

— L’espressione contiene un riferimento circolare.

— Non è possibile trovare la variabile utilizzata nell’espressione.

— Il tipo di valore della variabile non è compatibile con il tipo restituito dall’espressione.

— Nell’espressione è presente una sintassi non valida.

• Variabili personalizzate JavaScript contenenti una sintassi non valida nell’espressione che nonsuperano la convalida grammaticale.

È possibile correggere il riferimento o la mappatura dell’elemento nelle proprietà per renderlo valido.Quando un elemento diventa valido non verrà più visualizzato con il filtro Elementi non validi.

Icone

Esplora variabili utilizza icone per indicare elementi variabile diversi. Nella tabella seguente vengonomostrate le icone e gli elementi corrispondenti.

Icona Elemento

Radice variabile

Array

Array ripetibile

43

Page 44:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Icona Elemento

Variabile integer o elemento array

Variabile string o elemento array

Variabile float o elemento array

Variabile double o elemento array

Variabile boolean o elemento array

Variabile date o elemento array

Variabile time o elemento array

Variabile date time o elemento array

Utilizzo di Esplora layout HTML

Esplora layout HTML consente di utilizzare canali e regioni modello definiti nel modello. Canali eregioni modello vengono utilizzati insieme per consentire la pubblicazione di un singolo modello didocumento tramite canali di output diversi. Se per il modello non è definito alcun canale, Esploralayout HTML non è disponibile. Per ulteriori informazioni, vedere Utilizzo dei canali nel modello,pagina 253.

Utilizzo di contenuto nel canvasxPresso for Word viene utilizzato i Word controlli di contenuto per contrassegnare contenutodinamico (o variabile) nel documento di Word. I controlli sono visibili quando l’elemento vieneselezionato, all’interno del documento o in un pannello Esplora, oppure quando si passa il mousesull’elemento.

I controlli di contenuto vengono visualizzati come una casella blu più una scheda blu che contiene unnome. In questo esempio viene mostrato il controllo di contenuto su una variabile tabella.

Se si dispone di contenuti dinamici nidificati l’uno nell’altro, è possibile che le etichette dei controllidi contenuto si sovrappongano e non sembrino visualizzare il nome corretto dell’elemento. Ilnome completo dell’elemento è sempre visualizzato in Esplora modelli, dove si può verificare cheil nome sia corretto.

Nota: Quando si copia e incolla un contenuto dinamico, accertarsi anche di selezionare il controllo dicontenuto. Per fare questo, è sufficiente fare clic sul titolo del controllo di contenuto. Se non è possibileselezionare il controllo di contenuto, il contenuto dinamico verrà copiato come contenuto statico.

44

Page 45:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

Per posizionare il cursore fuori dal controllo di contenuto per poter aggiungere altro contenuto inaltri punti del documento, è possibile utilizzare uno dei seguenti metodi:• Fare clic in un paragrafo che non è contenuto in un controllo di contenuto (testo statico).

• Posizionare il cursore alla fine del contenuto che si trova nel controllo di contenuto, quindipremere il tasto freccia a destra.

• Posizionare il cursore all’inizio del contenuto e premere il tasto freccia a sinistra.

Funzione di annullamento nel contenuto dinamico

Non è possibile annullare o ripetere più passaggi eseguiti sul contenuto dinamico nel modello dixPresso for Word. Si tratta di un limite di Word relativo al controllo di contenuto. È possibileannullare solo passaggi singoli per le funzioni di xPresso.

Cleanup dei controlli di contenuto orfaniÈ possibile eliminare i controlli di contenuto orfani che rispettano le seguenti condizioni:• Il controllo è bloccato.

• La lunghezza del valore del tag di controllo deve essere uguale a 15.

• Il controllo è orfano e non è possibile trovarlo nella struttura ad albero di Esplora modelli.

Se un controllo di contenuto normale che non viene gestito da xPresso for Word soddisfa le condizioniprecedenti, verrà trattato come orfano.

Cleanup dei controlli di contenuto orfani:

1. Aprire un documento di xPresso for Word e selezionare File > xPresso per aprire la pagina dibackstage.

2. Fare clic su Azioni > Ripristina documento. Viene visualizzata una finestra di dialogo dovesi chiede la conferma della ricerca degli object orfani per la rimozione. Se si elimina il testocontenuto negli object orfani, selezionare Eliminare il testo presente negli object orfani.

3. Fare clic su Sì per rimuovere gli object orfani. Viene visualizzato un messaggio con il numero diobject eliminati.

45

Page 46:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Introduzione a xPresso for Word

46

Page 47:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 2Pianificazione del documento

xPresso for Word consente di migliorare un documento di Word aggiungendo dati, variabili e criteridi selezione per personalizzare l’output. È possibile creare un nuovo documento da utilizzare conxPresso for Word o personalizzare un documento di Word esistente.

Si consiglia di creare una bozza del documento e di contrassegnarla per indicare, ad esempio, laposizione del contenuto dinamico e di quello statico, nonché di variabili e di tabelle e grafici dinamici.Maggiore è la quantità degli elementi pianificati in anticipo, più facile sarà sviluppare i gruppi e leistanze dei contenuti, nonché le variabili. Quando si dispone della struttura di base, è inoltre minoreil rischio di dover apportare modifiche consistenti a progetto avanzato.

Tenere presente le seguenti considerazioni durante la creazione del documento:• Parti del documento da includere nell’output in modo dinamico? Criteri o campi dati in base aiquali includere o escludere contenuto?

• Parti statiche del documento, ovvero sempre incluse nell’output senza alcuna modifica? Elementiquali il nome e il logo dell’azienda possono essere utilizzati come testo statico.

• Variabili da includere nel documento? Eventuali campi dati che devono sempre contenere valoriper ciascuna variabile?

• Conformità dei dati ai requisiti di xPresso for Word? Disponibilità di uno o più file XML e di unoschema dati corrispondente per il documento?

• Quale tipo di output verrà generato con il documento? Differenti tipi di output possono averediverse limitazioni, ad esempio relative alle immagini e ai caratteri.

Consultare le seguenti sezioni durante la pianificazione del documento:• Contenuto del documento, pagina 48

• Output del documento, pagina 49

• Considerazioni sulla progettazione del documento, pagina 51

• Impostazione e layout della sezione, pagina 52

• Considerazioni sui caratteri, pagina 56

• Considerazioni sulla sillabazione, pagina 59

• Limitazioni, pagina 64

47

Page 48:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Contenuto del documentoL’output finale di un documento di xPresso for Word può avere molte versioni diverse. È infattipossibile creare svariate versioni di un elemento da un unico documento. Ciò consente dipersonalizzare in modo molto dettagliato l’output per il destinatario desiderato. Il contenuto checostituisce un documento può essere di due tipi di base: dinamico e statico. Entrambi rivestono unruolo importante nell’aspetto finale del documento.

Contenuto dinamico

Il contenuto dinamico può cambiare per ogni versione di un documento ed è controllato mediantecriteri e dati delle variabili. Il contenuto dinamico di xPresso for Word si trova all’interno di gruppidi contenuti. Ogni variazione del contenuto appare in un’istanza di contenuto distinta. È possibiledefinire più paragrafi, una frase o anche un’immagine come contenuto dinamico.

In genere, nell’output finale viene visualizzata solo un’istanza di contenuto di un gruppo dicontenuti. Ad esempio, per un documento è possibile disporre di due diversi paragrafi di apertura,ognuno destinato a un pubblico di destinazione diverso. Ciascun paragrafo costituisce un’istanzadi contenuto distinta all’interno dello stesso gruppo di contenuti. Per determinare quando ciascunparagrafo deve essere visualizzato nell’output, vengono utilizzati criteri.

I criteri consentono di controllare quando visualizzare un determinato contenuto dinamiconell’output. I dati determinano quindi il contenuto in base ai criteri definiti. È possibile definire criteriper controllare i gruppi di contenuti attivi nel documento e le istanze di contenuto di tali gruppi davisualizzare nell’output finale.

Il contenuto dinamico può essere visualizzato anche in una tabella dinamica. Per ulterioriinformazioni, vedere Utilizzo di tabelle dinamiche, pagina 177.

Esempio

In questo esempio, è riportata la sezione di un documento il cui contenuto è controllato dal valoredel campo dati chiamato New_Customer. Ci sono due valori possibili per New_Customer: True oFalse. In questa sezione del documento è visualizzato un messaggio mirato dipendente dal fattoche il cliente sia nuovo o esistente.

Nel gruppo di contenuti, che si chiamerà "Messaggio di benvenuto", dovranno esserci due istanze dicontenuto diverse, una per ogni valore possibile di New_Customer: l’istanza ExistingCustomer el’istanza NewCustomer. Ogni istanza di contenuto visualizza un messaggio diverso.

Istanza ExistingCustomer:Thank you for renewing your policy with Concordant Financial. We’re pleasedyou have chosen us to ensure you long term financial security by providing thecoverage that you need.

Istanza NewCustomer:

Welcome to the Concordant Family. We’re pleased you have chosen us for yourinsurance needs. By ensuring that you have the coverage you need, you’re

48

Page 49:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

helping to ensure your long-term financial security.

Il messaggio visualizzato nell’output del documento finale dipende dal valore del campoNew_Customer. Se il valore è True, viene visualizzata l’Istanza NewCustomer, se il valore è False,viene visualizzata l’istanza ExistingCustomer.

Contenuto statico

Il contenuto statico viene visualizzato in ogni iterazione del documento. Poiché l’inserimento di talecontenuto non è controllato da criteri, non deve trovarsi in un gruppo di contenuti. Ad esempio, ilnome e l’indirizzo della società possono costituire contenuto statico all’interno del documento.Per aggiungere contenuto statico al documento, la procedura è analoga a quella per l’aggiunta diqualsiasi contenuto a un documento di Word.

Il testo statico può contenere variabili. L’inserimento del testo di per sé è statico (il testo è sempreincluso nell’output), ma è possibile utilizzare le variabili per rendere dinamiche alcune parti delcontenuto. Ad esempio, un’intestazione documento potrebbe contenere informazioni su criteri esoftware. Questa sezione viene visualizzata in ogni iterazione del documento, esattamente allostesso modo e nello stesso punto. Questo contenuto è statico, non deve essere associato ad alcuncriterio o elemento di dati e pertanto non è presente in alcun gruppo di contenuti. Questo contenutonon include variabili, quindi anche se viene visualizzato sempre (ed è pertanto statico), il testo delcontenuto può essere diverso in ogni iterazione.

Output del documentoÈ possibile generare output AFP, DOCX, iDOCX, HTML, PDF, PDF/UA, PostScript, PPML e TIFFper il documento xPresso for Word. Per ulteriori istruzioni su come generare l’output, consultare laguida per l’utente di xAdmin.

Considerazioni sull’output PostScript

Durante la pubblicazione di file PostScript, il server xPression genera un output PostScript livello 3.xPression non è in grado di generare un livello diverso di PostScript. Controllare la compatibilitàdella stampante prima di generare l’output PostScript.

L’engine di pubblicazione di xPublish consente di specificare la dimensione della pagina sul device dioutput (in base alle impostazioni di xPresso for Word). La scelta del supporto più adatto si basa suldevice di output. L’orientamento della pagina viene gestito automaticamente da xPression.

Se una pagina di 8,5x14 pollici (Legale) viene inviata a un device contenente carta in formato Lettera(8,5x11) e Ledger (11x17), verrà selezionato automaticamente il formato Ledger e la pagina verràposizionata all’interno della pagina più grande. Si tratta del comportamento predefinito per i devicedi output PostScript.

49

Page 50:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Impostazione della lingua del documento per outputPDF/UA

È possibile progettare un documento PDF/UA con xPresso. In un documento PDF/UA, l’impostazionerelativa alla lingua è necessaria per definire la lingua utilizzata dall’assistive technology. Per ulterioriinformazioni, consultare la guida all’elaborazione dell’output di xPublish.

Per pubblicare un documento PDF/UA, è necessario specificare una lingua per il documento.

Impostazione della lingua documento

1. Accertarsi che il documento di xPresso for Word sia aperto.

2. Selezionare File > xPresso per aprire la pagina di backstage.

3. Nella pagina di backstage di xPresso, fare clic su Lingua del documento nella sezione Azioni.Viene visualizzata la finestra di dialogo Imposta lingua documento.

4. Selezionare una lingua dall’elenco e fare clic su OK. L’impostazione della lingua viene utilizzatanell’intero documento.

Output DOCX e iDOCX

È possibile creare un output .docx di Microsoft Word con due definizioni di output integrate: Docxe iDocx. Sebbene entrambe riescano a generare output .docx, le due definizioni di output sonodiverse. L’output iDOCX può essere generato solo dai documenti di xPresso for Word 4.5 o versionisuccessive. È possibile modificare un output iDOCX in Microsoft Word, quindi pubblicarlo in formatoPDF, PS, AFP, PCL o HTML tramite web service. Per istruzioni su come generare output e limitazionidei due tipi di output, consultare la guida per l’utente di xAdmin.

Output di imposizione multipla

L’engine di pubblicazione di xPublish supporta la produzione di output di imposizionemultipla. L’imposizione consente di stampare più pagine logiche su un foglio di carta fisico. Ledefinizioni dell’imposizione vengono specificate in xAdmin per definire i parametri di esecuzionedell’imposizione.

xPression supporta due forme di imposizione fondamentali:• Imposizione del libretto 2-up: l’imposizione del libretto è la disposizione di pagine logiche suifogli fisici in modo che quando i fogli vengono uniti compongono un libretto. Per l’imposizionedel libretto, xPression supporta due stili di rilegatura: punto a sella e dorso piatto.

Nota: Per l’imposizione del libretto 2–up, viene applicata la frangia su tutti i lati tranne quello dirilegatura nell’offset dell’indicatore di ritaglio e il lato di rilegatura viene troncato sul più piccolooffset dell’indicatore di ritaglio a metà della larghezza di rilegatura.

• Imposizione N-up: l’imposizione N-up viene utilizzata per stampare più pagine del cliente suun unico foglio per aumentare la produttività della stampante. Questo significa che "N" paginelogiche saranno inserite su un lato di ciascuna pagina fisica.

50

Page 51:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Per l’imposizione N-up, è possibile selezionare uno dei seguenti tipi:— Sequenziale: le pagine logiche sono inserite su pagine fisiche in ordine sequenziale. Quandoun pacchetto termina, quello successivo inizia nel successivo slot disponibile sull’imposizione.

— Impilato: i documenti del cliente sono ordinati nell’output in modo che quando i vari pezzisono tagliati separatamente, le pile risultanti possono essere combinate in modo che l’outputmantenga l’ordine dell’input originale.

In xPresso for Word, accertarsi di aver impostato le dimensioni e i margini della pagina in modo dacontenere interamente l’opzione di imposizione.

Definizione delle dimensioni della pagina

1. Fare clic sulla scheda Layout di pagina della barra multifunzione di Word.

2. Fare clic su Dimensioni nel gruppo Imposta pagina.

3. Selezionare le dimensioni della pagina dal menu o fare clic su Altre dimensioni foglio perdefinire dimensioni personalizzate.

4. Fare clic suMargini nel gruppo Imposta pagina per definire i margini.

Considerazioni sulla progettazione deldocumentoAlcune funzionalità di Word non sono supportate durante la pubblicazione del documento mediantel’engine di pubblicazione di xPublish. Per un elenco completo di funzionalità di Word supportate enon supportate, vedere le appendici seguenti:• Appendice D, Formattazione a livello di pagina

• Appendice E, Formattazione a livello di paragrafo

• Appendice F, Formattazione a livello di carattere

• Appendice G, Funzionalità speciali di Microsoft Word

Considerazioni sulla formattazione di testo

Nell’output di xPression non sempre il testo ha lo stesso aspetto che nel documento di Word. Durantela creazione del documento, tenere presente quanto segue:• Word e l’engine di pubblicazione di xPublish utilizzano logiche di composizione diverse. Pertanto,le interruzioni di riga e di pagina visualizzate in xPresso for Word possono apparire diversamentequando il documento viene pubblicato utilizzando la funzionalità Anteprima PDF o sul serverxPression.

• Le stringhe di testo possono apparire di lunghezze diverse quando si visualizza il documento inxPresso for Word e quando si utilizza la funzionalità Anteprima PDF o si pubblica il documento

51

Page 52:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

nel server. Ciò può essere dovuto al fatto che attualmente xPresso for Word non supporta alcunefunzionalità: crenatura, layout OpenType o uno speciale criterio di layout di Word.

• Un paragrafo con solo una interruzione di pagina viene visualizzato da xPression come unparagrafo vuoto. Di conseguenza, l’interruzione di pagina prima di un documento esterno conlayout potrebbe essere ignorata nell’output. Per evitare che queste interruzioni di pagina venganoignorate, inserire uno spazio unificatore prima dell’interruzione di pagina.

Considerazioni sulla formattazione di tabelle

È possibile includere tabelle statiche e dinamiche nel documento, ma il supporto di tabelle complesseè limitato. Le tabelle semplici sono interamente supportate, ma alcuni tipi di formattazione complessadelle tabelle (ad esempio la suddivisione o l’espansione di colonne o righe) utilizzati in combinazionepotrebbero generare un output diverso da quello desiderato. Per ulteriori informazioni, vedereSupporto alle tabelle di Word, pagina 173.

Impostazione e layout della sezionexPresso for Word utilizza definizioni di pagina per definire sezioni di un documento. Per ognidefinizione di pagina è possibile definire intestazioni e piè di pagina singoli. È anche possibiledefinire singole opzioni pagina per ogni definizione di pagina, ad esempio margini e orientamentopagina, impostazioni carta e layout.

Creazione di definizioni di pagina

Ogni documento di xPresso for Word contiene automaticamente una definizione di pagina che vienevisualizzata nella parte superiore di Esplora modelli. Questa definizione può essere utilizzata perdefinire le impostazioni per l’intero documento, o solo per la prima sezione. È possibile aggiungereulteriori definizioni di pagina in base alle esigenze.

Definizioni di pagina all’interno di contenitori, ad esempio contenuto riutilizzabile, loop, aree modellie gruppi di contenuto, non sono supportate. Di conseguenza, il menu Definizione di pagina nellascheda Progettazione di xPresso for Word e i menu Interruzioni e Colonne nella scheda Layout dipagina vengono disattivati quando il cursore viene inserito all’interno di un contenitore.

Creazione di definizioni di pagina

1. Posizionare il cursore nel modello in corrispondenza della posizione in cui si desidera modificarel’impostazione pagina.

52

Page 53:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

2. Fare clic su Definizione di pagina nella scheda Progettazione di xPresso for Word e selezionareuna delle seguenti opzioni:• Continua: inserisce un’interruzione di sezione e inizia la nuova definizione di pagina nellastessa pagina.

• Nuova pagina: inserisce un’interruzione di pagina e inizia la nuova definizione di paginanella pagina successiva.

• Pagina pari: inserisce un’interruzione di pagina e inizia la nuova definizione di pagina nellapagina pari successiva.

• Pagina dispari: inserisce un’interruzione di pagina e inizia la nuova definizione di paginanella pagina dispari successiva.

Un elemento Definizione di pagina viene inserito nella posizione appropriata di Esplora modelli.

3. Fare clic sul menu a discesa relativo all’elemento in Esplora modelli e selezionareModifica. Vienevisualizzata la finestra di dialogo Imposta pagina.

4. Definire le impostazioni margine, carta e layout pagina nelle schede appropriate. Perinformazioni sul supporto xPresso for Word delle opzioni, vedere Opzioni di impostazionedella pagina, pagina 305.

5. Definire le opzioni intestazione e piè di pagina per la definizione di pagina:• Utilizza dispari/pari (tutte): utilizza l’intestazione e il piè di pagina dispari/pari predefinitiper l’intero documento. Se si seleziona questa opzione, le intestazioni e i piè di paginavengono modificati per tutte le definizioni di pagina nel modello.

• Utilizza prima pagina: utilizza l’intestazione e il piè di pagina definiti per la prima pagina deldocumento per questa definizione di pagina.

• Mostra collegamento a precedente: collega l’intestazione e il piè di pagina e quelli nellasezione precedente. Elementi intestazione e piè di pagina vengono visualizzati nelladefinizione di pagina, con collegamento a icone precedenti.

• Definire nuove opzioni intestazione e piè di pagina per la sezione. Per ulteriori informazioni,vedere Utilizzo di intestazioni e piè di pagina, pagina 54.

se si inserisce una definizione di pagina interruzione di sezione Continua direttamente dopo unavariabile, questa verrà modificata in un’interruzione Nuova pagina. Questo è un problema legato aicontrolli di contenuto di Word. Per evitare questo inconveniente, inserire la definizione di paginaprima di aggiungere la variabile, o selezionare tutto il testo dalla posizione corrente fino alla fineprima di inserire la definizione di pagina (questa operazione sblocca il controllo di contenuto).

Nota:• Aprire la finestra di dialogo Imposta pagina facendo doppio clic su un’interruzione di sezionenon è un’azione supportata.

• L’inserimento di un’interruzione di sezione o di un’interruzione di pagina mediante il menuInterruzione di Word potrebbe generare degli errori per cui non è consigliata.

53

Page 54:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Utilizzo di intestazioni e piè di pagina

Per creare intestazioni e piè di pagina che si alternano tra pagine pari e pagine dispari, utilizzareun’intestazione per la prima pagina e una diversa intestazione per tutte le pagine successive, oqualsiasi altra combinazione. Con Microsoft Word il processo è automatizzato per le combinazioniseguenti:• Intestazioni e piè di pagina diversi tra pagine pari e pagine dispari

• Intestazione e piè di pagina diversi per la prima pagina

• Intestazioni e piè di pagina speciali

Quando si modificano intestazioni e piè di pagina all’interno di un modello, è necessario inseriremanualmente un’interruzione di sezione come interruzione di pagina nel punto del modello in cui sidesidera passare a una nuova pagina con intestazioni e piè di pagina diversi. Come interruzione disezione che interrompe una pagina è possibile utilizzare qualsiasi interruzione di sezione di Wordad eccezione dell’interruzione di sezione Continua. xPresso for Word supporta gli stili nel testodelle intestazioni e dei piè di pagina.

Nota: Tenere presenti le seguenti limitazioni intestazione e piè di pagina:• In Word attualmente esiste una limitazione relativa a intestazioni e piè di pagina. La lunghezza diquesti, infatti, deve essere inferiore alla metà della lunghezza della pagina. Eventuale contenutodell’intestazione o del piè di pagina visualizzato oltre la metà della pagina non viene visualizzatonell’output.

• Quando si apre un documento che non contiene un’intestazione o piè di pagina definito, èpossibile che un’intestazione o piè di pagina vuoto venga aggiunto al documento se un utenteha precedentemente aperto l’area intestazione e piè di pagina. La dimensione di questa areaintestazione vuota sarà maggiore rispetto a quella precedente. Modificare semplicemente ladimensione dell’area intestazione per ripristinare la dimensione precedente.

• Se vengono applicati dati a un documento, l’impostazione Collegamento a precedente perintestazioni e piè di pagina viene rimosso. Per evitare problemi di modifica delle intestazioni e deipiè di pagina, configurare l’impostazione Collegamento a precedente dopo l’applicazione dei dati.

Le opzioni di Word relative alle intestazioni e ai piè di pagina sono definite nella scheda Inseriscidella Barra multifunzione di Word, nel gruppo Intestazione e piè di pagina. Per informazionidettagliate sul supporto opzione intestazione e piè di pagina in xPresso for Word, vedere Opzionirelative all’intestazione e al piè di pagina, pagina 309.

Creazione di intestazioni e piè di pagina

È possibile aggiungere intestazioni e piè di pagina al modello di xPresso for Word in uso nello stessomodo in cui vengono aggiunte a qualsiasi documento di Word.

Per aggiungere un’intestazione o un piè di pagina, fare clic sulla scheda Inserisci sulla barramultifunzione di Word, quindi selezionare Intestazione o Piè di pagina nel gruppo Intestazione e pièdi pagina. Un’intestazione o un piè di pagina verrà aggiunto al modello.

È possibile aggiungere testo, immagini, la funzione Data/ora o i numeri di pagina all’intestazione oal piè di pagina.

54

Page 55:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Nota: L’inserimento di immagini TIFF in un’intestazione o un piè di pagina non è supportato.

Modifica di intestazioni e piè di pagina all’interno di un modello

È possibile definire intestazioni e piè di pagina diversi per le sezioni del modello. Per ridefinire leintestazioni e i piè di pagina al centro del modello, completare i passaggi seguenti:

1. Inserire un’interruzione di sezione come interruzione di pagina nella parte superiore deldocumento per iniziare la nuova pagina con intestazioni e piè di pagina ridefiniti.

2. Posizionare il cursore nella sezione che segue l’interruzione di sezione.

3. Aggiungere l’intestazione o il piè di pagina.

4. Nel gruppo di spostamento della scheda di progettazione strumenti di intestazione e piè dipagina, fare clic sul pulsante Collega a precedente per rendere questa intestazione o questopiè di pagina uguale a quello immediatamente precedente. Fare di nuovo clic sul pulsanteper disattivare il collegamento e definire una nuova intestazione o un nuovo piè di pagina inquesta sezione.

5. Fare clic su Chiudi intestazione e piè di pagina per uscire dalla barra degli strumenti Intestazionee piè di pagina e tornare al documento.

Intestazioni e piè di pagina “flessibili”

Supponiamo di aver assemblato due documenti per due clienti diversi. Il primo documento contieneuna pagina di informazioni, il secondo ne contiene otto. Che cosa è necessario fare se si desideravisualizzare un’intestazione sulla prima pagina, ma un’intestazione diversa sulle pagine successive?

Non è possibile prevedere la lunghezza di ogni documento, pertanto non è possibile modificarlimanualmente. Fortunatamente Microsoft Word consente di creare intestazioni aggiuntive e di“nasconderle” finché non sono necessarie per xPresso for Word.

Per inserire un’altra intestazione:

1. Aprire il modello.

2. Fare clic sulla scheda Layout di pagina sulla barra multifunzione di Word, espandere Impostapagina per visualizzare la finestra di dialogo corrispondente, quindi fare clic sulla scheda Layout.

3. Selezionare Diversi per la prima pagina nella sezione Intestazioni e piè di pagina e fare clicsu OK.

4. Inserire un’interruzione di pagina nel modello.

5. Nella nuova pagina, aggiungere una nuova intestazione. Questa è l’intestazione che si desideravisualizzare sulle pagine successive del documento assemblato.Verificare che l’etichetta sia “Intestazione”, non “Intestazione prima pagina”. Se recita“Intestazione prima pagina”, fare semplicemente clic su Avanti nel gruppo Navigazione dellascheda Progettazione strumenti intestazione e piè di pagina per passare alla nuova intestazioneaggiunta.

55

Page 56:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

6. Aggiungere il contenuto, quindi chiudere l’intestazione.

7. Per trovare l’interruzione che è stata aggiunta, fare clic su ¶ nel gruppo Paragrafo della schedaHome sulla barra multifunzione di Word.

8. Fare doppio clic sull’indicatore dell’interruzione di pagina per selezionarlo, quindi eliminarlo.La seconda pagina e l’intestazione di questa scompariranno. Anche se l’intestazione e leinformazioni appena aggiunte scompaiono, Word mantiene l’impostazione e la applica durantel’assemblaggio del documento quando sono necessarie pagine aggiuntive.

Considerazioni sui caratteriI caratteri supportati dall’engine di pubblicazione di xPublish variano a seconda del tipo di outputche si desidera creare. Nella tabella seguente viene riepilogato il supporto dei caratteri da parte dixPression.

Tipo di carattere AFP PDF PostScript

TrueType Sì Sì Sì

OpenType (Nuovo Tipo1)

Sì (solo .tff) Sì Sì, trannecaratteri bitmap

Caratteri vettoriali AFP Sì No No

Vecchio tipo 1 (Tipo 1Windows o Mac)

No Sì Sì

Doppio byte Sì Sì Sì

I caratteri utilizzati in documenti xPresso for Word devono trovarsi nella directory dei caratteripredefinita sia nel computer client sia nel server xPression. Al momento dell’installazione, ilprogramma di installazione imposta la directory dei caratteri predefinita sulla corrispondentedirectory di sistema per il client. Ad esempio, in Windows la directory predefinita èC:\Windows\Fonts. Se la directory dei caratteri in uso si trova in un percorso diverso, è possibilemodificare il file di configurazione per modificare la directory utilizzata da xPression.

Per modificare la directory dei caratteri predefinita di xPresso for Word:

1. Aprire Esplora risorse e cercare la directory di configurazione\

2. Aprire il file xPRSConfig.xml in un editor di testo.

3. Individuare la riga seguente: <prop name=“TtfFontPath” type=“List”value=“C:\WINDOWS\Fonts\” limit=“DIR” visible=“true”/>.

4. Impostare il parametro value sul percorso della directory dei caratteri in uso. Ad esempio,value=“C:\Winnt\Fonts”.

5. Salvare il file.Se la directory dei caratteri Windows è diversa dal set di directory predefinito di xPresso for Word enon si modifica il percorso nel file di configurazione, quando si tenta di visualizzare in anteprima

56

Page 57:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

un documento verrà visualizzato un messaggio che avvisa sull’impossibilità di reperire il caratteresostitutivo “Courier New”.

Caratteri supportati negli output PostScript e PDF

Per gli output PostScript e PDF, l’engine di pubblicazione di xPublish supporta tutti i caratteriTrueType e OpenType (tranne i caratteri bitmap), nonché i caratteri Type 1. I caratteri vengonoincorporati automaticamente nell’output PostScript. xPression incorpora l’intero carattere. Èimportante notare le informazioni seguenti sul supporto dei caratteri PostScript da parte di xPression:• Per incorporare i caratteri OpenType e TrueType, accertarsi che la stampante sia in grado diprodurre PostScript Level 2 con estensione CID o PostScript Level 3.

• Il formato di carattere Type 1 è limitato a 256 caratteri.

Adobe è autore e owner dello standard PostScript e Document Sciences aderisce a questo standard.L’output PostScript dei prodotti Document Sciences viene collaudato mediante interpreti AdobePostScript e altro software di elaborazione compatibile PostScript di comune utilizzo, ad esempioGhostScript. Alcuni interpreti PostScript di terze parti non implementano il linguaggio PostScriptin modo standard. È possibile che l’elaborazione di PostScript (generato da prodotti DocumentSciences o di altri produttori) effettuata da tali interpreti non sia corretta. Lo scopo di DocumentSciences è generare PostScript funzionante con tutti i prodotti PostScript e di emulazione PostScript.Non è tuttavia possibile garantire la compatibilità con ogni device presente sul mercato che non siaconforme allo standard Adobe. È possibile incontrare alcune difficoltà durante la stampa di caratteriTrueType su prodotti di emulazione PostScript. Alcuni errori possono infatti impedire la stampa. Diconseguenza, può essere necessario eseguire la conversione da caratteri TrueType a caratteri Type 1.

Nota: I caratteri Adobe Type 1 vengono convertiti nel formato PostScript utilizzando il set di caratteriANSI di Windows, tabella codici 1252.

Informazioni sui caratteri AFP

I caratteri AFP vengono aggiunti al server xPression mediante l’utility Carattere disponibile inxAdmin. Per ulteriori informazioni, vedere la Guida per l’utente di xAdmin.

L’engine di pubblicazione xPression Publish incorpora sempre caratteri AFP nel file di output AFP.Non è necessario trasferire i caratteri alla stampante.

xPression consente di convertire i caratteri TrueType in caratteri AFP vettoriali o bitmap durantela pubblicazione (attraverso un’impostazione della definizione dell’output). Durante il processodi conversione del carattere vettoriale, l’emettitore AFP crea pagine di codice personalizzate alfine di supportare i caratteri Unicode richiesti in un carattere vettoriale AFP ridotto. Per ulterioriinformazioni, vedere la Guida per l’utente di xAdmin.

Quando si esegue la conversione in caratteri vettoriali, perché siano supportati il grassetto e il corsivo,è necessario iniziare con un carattere TrueType grassetto o corsivo. Ad esempio, per ottenere uncarattere vettoriale in grassetto è possibile utilizzare arialbd.ttf (Arial Bold) mentre per ottenere uncarattere vettoriale in corsivo è possibile utilizzare ariali.ttf (Arial Italic). I caratteri bitmap non hannoquesta limitazione; essi possono simulare lo stile grassetto e corsivo dai caratteri standard.

57

Page 58:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Caratteri grandi supportati

L’engine di pubblicazione di xPublish supporta i caratteri grandi (detti anche a doppio byte) peroutput AFP, PDF e PostScript, a condizione che i caratteri siano TrueType. Per output AFP, il carattereSymbol non è supportato.

Le lingue asiatiche cinese semplificato, cinese tradizionale, giapponese e coreano (CJK), nonchéi relativi caratteri, sono supportate, con le limitazioni seguenti:• Le seguenti caratteristiche di composizione specifiche di CJK non sono supportate:— Regolazione automatica dello spazio tra caratteri CJK e latini (numeri)

— Punteggiatura sporgente

— Allineamento speciale di testo

— Orientamento del testo dall’alto in basso

— Caratteri fonetici

— Caratteri racchiusi

— Da orizzontale a verticale

• È supportato solo il formato BMP Unicode. Pertanto sono supportati solo alcuni caratteri CJK.

• La logica di giustificazione coreana non è supportata.

• È possibile che vi siano alcune differenze nell’altezza e nella spaziatura di riga tra l’outputsul server e ciò che viene visualizzato nello strumento di progettazione per i caratteri cinesi egiapponesi.

• I caratteri cinesi non sono supportati nei grafici dinamici.

Se si pubblica output in cinese tradizionale o semplificato, accertarsi che sia disponibile almeno uncarattere in cinese tradizionale o semplificato per l’utilizzo da parte dell’engine di pubblicazione. Senon è disponibile alcun carattere Cinese, xPression utilizza per impostazione predefinita CourierNew, che non produce l’output desiderato.

Nota: Microsoft Word consente di visualizzare caratteri accentati per font che non supportano inmaniera nativa tali caratteri (ad esempio, TimesNewRoman). L’engine di pubblicazione xPressionPublish non dispone di tale funzionalità. Se si utilizza tale font in xPresso for Word, quando lo sipubblica, i caratteri accentati non verranno visualizzati oppure verranno visualizzati in manieraerrata.

Tipografia asiatica supportata

In Microsoft Word sono disponibili diverse opzioni di tipografia asiatica. Nella tabella seguente vienedescritto il supporto delle opzioni di xPresso for Word.

Opzione Supporto

Interruzione di riga: Usa regole asiatiche per controllareil primo e l’ultimo carattere

Non supportato

58

Page 59:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Opzione Supporto

Interruzione di riga: Consenti ritorno a capo del testo inalfabeto latino a metà di una parola

Non supportato

Interruzione di riga: Consenti segni di punteggiaturasporgenti

Non supportato

Spaziatura caratteri: Consenti compressione dellapunteggiatura a inizio riga

Non supportato

Spaziatura caratteri: Regola automaticamente lo spaziotra caratteri asiatici e numeri

Supportato

Spaziatura caratteri: Allineamento testo Supportato solo versione di base

Opzioni: Impostazioni primo e ultimo carattere Supportato solo Standard

Opzioni: Crenatura Non supportato

Opzioni: Controllo spaziatura caratteri Supportato solo Non comprimere

Spaziatura caratteri: Regola automaticamente lo spaziotra testo asiatico e in alfabeto latino

Supportato

xPression non comprime la punteggiatura; pertanto, la stessa punteggiatura dello stesso carattere edella stessa dimensione avrà sempre la stessa larghezza. Inoltre, xPression non consente che lapunteggiatura superi il margine del paragrafo. A causa di queste limitazioni, è possibile vedere unadifferenza nelle interruzioni di riga tra il documento in xPresso for Word e l’output pubblicato.

Considerazioni sulla sillabazioneMicrosoft Word e xPression utilizzano soluzioni di sillabazione diverse durante il processo disillabazione delle parole di un documento. Il dizionario utilizzato da Word fornisce una sillabazionepiù affidabile rispetto al dizionario FOP utilizzato da xPression. A causa di questa differenza, leparole che appaiono sillabate in Word potrebbero apparire sillabate in modo diverso, o non sillabateaffatto, nell’output xPression.

I dizionari di sillabazione sono costituiti in genere da un algoritmo di sillabazione, contenente imodelli con dipendenze di lingua, e un dizionario delle eccezioni, ovvero un elenco di parole condescritti i punti di sillabazione consentiti.

xPression è installato con diverse versioni di lingua del dizionario di sillabazione. Ogni versioneviene denominata utilizzando il codice della lingua, ad esempio, fr.xml è il dizionario per il francese.La tabella seguente mostra i dizionari di sillabazione forniti con xPression.

Lingua File di sillabazione

Danese da.xml

Olandese nl.xml

Inglese (Regno Unito) en_GB.xml

Inglese (USA) en.xml e en_US.xml

Finlandese fi.xml

59

Page 60:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Lingua File di sillabazione

Francese fr.xml

Tedesco (Tradizionale) de.xml

Tedesco (Nuovo) de_DR.xml

Greco el.xml

Ungherese hu.xml

Italiano it.xml

Norvegese no.xml

Polacco pl.xml

Russo ru.xml

Slovacco sk.xml

Spagnolo es.xml

Modifica dei dizionari di sillabazione

Se la sillabazione visualizzata nell’output xPression non è quella desiderata per l’ambiente, è possibilemodificare i dizionari delle eccezioni (o tabelle). I dizionari di sillabazione utilizzati dal serverxPression si trovano nella directory [xPressionHome]\publish\hyphen. Sul client xPresso for Word, idizionari si trovano in Your_drive:\ProgramData\xPresso\xPresso_version\xPressofor Word\Office_version\Hyphen

I dizionari sul server sono utilizzati durante la pubblicazione, i dizionari sul client sono utilizzati perla funzione di anteprima PDF. Se si desidera visualizzare gli stessi risultati sul client e sul server,assicurarsi che il dizionario venga aggiornato in entrambe le posizioni.

L’aspetto di un file di sillabazione è simile al seguente:<?xml version="1.0" encoding="US-ASCII"?><!DOCTYPE hyphenation-info SYSTEM "hyphenation.dtd"><!--Hyphenation information for US English

--><hyphenation-info>

<hyphen-char value="-"/><hyphen-min before="3" after="2"/>

<classes>aAbB...zZ</classes>

<exceptions>as-so-ciateas-so-ciatesdec-li-na-tion

60

Page 61:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

oblig-a-tory...

In un file di sillabazione è possibile modificare tre elementi:• Il carattere di sillabazione, che si trova nel tag <hyphen-char value>. In questo esempio, il caratteredi sillabazione è un trattino (-).

• Il numero minimo di caratteri prima e dopo un carattere di sillabazione, che si trova nel tag<hyphen-min>. In questo esempio, il numero minimo di caratteri prima/dopo un caratteredi sillabazione è 3/2.

• Le eccezioni alla regola, che si trovano nel tag <exceptions>. Queste sono le parole per le quali nonsi desidera seguire l’impostazione precedente relativa al numero minimo di caratteri. È anchedove si definiscono le eventuali parole che non si desidera sillabare (aggiungerle semplicementesenza nessuna interruzione).

Quando si aggiunge un’eccezione al file, inserire il carattere di sillabazione in ogni posizione dellaparola dove la sillabazione è accettabile. In base all’esempio precedente, la parola "associate" puòessere sillabata nei modi seguenti:as-sociate

oppureasso-ciate

Per modificare un dizionario di sillabazione:

1. Individuare il dizionario da modificare sul server o sul client. Fare riferimento alla tabella nellasezione precedente per i nomi dei dizionari di sillabazione per ogni lingua.

2. Aprire il dizionario in un editor XML.

3. Individuare il tag da modificare nel file.

4. Apportare le modifiche:• <hyphen-char value="x"/> Digitare un nuovo carattere di sillabazione tra virgolettedoppie.

• <hyphen-min before="n" after="n"/> Digitare nuovi valori per le impostazioni delnumero minimo di caratteri, tra virgolette doppie.

• <exceptions> Aggiungere una nuova riga sotto il tag e digitare la nuova eccezione disillabazione. Assicurarsi di utilizzare il carattere di sillabazione corretto per indicare tutti ipunti di sillabazione accettabili nella parola.

5. Salvare il file dopo aver apportato tutte le modifiche necessarie.

Specifica di dizionari delle lingue diversi

Per impostazione predefinita, xPression utilizza l’impostazione Opzioni internazionali per lamacchina client o server per determinare quale dizionario di sillabazione della lingua utilizzare

61

Page 62:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

durante l’anteprima o la pubblicazione. Se si imposta Opzioni internazionali su French, verràutilizzato il dizionario fr.xml.

È possibile ignorare il comportamento predefinito fornendo un’impostazione della lingua all’internodi un documento. Se si dispone di un documento singolo da pubblicare in più lingue o inuna lingua diversa da quella selezionata per le Opzioni internazionali del sistema, è possibiledefinire un’impostazione della lingua all’interno del documento per controllare quale dizionariodi sillabazione viene utilizzato. La selezione della lingua viene passata tramite una variabile dioutput chiamata LOCALE. Quando xPression individua questa variabile di output, selezionaautomaticamente il dizionario di sillabazione sulla base del suo valore.

xPression supporta i codici lingua seguenti:• de (Danese)

• nl (Olandese)

• en_GB (Inglese Regno Unito)

• en, en_US (Inglese USA)

• fi (Finlandese)

• fr (Francese)

• de (Tedesco tradizionale)

• de_DR (Tedesco nuovo)

• el (Greco)

• hu (Ungherese)

• it (Italiano)

• no (Norvegese)

• po (Polacco)

• ru (Russo)

• sk (Slovacco)

• es (Spagnolo)

Nota: Attualmente sono supportati solo i codici lingua e non i codici paese.

È possibile passare il codice della lingua a una variabile di output LOCALE attraverso un campo neidati o una variabile codificata con un singolo valore. Se è necessario pubblicare il documento in piùlingue, utilizzare un campo nei dati per passare il codice, in modo da poterlo modificare in base alrecord di dati. Ad esempio, i dati del cliente potrebbero contenere un campo denominato <Lang> icui valori possono essere i seguenti: de, en, fr o es. Se il documento deve essere pubblicato solo in unalingua, è possibile codificare il codice della lingua in una variabile.

Creazione della variabile di output LOCALE

Prima di poter modificare l’impostazione della lingua, è possibile creare una variabile di outputdenominata LOCALE in xAdmin.

62

Page 63:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Creazione della variabile di output LOCALE

1. Accedere a xAdmin.

2. SelezionareGestione delle risorse > Variabili di output. Viene visualizzata la pagina con l’elencodelle variabili di output.

3. Fare clic su Aggiungi. Viene visualizzata la pagina Output Variables: Add a NewOutput Variable.

4. Digitare LOCALE nel campo Nome e selezionare Stringa nell’elenco Tipo.

5. Fare clic su Salva.

Passaggio del codice della lingua attraverso un campo dati

Per passare il codice della lingua attraverso un campo dati, completare i passaggi seguenti:

1. Assicurarsi che i dati contengano un campo il cui valore è il codice lingua richiesto per il recorddati. Nell’esempio precedente, questo campo è stato chiamato <Lang>.

2. Aprire il documento xPresso for Word che richiede l’impostazione lingua da definire.

3. Visualizzare Esplora variabili e individuare l’area dello schema che si desidera mappare allavariabile di output LOCALE.

4. Fare clic con il tasto destro del mouse sul campo contenente il codice della lingua (<Lang>nell’esempio citato) e fare clic su Impostazioni proprietà del documento.

5. Fare clic suModifica. Viene visualizzata la finestra di dialogo Seleziona Variabili di output.

6. Accertarsi che la variabile di output LOCALE si trovi nell’elenco Attivo e fare clic su OK. Se lavariabile di output LOCALE si trova nell’elenco Inattivo, trascinarla nell’elenco Attivo.

Passaggio del codice della lingua attraverso una variabile codificata

È possibile inoltre creare una variabile codificata con un singolo valore e mapparla alla variabile dioutput LOCALE per modificare l’impostazione della lingua. Completare i passaggi seguenti:

1. Aprire il documento xPresso for Word che richiede l’impostazione lingua da definire.

2. Visualizzare Esplora variabili e individuare l’area dello schema che si desidera mappare allavariabile di output LOCALE.

3. Fare clic sul menu relativo all’elemento dati padre e scegliere Funzione xPresso in Crea variabile.

4. Digitare il nome di una variabile e selezionare Stringa per il tipo di valore.

5. Digitare il codice della lingua racchiuso tra virgolette doppie nella casella Contenuto espressione,ad esempio "de", quindi fare clic su OK.

6. Fare clic con il pulsante destro del mouse sulla variabile e fare clic su Impostazioni proprietàdel documento.

7. Fare clic suModifica. Viene visualizzata la finestra di dialogo Seleziona Variabili di output.

63

Page 64:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

8. Accertarsi che la variabile di output LOCALE si trovi nell’elenco Attivo e fare clic su OK. Se lavariabile di output LOCALE si trova nell’elenco Inattivo, trascinarla nell’elenco Attivo.

LimitazioniRivedere le seguenti limitazioni di xPresso for Word:• Lingue supportate, pagina 64

• Impostazioni di visualizzazione di Windows, pagina 64

• La funzione di annullamento, pagina 64

• Interruzioni di sezione, pagina 65

• Stile Word PlaceholderText, pagina 65

• Documenti di sola lettura, pagina 65

• Verifica e visualizza anteprima, pagina 65

• Testo nascosto, pagina 65

• Mantieni con il successivo, pagina 66

• Tasti di scelta rapida, pagina 66

Lingue supportate

xPresso for Word non supporta le lingue che si leggono da destra verso sinistra, quale l’arabo.

Impostazioni di visualizzazione di Windows

Durante l’utilizzo di xPresso for Word, adottare la percentuale predefinita di ingrandimentodella visualizzazione di Windows (100%). xPresso for Word non supporta altre percentuali diingrandimento. Per verificare le percentuali di ingrandimento della visualizzazione, aprire ilPannello di controllo di Windows e controllare le impostazioni in Schermo. Accertarsi che lapercentuale di ingrandimento sia impostata su 100%.

La funzione di annullamento

Se si aggiunge il menu Annulla alla barra di accesso rapido o una scheda della barra multifunzionedi Word, il menu Annulla viene disabilitato quando si utilizza xPresso for Word. La funzione diannullamento è supportata solo con la combinazione di tasti Ctrl+Z.

64

Page 65:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Stile Word PlaceholderText

Microsoft Word contiene uno stile di paragrafo predefinito denominato “PlaceholderText”. Questostile è utilizzato internamente da xPresso for Word per il contenuto che non deve essere inclusocome output nel documento finale. Poiché xPression ignorerà qualsiasi contenuto formattato conquesto stile, evitare di utilizzarlo o modificarlo.

Interruzioni di sezione

I seguenti elementi relativi alle interruzioni di sezione non sono supportati.• Interruzioni di sezione o definizioni di pagina all’interno dei contenitori, come il contenutoriutilizzabile, loop, aree modelli e gruppi di contenuti (ad esempio, l’inserimento di contenutoriutilizzabile con più di una sezione di Word non è supportato).

• Creazione di un contenitore intorno a una interruzione di sezione

• Espansione di un’area modelli per includere un’interruzione di sezione

Il menu Definizione di pagina nella scheda Progettazione di xPresso for Word e i menu Interruzionie Colonne nella scheda Layout di pagina vengono disabilitati quando il cursore viene inseritoall’interno di un contenitore.

Quando si copia una selezione contenente un’interruzione di sezione continua e si incolla neldocumento, l’interruzione di sezione continua potrebbe essere sostituita da un’interruzione disezione nella pagina successiva. Per ulteriori informazioni su questo comportamento di Word, fareriferimento a http://support.microsoft.com/kb/291184.

Documenti di sola lettura

Quando si apre un documento di sola lettura e si seleziona un’immagine, è possibile immettere unalettera nel documento e salvarlo correttamente. Si tratta di una problema noto di Microsoft Word.

Verifica e visualizza anteprima

Quando si utilizza la funzione Verifica e visualizza anteprima, l’ultimo paragrafo del documento puòancora essere modificato. Si tratta di una problema noto di xPresso for Word.

Testo nascosto

xPression utilizza del testo nascosto con tag come parole chiave riservate per i comandi. Se si utilizzadel testo nascosto in un documento di xPresso for Word, è possibile rompere accidentalmentela struttura del documento.

65

Page 66:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Pianificazione del documento

Nota: Per evitare potenziali problemi, si consiglia di non utilizzare il testo nascosto nei documenti dixPresso for Word. Il contrassegno di fine paragrafo nascosto non causa problemi alla struttura deldocumento ma può andar perso nel documento di output dopo la pubblicazione.

Mantieni con il successivo

xPresso for Word supporta la funzionalità "Mantieni con il successivo" per i paragrafi nonché perun paragrafo seguito da una tabella.

Tasti di scelta rapida

NON modificare le combinazioni di tasti predefinite in Microsoft Word. In caso contrario, alcunecombinazioni di tasti di xPresso potrebbero non funzionare come previsto.

Se si verificano degli errori con le combinazioni di tasti, reimpostare tutte le combinazioni di tasti peril documento di xPresso. Per ulteriori dettagli sui passaggi, consultare la guida di Microsoft Help.

66

Page 67:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 3Utilizzo dei dati

L’output e la personalizzazione dei documenti di xPresso for Word dipendono dai dati variabile.Dopo aver caricato uno schema in un modello, è possibile creare variabili e definire criteridirettamente dagli elementi dati dello schema. È possibile quindi verificare il modello utilizzandodati per popolare le variabili e soddisfare i criteri. Questo consente di visualizzare dati reali durantel’utilizzo del modello.

I dati associati a un modello possono eseguire diverse attività:• Popolare variabili, solitamente con informazioni dell’account o del cliente.

• Soddisfare criteri per controllare il contenuto che viene visualizzato nell’output del documento.

• Passare il contenuto composto da righe di testo o interi paragrafi al documento.

La persona che pubblica il documento sul server deve sapere quali file di dati sono assegnati aldocumento. Se non è possibile assegnare un nome simile al file del pacchetto del documento e aifile di dati, è necessario applicare un altro metodo per assicurarsi che vengano utilizzati i file didati corretti con il documento.

In questo capitolo vengono trattati gli argomenti seguenti:• Preparazione dei file di dati, pagina 67

• Utilizzo dello schema, pagina 74

Preparazione dei file di datiNé xPresso for Word né il server xPression consentono di modificare file di dati. È pertantoimportante impostare correttamente i file di dati (schema e file XML) prima di iniziare a generareil documento. Per evitare problemi al momento della produzione, l’utente o l’amministratore didatabase deve assicurarsi che durante la preparazione dei file vengano seguite le linee guida trattatein questa sezione.

Durante la creazione di file di dati XML per l’utilizzo con xPresso for Word, tenere presente quantosegue:• Devono utilizzare la codifica UTF-8; Unicode e ANSI non sono supportati.

• Non possono contenere spazi dei nomi XML.

• Se verranno utilizzati nella pubblicazione, i nomi dei file non possono contenere i seguenticaratteri:

67

Page 68:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

& ^ = # @ $ % ’ * , / ? \ " + | { } < > ; :

• Gli elementi padre e figlio in uno schema non possono avere lo stesso nome.

Progettare lo schema per includere un elemento ripetitivo da utilizzare come elemento di massimolivello e un modello di contenuto che consente l’uso di più record. Chi progetta il documentoutilizzando lo schema in xPresso for Word deve conoscere l’elemento di massimo livello ripetitivo,poiché dovrà selezionarlo al momento del caricamento dello schema stesso. È opportuno chel’elemento di massimo livello corrisponda al tag di livello più elevato che rappresenta il recordripetuto nei dati. È consigliabile che il tag ripetuto appaia al secondo livello nella gerarchia delloschema.

Nell’esempio seguente, l’elemento radice è “Person”:<?xml version="1.0" encoding="UTF-8"?><xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"elementFormDefault="qualified"><xs:element name="Root_Element"><xs:complexType><xs:sequence><xs:element maxOccurs="unbounded" ref="Person"/></xs:sequence></xs:complexType></xs:element><xs:element name="Person"><xs:complexType><xs:sequence><xs:element ref="First"/><xs:element ref="Last"/><xs:element ref="City"/><xs:element ref="State"/></xs:sequence></xs:complexType></xs:element><xs:element name="First" type="xs:NCName"/><xs:element name="Last" type="xs:NCName"/><xs:element name="City" type="xs:string"/><xs:element name="State" type="xs:string"/></xs:schema>

I dati variabili possono trovarsi in un unico file XML con più record, in più file XML con più record oin più file XML ognuno con un unico record. Di seguito sono riportati alcuni esempi di file XML conun unico record o più record.

File con record singolo:

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

File con più record:

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

68

Page 69:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

<State>CT</State></Person><Person><First>Chris</First><Last>Richards</Last><City>Northhampton</City><State>MS</State></Person><Person><First>Mary</First><Last>Race</Last><City>San Diego</City><State>CA</State></Person></Root_Element>

Tipi di schema supportati

L’utilizzo dei tipi di schema seguenti è supportato in uno schema di xPresso quando si descrive unastruttura di database:• schema

• element

• complexType

• simpleType

• attributeGroup

• sequence

• attribute

• import

• include

Lo spazio dei nomi non è supportato. I tipi non presenti in questo elenco vengono ignorati e, seutilizzati, possono comportare errori.

Nota: xPression interpreta xs:long in uno schema come un numero intero. Per numeri grandi (piùdi 32 bit o 2147483647), utilizzare xs:string o modificare il tipo di variabile in xPresso for Wordda Integer a String. In caso contrario, nel valore numerico potrebbe verificarsi una sostituzione oun troncamento.

Utilizzo di istruzioni Include nello schema

xPresso for Word non supporta il caricamento di più file di schema in un unico documento. Tuttavia,nello schema è possibile utilizzare istruzioni Include; ciò consente essenzialmente di utilizzare piùschemi con un unico documento. Non esiste un limite per il numero di istruzioni Include che èpossibile inserire nello schema né per il livello di nidificazione delle istruzioni.

Le istruzioni Include devono avere questo formato:

69

Page 70:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

<xsd:include schemaLocation="percorso del file"/>

Ad esempio:

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

Se xPresso for Word non trova uno dei file dell’istruzione Include, viene generato questo messaggio:

Failed to find include file: <percorso del file>.

Per continuare a utilizzare lo schema, sarà necessario correggere l’istruzione Include o individuareil file mancante.

Nota: L’utilizzo delle istruzioni di importazione nello schema non è supportato.

Aggiunta di interruzioni di riga a campi XML

Può essere utile o necessario includere interruzioni di riga all’interno di campi XML di testo (stringa).xPresso for Word e il server xPression possono elaborare campi <xs:string> contenenti ritorni acapo al proprio interno. Ad esempio:<Street_Address>9573 Main StreetCA 92009,USA</Street_Address>

Alcuni editor XML, ad esempio XML Notepad, non sono in grado di visualizzare né in alcuni casidi salvare correttamente questo formato. Per aggiungere i ritorni a capo potrebbe essere necessarioaprire il file in un editor di testo.

Gli eventuali ritorni a capo (utilizzando il tasto Invio) contenuti nei dati cliente per creare nuoviparagrafi vengono trattati da xPression come nuovi paragrafi durante la pubblicazione. Tuttavia,se viene eseguita la verifica dei dati in uno strumento di progettazione, tali ritorni a capo verrannotrattati come nuove righe. Questo può causare una differenza tra l’aspetto del documento all’internodello strumento di progettazione durante la verifica e quando viene visualizzato in anteprima nellostrumento di progettazione o durante la pubblicazione sul server.

Nota: le interruzioni di riga possono essere ignorate negli output DOCX, iDOCX e HTML. Pervisualizzare le interruzioni di riga in questi output, utilizzare i tag <BR> che non fanno distinzione tramaiuscole e minuscole nel file XML.

Tag HTML nei dati XML

xPresso for Word supporta il passaggio di tag HTML nei dati XML utilizzati con i documenti dixPresso. I tag HTML devono essere chiusi, ad eccezione dei tag <BR>.

I tag HTML possono essere mantenuti o restituiti in testo normale. La stringa HTML può esserecodificata oppure contenuta in un tag CDATA. Ad esempio:<HTMLContentEncoded>&lt;b&gt;hello&lt;/b&gt;</HTMLContentEncoded>

oppure

70

Page 71:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

<HTMLContentCDATA><![CDATA[<b>Hello</b>]]></HTMLContentCDATA>

A seconda dell’impostazione, è possibile che la stringa precedente venga restituita come helloo come <b>hello</b>.

Quando si specifica un nome carattere in uno stile HTML, se il nome contiene spazi, come nel caso diArial Black, è necessario formattare il nome con virgolette di delimitazione, come mostrato di seguito:font-family:&aposArial Black&apos;

L’elaborazione dei tag HTML è configurabile a livello globale nel file xPRSConfig.xml che si trovasul client o nel file customerdata.properties disponibile sul server xPression; oppure perogni singola variabile nella finestra di dialogoModifica formattazione stringa (che ha la prioritàsull’impostazione globale per una variabile specifica). Per ulteriori informazioni sulla configurazionedell’elaborazione dei tag HTML a livello di variabile, vedere Formattazione di variabili stringa,pagina 92.

Nella seguente tabella vengono elencati i tag HTML o le entità nel file di dati XML. Qualsiasi tagHTML diverso da quelli presenti nell’elenco verrà ignorato e nel file di registro verrà visualizzatoun errore.

Tag HTML o entità Output generato

<b> Grassetto

<i> Corsivo

<s> o <strike> Barrato

<u> Sottolineato

<sub> Pedice

<sup> Apice

<span> Testo inline

Nota: l’attributo "stile" è supportato perutilizzare gli stili CSS inline. I tag <span>possono avere solo un tipo di bordo. Se vengonoimpostati dei bordi diversi, il risultato diventaimprevedibile.

<p> Paragrafo

Nota: l’attributo "stile" è supportato perutilizzare gli stili CSS inline.

<a> Collegamento

Nota: nei tag è supportato solo il testo semplicesenza stili o tag nidificati.

<em> Enfatizzato

<strong> Grande enfasi

Spazio unificatore

71

Page 72:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Proprietà CSS supportate

È possibile impostare delle proprietà CSS nei tag <span> e <p>. Nella tabella seguente sono elencate leproprietà CSS supportate nell’attributo "stile".

Nota: a causa delle limitazioni di Microsoft Word, il testo HTML nell’output iDOCX potrebbe essereleggermente diverso da quello che viene visualizzato in un browser.

Impostazione CSS Proprietà supportate

Bordo Le seguenti proprietà dei bordi sono supportate:"bordo", "spessore bordo", "stile bordo", "colorebordo", "bordo superiore", "bordo inferiore","bordo sinistro", "bordo destro", "stile bordosuperiore", "stile bordo inferiore", "stile bordosinistro", "stile bordo destro", "colore bordosuperiore", "colore bordo inferiore", "colorebordo sinistro", "colore bordo destro", "spessorebordo superiore", "spessore bordo inferiore","spessore bordo sinistro", "spessore bordodestro".

Nota: Sono supportati i seguenti stili: "nessuno","nascosto", "punteggiato", "tratteggiato","continuo", "double". Il valore del colore deveessere nello stesso formato della proprietà"colore". Lo spessore deve essere una lunghezzaCSS assoluta in px, cm, mm, in, pt o pc.

I tag <span> possono avere solo un tipo di bordo.Se vengono impostati dei bordi diversi, non èpossibile garantire con certezza il risultato.

Colore Le proprietà "colore" e "colore sfondo"sono supportate. Il valore del colore devecorrispondere a colori esadecimali, colori RGB onomi di colori predefiniti/tra più browser.

Carattere Le seguenti proprietà dei caratteri sonosupportate:• "famiglia di caratteri": il nome generico diuna famiglia non è supportato.

• "dimensione carattere": la dimensione delcarattere deve essere una lunghezza CSSassoluta in px, cm, mm, in, pt o pc.

• "stile carattere": supporta "eredita, "normale","corsivo" e "obliquo".

• "variante carattere": supporta "eredita","normale" e "maiuscoletto".

72

Page 73:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Impostazione CSS Proprietà supportate

• "spessore carattere": supporta "eredita","normale" e "grassetto".

Altro Sono supportate le seguenti proprietà:• "trasformazione testo": supporta "eredita","nessuno" e "maiuscole".

• "decorazione testo": supporta "eredita","nessuno", "sottolineato" e "barrato".

• "allineamento testo": supporta "a sinistra", "adestra", "al centro" e "giustificato". Questaproprietà può essere utilizzata solo nei tag<p>.

• "altezza di riga": una lunghezza CSS assolutain px, cm, mm, in, pt o pc. Questa proprietàpuò essere utilizzata solo nei tag <p>.

Configurazione dell’elaborazione dei tag HTML a livello globale

È possibile configurare la modalità di elaborazione dei tag HTML desiderata a livello globale pertutti i documenti di xPresso for Word impostando l’opzione HTMLFormat nel file xPRSConfig.xml(client) o nel file customerdata.properties (xPression Server). Questa impostazione può esseresostituita a livello di variabile selezionando o deselezionando Formattazione HTML nella finestradi dialogoModifica formattazione stringa. Per ulteriori informazioni, vedere Formattazione divariabili stringa, pagina 92.

Per poter visualizzare i risultati in xPresso for Word e nell’output pubblicato, modificarel’impostazione sul client e sul server.

Per configurare l’impostazione a livello globale:

1. Aprire Configure directory\xPRSConfig.xml nel computer client di xPresso for Word exPressionHome\customerdata.properties nel server xPression per la modifica.

2. Individuare la sezione <category name="DCPI"> del file.

3. Individuare la voce <prop name="HTMLFormatting" value="false"visible="false"/>.

4. Impostare HTMLFormating su true se si desidera che tutti i valori delle variabili venganovisualizzati nel documento utilizzando qualsiasi formattazione HTML contenuta nei dati XML.Impostare il valore su false se si desidera che tutti i tag HTML inclusi nei valori delle variabilivengano visualizzati come testo normale.

5. Salvare le modifiche.

73

Page 74:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Utilizzo dello schemaI dati determinano l’aspetto finale del documento. È fondamentale quindi che vengano configuraticorrettamente prima di creare il documento, per evitare potenziali problemi quando si passa ildocumento in produzione.

È necessario disporre di un file di schema XSD e uno o diversi file XML contenenti le informazionispecifiche per il documento che si sta creando. Questi file devono essere accessibili al computer clientxPresso. xPresso non supporta attualmente più file XSD.

Assicurarsi che lo schema e i file XML siano conformi agli standard xPresso prima di iniziarea utilizzarli per creare il documento. Per ulteriori informazioni, vedere Preparazione dei file didati, pagina 67. I nomi dei file di dati XML che verranno implementati nel server e usati per lapubblicazione non possono contenere i seguenti caratteri:&^=#@$%‘*,/?/“+|{}<>;:

Per associare uno schema al documento, si caricherà lo schema nel documento in xPresso for Word.Se lo scherma viene aggiornato dopo essere stato caricato, sarà necessario aggiornarlo anche neldocumento.

Caricamento dello schema

Lo schema di dati del documento viene visualizzato in Esplora variabili. Quando si crea un nuovomodello, è possibile caricare uno schema durante il processo di creazione, oppure in seguito dopoche il modello è stato creato.

Per caricare lo schema durante la creazione di un nuovo modello, selezionare la casella di controlloRichiedi file di schema XSD per creare un modello di dati variabile all’avvio nell’area Nuovomodello della pagina iniziale di xPresso for Word.

Nota: Se si modifica lo schema dopo averlo utilizzato per creare il documento e si carica la nuovaversione nel documento esistente, potrebbe essere necessario aggiornare alcuni riferimenti variabili.Per ulteriori informazioni, vedere Caricamento dello schema, pagina 75.

Per caricare lo schema di dati in uso in un modello esistente:

1. Visualizzare la pagina backstage di xPresso per il documento (File > xPresso).

2. Fare clic su Dati nell’area Gestione dati e scegliere Seleziona schema se il file è memorizzatolocalmente, oppure Seleziona schema da server se il file è memorizzato sul server.

3. Fare clic sul pulsante Sfoglia per individuare e selezionare il file dello schema di dati. Se si stacaricando uno schema da una directory locale, selezionare il file e fare clic su Apri.Se si sta caricando uno schema dal server, è possibile esplorare il repository xPressionDocumentum (se supportato) o selezionare un repository dall’elenco Server corrente e fare clicsu Connetti. Se è necessario specificare le informazioni di accesso, verrà visualizzata la finestraAccedi. Eseguire l’accesso, quindi individuare il file e fare clic su Carica. Qualsiasi repositorydefinito tramite una connessione ECM in xAdmin è disponibile nell’elenco Server corrente.Se lo schema contiene più di un elemento radice, xPresso chiede quale elemento si desiderautilizzare come radice. La radice del record ripetuto deve essere l’elemento di livello più elevatoche rappresenta il record ripetuto dei dati.

74

Page 75:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

4. Selezionare l’elemento ripetuto e fare clic su OK. Lo schema di dati viene visualizzato in Esploravariabili in una struttura gerarchica. Per ulteriori informazioni sugli elementi radice, vederePreparazione dei file di dati, pagina 67.

Ora che si dispone dello schema caricato, è possibile utilizzare i dati durante la creazione deldocumento. È possibile accedere ai campi dello schema per utilizzarli nel definire i criteri, è inoltrepossibile utilizzare i campi come variabili nel documento.

Per iniziare a creare gruppi di contenuti e istanze, vedere Creazione di un gruppo di contenuti, pagina146. Per utilizzare i dati per creare variabili nel documento, vedere Capitolo 4, Utilizzo di variabili.

Caricamento dello schema

Potrebbe essere necessario caricare uno schema aggiornato in un modello per il quale sono già statedefinite variabili e altro contenuto dinamico.

Quando si carica un nuovo schema nel documento, il vecchio schema viene rimosso. Le variabiliche sono state create dagli elementi dello schema che sono cambiate o che non appaiono nel nuovoschema devono essere rimappate. Se nel nuovo schema non sono presenti variabili da utilizzare perla mappatura, è possibile creare una variabile personalizzata nel nuovo schema e utilizzarla per lamappatura.

Per i documenti aggiornati, le variabili presenti nella cartella Variabile cliente legacy non possonoessere aggiornate aggiornando lo schema. Aggiornare queste variabili importando le definizionidi variabili.

Nota: Quando si aggiorna lo schema, il buffer UNDO viene cancellato. Una volta aggiornato loschema delle variabili, non è possibile annullare alcuna azione precedente all’aggiornamento delloschema.

Per caricare un nuovo schema e creare mappature di variabili:

1. Caricare il nuovo schema. Se il nuovo schema non contiene alcuna modifica alle variabiliattualmente utilizzate nel documento, l’aggiornamento dello schema viene terminato ed èpossibile ignorare i seguenti passaggi. Se il nuovo schema contiene modifiche alle variabiliattualmente in uso, ad esempio, viene ridenominata una variabile o modificato il tipo di dati diuna variabile, viene visualizzata la finestra di dialogo Aggiorna schema delle variabili.

2. (Facoltativo) È possibile fare clic su Cancella tutto per cancellare tutte le mappature esistentioppure è possibile selezionare una variabile mappata e fare clic su Elimina mappatura percancellare la mappatura relativa alla variabile.

3. Mappare manualmente una variabile in uso a una variabile presente nel nuovo schema medianteuna delle seguenti modalità:• Creare una mappatura di variabile tra una variabile in uso e un elemento del nuovo schema.

• Creare una variabile personalizzata come variabile mappata.

4. (Facoltativo) Una volta completata la creazione delle mappature di variabili, fare clic su Salvamappatura per salvare le mappature in un file XML. È possibile caricare le mappature di variabilisalvate quando si aggiorna lo schema delle variabili in altri documenti, selezionando Caricamappatura nella finestra di dialogo Aggiorna schema delle variabili.

75

Page 76:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Creazione di una mappatura di variabile

1. Nella finestra di dialogo Aggiorna schema delle variabili, selezionare una variabile che richiedela mappatura e fare clic su Crea mappatura. Una volta selezionata l’opzione Crea mappatura,non è possibile modificare la variabile selezionata nello schema delle variabili corrente. Fare clicsu Annulla mappatura per selezionare un’altra variabile.

2. Selezionare una variabile dal nuovo schema. Solo le variabili che possono essere mappate sonoabilitate per la selezione. Si consiglia di selezionare una variabile dello stesso tipo di dati dellavariabile attualmente in uso. Se si seleziona una variabile di tipo diverso e si crea la mappatura,possono verificarsi degli errori quando si pubblica il documento.

3. Fare clic su Fine mappatura per completare la mappatura. Una volta completata una mappatura,è possibile cancellarla selezionando la variabile mappata e facendo clic su Elimina mappatura.

Creazione di una mappatura di variabile personalizzata

Se nessun elemento di dati nel nuovo schema può essere mappato ad una variabile attualmentein uso, è possibile creare una variabile personalizzata come variabile mappata. Ad esempio, unavariabile denominata FullName è attualmente utilizzata nel documento per rappresentare ilnome completo di un cliente e lo schema viene aggiornato per utilizzare due variabili denominateFirstName e LastName per rappresentare il nome completo. In questo caso, è possibile creare unavariabile personalizzata concatenando FirstName e LastName e mapparla a FullName per evitarel’alterazione di qualsiasi logica nel documento.

1. Nella finestra di dialogo Aggiorna schema delle variabili, selezionare una variabile che richiedela mappatura.

2. Fare clic su Variabile personalizzata e selezionare il tipo di variabile che si desidera creare.

3. Selezionare un elemento principale per la nuova variabile personalizzata e fare clic su Continua.

4. Definire la variabile personalizzata e fare clic su OK per completare la mappatura. Una voltacompletata una mappatura, è possibile cancellarla selezionando la variabile mappata e facendoclic su Elimina mappatura.

Esempio

In questo esempio, si desidera utilizzare un nuovo schema per il documento. Il nuovo schemacontiene le seguenti modifiche:• Il nome di una variabile a cui si fa riferimento nel documento è stata modificata.

• Una variabile a cui si fa riferimento nel documento è stata rimossa.

• L’xPath di una variabile a cui si fa riferimento nel documento è stato modificato.

• Il tipo di variabile a cui si fa riferimento nel documento è stato modificato.

Nella pagina di backstage di xPresso, fare clic su Dati, selezionare Seleziona schema se il nuovo filedi schema è memorizzato in locale o su Seleziona schema da server se il file è memorizzato sul server.Viene visualizzata la finestra di dialogo Aggiorna schema delle variabili, in quanto le variabili

76

Page 77:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

sono state modificate nel nuovo schema. Poiché il filtroMappatura delle variabili necessaria vieneselezionato automaticamente, vengono visualizzate solo le prime tre variabili modificate.

Per visualizzare la variabile MYDECIMAL il cui tipo è stato modificato, selezionare il filtro Mostratutto o il filtro Tipo di valore campo modificato.

77

Page 78:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

78

Page 79:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Il nome della variabile NAMELAST è stato modificato in SURNAME. Per mappare la variabile,selezionare NAMELAST nella vista Schema delle variabili corrente e fare clic su Crea mappatura.

Selezionare SURNAME nella vista Nuovo schema di variabile e fare clic su Fine mappatura.

79

Page 80:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Una volta completata la mappatura, la variabile NAMELAST scompare dalla vista Mappatura dellevariabili necessaria.

80

Page 81:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

La variabile NAMEMIDDLE viene rimossa dal nuovo schema. È necessario creare una variabilepersonalizzata come variabile mappata. Selezionare NAMEMIDDLE, fare clic sulla freccia accanto aVariabile personalizzata e selezionare un tipo di variabile personalizzata.

81

Page 82:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

In questo esempio, viene creata una variabile JavaScript. Selezionare una variabile principale perla variabile personalizzata e fare clic su Continua. Creare una variabile JavaScript nella finestra didialogo Crea nuova variabile JavaScript e fare clic su OK per completare la mappatura.

82

Page 83:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

È possibile mappare la variabile CITY, di cui è stato modificato l’xPath, nello stesso modo in cuisi mappa la variabile NAMELAST.

83

Page 84:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo dei dati

Esplora variabili

Esplora variabili si trova all’interno del pannello Explorer di xPresso for Word. Fare clic sul pulsanteEsplora variabili che si trova nella parte inferiore del pannello per visualizzare Esplora variabili.

Esplora variabili visualizza l’intero schema di dati associato con il modello corrente. È possibilecreare variabili direttamente dagli elementi elencati nel pannello Esplora. Per ulteriori informazioni,vedere Aggiunta di variabili al modello, pagina 86. È anche possibile creare nuove variabilipersonalizzate direttamente nel pannello Esplora. Per ulteriori informazioni, vedere Creazione divariabili personalizzate, pagina 94.

Ad ogni elemento dati elencato nel pannello Esplora è associato un suo menu a discesa in cui sonoelencate le funzioni che è possibile eseguire per l’elemento. Le funzioni disponibili variano in base altipo di elemento.

Gli elementi visualizzati in Esplora variabili possono essere filtrati in modo da visualizzare solo unset secondario degli elementi contenuti nello schema. Questo è particolarmente utile quando sivisualizza uno schema di dimensioni molto grandi con numerosi elementi. È possibile utilizzare leopzioni di filtro nell’elenco a discesa o digitare le parole chiave nel campo di filtro.

84

Page 85:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 4Utilizzo di variabili

L’aggiunta di variabili e vettori di variabili al documento consente di controllare le tabelle, le immaginie il contenuto inclusi nell’output creato. Questo tipo di flessibilità consente di personalizzare ognidocumento per il destinatario desiderato, includendo elementi quali nome e indirizzo o contenutospecifico all’occupazione o ubicazione del destinatario. È possibile semplificare il messaggio perincludere informazioni pertinenti solo al singolo destinatario specifico del documento.

In questo capitolo vengono trattati gli argomenti seguenti:• Informazioni sulle variabili, pagina 85

• Aggiunta di variabili al modello, pagina 86

• Variabili di testo, pagina 87

• Creazione di variabili personalizzate, pagina 94

• Utilizzo di JavaScript, pagina 100

• Variabili d’ambiente di sistema, pagina 103

• Utilizzo della funzionalità Trova e sostituisci, pagina 104

• Array, pagina 107

• L’insieme delle definizioni di variabili, pagina 108

• Proprietà documento, pagina 111

Informazioni sulle variabiliIn Esplora variabili sono visualizzati tutti gli elementi dati contenuti nel file di schema associatoal modello di documento. Dagli elementi dati, è possibile creare direttamente variabili econtemporaneamente posizionarle nel modello. È anche possibile creare variabili personalizzateutilizzando una combinazione di elementi dati e funzioni xPath, JavaScript o xPresso inun’espressione di variabile.

Elementi dati figlio possono creare variabili che inseriscono testo specifico o immagini esternenell’output finale. Elementi dati padre (array) determinano i loop di contenuto e inseriscono tabellenell’output finale con informazioni specifiche del destinatario.

xPresso for Word inserisce le variabili in un documento utilizzando un controllo di contenuto Word.Questo controllo è visibile solo quando si seleziona la variabile. Per ulteriori informazioni, vedereUtilizzo di contenuto nel canvas, pagina 44.

85

Page 86:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

xPresso for Word consente di aggiungere al documento tre tipi di variabili: testo, immagine e tabella.Le variabili di testo vengono descritte in questo capitolo, variabili immagine e tabella vengonodescritte in capitoli successivi.

Nomi variabile

Per impostazione predefinita, il nome visualizzato utilizzato per gli elementi dello schema di datielencati in Esplora variabili è identico al nome elemento nello schema. xPresso for Word considera ilnome visualizzato un alias e utilizza l’xPath, non il nome, per identificare l’elemento.

In alcuni casi, è possibile avere elementi dati con lo stesso nome. Ad esempio, è possibile averediversi elementi First_Name visualizzati in diversi elementi padre, ad esempio Subscriber_Info,Dependent_Info e Agent_Info. Poiché il nome non viene utilizzato internamente per l’identificazione,è possibile avere più variabili con lo stesso nome, anche se potrebbe essere poco utile.

Per modificare il nome visualizzato fare clic sul menu a discesa relativo all’elemento nelpannello Esplora, selezionare Rinomina e digitare un nuovo nome. Nell’esempio precedente, èpossibile modificare le variabili First_Name in Subsriber_First_Name, Dependent_First_Name eAgent_First_Name. Questa modifica consente di semplificare l’identificazione della variabile dopoche è stata aggiunta al modello, poiché potrebbe non essere richiesta la visualizzazione dell’interoxPath.

Aggiunta di variabili al modelloEsistono diversi modi per aggiungere variabili al modello di documento:• CTRL + clic: posizionare il cursore sul canvas, premere CTRL, quindi fare clic sull’elemento datiin Esplora variabili che si desidera aggiungere.

Se la variabile è un elemento dati figlio, viene visualizzata nel modello come una variabile di testoin corrispondenza della posizione del cursore.

Se la variabile è un elemento dati padre, viene visualizzata la finestra di dialogo Definisci variabiletabella. Per ulteriori informazioni, vedere Variabili tabella, pagina 177.

Questo metodo non è applicabile per l’inserimento di variabili di immagine.

• Trascinamento della selezione: selezionare l’elemento dati in Esplora variabili, trascinarlo sulcanvas e rilasciarlo nel modello in corrispondenza della posizione desiderata.

Se la variabile è un elemento dati figlio, viene visualizzata nel modello come una variabile di testoin corrispondenza della posizione del cursore.

Se la variabile è un elemento dati padre, viene visualizzata la finestra di dialogo Definiscivariabile tabella. Per ulteriori informazioni, vedere Variabili tabella, pagina 177.

86

Page 87:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Questo metodo non è applicabile per l’inserimento di variabili di immagine.

• Inserimento del menu: posizionare il cursore nel canvas, fare clic sul menu a discesa relativoall’elemento dati e selezionare il tipo di variabile che si desidera inserire nell’opzione Inserisciselezione come:— Per tutti gli elementi dati figlio, è possibile selezionare Variabile testo.

— Per elementi dati figlio Stringa, è possibile selezionare Variabile testo o Variabile immagine.

— Per elementi dati padre, è possibile selezionare Variabile tabella o Loop di contenuto.

Nota: Se si inserisce una variabile testo all’interno di un’altra parola in modo che non esistano spazitra la variabile e il testo, la combinazione di parola/variabile verrà contrassegnata come errore dalcorrettore ortografico di Word. Si tratta del comportamento predefinito di Word ed xPresso for Wordnon offre alcuna funzione che consenta di ignorare questo comportamento.

Variabili di testoLe variabili testo vengono utilizzate per inserire informazioni personali nel documento, ad esempio ilnome e l’indirizzo del destinatario. Possono essere numeriche (Float, Double, Boolean o Decimal) odi tipo data, ora, data e ora o stringa. I campi Data, Ora e DataOra devono essere visualizzati neidati utilizzando un formato specifico:• Data: aaaa-mm-gg (ad esempio: 2003-05-19)

• Ora: hh:mm:ss (ad esempio: 11:22:50)

• DataOra: aaaa-mm-ggThh:mm:ss (ad esempio: 2002-01-05T03:15:30)

Le variabili di testo possono essere utilizzate per operazioni più complesse dell’inserimento didati relativi ai clienti. È possibile creare file XML contenenti grandi parti di contenuto, e quindi,utilizzando le variabili, è possibile inserire tali parti di contenuto nel documento. Il documentopuò quindi rappresentare solo un modello contenente variabili e cornici per il posizionamento dicontenuto, che in realtà si trova in un file XML.

Nota:• Se il tipo di dati della variabile è numerico, il suo valore non può essere null. Se si tenta diapplicare al documento dati contenenti un valore null per una variabile di tipo numerico, inxPresso for Word viene generato un errore.

• Se i dati contengono i valori "0" o "1" per una variabile di tipo booleano, la variabile restituiscesempre "false" senza nessun avviso o messaggio di errore.

Visualizzazione di variabili testo nel documento

Sono disponibili diverse opzioni per impostare la visualizzazione delle variabili testo durantel’utilizzo di un documento xPresso for Word. La scelta dell’opzione appropriata sarà determinata

87

Page 88:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

dalle informazioni sulle variabili che è necessario visualizzare durante la creazione del documento odalla preferenza personale. Sono disponibili tre opzioni:• Nome: visualizza il nome della variabile di testo.

• xPath: visualizza l’intero xPath della variabile di testo. Questa opzione è disponibile solo perle variabili definite con un’espressione xPath.

• Carattere: visualizza il carattere immesso nella casella di testo visualizzata con questa opzione.Questa opzione è utile quando i nomi variabile sono più lunghi della larghezza dell’area in cui idati vengono inseriti, ad esempio in celle di tabella con colonne strette.

La preferenza di visualizzazione può essere impostata utilizzando l’opzione Visualizzaz. variab. chesi trova nell’area Variabile sulla scheda Progettazione di xPresso for Word della barra multifunzionedi Word.

Definizione dei formati globali delle variabili

È possibile definire i formati globali delle variabili a livello del documento. Quando si visualizzal’anteprima di un documento o lo si pubblica, i formati globali vengono applicati alle variabili esistentiche non sono state formattate attraverso Esplora variabili, Esplora modelli e nel canvas. Per istruzionisu come formattare le singola variabili, consultare Formattazione delle variabili testo, pagina 89.

Nota: I formati globali non sono effettivi sui risultati di calcolo del subtotale.

xPresso consente di definire i formati globali dei seguenti tipi di variabili:• Intero

• Virgola mobile

• Double

• Data

• Ora

• DataOra

Definizione dei formati globali delle variabili

1. Aprire il documento di xPresso for Word e visualizzare la pagina di backstage selezionandoFile > xPresso.

2. Fare clic sul pulsante Dati e selezionare Impostare i formati di variabile predefiniti per ildocumento dall’elenco. Viene visualizzata la finestra di dialogo Imposta formati predefiniti.

3. Fare clic sul pulsante Formato di ciascun tipo di variabile e selezionare le opzioni desiderate. Peristruzioni su come selezionare le opzioni di ciascun tipo di variabile, consultare Formattazionedelle variabili testo, pagina 89.

4. Fare clic su OK per salvare i formati globali.

88

Page 89:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Formattazione delle variabili testo

È possibile formattare le variabili testo per determinare il modo in cui vengono visualizzatenell’output. Potrebbe essere necessario, ad esempio, visualizzare nell’output una variabile di tipodata come 01/05/2002, aggiungere un separatore delle migliaia o un simbolo di valuta all’output dellavariabile numerica oppure visualizzare nell’output una variabile stringa tutta in caratteri maiuscoli,indipendentemente dallo stile della stringa immessa.

Nota: Se una variabile contiene un carattere della lingua Cinese (o altro carattere asiatico), ènecessario selezionare la libreria di caratteri corretta dall’elenco a discesa Carattere di Word perassicurarsi che la formattazione venga visualizzata correttamente.

Le variabili possono essere formattate tramite Esplora variabili, Esplora modelli o nel canvas. Quandosi definisce un formato per un elemento dati in Esplora variabili, questo sarà il formato predefinitoe verrà applicato a ogni variabile successiva creata da tale elemento dati. Se la variabile vieneformattata in Esplora modelli, o nel canvas, il formato si applica solo a questa istanza specifica dellavariabile. È possibile ignorare un formato predefinito (definito in Esplora variabili) per una variabilespecifica definendo un nuovo formato per la variabile in Esplora modelli o nel canvas. Se nessuno deimetodi viene utilizzato per formattare una variabile, il formato globale verrà applicato alla variabilequando si visualizza l’anteprima del documento o lo si pubblica.

Definizione di un formato predefinito

Un formato variabile predefinito si applica a tutte le variabili create dall’elemento dati per cui ilformato è definito. I formati predefiniti possono essere ignorati definendo un formato per unavariabile specifica.

Definizione di un formato predefinito

1. Rendere visibile Esplora variabili.

2. Fare clic sul menu a discesa relativo all’elemento dati e selezionare Imposta formato predefinito.Viene visualizzata la finestra di dialogo Formato per il tipo di elemento.

3. Definire il formato utilizzando i passaggi nella sezione appropriata:• Formattazione di variabili di tipo data, ora o data e ora, pagina 90

• Formattazione di variabili numeriche, pagina 91

• Formattazione di variabili stringa, pagina 92

Definizione di un formato per una variabile specifica

Dopo aver aggiunto una variabile al modello, è possibile definire un formato specifico per la variabile.Questo formato ignora l’eventuale formato predefinito applicato alla variabile quando è stata creata.È possibile definire il formato specifico della variabile in Esplora modelli o nel canvas.

89

Page 90:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Definizione di un formato per una variabile specifica

1. Da Esplora modelli: fare clic sul menu a discesa relativo alla variabile e selezionareModificaformato.Dal canvas: posizionare il cursore all’interno della variabile sul canvas, quindi fare clic suFormato nella sezione Variabile della scheda xPresso sulla barra multifunzione di Word.Viene visualizzata la finestra di dialogo Formato per il tipo di elemento.

2. Definire il formato utilizzando i passaggi nella sezione appropriata:• Formattazione di variabili di tipo data, ora o data e ora, pagina 90

• Formattazione di variabili numeriche, pagina 91

• Formattazione di variabili stringa, pagina 92

Formattazione di variabili di tipo data, ora o data e ora

Per formattare una variabile Data, Ora o DataOra, completare i passaggi seguenti:

1. Selezionare la casella di controllo Impostazioni locali, quindi selezionare un’impostazionelocale dall’elenco a discesa. Le opzioni elencate nell’elenco a discesa Formato variano in base allaselezione effettuata.

2. Selezionare il formato dall’elenco a discesa. Ad esempio, se si seleziona aaaa-MM-gg per unavariabile data, 05-19-2003 viene visualizzato come 2003-05-19 nell’output; oppure, se si selezionah:mm per un variabile ora, 12:00:09 viene visualizzato come 12:00 PM nell’output.

3. Fare clic su OK. Per impostazione predefinita, in xPresso for Word vengono visualizzate soloalcune opzioni di formato per le variabili Data e Ora. Per utilizzare un formato diverso, èpossibile aggiungerlo come un formato personalizzato. Per ulteriori informazioni, vedereAggiunta di formati personalizzati, pagina 90.

Nota: Se si modifica l’impostazione del fuso orario nel computer, sarà necessario riavviare ilcomputer affinché la modifica venga visualizzata nelle variabili di tipo ora o data e ora.

Aggiunta di formati personalizzati

Se la finestra di dialogo Modifica formato data, Modifica formato ora, o Modifica formato data/oranon contiene il formato richiesto, è possibile definire un formato personalizzato che vengavisualizzato come un’opzione. I formati personalizzati vengono aggiunti al file localeformat.xml evengono visualizzati nell’elenco a discesa appropriato.

Aggiunta di un formato personalizzato

1. Cercare la directory C:\Program Files\Common Files\xPresso\Version#\xPRS\locale, dove Version# è il numero di versione dell’installazione. Nei sistemi operativi a 64bit, utilizzare “Programmi (x86)”.

2. Aprire il file localeformat.xml in un editor di testo.

3. Individuare le impostazioni locali in cui si desidera aggiungere il nuovo formato. Ad esempio,per aggiungere un formato alle impostazioni locali danesi, individuare:

90

Page 91:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

<Locale name="da_DK" display="Danish (Denmark)">

4. Individuare la sezione per il tipo di formato da aggiungere: <date>, <time> o <datetime>.

5. Nella sezione appropriata, aggiungere una nuova voce per il formato utilizzando il modelloriportato di seguito.<format value="valore" sample="esempio" />Oppure è possibile modificare un formato esistente. In questo modo, l’opzione esistentenell’elenco a discesa verrà sostituita dalla nuova opzione.Assicurarsi che qualsiasi valore contenente una data segua la convenzione della data Java; adesempio, per l’anno utilizzare aaaa.

6. Salvare il file localeformat.xml.

7. Riavviare xPresso for Word.

Formattazione di variabili numeriche

Per formattare una variabile numerica, completare i passaggi seguenti:

1. Selezionare le impostazioni locali che si desidera utilizzare per specificare la formattazione delnumero. Il separatore delle migliaia e il simbolo di valuta sono associati a questa impostazione.

2. Selezionare Utilizza separatore migliaia nella sezione Delimitatori per includere un separatoremigliaia nell’output variabile. Il separatore dipende dalle impostazioni locali selezionate. Se,ad esempio, per le impostazioni locali si seleziona Inglese (Stati Uniti), il numero 5000 verràvisualizzato come 5,000.

3. Immettere il numero di cifre decimali per visualizzare la variabile numerica con cifre decimali.Se, ad esempio, si immette 3, 5000 il numero verrà visualizzato come 5000,000.

4. Selezionare il tipo di simbolo da visualizzare con il numero:• Nessuno: nessun simbolo viene visualizzato con il numero nell’output.

• Percentuale: un segno di percentuale viene visualizzato con il numero nell’output. Il numero5000, ad esempio, verrà visualizzato come 500000%.

• Divisa: il simbolo di valuta per le impostazioni locali selezionate viene visualizzato con ilnumero nell’output. Selezionare la posizione del simbolo (prima o dopo il numero) dall’elencoa discesa. Se, ad esempio, si seleziona Inglese (Stati Uniti) per le impostazioni locali e Primaper la posizione del simbolo, il numero 5000 verrà visualizzato come $5000.

5. Selezionare Precisione nella sezione Arrotondamento per arrotondare il numero quando vienevisualizzato nel documento. Immettere il numero di cifre che si desidera venga restituito. Ilconteggio delle cifre inizia dalla cifra diversa da zero all’estrema sinistra del risultato esatto.

6. Selezionare la modalità di arrotondamento che si desidera utilizzare:• Excel: consente di utilizzare il protocollo di arrotondamento di Microsoft Excel.

• Parte intera superiore: consente di arrotondare per eccesso verso l’infinito positivo.

• Unità inferiore: consente di arrotondare verso lo zero.

• Parte intera inferiore: consente di arrotondare per difetto verso l’infinito negativo.

91

Page 92:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

• Asimmetrico: consente di arrotondare al valore più vicino a meno che la cifra non siaequidistante, nel qual caso viene utilizzato l’arrotondamento per difetto.

• Convergente: consente di arrotondare al valore più vicino a meno che la cifra non siaequidistante, nel qual caso viene utilizzato l’arrotondamento al valore pari.

• Simmetrico: consente di arrotondare al valore più vicino a meno che la cifra non siaequidistante, nel qual caso viene utilizzato l’arrotondamento per eccesso.

• In eccesso: consente di arrotondare per eccesso.

7. Fare clic su OK.

Formattazione di variabili stringa

Per formattare una variabile stringa, completare i passaggi seguenti:

1. Selezionare uno dei seguenti formati:• Nessuna: ’Nome agent’ verrà visualizzato come ’Nome agent" (nessuna modifica)

• MAIUSCOLE: ’Nome agent’ verrà visualizzato come ’NOME AGENT’

• minuscole: ’Nome software’ verrà visualizzato come ’nome software’

• Iniziali maiuscole: ’Nome agent’ verrà visualizzato come ’Nome Agent’

2. Selezionare Utilizza formattazione HTML da campo variabile se i dati XML contengono tagHTML che si desidera mantenere nell’output del testo della variabile. Se la casella di controllo èdeselezionata, qualsiasi tag HTML rilevato durante la pubblicazione verrà restituito come testonormale, ad esempio, <b>hello</b> anziché hello.

3. Selezionare Rimuovi linea vuota per verificare che nell’output non venga visualizzata una rigavuota quando un record non contiene dati per questo campo variabile.

4. Fare clic su OK.

Nota: La formattazione HTML non viene visualizzata nell’output quando si applicano dati per laverifica e l’anteprima del documento; per visualizzare la formattazione nell’output è necessario creareun’anteprima PDF o pubblicare il documento sul server.

Quando si definisce un formato per una variabile stringa, in xPression il formato potrebbe nonessere applicato nell’output se la variabile contiene formattazione di stili di Word. Se, ad esempio, sicrea una variabile stringa utilizzando uno stile con i caratteri tutti maiuscoli e quindi si specifica laformattazione Minuscole nella finestra di dialogo Formattazione stringa, la variabile verrà pubblicatada xPression utilizzando caratteri tutti maiuscoli.

Rimozione delle righe vuote nei blocchi di testo

Se si dispone di una variabile in cui a non tutti i record di dati corrisponde un valore e si desideraevitare di visualizzare righe vuote per i record vuoti nei documenti, è possibile utilizzare lafunzionalità Rimuovi linea vuota. Questa funzionalità è utile in presenza di contenuto quale i blocchidi indirizzi, dove i differenti record di dati possono avere un differente numero di righe. L’utilizzo

92

Page 93:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

della funzionalità Rimuovi linee vuote assicura che tutti gli indirizzi vengano stampati come blocchicontinui, senza righe vuote.

L’opzione Rimuovi righe vuote è definita a livello di variabile in Esplora modelli.

Nota: Questa opzione viene elaborata dall’engine di pubblicazione e pertanto verrà visualizzata soloquando si crea un’anteprima PDF del documento o si pubblica il documento nel server. I risultati diquesta opzione non sono visibili quando si applicano dati.

Rimozione delle linee vuote da una variabile

1. Fare clic sul menu a discesa relativo alla variabile di testo in Esplora modelli e selezionareProprietà. La tabella delle proprietà per l’istanza della variabile viene visualizzata nella variabilenel pannello Esplora.

2. Selezionare la casella di controllo accanto al campo Rimuovi linea vuota per cambiarel’impostazione da Falso a Vero. Questa operazione indica a xPression di rimuovere la riga perquesta variabile nei documenti i cui dati non contengono un valore per la variabile.

Quando si genera l’output per il documento, se un record non contiene dati per la variabile, la rigaverrà esclusa dall’output. In questo modo, l’output non conterrà righe vuote. Ad esempio:

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

Producono questo output:

Elizabeth Steele38792 S. West Blvd.Apartment 1824Andover, CT 06123

Questi dati invece:

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

Producono questo output:

John Smith123 Main St.Hartford, CT 06040

93

Page 94:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Creazione di variabili personalizzateIn alcuni casi, potrebbe essere necessario creare una variabile “da zero” anziché usare direttamenteun elemento dati. È possibile creare tre tipi di variabili: JavaScript, Funzione xPresso e xPath.

Creazione di una variabile

1. Rendere visibile Esplora variabili.

2. Individuare l’elemento dello schema in cui si desidera aggiungere la nuova variabile.

3. Fare clic sul menu a discesa relativo all’elemento e selezionare il tipo di variabile che si desideracreare nell’opzione Crea variabile:• JavaScript

• Funzione xPresso

• xPath

Per informazioni su ciascun tipo di variabile, vedere le seguenti sezioni.

4. Specificare un nome per la variabile. Il nome non può essere uguale ai nomi di altre variabilipresenti nello stesso elemento padre.

Variabili JavaScript

Quando si crea una variabile personalizzata, è possibile fornire la mappatura tramite una funzioneJavaScript. JavaScript offre la massima flessibilità nella scrittura di funzioni e calcoli complessi.È possibile utilizzare questo linguaggio per operazioni quali la chiamata a un servizio web pereseguire una ricerca di dati, l’esecuzione di un calcolo finanziario complesso, l’esecuzione di unatrasformazione complessa, come la conversione di dati numerici in parole, la ricerca di un’espressioneregolare in una stringa o l’esecuzione di un ordinamento personalizzato di dati. Per ulterioriinformazioni, vedere Utilizzo di JavaScript, pagina 100. È inoltre possibile utilizzare codice JavaScriptglobale nelle espressioni, che possono fare riferimento a script JavaScript esterni o essere porzionidi codice JavaScript riutilizzabile. Per ulteriori informazioni, vedere Creazione di script JavaScriptglobali, pagina 100.

Tutte le espressioni JavaScript vengono create nell’editor JavaScript, contenente strumenti e opzioniche consentono di costruire un’espressione per la variabile.

Nota: (1) Accertarsi che l’ultima istruzione della variabile personalizzata sia un valore JavaScript(ad esempio, una costante, una variabile o una funzione che restituisce un valore). (2) Riferimenti avariabili di XML utilizzano l’object “resolver”.

La casella di modifica JavaScript rappresenta il punto in cui è possibile creare l’espressione. Èpossibile includere campi dello schema (formattati in base alle convenzioni di denominazioneJavaScript standard) e funzioni nell’espressione e utilizzare gli operatori booleani seguenti: >(maggiore di), < (minore di), >= (maggiore o uguale a), <= (minore o uguale a) e ! (diverso da). Leespressioni devono essere definite in uno dei formati seguenti:if(resolver.getValueByName (“fullname”)=="abc") return false; else return true;

94

Page 95:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

In alternativa, è possibile inserire true o false come valore booleano. L’esempio seguente non èvalido: (3-2)!=(5-8)

È inoltre possibile eseguire i calcoli seguenti nell’espressione:

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

Nota: In JavaScript, i numeri di nodo a virgola mobile non sono precisi. Pertanto, è consigliabile nonutilizzare i valori float per calcolare una quantità esatta, ad esempio per i calcoli monetari.

Inserimento di variabili in espressioni JavaScript

Per includere una variabile nell’espressione, selezionarla dall’elenco e trascinarla nella casellaJavaScript, oppure fare doppio clic sulla variabile nell’elenco. La variabile selezionata verràvisualizzata nella casella nel formato JavaScript corretto:resolver.getValueByName("BDT:STOCK:STOCK_NAME")

Se lo si desidera, è quindi possibile aggiungere un operatore. Per creare, ad esempio, una variabiledenominata “TotalAmountDue”, è possibile specificare:resolver.getValueByName("BDT:Customer:AcctInfo:BalanceForward")+resolver.getValueByName("BDT:Customer:AcctInfo:AmtDue")

I array utilizzati nelle espressioni non possono essere nidificati e le variabili non possono essereautoreferenziali.

Inserimento di funzioni in espressioni JavaScript

Per includere una funzione JavaScript nell’espressione, fare doppio clic sulla funzione nell’elencoFunzioni JavaScript, oppure selezionare una funzione e trascinarla nella casella Espressione. Adesempio:concat([string1[, string2[,]]])

Selezionare ciascun argomento e sostituirlo aggiungendo una variabile o digitando un valore. Percreare, ad esempio, una variabile denominata “FullName”, è possibile specificare:concat (resolver.getValueByName("BDT:CUSTOMER:CUSTOMER_DEMOGRAPHIC:FIRST_NAME"), ’ ’,resolver.getValueByName("BDT:CUSTOMER:CUSTOMER_DEMOGRAPHIC:MIDDLE_INITIAL"), ’ ’,resolver.getValueByName("BDT:CUSTOMER:CUSTOMER_DEMOGRAPHIC:LAST_NAME"))

95

Page 96:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Per ulteriori informazioni sulle singole funzioni disponibili, vedere Appendice C, Funzioni JavaScript.

Inserimento di istruzioni If/Else in espressioni JavaScript

È possibile utilizzare la logica if-else nelle espressioni per le variabili per creare istruzioni piùcomplesse. Sono supportati i formati delle istruzioni seguenti:if ("a"=="a") return "a"; if ("a"=="b") return "b"; else return "c"

if (resolver.getValueByName("variable")=="a") return "a";if (resolver.getValueByName("variable")=="b") return "b"; else return "c"

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

Ad esempio:if (resolver.getValueByName("BDT:Customer:CustInfo:CollateralType")=="00")return "Improve your customer communications";if (resolver.getValueByName("BDT:Customer:CustInfo:CollateralType")=="30")return "Improve your policyholder communications";if (resolver.getValueByName("BDT:Customer:CustInfo:CollateralType")=="31")return "Improve your P&C forms management process";else return "Improve your client communications";

Verifica dell’espressione JavaScript

Dopo avere completato l’espressione, è necessario verificarne la grammatica. Questo processoconsente di controllare solo la grammatica dell’espressione; le funzioni contenute nell’espressionenon vengono verificate. Per verificare l’espressione, fare clic su Fare clic per verificare la presenza dierrori in JavaScript nella parte inferiore della finestra di dialogo. Verrà visualizzato un messaggio aldi sotto della casella JavaScript indicante i risultati della verifica.

Esempio di espressione JavaScript

Questo esempio JavaScript accetta un valore numerico e lo converte in parole. Questa funzione puòessere utilizzata per scrivere la quantità su un assegno.

L’aspetto del codice JavaScript per la variabile BalanceInWords è il seguente:var s = "";if (isDataNull(BALANCE) == "true") {s = "NO BALANCE AVAILABLE";

}else {s = numberToDollars(BALANCE);

Se il valore per il campo dati BALANCE è “222.541,54”, il valore per la variabile BalanceInWordssarà “DUECENTO VENTIDUEMILA CINQUECENTO QUARANTUNO dollari eCINQUANTAQUATTRO centesimi”.

96

Page 97:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Variabili Funzione xPresso

Quando si crea una variabile personalizzata, è possibile indicare la mappatura tramite un’espressioneFunzione xPresso. La possibilità di definire un’espressione significa che la variabile può rappresentaremolto più che semplicemente un campo dati. È possibile confrontare campi dati, eseguire calcoli eutilizzare funzioni il cui risultato venga visualizzato nell’output del documento. Questa opzioneoffre un’elevata flessibilità.

Nota: Le variabili di tipo Funzione xPresso non possono contenere una virgola (,) nel nome, népossono fare riferimento a un’altra variabile contenente una virgola nel nome.

Tutte le espressioni Funzione xPresso vengono create nell’editor funzioni xPresso, contenentestrumenti e opzioni che consentono di costruire un’espressione per la variabile in uso.

La casella nella parte superiore è il punto in cui è possibile costruire l’espressione. È possibileincludere campi dello schema e funzioni nell’espressione e utilizzare gli operatori booleani seguenti:> (maggiore di), < (minore di), >= (maggiore o uguale a), <= (minore o uguale a) e ! (diverso da). Leespressioni devono essere definite in uno dei formati seguenti:if((3-2)!=(5-8)) return true; else return false;if($fullname$=="abc") return false; else return true;

In alternativa, è possibile inserire true o false come valore booleano. L’esempio seguente non èvalido: (3-2)!=(5-8)

È inoltre possibile eseguire i calcoli seguenti nell’espressione:integer + integer, float, or doubleinteger - integer, float, or doubleinteger * integer, float or doubleinteger / float or doubleinteger % float or doublefloat + float or doublefloat - float or doublefloat * float or doublefloat / float or doublefloat % float or doubledouble + doubledouble - doubledouble * doubledouble % doublestring + string

Nota: È necessario digitare una “f” insieme a qualsiasi valore float utilizzato in un calcolo. Adesempio:$Pay:Price$*0.15f-(1.0f/3.0f)*1600

Suggerimento: Se è necessario modificare il tipo di valore della variabile durante la creazionedell’espressione, selezionare un nuovo tipo nell’elenco a discesa Tipo di valore visualizzato nella partesuperiore della finestra di dialogo.

97

Page 98:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Inserimento di variabili in espressioni Funzione xPresso

Per includere una variabile nell’espressione, fare clic su Seleziona variabile e selezionare la variabilenella finestra di dialogo Seleziona variabile. La variabile selezionata verrà visualizzata nella casellautilizzando il formato seguente:$DataPath:VariableName$

Se lo si desidera, è quindi possibile aggiungere un operatore. Per creare, ad esempio, una variabiledenominata “Nome completo”, è possibile specificare:

$PRIMARY_ACCOUNT:FNAME$+""+$PRIMARY_ACCOUNT:MIDDLE_INITIAL$+""+$PRIMARY_ACCOUNT:LNAME$

Nota: I array utilizzati nelle definizioni delle variabili non possono essere nidificati.

Inserimento di funzioni in espressioni Funzione xPresso

Per includere una funzione nell’espressione, fare innanzitutto clic su un pulsante di opzione pervisualizzare le funzioni disponibili: Funzioni numeriche, Funzioni logiche, Funzioni gruppo,Funzioni stringa o Funzioni DataOra. È possibile fare clic su una funzione nell’elenco pervisualizzarne una descrizione nella parte inferiore della finestra di dialogo. Fare doppio clic su unafunzione nell’elenco per visualizzarla nella casella dell’espressione, in cui è possibile modificarla.Ad esempio:addDay( datetime_or_date_value , numeric_value )

Selezionare ogni argomento e sostituirlo selezionando un campo dello schema o digitando un valore.Per creare, ad esempio, una variabile denominata “DatePastDue”, è possibile specificare:

addDay($DATE_DUE$), 7)

Per ulteriori informazioni sulle singole funzioni disponibili, vedere Appendice B, Funzioni xPresso.

Inserimento di istruzioni If/Else in espressioni Funzione xPresso

È possibile utilizzare la logica if-else nelle espressioni per le variabili per creare istruzioni piùcomplesse. Sono supportati i formati delle istruzioni seguenti: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"

Ad esempio:

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";else return "Improve your client communications";

98

Page 99:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Verifica dell’espressione Funzione xPresso

Dopo avere completato l’espressione, è necessario verificarla per accertarne il funzionamento e lavalidità. Per verificare l’espressione, fare clic su Fare clic per verificare la presenza di errori inEspressione nella parte inferiore della finestra di dialogo. Verrà visualizzato un messaggio nellafinestra di dialogo al di sotto della casella dell’espressione indicante i risultati della verifica.

Variabili xPath

Quando si crea una variabile personalizzata, è possibile indicare la mappatura tramite un’espressionexPath.

Tutte le espressioni xPath vengono create nell’editor xPath, contenente strumenti e opzioni checonsentono di costruire un’espressione per la variabile. La casella di modifica xPath rappresenta ilpunto in cui è possibile creare l’espressione. È possibile includere nell’espressione campi di schemae funzioni.

Inserimento di variabili in espressioni xPath

Per includere un campo dello schema (variabile) nell’espressione, selezionare l’elemento schemadall’elenco e trascinarlo nella casella xPath, oppure fare doppio clic sulla variabile nell’elenco. Lavariabile selezionata verrà visualizzata nella casella insieme al percorso completo:/CUSTOMER/CUSTOMER_DEMOGRAPHIC/STATE

Se lo si desidera, è quindi possibile aggiungere un operatore. Per creare, ad esempio, una variabiledenominata “TotalAmountDue”, è possibile specificare:

/Customer/AcctInfo/BalanceForward+/Customer/AcctInfo/AmtDue

I array utilizzati nelle espressioni non possono essere nidificati.

Inserimento di funzioni in espressioni xPath

Per includere una funzione nell’espressione, fare doppio clic sulla funzione nell’elenco FunzionixPath, oppure selezionare una funzione e trascinarla nella casella Espressione. Ad esempio:concat(string, string, string*)

Selezionare ciascun argomento e sostituirlo aggiungendo un campo dello schema o digitando unvalore. Per creare, ad esempio, una variabile denominata “FullName”, è possibile specificare:

concat(/CUSTOMER/CUSTOMER_DEMOGRAPHIC/FIRST_NAME, ’ ’,/CUSTOMER/CUSTOMER_DEMOGRAPHIC/MIDDLE_INITIAL, ’ ’,/CUSTOMER/CUSTOMER_DEMOGRAPHIC/LAST_NAME)

Per ulteriori informazioni sulle singole funzioni disponibili, vedere Appendice A, Funzioni xPath.

Nota: La funzione namespace-uri attualmente non è supportata in xPression.

99

Page 100:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Verifica dell’espressione xPath

Dopo avere completato l’espressione, è necessario verificarne la grammatica. Questo processoconsente di controllare solo la grammatica dell’espressione; le funzioni contenute nell’espressione nonvengono verificate. Per verificare l’espressione, fare clic su Verifica. Verrà visualizzato un messaggioal di sotto della casella xPath indicante i risultati della verifica.

Utilizzo di JavaScriptJavaScript è un linguaggio di script standard con un’ampia disponibilità di codice per la risoluzionedi problemi e un’ampia disponibilità di strumenti. È possibile utilizzare JavaScript per definire valoriper variabili personalizzate in documenti xPresso. JavaScript è solo uno dei tre possibili modi perdefinire valori di variabile personalizzati; le altre opzioni includono istruzioni xPath e funzionixPresso. Le funzioni xPresso sono meno potenti di JavaScript, ma sono utili poiché incapsulanocodice di elaborazione a dati comuni. Sebbene non sia possibile combinare direttamente le funzionixPresso con JavaScript, JavaScript può fare riferimento a variabili che usano funzioni xPresso.

Quando si utilizza JavaScript in xPresso, l’ordine di esecuzione delle istruzioni non è garantito. Nontentare di impostare o fare riferimento a variabili comuni tra variabili o object diversi. Accertarsi diinizializzare le variabili come richiesto prima di ogni loop.

JavaScript è un modo per definire una variabile xPresso; non è possibile utilizzare variabili JavaScriptdirettamente in un documento. Quando si crea una variabile personalizzata, è possibile fornireJavaScript per definire il valore della variabile. xPresso esegue alcune verifiche della struttura dellasintassi di JavaScript, ma non convalida i riferimenti a variabili o metodi. Quando si definisce unavariabile personalizzata utilizzando JavaScript, nella finestra di dialogo della definizione sonodisponibili funzioni JavaScript comuni per semplificare l’utilizzo. Accertarsi di assegnare allevariabili JavaScript un nome diverso dalle variabili xPresso. Per ulteriori informazioni, vedereVariabili JavaScript, pagina 94.

Javascript globale

xPresso offre anche la possibilità di definire JavaScript globale a cui è possibile fare riferimento dallevariabili JavaScript. JavaScript globale può contenere funzioni che vengono riutilizzate, nonchévariabili e istruzioni a livello documento. È possibile definire JavaScript globale tramite un fileJavaScript esterno o tramite JavaScript personalizzato.

Creazione di script JavaScript globali

È possibile creare riferimenti a file JavaScript esterni e creare script JavaScript personalizzati tramitel’opzione JavaScript globale. Questi script JavaScript globali possono essere quindi utilizzati nelledefinizioni delle variabili JavaScript.

Nota: Il protocollo FTP è supportato per l’utilizzo con JavaScript globali; tuttavia, il comando EPSVALL non è supportato.

100

Page 101:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Per creare un elemento JavaScript globale:

1. Con un documento aperto, visualizzare la pagina di backstage di xPresso (File > xPresso).

2. Fare clic su Imposta JavaScript globale, nella parte inferiore della pagina.

3. Digitare un nome per l’elemento JavaScript globale.

4. Selezionare File JS esterno o Personalizza JS dall’elenco a discesa Tipo e fare clic su Aggiungi.

5. File JS esterno: fare clic sul pulsante Sfoglia per individuare e selezionare il file JavaScriptesterno. Fare clic su OK.Personalizza JS: definire l’espressione JavaScript personalizzata, verificarla e fare clic su OK. Perulteriori informazioni, vedere Variabili JavaScript, pagina 94.Il JavaScript globale viene visualizzato nell’elenco.

Al termine, è possibile modificarlo, cancellarlo o spostarlo verso l’alto o verso il basso nell’elencoutilizzando i pulsanti visualizzati sopra l’elenco.

Utilizzo di percorsi relativi per JavaScript globali

È possibile definire la posizione dei file JavaScript globali utilizzando un percorso relativo, che abilitala memorizzazione degli script in percorsi diversi su macchine host differenti. Se xPresso for Word eil server xPression sono installati, una directory \js predefinita viene configurata automaticamente.Durante l’installazione di xPresso for Word, è possibile accettare il percorso predefinito delladirectory o definirne uno nuovo. Sulle macchine client e server, la directory predefinita (proprietàjs_dir) è definita nel file xPRSConfig.xml, modificabile se necessario.

Il file xPRSConfig.xml si trova nei percorsi seguenti:• Client xPresso for Word: directory di configurazione.

• Server xPression: directory xPressionHome.

Se si memorizzano script JavaScript nella directory \js predefinita, quando si specifica la posizione nelcampo Riferimento JavaScript globale, è possibile immettere semplicemente il nome file. xPressionviene così configurato per ricercare il file nella directory \js.

L’uso di percorsi relativi consente di creare file JavaScript separati che hanno lo stesso nome e chesono memorizzati su macchine host diverse, ma a cui si fa riferimento allo stesso modo da xPression.

Utilizzo di Java

xPresso consente anche di eseguire codice Java da JavaScript. Java in xPresso si basa sull’engineJavaScript e il suo utilizzo è possibile come risultato dell’implementazione del supporto JavaScript.

Gli object Java sono accessibili tramite variabili JavaScript. È possibile creare object Java utilizzandodichiarazioni di variabile quali:var myDate = java.util.Date();var myDateString = myDate.toString();

È anche possibile accedere a membri statici quali:java.lang.Math.PI

101

Page 102:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

java.lang.Math.cos(myNumber)

“Primitivi”, inclusi object Stringa, vengono passati come normal. Solo i primitivi possono essereutilizzati nella logica xPresso o nel documento.

Per eseguire Java in xPresso, occorre verificare che la classe Java si trovi nel percorso di classeaggiungendo il percorso assoluto JAR alla variabile d’ambiente di sistema CLASSPATH. La classeJava verrà caricata in fase di esecuzione. Dopo aver aggiunto JAR al percorso di classe, è necessarioriavviare xPresso for Word.

Esempio di utilizzo di uscite utente Java

In questo esempio, viene definita una classe Java come segue:package com.docsci.test;

public class testJar {private String m_name;public testJar(String name){m_name = name;}

public String SayHelloToName(){return "Hello " + m_name;}}

dove com.docsci.test è il percorso del pacchetto. È possibile denominare il percorso delpacchetto come desiderato.

Per utilizzare questa classe Java da xPress for Word, esportare le classi Java come un file JAR, adesempio, testJar.jar. Aggiungere il percorso assoluto del proprio file JAR alla variabile d’ambiente delsistema CLASSPATH. Richiamare la classe Java in uno dei due modi seguenti:• Creare un elemento di JavaScript globale e richiamare la classe Java nella definizione:

function testInGlobalJavaScript(){var a = new com.docsci.test.testJar("Tom, this is use in Global JavaScript");return a.SayHelloToName();}

Quindi, creare una variabile JavaScript e includere la funzione di JavaScript globale nelladefinizione:testInGlobalJavaScript()

• Creare una variabile JavaScript globale e richiamare la classe Java nella definizione:function test(){var a = new com.docsci.test.testJar("Tom, this is use in Variable Definition Panel");return a.SayHelloToName();}

test()

Ora è possibile utilizzare la variabile JavaScript nel documento per richiamare la classe Java.

102

Page 103:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Se si fa riferimento a un nome di pacchetto in xPresso for Word, utilizzare la sintassiseguente: Packages.PackagePath. Ad esempio, var UserExit = new Packages.ch.test.om.mxpression.exit.OMExitPoint(). Tuttavia, esistono delle variabili di livellosuperiore predefinite equivalenti a Packages, ad esempio com e org. Pertanto, nel nostro esempio,com.docsci.test.testJar è equivalente a Packages.com.docsci.test.testJar. Perulteriori informazioni, consultare https://developer.mozilla.org/en-US/docs/Rhino/Scripting_Java.

Variabili d’ambiente di sistemaxPression consente di definire variabili che sono specifiche del sistema o dell’ambiente. Questevariabili possono essere utilizzate per identificare informazioni e risorse che possono cambiare da unambiente a un altro. Le variabili vengono definite sul Server xPression e quindi scaricate e utilizzatenel modello di documento. Il valore della variabile viene definito sul server e può pertanto variare inbase all’ambiente server, ad esempio sviluppo, verifica e produzione.

Le variabili d’ambiente di sistema vengono in genere utilizzate per percorsi che cambiano traambienti. Si supponga, ad esempio, di avere un’immagine che risiede su disco. L’immagine èmemorizzata in directory diverse nei server di sviluppo e produzione. Per utilizzare una variabiled’ambiente di sistema per questo esempio, procedere come indicato di seguito:• Creare una variabile d’ambiente di sistema su entrambi i server e assegnarle un nomecaratteristico. Per questo esempio, è possibile utilizzare IMAGE_DIR.— Sul server di sviluppo, definire il valore della variabile con il percorso alla directory delleimmagini sul server. Ad esempio, “C:/Test/Images”.

— Sul server di produzione, definire il valore della variabile con il percorso alla directory delleimmagini sul server. Ad esempio, “C:/Assets/Claims/Correspondence/Images”.

Per ulteriori informazioni sulla creazione di variabili d’ambiente di sistema, vedere la Guidaper l’utente xAdmin.

• Nel modello di xPresso for Word, creare una variabile personalizzata. Definire il valore dellavariabile come segue:

{IMAGE_DIR}+”/”+{IMAGE_NAME}

Quando la variabile viene risolta sul server di sviluppo, xPression ricerca l’immagine nelladirectory C:/Test/Images. Quando viene risolta sul server di produzione, la ricerca viene eseguitanella directory C:/Assets/Claims/Correspondence/Images.

Caricamento di variabili d’ambiente di sistema

Le variabili dell’ambiente di sistema sono definite nel server. Per utilizzarle nel modello, caricarel’elenco delle variabili in xPresso for Word completando i seguenti passaggi:

1. Con un modello aperto, visualizzare la pagina di backstage di xPresso (File > xPresso).

2. Fare clic su Dati e selezionare Imposta variabili d’ambiente di sistema. Le variabili attualmentedefinite sul server a cui si è connessi vengono visualizzate nell’intestazione Inattiva. Le eventualivariabili attualmente attive per questo modello vengono visualizzate nell’intestazione Attiva.

103

Page 104:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

3. Selezionare una variabile nell’intestazione Inattiva e trascinarla nell’intestazione Attiva. Ripetereper tutte le variabili che si desidera attivare per questo modello. Se si desidera rimuovere unavariabile dal modello, invertire il processo.

4. Fare clic suOK. Le variabili d’ambiente di sistema attive vengono visualizzate nella parte inferioredi Esplora variabili e sono disponibili per l’utilizzo all’interno del modello, analogamentea qualsiasi altra variabile.

Utilizzo della funzionalità Trova e sostituiscixPresso for Word fornisce una funzione Trova e sostituisci estremamente efficace che consente nonsolo di sostituire testo statico con testo statico, ma anche di sostituire testo statico con variabili. Lafunzione Trova e sostituisci ignora le istanze delle variabili visualizzate nel documento durante ilprocesso di ricerca; quindi non è possibile cercare le variabili o il testo contenuto nella variabile.

Ricerca di un elemento

1. Posizionare il cursore nel punto del modello di documento in cui si desidera iniziare la ricerca.

2. Fare clic sulla scheda Progettazione di xPresso for Word nella barra multifunzione di Word.

3. Fare clic su Ricerca avanzata. Viene visualizzata la finestra di dialogo Trova e sostituisci dixPresso for Word.

4. Inserire una stringa di ricerca nella casella di testo Trova. La stringa di ricerca può esserecostituita da testo statico, caratteri jolly e codici di caratteri non jolly.Per ricercare un carattere come testo statico definito come un carattere jolly, digitare una barrarovesciata (\) prima del carattere. Ad esempio, per individuare un punto interrogativo (?),digitare \?.Utilizzare una virgola (,) per separare più stringhe di ricerca.

5. Selezionare il punto all’interno del documento si desidera avviare la ricerca:• Tutti i contenuti: viene ricercato tutto il contenuto presente nel documento, intestazioni epiè di pagina inclusi, partendo dal punto in corrispondenza della posizione del cursore neldocumento.

• Selezione: viene ricercato l’intervallo di contenuti attualmente selezionato.

Questa opzione è disponibile solo se un intervallo di contenuti è selezionato all’interno deldocumento.

• Solo corpo del testo: effettua la ricerca solo del contenuto presente nel corpo principale deldocumento, senza includere eventuale contenuto presente in intestazioni o piè di pagina.

Questa opzione è disponibile solo se il contenuto attualmente selezionato, o la posizione delcursore, si trova nel corpo principale del documento.

• Solo intestazione/piè di pagina: effettua la ricerca solo del contenuto presente nelleintestazioni e nei piè di pagina del documento.

Questa opzione è disponibile solo se il contenuto attualmente selezionato, o la posizione delcursore, si trova nell’intestazione o piè di pagina del documento.

104

Page 105:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

A differenza di Microsoft Word, la funzione Trova e sostituisci di xPresso for Word non visualizzaun messaggio quando la ricerca raggiunge la fine della selezione o l’inizio del documento.Utilizza la selezione nell’elenco a discesa Dove per determinare l’ambito della ricerca.

6. Selezionare le opzioni di ricerca:• Cerca in alto: selezionare questa casella di controllo per eseguire la ricerca indietro neldocumento dalla posizione iniziale del cursore. Lasciare questa casella di controllodeselezionata (impostazione predefinita) per eseguire la ricerca in avanti nel documentodalla posizione del cursore.

• Maiuscole/minuscole: selezionare questa casella di controllo per eseguire una ricerca condistinzione tra maiuscole e minuscole. Lasciare questa casella di controllo deselezionata perignorare la distinzione tra maiuscole e minuscole durante la ricerca.

Questa opzione non è disponibile se è selezionata l’opzione Utilizza caratteri jolly.

• Usa caratteri jolly: selezionare questa casella di controllo per utilizzare caratteri jolly nellastringa di ricerca. Quando si seleziona questa opzione, viene eseguita solo la ricerca deltesto esatto specificato.

Se si sceglie questa opzione, le opzioni Maiuscole/minuscole e Trova parola intera vengonoautomaticamente selezionate.

L’opzione Utilizza caratteri jolly non è supportata quando si seleziona l’opzione Consentivariabili nel testo sostitutivo.

Per ulteriori informazioni sui caratteri jolly, vedere Utilizzo di caratteri jolly, pagina 106.

• Parola intera: selezionare questa casella di controllo per garantire che vengano individuatesolo le parole intere contenenti la stringa di ricerca. Lasciarla deselezionata per ignorarel’inizio e la fine della parola durante la ricerca.

Questa opzione non è disponibile se è selezionata l’opzione Maiuscole/minuscole.

7. Fare clic su Trova successivo per individuare solo la stringa di ricerca senza sostituirla. xPressofor Word ricerca tutto il contenuto statico all’interno del modello di documento ed evidenziala prima istanza della stringa di ricerca nel documento. Ripetere questo passaggio fino aindividuare tutte le istanze.Fare clic sulla scheda Sostituisci se si desidera sostituire la stringa di ricerca individuata econtinuare con i passaggi successivi.

8. Specificare con che cosa sostituire la stringa di ricerca. È possibile inserire testo statico oppure èpossibile selezionare una variabile o definire un’espressione della variabile:• Testo statico: inserire la stringa statica nella casella di testo Sostituisci che si desiderautilizzare per sostituire il testo individuato.

• Variabile: selezionare la casella di controllo Consenti variabili nel testo sostitutivo. Lacasella di testo Sostituisci con diventa di sola lettura e viene visualizzato il pulsante Variabile.

Fare clic sul pulsanteVariabile per aprire la finestra di dialogo Trova e sostituisci con variabili.Fare doppio clic su una variabile per selezionarla. È anche possibile creare un’espressionevariabile per sostituire il testo selezionato. È possibile utilizzare solo elementi figlio per lasostituzione, non è possibile selezionare un elemento padre (un array).

Fare clic su Inserisci. La variabile o l’espressione della variabile compare nella casellaSostituisci con.

105

Page 106:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

L’opzione Consenti variabili nel testo sostitutivo non è supportata quando si seleziona Utilizzacaratteri jolly.

9. Fare clic su Sostituisci o su Sostituisci tutto. Se si fa clic su Sostituisci, xPresso for Wordsostituisce l’istanza attualmente evidenziata della stringa di ricerca ed evidenza l’istanzasuccessiva nel documento. Se si fa clic su Sostituisci tutto, tutte le istanze individuate neldocumento verranno sostituite senza richiesta di conferma ulteriore.

Utilizzo di codici di caratteri non jolly

Esistono diverse combinazioni di carattere che non sono caratteri jolly, ma che possono essereutilizzati per individuare tipi di contenuto specifici. Nella seguente tabella vengono elencati questicaratteri con una descrizione del loro utilizzo.

Per trovare Tipo

Qualsiasi carattere ^?

Qualsiasi cifra ^#

Qualsiasi lettera ^$

Immagine o grafico (solo inline) ^g

Indicatore di piè di pagina ^f o ^2

Indicatore di fine nota ^e

Campo (quando i codici di campo sonovisibili)

^d o ^19 o ^21

Commento (quando i commenti sono inline) ^a o ^5

Interruzione di sezione ^b

Spazio vuoto ^w (qualsiasi combinazione di spaziregolari e unificatori e caratteri ditabulazione)

Utilizzo di caratteri jolly

I caratteri jolly possono essere utilizzati nella stringa di ricerca per espandere l’ambito della ricerca.Quando si seleziona la casella di controllo Usa caratteri jolly, viene individuato solo il testo esattospecificato. Le opzioni Maiuscole/minuscole e Solo parole intere vengono automaticamente attivatequando si utilizzano caratteri jolly e non possono essere disattivate.

È possibile utilizzare parentesi per raggruppare caratteri jolly e testo e per indicare l’ordine divalutazione. Ad esempio, digitare (pre)*(ti) per individuare “preordinati” e “prevenuti”.

È possibile utilizzare il carattere jolly \n per cercare un’espressione e sostituirla con l’espressioneriordinata. Ad esempio, digitare (Ashton)(Chris) nella casella di testo Trova, quindi digitare \2\1nella casella di testo Sostituisci con. xPresso for Word individuerà Ashton Chris e lo sostituirà conChris Ashton.

106

Page 107:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Nella tabella seguente vengono elencati i caratteri jolly che è possibile utilizzare per trovare alcunielementi.

Per trovare Tipo Esempio

Qualsiasi carattere singolo ? s?i individua sai e sei.

Qualsiasi stringa di caratteri * s*a individua sella e setta.

L’inizio di una parola < <(inter) individua interno e internazionale, ma nonreinternare.

La fine di una parola > (si)> individua si e vasi, ma non residenti.

Uno dei caratteri specificati [] p[ae]lo individua palo e pelo.

Qualsiasi carattere singolo in questo intervallo [-] [p-f]alla individua palla e falla. Gli intervalli devonoessere in ordine crescente.

Qualsiasi carattere singolo ad eccezione delcarattere nell’intervallo racchiuso tra parentesi

[!x-z] t[!a-m]ck individua tock e tuck, ma non tack o tick.

Esattamente n occorrenze del carattere oespressione precedente

{n} fe{2}d individua feed, ma non fed.

Almeno n occorrenze del carattere o espressioneprecedente

{n,} fe{1,}d individua fed e feed.

Da n a m occorrenze del carattere o espressioneprecedente

{n,m} 10{1,3} individua 10, 100 e 1000.

Una o più occorrenze del carattere o espressioneprecedente

@ lo@t individua lot e loot.

ArrayArray, o elementi dati padre nello schema, possono essere utilizzati per creare variabili tabella odeterminare loop di contenuto. I metodi per l’inserimento di array nel modello sono identici a quelliper le variabili; per istruzioni vedere Aggiunta di variabili al modello, pagina 86.

Quando si posiziona un array nel modello, come una tabella o un loop di contenuto, duevariabili vengono automaticamente aggiunte all’elemento dati padre in Esplora variabili:Indice<NameofTableorLoop> e Totale<NameofTableorLoop>.

La variabile Indice è un contatore del record corrente. Consente di verificare l’indice o la posizionedel record corrente, o il numero di iterazione del loop attualmente eseguito. Il conteggio indice iniziain corrispondenza del valore 1. La variabile Totale fornisce il conteggio record totale.

Se un singolo array viene utilizzato più volte nel modello, è importante assegnare nomi significativialle tabelle e ai loop generati dall’array, in modo che anche i nomi delle variabili Indice e Totale sianosignificativi. Ogni tabella e loop generano delle proprie variabili Indice e Totale, poiché il conteggio diun array specifico può variare a seconda che si applichi un filtro loop o si modifichi l’xPath.

Dopo che un array è stato utilizzato per creare una variabile tabella o un loop di contenuto, è possibilemodificare la tabella o il loop di contenuto per definire un nuovo xPath.

107

Page 108:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Filtro di un array

In alcuni casi, è possibile includere solo alcuni elementi contenuti nei dati array. Per loop dicontenuto, è possibile definire un filtro; tuttavia, variabili tabella non offrono questa opzione. Perloop di contenuto e variabili tabella è possibile definire l’xPath dell’array per includere solo i datidesiderati. Ad esempio, potrebbe essere utile includere solo valori account negativi. È possibiledefinire un xPath simile a: /Account[Balance<0]. Per ulteriori informazioni sulla definizione dixPaths, vedere Variabili xPath, pagina 99.

Nota: Quando si utilizza un filtro e la variabile Totale nel documento, il tempo impiegato nel calcolodel valore della variabile Totale potrebbe essere elevato. È consigliabile definire l’xPath del array inmodo da includere solo i dati desiderati.

xPath array possono essere modificati nella finestra di dialogo Definisci variabile tabella, nellafinestra di dialogo Definisci loop.

Riferimento a un’istanza di variabile specifica all’internodi un array

Quando si utilizza un array, non è sempre consigliabile eseguire il loop nei dati in una posizionespecifica. Il progetto del modello in uso potrebbe richiamare dati da un unico array ripetitivovisualizzato in posizioni diverse. A questo scopo, definire xPath diversi per l’array per includere datispecifici per ogni posizione. Ad esempio, per includere il secondo gruppo di dati per un elemento, èpossibile definire un xPath simile a: /Vehicle[Index=2]. Per ulteriori informazioni sulla definizione dixPath, vedere Variabili xPath, pagina 99.

xPath array possono essere modificati nella finestra di dialogo Definisci variabile tabella, nellafinestra di dialogo Definisci loop.

L’insieme delle definizioni di variabiliLe definizioni di variabili possono essere condivise tra modelli xPresso for Word versione 4.5. Questoconsente di riutilizzare in continuazione definizioni di variabili comuni senza ricrearle da zero.Se i dati tra il documento di origine e il nuovo documento non corrispondono completamente, ledefinizioni delle variabili possono essere facilmente rimappate dopo l’importazione.

Nota: L’insieme delle definizioni di variabili non possono essere condivise tra xPresso for Wordversione 4.5 e xPresso for Adobe InDesign, xPresso for Dreamweaver, o una versione precedentedi xPresso for Word.

Per attivare la condivisione delle definizioni delle variabili, xPresso for Word contiene sia unafunzione di importazione (per attivare l’uso delle variabili create in altri documenti nel documentocorrente), che una funzione di esportazione (per attivare il salvataggio di un insieme di variabilicreate in questo documento per utilizzarlo in altri documenti). Le funzioni di importazione edesportazione si trovano entrambe nella pagina xPresso della vista Backstage di Word.

108

Page 109:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Importazione di definizioni di variabili

È possibile importare nel modello di xPresso for Word definizioni di variabili esportate da un altrodocumento di xPresso for Word versione 4.5. In questo modo è possibile condividere definizioni divariabili tra modelli, evitando di ricreare variabili di uso comune in ogni nuovo modello.

Per importare definizioni di variabili:

1. Aprire il modello in xPresso for Word in cui si desidera importare le definizioni.

2. Visualizzare la pagina di backstage di xPresso (File > xPresso).

3. Fare clic su Dati nell’area Gestione dati e selezionare Importa definizioni variabili o Importadefinizioni variabili dal server.

4. Per un’importazione locale, individuare e selezionare il file XML di esportazione contenente ledefinizioni di variabile che si desidera importare e fare clic su Apri.Per un’importazione server, selezionare il repository in cui si trova il set, quindi selezionare ilnome del set dall’elenco a discesa. Il server può essere configurato per utilizzare solo il repositoryxPression, nel qual caso sarà la sola scelta dall’elenco a discesa. Fare clic su OK.Se il documento contiene un elemento con lo stesso nome di un elemento importato, verràvisualizzata la finestra di messaggio Importazione variabile. Se due elementi hanno lo stessonome ma sono di tipo diverso, in xPresso for Word verrà visualizzato un messaggio di errore.Sarà necessario rendere entrambi gli elementi dello stesso tipo, quindi eseguire di nuovol’importazione.

5. Selezionare la modalità desiderata per gestire il nome di variabile duplicato specifico o tutti inomi di variabile duplicati, quindi fare clic su Continua importazione. In alternativa, è possibilefare clic su Annulla importazione.

Se il documento utilizza lo stesso schema del documento da cui sono state esportate le definizioni,queste verranno mappate automaticamente ai dati del documento. Se i documenti utilizzano file dischema diversi, è possibile mappare manualmente le definizioni una volta importate, oppure èpossibile aprire il file di definizione delle variabili in un editor XML, utilizzare la funzione Trova esostituisci per aggiornare i riferimenti di percorso, quindi importare le definizioni.

Opzioni di importazione delle variabili

La finestra di messaggio Importazione variabile contiene le opzioni seguenti.

Opzione Descrizione

Mantieni la variabileesistente nel documento

Selezionare questa opzione per mantenere la variabile esistente nel documentoe non sovrascriverla con la variabile con lo stesso nome presente nel file. Fareclic su Continua importazione. Se viene rilevato un altro nome di variabileduplicato, la finestra di messaggio verrà visualizzata di nuovo.

109

Page 110:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Opzione Descrizione

Mantieni tutte le variabiliesistenti nel documento

Selezionare questa opzione per mantenere tutte le variabili presenti neldocumento e non sovrascriverle con quelle con lo stesso nome presenti nel file.Fare clic su Continua importazione. In xPresso for Word 2007 non verrannopiù visualizzate altre richieste se viene rilevato un nuovo nome di variabileduplicato, ma verrà utilizzata questa opzione per elaborarlo.

Utilizza la variabile nel file Selezionare questa opzione per importare la variabile duplicata dal file esovrascrivere la variabile esistente nel documento. Fare clic su Continuaimportazione. Se viene rilevato un altro nome di variabile duplicato, la finestradi messaggio verrà visualizzata di nuovo.

Utilizza tutte le variabili nelfile

Selezionare questa opzione per importare tutte le variabili duplicate dal filee sovrascrivere qualsiasi variabile esistente con i nomi duplicati. Fare clicsu Continua importazione. In xPresso for Word 2007 non verranno piùvisualizzate altre richieste se viene rilevato un nuovo nome di variabileduplicato, ma verrà utilizzata questa opzione per elaborarlo.

Continua importazione Fare clic su Continua importazione per utilizzare l’opzione selezionata econtinuare il processo di importazione.

Annulla importazione Fare clic su Annulla importazione per interrompere il processo diimportazione e non importare più altre variabili. Tutte le variabili importateprima di fare clic sul pulsante verranno mantenute nel documento.

Esportazione di definizioni di variabili

È possibile esportare le definizioni di variabili attualmente definite nel modello, in modo da poterleutilizzare in altri modelli di xPresso for Word versione 4.5. Il processo di esportazione crea un fileXML che può essere quindi importato in un altro modello.

Nota: Il Server xPression non identifica lo strumento xPresso utilizzato per esportare il file didefinizione di variabile. Di conseguenza, nel nome del file di esportazione è importante indicare cheil set di definizioni di variabili deriva da xPresso for Word versione 4.5.

Per esportare le definizioni delle variabili:

1. Aprire il modello in xPresso for Word che contiene le definizioni da esportare.

2. Visualizzare la pagina di backstage di xPresso (File > xPresso).

3. Fare clic su Dati nell’area Gestione dati e selezionare Esporta definizioni variabili o Esportadefinizioni variabili al server.

4. Per un’esportazione locale, passare alla posizione in cui si desidera archiviare il file diesportazione e digitare un nome per il file.Per un’esportazione server, selezionare il repository server in cui si desidera esportare il set didefinizioni della variabile e quindi assegnare un nome al set. Il server può essere configurato perutilizzare solo il repository xPression, nel qual caso sarà la sola scelta dall’elenco a discesa.I nomi devono avere una lunghezza inferiore a 200 caratteri e non possono contenere alcuno deiseguenti caratteri: < > & \ “ ’ : @ ! ? * # \\ $ / [ ] { } ( )

110

Page 111:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Ricordare di indicare in qualche modo xPresso for Word versione 4.5 nel nome file. Ad esempio,xWord4.5_ClientLetterVariables.

5. Fare clic su Salva (locale) oppure OK (server).

Proprietà documentoLe proprietà documento forniscono un modo per associare dati contenuti in un modello con variabilidi output definite sul server. Le variabili di output possono essere usate in espressioni e modelli didenominazione file in diverse aree di xAdmin. In xPresso for Word, è possibile specificare qualsiasielemento dati come una proprietà del documento.

Assicurarsi che tutte le proprietà del documento che verranno utilizzate nei modelli di denominazionefile siano associate a elementi dati con valori univoci per ciascun record nel file di dati. Se un valorenon è univoco, è possibile che vengano creati nomi di file duplicati, che genereranno un errore.Verificare inoltre che il valore non includa uno dei caratteri seguenti: \, /, :, *, ?, “, <, >, |.

Le proprietà del documento possono essere condivise tra documenti e tra strumenti di progettazionedi xPresso. Indipendentemente dallo strumento di xPresso in cui sono state originariamente create, èpossibile utilizzare le definizioni in qualsiasi documento xPresso for Adobe InDesign, xPresso forWord o xPresso for Dreamweaver. Per attivare la condivisione delle proprietà del documento, xPressofor Word contiene sia una funzione di importazione (per attivare l’uso delle proprietà create in altridocumenti nel documento corrente), che di una funzione di esportazione (per attivare il salvataggiodi una proprietà del documento creata in questo documento per utilizzarla in altri documenti).

Proprietà documento vengono definite in Esplora variabili.

Creazione di una proprietà del documento

Quando si crea una proprietà documento, un elemento dati viene mappato direttamente a unavariabile di output memorizzata sul server. Per completare questi passaggi è necessario essereconnessi al Server xPression.

Per definire una elemento dati come una proprietà documento:

1. Rendere visibile Esplora variabili.

2. Fare clic sul menu a discesa relativo all’elemento dati e selezionare Impostazioni proprietàdel documento.

3. Fare clic suModifica. Viene visualizzata la finestra di dialogo Seleziona Variabili di output.Le variabili nella sezione Attiva sono già mappate all’elemento dati, le variabili nella sezioneInattiva non sono mappate.

4. Selezionare una variabile e fare clic sull’icona Aggiungi per mappare la variabile. Selezionare unavariabile e fare clic sull’icona Elimina per annullare la mappatura della variabile.

5. Fare clic su OK.Dopo che è stata definita, quando si utilizza la variabile di output selezionata nelle espressioni e inmodelli di denominazione file associati al documento, verranno utilizzati i dati dell’elemento dati.

111

Page 112:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Importazione delle proprietà del documento

È possibile importare nel documento di xPresso for Word proprietà del documento esportate da unaltro documento di xPresso. Le proprietà possono essere importate da un documento di xPressofor Adobe InDesign, xPresso for Dreamweaver o xPresso for Word. In questo modo, è possibilecondividere le proprietà del documento tra documenti evitando di ricreare proprietà di uso comunein ogni nuovo documento.

Per importare le proprietà del documento:

1. Aprire il modello in xPresso for Word in cui si desidera importare le proprietà del documento.

2. Visualizzare la pagina di backstage di xPresso (File > xPresso).

3. Fare clic su Gestione OP nell’area Impostazione elaborazione di output e selezionare Importaproprietà documento o Importa proprietà documento dal server.

4. Per un’importazione locale, individuare e selezionare il file XML di esportazione contenente leproprietà del documento che si desidera importare e fare clic su Apri.Per un’importazione server, selezionare il repository contenente il set da importare. Il server puòessere configurato per utilizzare solo il repository xPression, nel qual caso sarà la sola sceltadall’elenco a discesa. Fare clic su OK.

Se il documento utilizza lo stesso schema del documento da cui sono state esportate le proprietà,queste verranno mappate automaticamente ai dati del documento. Se i documenti utilizzano file dischema diversi, è possibile mappare manualmente le proprietà in seguito all’importazione.

Opzioni relative all’importazione di proprietà

La finestra di messaggio relativa all’importazione delle proprietà contiene le opzioni seguenti.

Opzione Descrizione

Mantieni la proprietàesistente nel documento

Selezionare questa opzione per mantenere la proprietà esistente neldocumento e non sovrascriverla con la proprietà con lo stesso nomepresente nel file. Fare clic su Continua importazione. Se viene rilevatoun altro nome di proprietà duplicato, la finestra di messaggio verràvisualizzata di nuovo.

Mantieni tutte le proprietàesistenti nel documento

Selezionare questa opzione per mantenere tutte le proprietà presenti neldocumento e non sovrascriverle con quelle con lo stesso nome presentinel file. Fare clic su Continua importazione. In xPresso for Word nonverranno più visualizzate altre richieste se viene rilevato un nuovo nomedi proprietà duplicato, ma verrà utilizzata questa opzione per elaborarlo.

Utilizza la proprietà nel file Selezionare questa opzione per importare la proprietà duplicata dal file esovrascrivere la proprietà esistente nel documento. Fare clic su Continuaimportazione. Se viene rilevato un altro nome di proprietà duplicato, lafinestra di messaggio verrà visualizzata di nuovo.

112

Page 113:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

Opzione Descrizione

Utilizza tutte le proprietà nelfile

Selezionare questa opzione per importare tutte le proprietà duplicate dalfile e sovrascrivere qualsiasi proprietà esistente con i nomi duplicati. Fareclic su Continua importazione. In xPresso for Word non verranno piùvisualizzate altre richieste se viene rilevato un nuovo nome di proprietàduplicato, ma verrà utilizzata questa opzione per elaborarlo.

Continua importazione Fare clic su Continua importazione per utilizzare l’opzione selezionata econtinuare il processo di importazione.

Annulla importazione Fare clic su Annulla importazione per interrompere il processo diimportazione e non importare più altre proprietà. Tutte le proprietàimportate prima di fare clic sul pulsante verranno mantenute neldocumento.

Esportazione delle proprietà del documento

È possibile esportare le proprietà del documento attualmente definite nel documento in modo dautilizzarle in altri documenti di xPresso for Adobe InDesign, xPresso for Dreamweaver e xPressofor Word. Il processo di esportazione crea un file XML che può essere quindi importato in un altrodocumento.

Per esportare le proprietà del documento:

1. Visualizzare la pagina di backstage di xPresso (File > xPresso).

2. Fare clic sul menu a discesa Gestione OP e scegliere Esporta proprietà o Esporta proprietàdocumento al server.

3. Per un’esportazione locale, passare alla posizione in cui si desidera archiviare il file diesportazione e digitare un nome per il file.Per un’esportazione server, selezionare il repository server in cui si desidera esportare il set didefinizioni della variabile e quindi assegnare un nome al set. Il server può essere configurato perutilizzare solo il repository xPression, nel qual caso sarà la sola scelta dall’elenco a discesa.I nomi devono avere una lunghezza inferiore a 200 caratteri e non possono contenere alcuno deiseguenti caratteri: < > & \ “ ’ : @ ! ? * # \\ $ / [ ] { } ( )

4. Fare clic su Salva.

113

Page 114:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di variabili

114

Page 115:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 5Aggiunta di funzionalità ai modelli

xPresso for Word consente di aggiungere numerose funzionalità a un modello per migliorare l’aspettofinale e l’usabilità del documento risultante. Alcune di queste funzionalità sono supportate tramite lefunzionalità esistenti di Microsoft Word, mentre altre sono funzionalità di xPression.

In questo capitolo vengono trattati gli argomenti seguenti:• Utilizzo delle caselle di testo di Microsoft Word, pagina 115

• Tecniche di formattazione del testo, pagina 122

• Riferimenti incrociati, pagina 124

• Sommari, pagina 125

• Indicizzazione del documento, pagina 129

• Utilizzo delle funzionalità PDF, pagina 132

• Aggiunta del testo alternativo, pagina 140

• Utilizzo di indicatori per l’elaborazione del documento, pagina 140

• Aggiunta di una descrizione di modello, pagina 142

Utilizzo delle caselle di testo di Microsoft WordEsistono due metodi supportati per l’inserimento delle caselle di testo nel documento di xPresso forWord: inserimento dal menu Forme e inserimento dal menu Casella di testo. Per ogni metodo sonosupportati diversi tipi di opzioni di casella di testo.

Durante la creazione di caselle di testo, verificare che la dimensione della casella di testo siasufficientemente larga da contenere tutto il contenuto al suo interno. In alcuni casi il contenuto vienereso da xPression in modi differenti, pertanto una casella di testo che in xPresso for Word potrebbeapparire sufficientemente grande per il contenuto, potrebbe risultare non sufficientemente grande neldocumento pubblicato. Il contenuto che non è adattato alla casella di testo dopo il rendering, nonapparirà nell’output.

115

Page 116:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Nota:• È possibile che le caselle di testo ancorate non vengano visualizzate nella stessa esatta posizionequando il documento viene pubblicato sul server xPression.

• Se l’ancoraggio di una casella di testo viene posizionato all’inizio di un sommario, quando ildocumento viene pubblicato verrà visualizzato un paragrafo vuoto prima del sommario.

• xPresso for Word non supporta la funzionalità di trascinamento della selezione per spostare lecaselle di testo di Microsoft Word.

• Verificare che l’altezza della casella di testo non superi la cornice del corpo; in caso contrario, nonverrà generato l’output della pagina dove si trova la casella di testo.

Quando si utilizzano le caselle di testo di Word in un documento xPresso for Word, occorre tenerepresente alcuni punti riguardanti le caselle di testo.• Formattazione di una casella di testo, pagina 117

• Utilizzo delle cornici, pagina 120

• Caselle di testo/cornici e contenuto dinamico, pagina 121

Inserimento dal menu Forme

Per inserire una casella di testo dal menu Forme che viene visualizzato nella scheda Inserisci dellabarra multifunzione di Word, completare i seguenti passaggi:

1. Fare clic su Inserisci > Forme.

2. Selezionare la forma da inserire: Casella di testo, Rettangolo o Rettangolo smussato. Non sonoattualmente supportate altre forme.

3. Disegnare la casella di testo nella pagina.Se è stato selezionato Rettangolo o Rettangolo smussato, fare clic con il pulsante destro del mousesulla casella di testo e selezionareAggiungi testo. La forma verrà convertita in una casella di testo.

Inserimento dal menu Casella di testo

Per inserire una casella di testo è possibile utilizzare il menu Casella di testo visualizzato nella schedaInserisci della barra multifunzione di Word. Fare semplicemente clic sulla scheda Inserisci, quindisuCasella di testo dal menu Testo e scegliere Disegna casella di testo.

Per creare una casella di testo con gli angoli smussati, disegnare la casella, quindi fare clic su Cambiaforma dal menu Stile casella di testo, quindi scegliere Rettangolo smussato. La forma Rettangolosmussato non è supportata per l’output AFP, PCL, DOCX o HTML.

116

Page 117:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Formattazione di una casella di testo

Dopo aver posizionato una casella di testo in un documento, è possibile formattarla tramite le opzionidi formattazione di Word. Non è possibile modificare gli attributi della casella di testo dopo che èstato aggiunto contenuto variabile. Si consiglia di formattare la casella di testo prima di aggiungerecontenuto variabile (ad esempio gruppi di contenuti, loop di contenuto o variabili).

Se si riempie una casella di testo con il colore nero e successivamente il testo della casella di testoviene impostato su Automatico (nero), il testo apparirà di colore bianco nel documento. Invece,quando si visualizza in anteprima o si pubblica il documento, il testo apparirà di colore nero epertanto non risulterà visibile nella casella di testo nera.

Nota:• La rotazione delle caselle di testo inline non è supportata in xPresso for Word; è supportata invecela rotazione delle caselle di testo con posizione assoluta.

• I bordi "Tratto punto" non sono supportati completamente nelle caselle di testo. In MicrosoftWord i bordi “Tratto punto” nelle caselle di testo presentano un aspetto differente rispetto aglistessi bordi nei paragrafi o nelle tabelle. In xPression lo stile di bordo "Tratto punto" è utilizzatodai paragrafi e dalle tabelle in tutte le situazioni. Di conseguenza, lo stile di bordo "Tratto punto"della casella di testo apparirà differente in Microsoft Word rispetto all’output.

Riempimento forma

Quando si crea una casella di testo utilizzando una forma, Microsoft Word consente di riempirlacon un colore. Nella tabella seguente sono elencate in modo dettagliato le opzioni supportate delmenu Riempimento forma.

Opzione Supporto

Colori del tema Supportato

Colori standard Supportato

Nessun riempimento Supportato

Altri colori di riempimento Supportati, eccetto Trasparenza

Immagine Non supportato

Sfumatura Non supportato

Trama Non supportato

Motivo Non supportato

xPresso for Word supporta solo Nessun riempimento e Riempimento a tinta unita. L’opzioneSfumatura non è supportata.

117

Page 118:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Contorno forma

Quando si crea una casella di testo utilizzando una forma, Word consente di specificare il colore el’aspetto del contorno della forma. Nella tabella seguente sono elencate in modo dettagliato le opzionisupportate del menu Contorno forma.

Opzione Supporto

Colori del tema Supportato

Colori standard Supportato

Nessun contorno Supportato

Altri colori di contorno Supportato

Spessore Supportato

Tratteggio Supportato solo Continuo

Frecce Non supportato

Motivo Non supportato

Nota: Se si seleziona Punto oppure Tratteggiata punteggiata nell’opzione Tratteggio, i puntiassumeranno la forma di brevi lineette tratteggiate verticali nell’output.

Formattazione della forma

Quando si crea una casella di testo utilizzando una forma,Microsoft Word consente di formattarequest’ultima. Nella tabella seguente vengono elencate in modo dettagliato le opzioni supportate nellafinestra di dialogo Formato forma della scheda Casella di testo.

Opzione Supporto

Allineamento verticale Supportato

Orientamento testo Supportato

Nota: La funzionalità Orientamentotesto > Ruota caratteri asiatici di 270gradi non è supportata.

Non ruotare il testo Non supportato

Adatta dimensioni forma al testo Non supportato

Margine interno Supportato

Testo con a capo automatico nella forma Non supportato

Orientamento testo - Installazioni non in lingua inglese

Nelle installazioni di Word in lingue diverse dall’inglese, solo gli orientamenti Orizzontale, Ruotatutto il testo di 90° e Ruota tutto il testo di 270° sono supportati in xPresso for Word. Queste

118

Page 119:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

opzioni sono disponibili anche nella scheda Strumenti di disegno formattazione facendo clic suOrientamento testo > Opzioni di orientamento del testo.

Posizione

È possibile definire opzioni di posizione per la casella di testo. Nella tabella seguente vengono elencatein modo dettagliato le opzioni supportate della scheda Posizione della finestra di dialogo Layout.

Opzione Supporto

Orizzontale: Allineamento Non supportato

Orizzontale: Layout libro Non supportato

Orizzontale: Posizione assoluta Sono supportati solo A destra di Margine, Pagina,Colonna eMargine sinistro

Orizzontale: Posizione relativa Non supportato

Verticale: Allineamento Non supportato

Verticale: Posizione assoluta Sono supportati solo Sotto a Margine, Pagina, Paragrafo,Linea eMargine superiore

Verticale: Posizione relativa Non supportato

Opzioni: Sposta object con testo Non supportato

Opzioni: Blocca ancoraggio Non supportato

Opzioni: Consenti sovrapposizione Non supportato

Opzioni: Layout in cella di tabella Non supportato

Disposizione testo

Word consente di definire opzioni di disposizione del testo per la casella di testo. Nella tabellaseguente vengono elencate in modo dettagliato le opzioni supportate della scheda Disposizionetesto della finestra di dialogo Layout avanzato.

Opzione Supporto

Disposizione testo Supportati solo Incorniciato, Sopra e sotto, Dietro al testo,Davanti al testo e In linea con il testo

Testo a capo Supportato solo Su entrambi i lati

Distanza dal testo Supportato

GruppoLe opzioni Casella di testo > Gruppo sono supportate in xPresso for Word.

Opzione Supporto

Ruota a destra 90 Supportato

119

Page 120:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Opzione Supporto

Ruota a sinistra 90 Supportato

Allinea Supportato

Utilizzo delle cornici

Per inserire le cornici tramite l’area Strumenti precedenti della scheda Sviluppatore della barramultifunzione di Word, fare clic su Inserisci cornice sottoModuli precedenti.

Nota: Le cornici non sono supportate per l’output HTML.

A causa di una limitazione con il supporto cornici in xPresso for Word, si consiglia di non inserirepiù di una cornice in una singola pagina e di non creare cornici che attraversano più pagine. Siconsiglia inoltre di utilizzare un’interruzione di pagina anziché ritorni a capo multipli per forzarela visualizzazione di una seconda cornice in una pagina successiva. Se si utilizzano solo ritorni acapo tra due cornici, quando si pubblica il documento è possibile che entrambe le cornici appaianosulla stessa pagina.

Dopo aver inserito una cornice nel documento, è possibile formattarla. Nella tabella seguente sonoelencate in modo dettagliato le opzioni supportate della finestra di dialogo Cornice.

Opzione Supporto

Disposizione testo Supportato

Dimensioni: Larghezza/Altezza

È supportato solo Esatta

Dimensioni: A Supportato *

Orizzontale Supportato

Verticale Supportato

Sposta con il testo Non supportato

Blocca ancoraggio Non supportato

* Per l’impostazione “A” delle opzioni Larghezza e Altezza in Dimensioni, i valori devono esserecompresi in un intervallo valido per il documento. Se il valore è troppo grande, ovvero tale che lacornice sia maggiore dell’area, o troppo piccolo, ovvero tale che la cornice sia minore del contenuto,né la cornice né il contenuto verranno visualizzati nell’output del documento di xPression.

Word consente di applicare bordi alle cornici e di selezionare quali lati della cornice devono presentarebordi. Non è necessario che ogni lato della cornice presenti un bordo. xPresso for Word, tuttavia,supporta solo le cornici prive di bordi (ovvero senza bordo su ogni lato) e quelle che presentano unbordo su tutti i lati. L’applicazione di un bordo a solo una parte dei lati della cornice non è supportata.

Gruppo

Per raggruppare le forme e gli altri oggetti, nella scheda Formato fare clic su Gruppo > Gruppo.

120

Page 121:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Opzione Supporto

Gruppo Supportato

Allinea Supportato

Ruota Non supportato

Ruota Non supportato

Tabelle contenute nelle cornici

Se si crea una cornice in Word, vi si aggiunge testo e quindi si inserisce una tabella sotto il testo, lacornice sembra suddividersi in due cornici separate. Verrà visualizzata una cornice con il testo, spaziovuoto e quindi ciò che sembra essere una seconda cornice contenente la tabella. Se si seleziona lacornice, verrà selezionata come un’unica cornice. Quando si visualizza in anteprima o si pubblicail documento in xPression, la cornice non verrà visualizzata come suddivisa, bensì come di fattoè, ovvero un’unica cornice.

Caselle di testo/cornici e contenuto dinamico

Ogni contenuto dinamico all’interno di una casella di testo viene visualizzato in Esplora modelli sottola radice della Struttura o sotto un altro elemento di contenuto dinamico presente nella stessa caselladi testo. A causa di questa struttura, non è possibile nidificare contenuto dinamico presente in unacasella di testo all’interno di un contenuto dinamico che si trova all’esterno della casella di testo. Adesempio, si supponga di aver creato un loop di contenuto (Loop A) all’interno di una casella di testo,e quindi un altro loop di contenuto (Loop B) che, oltre alla casella di testo, include testo all’esterno diquest’ultima. In questo caso, il Loop A non verrà visualizzato nella Struttura come elemento figliodel Loop B. Invece, entrambi i loop di contenuto verranno visualizzati allo stesso livello. Quando siapplicano dati in questo scenario, il Loop B viene elaborato e pubblicato nel documento, mentre ilLoop A viene ignorato.

Se una casella di testo o un ancoraggio di cornice si trova all’interno di contenuto dinamico, talecasella di testo o cornice è considerata parte del contenuto dinamico e sarà trattata come tale durantela pubblicazione. Se si trascina l’elemento con ancoraggio all’esterno dell’ambito del contenutodinamico, tale elemento non verrà più considerato come appartenente al contenuto dinamico. xPressofor Word non rileva questo cambiamento quando si sposta l’ancoraggio. Pertanto, è necessarioconoscere la posizione dell’ancoraggio e assicurarsi che sia quella desiderata. Allo stesso modo, nelcaso di una casella di testo contenente variabili, se si trascina tale casella da un’istanza di contenutoa un’altra, è possibile che Esplora modelli non venga aggiornato in modo da riportare le variabilinella nuova istanza di contenuto. Se dopo aver creato una casella di testo si desidera spostarla, èconsigliabile eliminare la casella di testo e crearne una nuova nella nuova posizione.

Se nel documento non viene visualizzato alcun ancoraggio, è possibile utilizzare la finestra didialogo Opzioni di Word per configurare quest’ultimo affinché mostri gli ancoraggi. Nella paginaVisualizza, selezionare Ancoraggi object.

121

Page 122:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Tecniche di formattazione del testoIn questa sezione sono illustrate le tecniche di formattazione che è possibile utilizzare nei documentixPresso for Word.

• Numeri di pagina, pagina 122

• Date aggiornate dinamicamente, pagina 122

• Elenchi puntati, pagina 123

• Elenchi numerati complessi, pagina 123

• Controllo Righe isolate paragrafo avanzato, pagina 123

• Rimozione delle righe vuote nei blocchi di testo, pagina 92

Numeri di pagina

Quando si inseriscono i numeri di pagina nel documento di xPresso for Word, è possibile utilizzarel’opzione Formato pagina Numeri per definire il formato del numero. È possibile accedere all’opzioneFormato pagina Numeri facendo clic sul menu Numero di pagina nel gruppo Intestazione epiè di pagina della scheda di progettazione strumenti di intestazione e piè di pagina sulla barramultifunzione di Word. È inoltre possibile formattare i numeri di pagina facendo clic con il pulsantedestro del mouse sul numero e selezionando Modifica campo.

Per ulteriori informazioni sull’utilizzo dei numeri di pagina, vedere Opzioni di numerazione pagine,pagina 310.

Date aggiornate dinamicamente

xPresso for Word supporta la funzionalità di Microsoft Word che aggiorna dinamicamente le dateinserite nei documenti. Per inserire una data e un’ora nel documento è possibile utilizzare l’opzioneData e ora nel gruppo Testo della scheda Inserisci di Word. Nella finestra di dialogo Data e oradi Word, scegliere il formato e selezionare la casella di controllo Aggiorna automaticamenteaffinché xPression aggiorni automaticamente il documento con la data e l’ora correnti durante lapubblicazione.

Nota:• L’utilizzo dei caratteri a larghezza intera non è supportato. È possibile visualizzare l’opzione Usacaratteri a larghezza intera quando l’opzione Aggiorna automaticamente non è selezionata.

• Nella finestra di dialogo Data e ora, selezionando Cinese (Repubblica popolare cinese) nelcampo Lingua, l’opzione h时时时m分分分 non è supportata. Il codice di campo di questa opzione è {TIME\@ "AMPMh时m分" }.

• Quando l’impostazione locale non è l’inglese, il formato della data e dell’ora potrebbe esserevisualizzato diversamente da quello di Microsoft Word.

122

Page 123:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Elenchi puntati

Gli stili elenchi puntati potrebbero non apparire correttamente nell’output diverso da PDF. L’outputHTML non supporta alcuni caratteri punto elenco.

Elenchi numerati complessi

È possibile utilizzare il campo SEQ per creare elenchi numerati complessi nel documento di xPressofor Word se è richiesto dal progetto. Il campo SEQ è un segnaposto per un numero che può variarenel documento, ad esempio, un elenco numerato che può variare da un record all’altro.

Controllo Righe isolate paragrafo avanzato

xPresso for Word consente di definire impostazioni avanzate per le righe isolate dei paragrafi. Wordoffre funzionalità per controllare le righe isolate dei paragrafi. Tuttavia, tali funzionalità non possonoessere applicate a un numero specifico di righe. Quando in Word si seleziona la casella di controllorelativa alle righe isolate nella finestra di dialogo Paragrafo e nella scheda Distribuzione testo,Microsoft Word fa in modo che due righe vengano visualizzate nella parte inferiore o superioredi una pagina.

Grazie alla funzionalità di impostazione dei paragrafi di xPresso for Word è possibile specificare per iparagrafi il numero desiderato di righe isolate.

Per definire le impostazioni delle righe isolate per un paragrafo:

1. Selezionare il paragrafo nella pagina del documento e fare clic su Paragrafo nell’area Opzionidella scheda xPresso sulla Barra multifunzione di Microsoft Word.Verrà visualizzata la finestra di dialogo Paragrafo.

2. Specificare il numero di righe isolate desiderato. L’intero impostato in questo campo definisce ilnumero minimo di righe di uno stesso paragrafo riportate in una nuova pagina. Ad esempio, sesi imposta questo valore su tre, il paragrafo si interromperà a un limite di pagina e nella nuovapagina verranno visualizzate tre o più righe. Il paragrafo si interromperà al limite di pagina solose è possibile visualizzare tre o più righe nella nuova pagina.

3. Specificare il numero di righe orfane desiderato. L’intero impostato in questo campo definisceil numero minimo di righe che possono essere visualizzate nel paragrafo corrente prima che ilparagrafo possa essere interrotto a un limite di pagina. Ad esempio, se si imposta questo valoresu tre, il paragrafo si interromperà a un limite di pagina solo se tre o più righe precedono illimite di pagina.

4. Fare clic su OK.

Nota: Se la somma dell’impostazione righe isolate è maggiore delle righe del paragrafo, tutte le righeinizieranno con una nuova pagina.

123

Page 124:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Riferimenti incrociatiI documenti xPresso for Word possono includere riferimenti incrociati standard utilizzando l’appositafunzionalità di Word. Attualmente solo i numeri di pagina sono supportati come testo riferimentoincrociato; non è possibile includere testo all’interno di riferimenti incrociati. Per il supporto specificosull’opzione dei riferimenti incrociati, vedere Opzioni relative ai riferimenti incrociati, pagina 125.

I riferimenti incrociati sono supportati solo per i tipi di output di impaginazione seguenti: PDF,PostScript, AFP e PCL. Poiché sono attualmente supportati solo riferimenti incrociati numeri dipagina, l’output privo di impaginazione (HTML e testo) non può contenere riferimenti incrociati. Iriferimenti incrociati collegamento ipertestuale sono supportati solo per l’output PDF.

In genere, i riferimenti incrociati sono supportati nei documenti principali e nei relativi elementi dicontenuto universale. Tuttavia, poiché InDesign utilizza un meccanismo differente per i riferimentiincrociati rispetto a Word, quelli che appaiono nel contenuto universale di xPresso for AdobeInDesign potrebbero non essere risolti correttamente.

xPresso for Word utilizza i segnalibri per creare i riferimenti incrociati. È necessario innanzituttocreare un segnalibro per ciascuna sezione nel documento a cui si desidera fare riferimento. Acausa della natura dinamica dei documenti di xPresso for Word, è possibile avere più parti dicontenuto (in diversi elementi di contenuto) con lo stesso segnalibro. Ciò è supportato al momentodella progettazione; tuttavia, durante la pubblicazione, potrebbe esserci un solo segnalibrocon un nome specifico nel documento composto. Questo consente un riferimento incrociatodinamico, in cui la destinazione può cambiare in base al contenuto selezionato per l’inclusione inun’iterazione documento specifica. Se xPression incontra un nome di segnalibro duplicato durantela pubblicazione, utilizza sempre il primo segnalibro incontrato, indipendentemente se appare inun documento principale o secondario. Se manca un segnalibro, i riferimenti incrociati apparirannovuoti nell’output e nel registro di pubblicazione verrà visualizzato un messaggio di errore.

Per creare un segnalibro:

1. Selezionare il testo a cui si desidera fare riferimento.

2. Fare clic sulla scheda Inserisci sulla barra multifunzione di Word.

3. Fare clic su Segnalibro. Verrà visualizzata la finestra di dialogo Segnalibro.

4. Digitare un nome descrittivo per il segnalibro. I segnalibri possono contenere un massimo di 40caratteri e non possono includere spazi, mentre sono supportati i trattini.

5. Fare clic su Aggiungi.

Per creare un riferimento incrociato:

1. Posizionare il cursore nel punto del documento in cui si desidera visualizzare il riferimentoincrociato.

2. Fare clic sulla scheda Inserisci sulla barra multifunzione di Word.

3. Fare clic su Riferimento incrociato. Verrà visualizzata la finestra di dialogo Riferimentoincrociato.

4. Selezionare Segnalibro come tipo di riferimento. Il segnalibro è l’unico tipo di riferimentosupportato.

124

Page 125:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

5. Selezionare Numero di pagina dall’elenco a discesa Inserisci riferimento a. Al momento sonosupportati solo i riferimenti di numeri di pagina.

6. Selezionare la casella di controllo Inserisci come collegamento ipertestuale se si desidera che ilriferimento incrociato appaia come collegamento ipertestuale nell’output PDF. Questa opzione èsupportata solo per l’output PDF e verrà ignorata per altri tipi di output.

7. Selezionare dall’elenco il segnalibro a cui si desidera che il riferimento incrociato facciariferimento.

8. Fare clic su Inserisci.

Opzioni relative ai riferimenti incrociati

Nella tabella che segue vengono descritte le opzioni supportate da xPresso for Word nella finestra didialogo Riferimento incrociato di Word.

Funzionalità Supporto

Tipo di riferimento Solo Segnalibro è supportato

Inserisci riferimento a Solo Numero di pagina è supportato

Inserisci come collegamentoipertestuale

Supportato solo output PDF

Separa numeri con Non supportato

Per il segnalibro Supportato

SommariI documenti di xPresso for Word possono includere un sommario utilizzando alcune delle funzionidi base del sommario di Word. Se si definisce il sommario in un gruppo di contenuto non idoneo aessere incluso nel documento, il sommario non sarà visualizzato nel prodotto finito. Assicurarsi che,indipendentemente da dove si trova il sommario, il contenuto sia idoneo e possa essere visualizzatoin qualsiasi output necessario.

Per abilitare l’accessibilità, xPression aggiunge automaticamente del testo alternativo ai sommaridurante la pubblicazione dei documenti PDF/UA. Se si sta progettando un documento per l’outputPDF/UA, le impostazioni degli artefatti nei sommari non sono effettivi nell’output PDF/UA.

Se il documento include contenuto universale, è possibile unire le voci di sommario del documentocon contenuto universale nel sommario del documento principale.

Nota: L’unione delle voci di sommario per il contenuto universale nel sommario del documentoprincipale non è supportata per l’output HTML.

I codici di campo associati a una voce di sommario sono in genere testo nascosto. Per attivare odisattivare la visualizzazione dei codici di campo, fare clic suMostra/Nascondi nel gruppo Paragrafodella scheda Home della barra multifunzione di Word.

125

Page 126:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Esistono due modi per inserire un sommario: utilizzando un formato di Word disponibile (senzaapportare modifiche o modificandolo mediante le impostazioni della finestra di dialogo Sommario)oppure generando un proprio sommario attraverso la definizione dei codici di campo nella finestra didialogo Campo. xPresso for Word non supporta la creazione di sommari tramite l’opzione Tabellamanuale disponibile nel menu incorporato Sommario.

Nota:• Se si applica uno stile di intestazione solo a parte di un paragrafo anziché all’intero paragrafo,tale testo di intestazione non verrà visualizzato come voce di sommario quando il documentoviene visualizzato in anteprima in formato PDF o pubblicato.

• L’utilizzo di più lingue in un singolo sommario non è supportato. Per evitare questa limitazione,assicurarsi che gli stili di Word “Sommario numero” siano definiti in modo da utilizzare uncarattere per la stessa lingua utilizzata nel resto del sommario. Ad esempio per visualizzare icaratteri cinesi, utilizzare un carattere asiatico.

Opzioni sommario

Per accedere alle opzioni relative al Sommario, fare clic sulla scheda Riferimenti, fare clic suSommario nel gruppo Sommario, quindi selezionare Inserisci sommario. La scheda Sommarioconsente di definire le opzioni per il sommario.

La scheda Sommario contiene le opzioni seguenti.

Funzionalità Supporto

Mostra numeri di pagina Supportato

Numeri di pagina allineati a destra Supportato

Carattere di riempimento Supportato

Usa collegamenti ipertestuali anzichénumeri di pagina

Supportato

Formati Sono supportati solo Da modello,Classico, Caratteristico, Formale eSemplice

Mostra livelli Supportato

Opzioni: Stili Supportato

Opzioni: Livelli struttura Supportato

Opzioni: Campi per voci di Sommario Supportato

Opzioni di modifica Supportato (vedere Modifica degli stili,pagina 127)

Nota: Gli stili personalizzati non sono supportati nei sommari che appariranno nell’output DOCX.Utilizzare solo stili di Word incorporati nei documenti che verranno generati in formato DOCX.

126

Page 127:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Modifica degli stili

Facendo clic su Modifica nella scheda Sommario, verrà visualizzata la finestra di dialogo Stile. Sesi sceglie Modifica nella finestra di dialogo Stile, verrà visualizzata la finestra di dialogo Modificastile. xPresso for Word supporta solo la modifica dei formati Carattere, Paragrafo e Tabulazioni nellafinestra di dialogo Modifica stile. La specifica della numerazione come parte del formato non èsupportata.

Inserimento di un SommarioNota:• L’opzione Tabella manuale nel menu incorporato Sommario non è supportata.

• Se l’ancoraggio di una casella di testo viene posizionato all’inizio di un sommario nello strumentodi progettazione xPresso for Word, quando il documento viene pubblicato verrà visualizzato unparagrafo vuoto prima del sommario.

Per inserire un sommario nel documento, completare la seguente procedura:

1. Posizionare il cursore nel documento nel punto in cui si desidera che venga visualizzato ilSommario.

2. Fare clic su Sommario nel gruppo Sommario della scheda Riferimenti della Barra multifunzionedi Word.

3. Selezionare uno dei formati incorporati oppure fare clic su Inserisci sommario. Se si selezionauno dei formati incorporati, si è pronti a inserire il Sommario. Se si seleziona l’opzione Inseriscisommario, verrà visualizzata la finestra di dialogo Sommario.

4. Modificare le impostazioni nella scheda Sommario. Per impostazione predefinita, Microsoft Wordconsente di creare un sommario a tre livelli basati sulle Intestazioni 1-3. È possibile accettarequesto tipo di sommario oppure specificare un set di stili differente. Per specificare stili differenti,fare clic su Opzioni e definire i nuovi stili.

5. Fare clic su OK tutte le volte necessarie per uscire dalle finestre di dialogo aperte per inserire ilsommario.

Generazione di un Sommario utilizzando dei campi

È possibile ignorare la funzionalità di generazione automatica dei sommari di Word e crearne unopersonale utilizzando i codici di campo per voci di sommario (TC) e sommario (TOC). Il codice dicampo TC definisce il testo e i numeri di pagina per le voci nel Sommario e negli elenchi di tabelle,figure e contenuto simile. Inserire un campo TC immediatamente prima del testo che si desideraincludere nel sommario. Il campo TOC raccoglie le voci del sommario utilizzando i livelli diintestazione, gli stili specificati o le voci specificate dai campi TC.

127

Page 128:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

xPresso for Word supporta la capacità di inserire un Sommario dal livello di campo e di configurarele opzioni di Sommario manualmente. Sono supportate le seguenti opzioni:• \f. Consente di generare un sommario dai campi TC. Se viene specificato EntryIdentifier, ilsommario viene generato solo dai campi TC che hanno lo stesso identificatore (in genere unalettera). Ad esempio, { TOC \f t } genera un sommario dai campi TC quali { TC “Testo voce” \f t }.

• \h. Consente di inserire voci di sommario come collegamenti ipertestuali.

• \l. Consente di generare un sommario dai campi TC che assegnano voci a uno dei livelli specificati.Ad esempio, { TOC \l 1-4 } crea un sommario dai campi TC che assegnano voci ai livelli 1-4. Icampi TC che assegnano voci a livelli inferiori vengono ignorati.

• \n. Consente di omettere i numeri di pagina dal sommario. I numeri di pagina vengono omessi datutti i livelli. Se si desidera includere i numeri di pagina, rimuovere questa opzione.

• \o. Consente di generare un sommario dai paragrafi formattati con stili di intestazione incorporati(in Word si tratta degli stili da Intestazione 1 a Intestazione 9). Se si desidera visualizzaresolo i primi tre livelli degli stili, il campo avrà l’aspetto seguente: {TOC \o “1-3”}. Se nonviene specificato alcun intervallo di intestazioni, verranno elencati tutti i livelli di intestazioneincorporati utilizzati nel documento. Il numero dell’intervallo deve essere racchiuso tra virgolette.

• \t. Consente di generare un sommario dai paragrafi formattati con stili diversi dagli stili diintestazione incorporati. Ad esempio, {TOC \t “chaptertitle,1,chapterhead,2”} genera unsommario dai paragrafi formattati con gli stili "titolocapitolo" e "intestazionecapitolo". Il numeroche segue ciascun nome di stile indica il livello della voce nel sommario che corrisponde a quellostile. Il testo che viene selezionato per creare voci di sommario a livelli suddivisi per paragrafi nonpuò essere formattato in colonne.

• \u. Consente di generare un sommario utilizzando il livello di struttura paragrafo applicato.

L’opzione \z non è supportata. xPresso for Word non supporta opzioni per i campi TC.

Inserimento di un Sommario con codici di campo TCe TOC

Per inserire un sommario a livello del campo, completare i seguenti passaggi:

1. Posizionare il cursore nel punto in cui si desidera inserire il codice TOC nel contenuto.

2. Fare clic sulla scheda Inserisci, quindi su Parti rapide nel gruppo Testo e selezionare Campo.

3. Selezionare Indici e sommario nell’elenco Categorie.

4. Selezionare TOC nell’elenco Nomi dei campi.

5. Fare clic suCodici di campo per specificare manualmente le opzioni che si desidera utilizzare nelsommario. In xPresso for Word, le opzioni che sono state selezionate per il sommario vengonovisualizzate nella casella Codici di campo. Diventa disponibile anche il pulsante Opzioni.

6. Fare clic su Opzioni per visualizzare la finestra di dialogo Opzioni campo.In questa finestra è possibile selezionare le opzioni che si desidera utilizzare e aggiungerlefacendo clic su Aggiungi al campo. Ogni opzione che viene aggiunta viene visualizzata nellacasella di modifica. In questa casella è possibile digitare i parametri che si desidera utilizzare per

128

Page 129:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

l’opzione aggiunta. Una volta aggiunti tutte le opzioni e i parametri, fare clic suOK e visualizzarei risultati nella casella di modifica Codici di campo.

7. Fare di nuovo clic su OK per visualizzare il Sommario nel documento. È possibile utilizzareil comandoMostra/Nascondi codici campo del menu di scelta rapida per passare tra lavisualizzazione dei codici di campo e il risultato.

Indicizzazione del documentoÈ possibile includere un indice nel documento xPresso for Word utilizzando la funzionalità diindicizzazione di Word. Per ulteriori informazioni sull’utilizzo della funzionalità di indicizzazione diWord, vedere la guida di Word.

xPresso for Word supporta 9 livelli di indice in un documento. In Word sono visibili solo 7 livellidi indice; tuttavia, quando si pubblica il documento, sarà possibile visualizzare tutti i 9 livelli sespecificato.

Le voci di indice (indicatori) visualizzate nel contenuto universale esterno possono essere inclusenell’indice del documento principale. Tuttavia, se anche il contenuto universale contiene un indice, levoci indice del documento principale non appaiono nell’indice del contenuto universale.

Nota:• Gli indici nei documenti di xPresso for Word sono supportati solo in inglese.

• L’inclusione di un indice nel documento non è supportata per l’output HTML.

Contenuto dinamico in un indice

È possibile creare voci di indice in gruppo di contenuti, contenuto di un loop di contenuti e contenutostatico. La creazione di voci di indice nelle variabili non è supportata; se si definisce una variabilecome voce di indice, nell’indice del file di output verrà visualizzato il nome della voce, anziché i datidella variabile. Non è possibile formattare un indice che contiene voci dinamiche per includerepiù colonne.

Applicazione di stili alle voci di indice

Se si applica uno stile o una formattazione a una voce di indice del documento, la voce verràvisualizzata con la formattazione utilizzata durante l’aggiornamento dell’indice; tuttavia, quandosi pubblica il documento, le voci dell’indice nell’output del documento utilizzeranno lo stile e ilformato definiti nella finestra di dialogo Indice.

129

Page 130:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Finestra di dialogo Segna voce di indice analitico

Nella finestra di dialogo Segna voce di indice analitico vengono supportate le opzioni seguenti perla creazione di voci di indice nel documento.

Funzionalità Supporto

Indice: Voce principale Supportato

Indice: Voce principale:Intestazione

Non supportato

Indice: Voce secondaria Supportato

Indice: Voce secondaria:Intestazione

Non supportato

Opzioni: Riferimento incrociato Supportato

Opzioni: Pagina corrente Supportato

Opzioni: Intervallo pagine Non supportato

Formato numero di pagina Supportato

Finestra di dialogo Indice

Nella finestra di dialogo Indice vengono supportate le opzioni seguenti per la creazione di un indicenel documento.

Funzionalità Supporto

Numeri di pagina allineati a destra Supportato

Carattere di riempimento Supportata solo la linea tratteggiata

Formati Supportati solo Da modello e Classico

Tipo Supportato

Colonne Supportato, eccetto Auto

Lingua Supportata solo la lingua inglese (StatiUniti)

Nuove opzioni degli stili

Per accedere a questo set di opzioni, passare a Home > Stili.

Le opzioni seguenti sono supportate nella finestra di dialogo Nuovi stili.

Funzionalità Supporto

Funzionalità Supportato

130

Page 131:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Funzionalità Supporto

Set di stili Supportato

Colore Supportato

Carattere Supportato

Spaziatura paragrafi Supportato

Colonne

Quando si specifica un valore per l’opzione Colonne nella finestra di dialogo Indice, tenere presentequanto segue:

• Se l’indice contiene voci provenienti da contenuto dinamico, l’unico valore supportato perl’opzione Colonne nella finestra di dialogo Indice è 1.

• Se l’indice contiene solo voci statiche e si utilizzano più colonne, è necessario assicurarsi che lalunghezza della tabulazione non sia superiore alla lunghezza della colonna. Se il contenutodell’indice supera le dimensioni di una colonna, in xPresso for Word verrà generato un errore.

• Se il valore nell’opzione Colonne è maggiore di 1 e il documento contiene solo una voce di indice,l’indice generato durante la pubblicazione del documento non verrà formattato correttamente.

Creazione di intestazioni di indice

In xPresso for Word è possibile creare un’intestazione per le pagine di indice affinché venganovisualizzati i primi e gli ultimi elementi della pagina. Per aggiungere un’intestazione all’indice, ènecessario utilizzare la funzione xPresso for Word. Se si crea un’intestazione di indice senza generareun indice, l’intestazione non sarà visualizzata nell’output del documento pubblicato.

Nota:• Quando si rigenera (aggiorna) l’indice dopo la creazione, è possibile che l’intestazione dell’indicevenga persa e che sia necessario crearla nuovamente. A causa di questa limitazione, si consiglia dicreare la relativa intestazione dopo avere sviluppato completamente l’indice.

• Le intestazioni di indice e il separatore indice contengono solo caratteri non accentati.

Per creare un’intestazione di indice in xPresso

1. Fare clic su Intestazione indice nell’area Inserisci della scheda Progettazione di xPresso forWord sulla barra multifunzione di Word. Verrà visualizzata la finestra di dialogo Impostazioniintestazione indice.

2. Selezionare la casella di controllo Usa intestazione indice.

3. Selezionare l’aspetto desiderato per l’intestazione dell’indice nella pagina: Fisso: giustificato adestra sulle pagine pari e dispari o Speculare: giustificato a destra su pagine dispari, a sinistrasu pagine pari.

4. Selezionare se si desidera visualizzare nell’intestazione solo lettere o lettere e voci di indice:Alfabetico (A - Z) o Contenuto (A: Animale - Z: Zoo).

131

Page 132:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

5. Digitare il separatore che si desidera utilizzare per separare le voci nell’intestazione. Ad esempio,da A a Z o A - Z. È supportato qualsiasi carattere non accentato o combinazioni di caratteri; icaratteri accentati non sono supportati.

6. Fare clic su OK. L’intestazione viene visualizzata nella pagina del documento.Per rimuovere le intestazioni di indice, fare clic su Intestazione indice nella scheda xPresso forWord, deselezionare la casella di controllo Usa intestazione indice e fare clic su OK. Non rimuoverele intestazioni di indice direttamente dal canvas, altrimenti continueranno a essere visualizzatenell’output.

Nota: se l’ancoraggio di un’intestazione di indice viene visualizzato in un campo Sommario o in uncampo Indice, l’intestazione di indice non verrà visualizzata nell’output quando si apre l’anteprimao si pubblica il documento.

Utilizzo delle funzionalità PDFNumerose sono le funzionalità PDF supportate che possono essere utilizzate nella creazione di outputPDF con unmodello di xPresso for Word. Nelle sezioni che seguono vengono descritte queste opzioni.• Creazione di segnalibri PDF, pagina 132

• Collegamenti ipertestuali in PDF, pagina 133

• Progettazione di documenti PDF compilabili, pagina 135

• Aggiunta di firme digitali, pagina 138

Creazione di segnalibri PDF

xPresso for Word traduce i livelli di struttura di Microsoft Word in segnalibri di Adobe Acrobat PDFche vengono visualizzati nel riquadro sinistro del PDF quando viene visualizzato in Adobe AcrobatReader. xPresso for Word supporta quattro livelli di segnalibri PDF.

Uno stile di paragrafo di Microsoft Word con un livello di struttura di 1 crea un segnalibro a livello diradice. Un livello di struttura 2 crea un segnalibro subordinato al livello di struttura 1 e un livellodi struttura 3 crea un segnalibro subordinato al livello di struttura 2. Microsoft Word fornisce novelivelli di struttura totali.

Impostazione di livelli di struttura su un paragrafo

Per impostare i livelli di struttura degli stili, completare i seguenti passaggi:

1. Posizionare il cursore nel paragrafo che utilizza lo stile sul quale si desidera definire un livello distruttura.

2. Fare clic sulla scheda Home nella Barra multifunzione di Word ed espandere il gruppo Stili.

3. Individuare lo stile nell’elenco, fare clic sulla freccia per il nome dello stile e scegliereModifica.

132

Page 133:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

4. Fare clic su Formato e selezionare Paragrafo.

5. Definire i livelli di struttura nell’elenco dei livelli Struttura.

Attenzione: Non è possibile utilizzare formattazione diretta per specificare i livelli dellastruttura sugli stili del paragrafo che non definiscono un livello di struttura o che sono impostatisull’aggiornamento automatico. Quando si salva il documento, il livello di struttura verrà perso.

Collegamenti ipertestuali in PDF

xPresso for Word supporta i collegamenti ipertestuali per consentire la pubblicazione tramite PDF.Tutti gli altri formati di output ignorano i collegamenti ipertestuali.

I segnalibri di Microsoft Word consentono di contrassegnare un punto specifico in un documentocome destinazione di un collegamento ipertestuale dagli altri punti nello stesso documento o da unaltro documento. Per inserire dei collegamenti ipertestuali, è necessario prima inserire i segnalibrinel documento che fungeranno da destinazioni dei collegamenti ipertestuali. xPresso for Wordsupporta i collegamenti ipertestuali e i segnalibri solo all’interno dello stesso documento. Per creareun collegamento a siti web dall’interno di un PDF, xPresso for Word supporta anche i collegamentiipertestuali URL dinamici.

Inserimento di segnalibri come destinazioni di collegamentiipertestuali

Per posizionare un segnalibro come destinazione del collegamento ipertestuale, completare i passaggiseguenti:

1. Selezionare il testo da utilizzare come destinazione del collegamento ipertestuale.

2. Fare clic sulla scheda Inserisci nella Barra multifunzione di Word, quindi fare clic su Segnalibro.Verrà visualizzata la finestra di dialogo Segnalibro.

3. Nella casella Nome segnalibro digitare un nome univoco per il segnalibro. Questo nome deveessere univoco nel documento.

4. Fare clic su Aggiungi.

Inserimento di collegamenti ipertestuali PDF nel documento

Per creare un collegamento a un segnalibro, completare i seguenti passaggi:

1. Selezionare il testo da utilizzare come collegamento ipertestuale.

2. Fare clic sulla scheda Inserisci nella Barra multifunzione di Word e fare clic su Collegamentoipertestuale. Verrà visualizzata la finestra di dialogo Collegamento ipertestuale.

133

Page 134:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

3. Fare clic su Segnalibro. Verrà visualizzata la finestra popup Seleziona posizione nel documento.Selezionare il segnalibro che si desidera utilizzare come destinazione e fare clic su OK.

4. Fare di nuovo clic su OK. Il collegamento ipertestuale verrà visualizzato nel contenuto. Pertestare il collegamento, fare clic sul collegamento ipertestuale tenendo premuto il tasto CTRL.

Aggiunta di collegamenti ipertestuali URL dinamici

Per creare un collegamento a un sito web, completare i seguenti passaggi:

1. Creare una variabile JavaScript per il documento. Per ulteriori informazioni, vedere Creazione divariabili personalizzate, pagina 94.

2. Per la variabile JavaScript, immettere l’URL con la variabileresolver.getValueByName("Variable")

Il formato è:"<a href=’" + resolver.getValueByName("Variable")+"’>" + "Sample URL" + "</a>"

Ad esempio:"<a href=’" + resolver.getValueByName("AllTypeField:developer")+"’>"+ "www.emc.com" + "</a>"

3. Inserire la variabile nel documento e quindi applicare il formato HTML alla variabile.

4. Visualizzare in anteprima il documento come PDF. Il collegamento ipertestuale URL dinamicoviene visualizzato nel contenuto ed è possibile testare il collegamento.

Aggiunta di testo alternativo ai collegamenti ipertestuali

xPresso consente di progettare un documento del tipo di output PDF/UA. Per essere conformi aglistandard PDF/UA, i collegamenti ipertestuali in un documento di xPresso devono contenere deltesto alternativo; in caso contrario, si potrebbero verificare degli errori durante la visualizzazionedell’anteprima o la pubblicazione. Per una panoramica sul tipo di output PDF/UA, consultare laguida all’elaborazione dell’output PDF/UA.

Aggiunta di testo alternativo a un collegamento ipertestuale

1. In un documento xPresso for Word, selezionare il collegamento ipertestuale a cui aggiungeredel testo alternativo.

2. Dalla scheda Progettazione di xPresso for Word della barra multifunzione di Word, fare clicsul pulsante Testo alternativo nella sezione Opzioni. Viene visualizzata la finestra di dialogoImpostazione testo alternativo. È possibile inoltre fare clic con il pulsante destro del mouse sulcollegamento ipertestuale e selezionare xWord Designer > Imposta testo alternativo per aprirequesta finestra di dialogo.

3. Nell’elenco Impostazioni locali, selezionare la lingua del testo alternativo.

4. Digitare il testo alternativo nella casella Descrizione. Il testo alternativo non deve superare 200caratteri. Se è stata già impostata la descrizione di comando per il collegamento ipertestualequando si inserisce il collegamento ipertestuale con Microsoft Word, è possibile visualizzare il

134

Page 135:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

testo della descrizione di comando nella casella Descrizione. Questo perché, per impostazionepredefinita, xPresso utilizza il testo della descrizione di comando come testo alternativo deicollegamenti ipertestuali.

Nota: quando si utilizza un documento .docx di Word come contenuto universale, assicurarsi chei collegamenti ipertestuali nel documento .docx contengano il testo della descrizione di comando.In caso contrario, potrebbero verificarsi degli errori durante la pubblicazione dell’output PDF/UA.

5. Fare clic su OK.Per visualizzare il testo alternativo impostato, aprire di nuovo la finestra di dialogo Impostazionetesto alternativo.

Progettazione di documenti PDF compilabili

L’engine di pubblicazione di xPublish consente di creare output PDF che contiene campi compilabili.È possibile aggiungere al documento di Word controlli di contenuto che saranno utilizzati comecampi compilabili nella creazione di output PDF. Aggiungere i controlli modulo al documentotramite la scheda Progettazione di xPresso for Word sulla barra multifunzione di Word.

Nell’output di un documento PDF di xPresso for Word sono supportate le caselle di testo, le caselle dicontrollo e gli elenchi a discesa. È possibile aggiungere a un campo un testo predefinito che vienevisualizzato nel campo modulo del file PDF risultante. È possibile utilizzare il testo statico o unavariabile come testo predefinito e formattare la variabile nel testo predefinito.

È possibile specificare un nome per un controllo modulo. Il nome viene memorizzato come unaproprietà del controllo modulo nel file PDF di output. Quando si estraggono i dati dal file PDF, èpossibile ottenere informazioni utili dai nomi. Nei nomi dei controlli modulo è possibile utilizzaretesto statico, variabili o la combinazione di entrambi. Se due controlli modulo condividono lo stessonome, i due campi condividono lo stesso valore. Quando si modifica il valore di un controllo modulo,il valore dell’altro controllo modulo viene aggiornato automaticamente.

Nota:• Non nominare allo stesso modo due tipi diversi di controlli modulo, ad esempio un elenco adiscesa e una casella di controllo, altrimenti si verificheranno degli errori.

• Per assegnare lo stesso nome a due controlli modulo, questi devono avere, oltre allo stesso tipo dicampo, anche le stesse proprietà, come ad esempio il numero massimo di caratteri nella caselladi testo. In caso contrario, potrebbero verificarsi degli errori.

• Accertarsi che i nomi dei controlli modulo nel documento principale siano diversi da quelli neidocumenti PDF esterni. In caso contrario, l’output PDF compilabile potrebbe non essere corretto.

L’aggiunta di campi modulo attraverso le opzioni legacy nel gruppo Controlli non è supportata.Tuttavia, i campi modulo che si aggiungono utilizzando le opzioni Legacy nel gruppo Controllisaranno convertiti in campi compilabili quando l’engine di pubblicazione di xPublish genereràl’output PDF con l’opzione Compilabile selezionata. Per ulteriori informazioni sull’opzioneCompilabile, vedere la Guida per l’utente di xAdmin.

135

Page 136:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Quando si progettano documenti PDF compilabili è necessario tenere in considerazione i seguentifattori:• I controlli modulo generati in un documento PDF compilabile sono campi AcroForms.

• Le versioni di Adobe Reader precedenti alla 11 non supportano il salvataggio dei file PDFcompilabili con valori di campo modificati, tuttavia, è possibile stampare un documento coni valori modificati. Adobe Acrobat Professional e Adobe Reader versione 11 e successivesupportano il salvataggio di file PDF con valori di campo modificati.

• Quando si pubblica un documento in un formato di output diverso dal PDF, il contenutoproveniente dai controlli delle caselle di testo e combinate viene inserito nel documento cometesto senza il controllo e le caselle di controllo vengono visualizzate come immagini nell’outputdel documento.

• I controlli modulo di xPresso for Word verranno visualizzati come campi modulo legacy diMicrosoft Word negli output DOCX.

Aggiunta di un controllo modulo al documento

Per aggiungere un controllo modulo al documento, completare i passaggi seguenti:

1. Posizionare il cursore nel documento nel punto in cui si desidera inserire il campo.

2. Dalla scheda Progettazione di xPresso for Word della barra multifunzione di Word, fare clicsull’elenco a discesa Controlli modulo e selezionare uno dei seguenti tipi di controllo modulo:• Casella di controllo

• Elenco a discesa

• RTF

3. Specificare un nome per il campo. È possibile includere delle variabili facendo clic sul pulsanteSfoglia del campo Nome. Viene visualizzata la finestra di dialogoModifica valore elementoelenco.

4. Nella finestra di dialogoModifica valore elemento elenco, fare clic suMostra avanzate se lacasella Avanzate è nascosta. È possibile selezionare le variabili che si desidera utilizzare emodificarne il nome nella sezione Avanzate. Quando il valore contiene delle variabili, è possibilemodificarlo solo nella sezione Avanzate di questa finestra di dialogo.

5. Se si sta inserendo un controllo modulo RTF o Elenco a discesa, specificare le impostazionipredefinite. Per un controllo RTF, è possibile definire un valore predefinito. Per includerevariabili in un valore predefinito, fare clic sul pulsante Sfoglia per aprire la finestra di dialogoModifica valore elemento elenco e selezionare le variabili.Per modificare la formattazione di una variabile, selezionare la variabile nella casella Avanzatedella finestra di dialogoModifica valore elemento elenco. Il pulsante Formatta variabile èabilitato se per la variabile selezionata è disponibile la formattazione. Fare clic sul pulsanteFormatta variabile per modificare la formattazione della variabile.

6. Nel campo Descrizione comando, è possibile specificare il testo per il passaggio del mouse per ilcontrollo modulo. Il testo della descrizione del comando non deve superare i 5.000 caratteri.

136

Page 137:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Nota: per generare un output PDF/UA compilabile, è necessario specificare la descrizione delcomando per il controllo modulo. In caso contrario, potrebbero verificarsi degli errori durante lapubblicazione dell’output PDF/UA. Il testo della descrizione del comando nell’output PDF/UAsarà letto dai lettori conformi.

7. Inserendo un controllo modulo Elenco a discesa, è possibile aggiungere elementi dell’elencoe modificare i valori. Per includere le variabili in un elemento elenco, fare clic su Inseriscielemento elenco variabile per aprire la finestra di dialogoModifica valore elemento elenco eselezionare le variabili.Per modificare la formattazione di una variabile, selezionare la variabile nella casella Avanzatedella finestra di dialogoModifica valore elemento elenco. Il pulsante Formatta variabile èabilitato se per la variabile selezionata è disponibile la formattazione. Fare clic sul pulsanteFormatta variabile per modificare la formattazione della variabile.

Nota: è possibile definire gli elementi dell’elenco a discesa solo nella finestra di dialogoImpostazioni elenco a discesa. La modifica degli elementi nell’elenco a discesa del canvas non èsupportata.

8. Se si sta inserendo un controllo modulo RTF, specificare le impostazioni di progettazione e dipubblicazione. Completare i passaggi seguenti:a. Nella sezione Impostazioni progettazione, specificare il modo in cui viene visualizzato

il controllo modulo nel documento di progettazione. Questa impostazione non influiscesull’output.

b. Nella sezione Impostazioni pubblicazione, specificare le impostazioni della casella RTFnell’output. È possibile definire il limite di caratteri e la larghezza dello schermo per lacasella di testo, nonché selezionare un’unità di misura. Nell’elencoAllineamento, selezionareuna delle seguenti opzioni:• Predefinito: utilizza lo stesso allineamento del paragrafo racchiuso.

• A sinistra: allinea il testo a sinistra.

• Al centro: allinea il testo al centro.

• A destra: allinea il testo a destra.

Nota: Tutte le impostazioni della sezione Impostazioni pubblicazione diventano effettivesolo negli output PDF compilabili.

Nota:• Se si seleziona un intervallo di contenuto sul canvas e si inserisce una casella di testo RTF, lacasella di testo viene posizionata prima del contenuto selezionato.

• Per modificare il contenuto di un controllo modulo, fare clic su menu a discesa del controllomodulo in Esplora modelli, quindi suModifica. Non è consigliabile selezionare un controllomodulo nel canvas e modificarne il contenuto. Le modifiche effettuate in questo senso nonsi riflettono nell’output pubblicato.

• Per modificare lo stile del carattere di una controllo modulo, selezionare tutti i contenuti delcontrollo modulo nel canvas ed effettuare le modifiche.

• I caratteri speciali come 0x0a, 0x0d e le schede non sono supportate nel testo del controllo modulo.

137

Page 138:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Aggiunta di firme digitali

xPresso for Word consente di creare documenti per l’output PDF contenenti segnaposto di firmadigitale e firme digitali.

È possibile creare segnaposto di firma nei documenti per fornire campi di firma vuoti nei PDF,consentendo ai destinatari di firmare elettronicamente il documento. In alternativa, è possibile crearefirme che vengono aggiunte automaticamente ai PDF per rappresentare una persona o un’entità.

Durante la pubblicazione di un file PDF con una firma digitale, è possibile aggiungere un certificatodi firma per confermare che il documento è stato firmato da una persona o un’entità considerataattendibile dal destinatario. Inoltre, è possibile aumentare la sicurezza e migliorare l’attendibilità deldestinatario bloccando il documento dopo la firma per verificare che non sia stato modificato.

Per creare documenti con firma digitale, è necessario definire le firme digitali e i repository di firmedigitali in xAdmin. Inoltre, le firme digitali devono essere abilitate nelle definizioni di output PDF.Per ulteriori informazioni, vedere la Guida per l’utente di xAdmin.

Creazione di segnaposto di firma

È possibile creare uno o più segnaposto di firma in un documento. I segnaposto vengono visualizzaticome campi di firma vuoti nel PDF al termine della pubblicazione, e i destinatari possono fare clic neicampi per firmare elettronicamente il documento.

Per creare un segnaposto di firma, completare i passaggi seguenti:

1. Nella barra degli strumenti di xPresso, fare clic su Firma e selezionare Segnaposto firma. Vienevisualizzata la finestra di dialogo Proprietà segnaposto firma.

2. Digitare un nome per il campo del segnaposto di firma.

Nota: I nomi di tutti i segnaposto e di tutte le firme digitali in un documento devono essereunivoci. La pubblicazione e/o l’anteprima non riescono se i nomi sono identici.

3. Digitare una suggerimento per fornire informazioni per il destinatario o cercare una o piùvariabili per definire il suggerimento.

4. Fare clic su OK. Viene aggiunto un campo del segnaposto di firma in corrispondenza dellaselezione corrente. È possibile visualizzare l’anteprima del PDF e quindi modificare le dimensionidel campo, modificare le proprietà del segnaposto o eliminare il campo.

Creazione di firme

In un documento è possibile creare un campo di firma che viene automaticamente firmato con unafirma digitale predefinita al termine della pubblicazione. Nel PDF la firma digitale viene visualizzatacome immagine o non è visibile, in base alla selezione. Se il campo non viene firmato al termine dellapubblicazione, viene generato un messaggio di errore.

138

Page 139:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

In un flusso di lavoro del documento possono essere presenti più firme. È possibile certificare unafirma per confermare che il documento è stato creato e firmato da persone attendibili e per unamaggiore sicurezza il documento può essere bloccato da una firma per impedirne la modifica.

Nota:• Nel PDF di output può essere presente solo una firma che blocca il documento dopo la firma.

• Se una firma digitale certificata blocca il documento dopo la firma, non è possibile aggiungerealtre firme o segnaposto nel PDF.

Per creare una firma, completare i passaggi seguenti:

1. Nella barra degli strumenti di xPresso, fare clic su Firma e selezionareFirma. Viene visualizzatala finestra di dialogo Proprietà firma.

2. Dall’elenco a discesa selezionare un nome di firma digitale per il campo o digitare un nome.

Nota: Se xPresso non è connesso al server xPression o il nome non corrisponde a definizioni difirma digitale oppure corrisponde a più di una definizione, viene visualizzato un messaggio diavvertenza. Inoltre, i nomi di tutte le firme digitali e di tutti i segnaposto in un documentodevono essere univoci. La pubblicazione e/o l’anteprima non riescono se i nomi sono identici.

3. Digitare una suggerimento per fornire informazioni per il destinatario o cercare una o piùvariabili per definire il suggerimento.

4. Selezionare una delle opzioni di firma riportate di seguito:• Firma (visibile): il campo della firma viene firmato senza certificazione. Nel PDF il campovisualizza l’immagine della firma e il destinatario può visualizzare le informazioni facendoclic sul campo.

• Certificazione (visibile): il campo della firma viene firmato con la certificazione. Nel PDF unadichiarazione di certificazione viene visualizzata sopra il documento e nel campo della firmaviene visualizzata l’immagine della firma. Il destinatario può visualizzare le informazionifacendo clic sul campo.

• Certificazione (non visibile): il campo della firma viene firmato con la certificazione. NelPDF una dichiarazione di certificazione viene visualizzata sopra il documento, ma il campodella firma viene visualizzato come uno spazio vuoto. Il destinatario può visualizzare leinformazioni solo nel pannello della firma del visualizzatore PDF. Suggerimento: per ridurre alminimo lo spazio vuoto, rendere il campo della firma il più piccolo possibile.

5. Selezionare Blocca documento dopo la firma per impostare la firma per bloccare il file PDF.

Nota: Se a un documento sono stati aggiunti segnaposto di firma, non selezionare l’opzione diblocco per una firma, in caso contrario i destinatari non potranno firmare i segnaposto nel PDF.

6. Fare clic su OK. Viene aggiunto un campo della firma in corrispondenza della selezione corrente.È possibile visualizzare l’anteprima del PDF e quindi modificare le dimensioni del campo,modificare le proprietà della firma o eliminare il campo.

139

Page 140:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

Aggiunta del testo alternativoÈ possibile aggiungere del testo alternativo alle immagini, ai grafici dinamici e ai collegamentiipertestuali nel documento. Il testo alternativo può essere letto dai lettori PDF/UA conformi inun output PDF/UA.• Per aggiungere del testo alternativo alle immagini, consultare Aggiunta di testo alternativo alleimmagini, pagina 169.

• Per aggiungere del testo alternativo ai collegamenti ipertestuali, consultare Aggiunta di testoalternativo ai collegamenti ipertestuali, pagina 134.

• Per aggiungere del testo alternativo ai grafici dinamici, consultare Aggiunta di testo alternativo agrafici dinamici, pagina 223.

Utilizzo di indicatori per l’elaborazione deldocumentoEsistono svariate opzioni per l’elaborazione di output disponibili sulle stampanti con volumi elevati.Potrebbe essere necessario comunicare con la stampante tramite il documento per specificareimpostazioni quali la modifica di un colore o del formato della carta o forse una modifica da stampasemplice a stampa fronte retro. Il server di xPression utilizza indicatori per identificare opzioni dielaborazione dell’output. Gli indicatori sono definiti in xAdmin, probabilmente dall’amministratoredi sistema. Gli indicatori sono indipendenti dal device e sono utilizzati semplicemente percontrassegnare un punto nel documento in cui si desidera eseguire l’elaborazione dell’output. Leopzioni che possono essere definite per gli indicatori dipendono dalla stampante e dalle opzionidisponibili nel file PPD della stampante.

Anche se gli indicatori vengono definiti e memorizzati in xAdmin, xPresso for Word consente dicaricare un elenco di indicatori e di inserirli nel documento. In un documento di xPresso for Word gliindicatori vengono posizionati in corrispondenza delle interruzioni di sezione. Pertanto, è necessarioassicurarsi che in ogni punto del documento in cui si desidera posizionare un indicatore sia presenteun’interruzione di sezione.

Caricamento dell’elenco degli indicatori

Prima di inserire un indicatore nel documento, è necessario caricare l’elenco di indicatori in xPressofor Word. È possibile che un file Markers.xml sia stato scaricato dal server e memorizzato localmenteper l’utilizzo, oppure, se si è connessi al server, è possibile scaricare gli indicatori direttamente dalserver. In caso di dubbi su quale metodo utilizzare, rivolgersi all’amministratore di sistema.

Per caricare l’elenco di indicatori:

1. Visualizzare la pagina di backstage di xPresso (File > xPresso).

2. Fare clic su Gestione OP e selezionare una delle opzioni indicate di seguito:• Importa indicatori. Selezionare questa opzione se un file Markers.xml è stato scaricato dalserver in una directory locale accessibile dal client xPresso for Word. È possibile che il file

140

Page 141:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

non contenga tutti gli indicatori disponibili se nuovi indicatori sono stati creati da quando ilfile è stato scaricato.

• Importa indicatori da server. Selezionare questa opzione se si è connessi al server. Questaopzione scarica automaticamente tutti gli indicatori attualmente definiti sul server. Verràvisualizzata una finestra di dialogo nella quale saranno elencati tutti gli indicatori. Fare clic suOK. Se si seleziona questa opzione, la procedura è terminata ed è possibile continuare conInserimento di un indicatore nel documento, pagina 141.

3. Individuare e selezionare il fileMarkers.xml.

4. Fare clic su Apri. Verrà visualizzata una finestra di dialogo nella quale saranno elencati tuttigli indicatori. Fare clic su OK. Non è possibile continuare con Inserimento di un indicatorenel documento, pagina 141.

Inserimento di un indicatore nel documento

Una volta caricato l’elenco di indicatori in xPresso for Word, è possibile inserire indicatori nellapagina del documento. Potrebbe essere necessario contattare l’amministratore di sistema o l’autoredegli indicatori per assicurarsi di selezionare le versioni più recenti.

Nota: Se l’elenco di indicatori non è stato caricato recentemente, potrebbe essere opportuno caricarlodi nuovo. Potrebbe essere che siano stati aggiunti nuovi indicatori in xAdmin dall’ultima voltache l’elenco è stato caricato.

Per inserire un indicatore:

1. Posizionare il cursore in corrispondenza dell’interruzione di sezione che indica il punto deldocumento in cui si desidera inserire l’indicatore.

2. Fare clic su Indicatore nel gruppo Inserisci della scheda xPresso sulla barra multifunzione. Verràvisualizzata la finestra di dialogo Indicatori OP contenente l’elenco degli indicatori attualmentedisponibili.

3. Selezionare l’indicatore desiderato dall’elenco e fare clic su OK. Il nome dell’indicatore vienevisualizzato in Esplora modelli sotto la definizione di pagina in cui è stato inserito.

Una volta posizionato in un modello, un indicatore diventa un attributo della prima seziona da cuiè stato creato. L’indicatore non viene spostato su un’altra definizione di pagina anche se ne vieneinserita una nuova definizione di pagina prima di esso.

Nota: Durante l’inserimento di indicatori nel documento non è possibile eseguire più operazioniAnnulla e Ripeti in successione. È possibile annullare e ripetere solo la posizione dell’ultimoindicatore posizionato. Se vengono annullate contemporaneamente più posizioni dell’indicatore, saràpossibile ripeterne solo una.

Forzatura del recto di una nuova pagina

Se il progetto del documento è costituito da diverse sezioni e una sezione specifica deve sempreiniziare dal recto di una pagina, è possibile utilizzare un indicatore per forzare l’utilizzo del recto diuna nuova pagina in quel punto del documento. Quando si modifica la modalità di utilizzo delle

141

Page 142:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta di funzionalità ai modelli

facciate della pagina durante la pubblicazione, viene sempre forzato l’uso di un nuovo foglio. Se ildocumento è fronte retro, posizionare un indicatore impostato come fronte retro nella sezione chesi desidera iniziare dal recto. Quando si pubblica il documento, quando questo indicatore vieneelaborato viene forzato l’utilizzo di un nuovo foglio e viene quindi aggiunta una nuova pagina sulrecto del documento. Poiché il documento originariamente era fronte retro, non è stato modificatol’utilizzo delle facciate, ma solo forzata una pagina sul recto.

Aggiunta di una descrizione di modelloxPresso for Word consente di salvare una descrizione insieme al modello. La descrizione di unmodello di xPresso è uguale alla proprietà di documento “Commenti” di Word e può essere aggiuntatramite l’interfaccia di Word o la pagina di backstage di xPresso.

La descrizione viene visualizzata nell’area Elenco documenti di xAdmin, in xDashboard quando siseleziona un documento per la pubblicazione e viene restituita insieme al nome del modello inuna chiamata al servizio web. La descrizione consentirà all’utente che esegue la pubblicazione diidentificare il documento, assicurando che venga selezionato il documento corretto.

Per aggiungere la descrizione di un modello tramite l’interfaccia di Word, visualizzare la pagina dibackstage relativa alle informazioni su Word (File > xPresso). Individuare l’area Proprietà sul latodestro della pagina. Fare clic sull’area Aggiungi commenti accanto all’etichetta Commenti. Digitarela descrizione.

Per aggiungere la descrizione del modello tramite l’interfaccia di xPresso for Word, visualizzare lapagina di backstage di XPresso (File > xPresso). Fare clic suModifica descrizione modello e digitarela descrizione nella casella.

142

Page 143:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 6Aggiunta della variabilità ai modelli

La variabilità consente di progettare un unico modello che produrrà output differenti in base a deicriteri e dei dati. Esistono numerosi modi per aggiungere la variabilità al modello di xPresso for Word.

Se il documento è stato progettato in anticipo, è necessario sapere quali aree dovranno esseredinamiche e quali includeranno contenuto statico. Il contenuto dinamico può variare a ciascunaiterazione del documento, mentre il contenuto statico rimane uguale in tutte le iterazioni.

In questo capitolo vengono trattati gli argomenti seguenti:• Filtri, pagina 143

• Creazione di un gruppo di contenuti, pagina 146

• Creazione di istanze di contenuto, pagina 147

• Loop di contenuto, pagina 153

FiltrixPresso for Word consente di assegnare dei criteri al contenuto dinamico per determinare se ilcontenuto specifico deve essere incluso nell’output finale del documento. È possibile assegnaredei criteri a gruppi di contenuti, istanze di contenuto, loop di contenuto, elementi di contenutoriutilizzabili ed elementi di contenuto universali.

I criteri sono definiti nella maggior parte delle istanze come espressioni condizionali (if-else).Questa logica consente di creare un’espressione da utilizzare per determinare quando far apparireil contenuto. Nell’espressione è possibile utilizzare logica booleana e confrontare variabili rispettoa campi o valori. Per le istanze di contenuto è possibile definire una logica di semplice confronto(commutazione), che consente di confrontare il valore di un singolo campo dati per determinare sel’istanza di contenuto è adatta a essere inclusa.

Nota: (1) Prima di definire i criteri, sarà necessario caricare lo schema di dati. Per ulterioriinformazioni, vedere Caricamento dello schema, pagina 74.

(2) I valori nelle istruzioni per i criteri fanno distinzione tra maiuscole e minuscole e devonocorrispondere esattamente ai valori nei dati.

143

Page 144:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

Logica del gruppo di contenuti

La maggior parte del contenuto dinamico del modello di xPresso for Word sarà contenuto in gruppi eistanze di contenuto e, facoltativamente, in varianti. In xPression i criteri definiti vengono utilizzatia più livelli per determinare quale contenuto includere in un documento per un record di un datocliente.

A livello di gruppo di contenuti, è possibile definire dei criteri per determinare se il gruppo dicontenuti è “attivo”, quindi da includere nell’output del documento, o "inattivo" e quindi da nonincludere. Questo tipo di logica permette di saltare automaticamente parti di contenuto che non sonovalide per il record di un dato cliente. I criteri di attivazione/disattivazione sono definiti utilizzandola logica delle espressioni condizionali.

A livello di istanza di contenuto, è possibile definire quale istanza del contenuto deve essere inclusanel record di ciascun utente. I criteri di istanza di contenuto possono essere definiti utilizzando lalogica delle espressioni condizionali o la logica del semplice confronto.

A livello di variante, è possibile definire degli attributi di selezione rapida per determinare qualeversione dell’istanza di contenuto deve essere inclusa nel record di ciascun utente. Le selezionirapide sono attributi condivisi creati sul server che possono essere associati facoltativamente alcontenuto nel modello. Permettono di determinare se il contenuto deve essere incluso o meno senzala necessità di definire i criteri. Per ulteriori informazioni, vedere Utilizzo di selezioni rapide e divarianti, pagina 149.

Definizione della logica delle espressioni condizionali

La finestra di dialogo Imposta criteri consente di definire un’espressione condizionale per controllarequando il contenuto dinamico deve essere incluso nell’output del documento. Nell’espressionecondizionale è possibile selezionare variabili da confrontare rispetto a un valore o a un campo eutilizzare operatori booleani per combinare istruzioni per i criteri.

L’espressione condizionale viene generata da istruzioni di criterio singole che vengono combinateinsieme utilizzando operandi e meccanismi di raggruppamento.

Per aggiungere una nuova istruzione di criterio:

1. Fare clic su Nuovi criteri. Verrà visualizzata la finestra di dialogo Nuovi criteri.

2. Fare clic sul pulsante Sfoglia per selezionare un campo dati.

3. Selezionare l’operatore dall’elenco a discesa.

4. Selezionare di confrontare il campo dati rispetto a un valore o a un altro campo dati.

5. Digitare il valore o utilizzare il pulsante Sfoglia per selezionare il campo.I valori nelle istruzioni logiche fanno distinzione tra maiuscole e minuscole e devonocorrispondere esattamente al valore nei dati.

6. Fare clic su OK.Se si desidera confrontare due o più istruzioni, completare i passaggi precedenti per definire lealtre istruzioni.

144

Page 145:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

È possibile utilizzare i pulsanti AND e OR per aggiungere gli operandi e le frecce Su e Giù perridisporre le istruzioni.

I pulsanti Aggiungi parentesi (raggruppamento) e Rimuovi parentesi (annulla raggruppamento)possono essere utilizzati per raggruppare le istruzioni secondo le necessità. Per abilitare questipulsanti, è necessario selezionare più righe.

Nota: Se si confrontano valori di data, il valore deve essere nel formato data delle impostazioniinternazionali correnti utilizzato dal sistema operativo.

Definizione della logica del semplice confronto

La finestra di dialogo Logica di commutazione consente di definire la logica del semplice confrontoper le istanze di contenuto. La logica del semplice confronto deve essere utilizzata nel caso di uncampo singolo nei dati che contiene valori utilizzati per controllare l’inclusione di ciascuna istanza dicontenuto. Questa logica è un semplice test vero/falso: o il valore corrisponde e l’istanza di contenutoviene inclusa oppure il valore non corrisponde e l’istanza non viene inclusa. È possibile definire unadelle istanze di contenuto come istanza predefinita, che verrà visualizzata nell’output se tutte lealtre istanze non soddisfano i criteri.

Solo i campi stringa possono contenere valori null per la logica del semplice confronto. Di seguitoviene indicato come viene risolta la logica del semplice confronto di stringa in xPresso for Word:• Se il valore del campo è null:— Viene visualizzata la prima istanza con un valore di campo vuoto

— Se nessun valore di campo è vuoto, viene visualizzata l’istanza specificata come predefinita

— Se non è presente un’istanza predefinita, viene disattivato il gruppo di contenuti

• Se il valore del campo è diverso da null:— Viene visualizzata la prima istanza il cui valore di campo corrisponde al valore del campodei dati

— Se non corrisponde alcuna istanza, viene visualizzata l’istanza specificata come predefinita

— Se non è presente un’istanza predefinita, viene disattivato il gruppo di contenuti

Per i campi non stringa, il valore del campo dell’istanza di contenuto deve essere dello stesso tipodel valore del campo dati. Per i campi non stringa, la logica del semplice confronto viene risolta inxPresso for Word nel seguente modo:• Viene visualizzata la prima istanza il cui valore di campo corrisponde al valore del campo dei dati

• Se non corrisponde alcuna istanza, viene visualizzata l’istanza specificata come predefinita

• Se non è presente un’istanza predefinita, viene disattivato il gruppo di contenuti

Per definire la logica del semplice confronto:

1. Fare clic sul pulsante della variabile accanto alla casella di testo Scegli una variabile. Verràvisualizzata la finestra di dialogo Inserisci variabile. Selezionare il campo che si desiderautilizzare per determinare l’inclusione del contenuto e fare clic su Inserisci.

145

Page 146:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

2. Fare doppio clic sul campo Valore per una o più istanze di contenuto e digitare il valore cheindica l’inclusione per quella variabile. Ripetere la procedura per tutte le istanze per le quali sidesidera definire dei valori.I valori nelle istruzioni logiche fanno distinzione tra maiuscole e minuscole e devonocorrispondere esattamente al valore nei dati.

3. (Facoltativo) Selezionare la casella di controllo nella colonna Predefinito per definire l’istanzadi contenuto come istanza predefinita. È possibile definire una sola istanza come predefinita.L’istanza predefinita viene visualizzata nel documento se i dati non soddisfano i criteri pernessuna delle altre istanze.

4. Fare clic su OK.

Creazione di un gruppo di contenutiUn gruppo di contenuti è un contenitore per il contenuto dinamico. Ogni variazione del contenuto sitrova in un’istanza di contenuto all’interno del gruppo di contenuti. I gruppi di contenuti possonocomprendere una sola istanza di contenuto o molte istanze. I gruppi di contenuti con una sola istanzacontengono contenuto invariabile, ma che può essere incluso o escluso dinamicamente dall’outputdel documento.

Per creare un gruppo di contenuti, selezionare il contenuto nel canvas che si desidera includere nellaprima istanza del gruppo di contenuti oppure posizionare il cursore nel punto in cui si desiderache appaia il gruppo di contenuti. Fare clic su Gruppo di contenuti nella scheda xPresso sullaBarra multifunzione di Word.

In xPresso for Word quindi:• Verrà aggiunto un nuovo elemento Gruppo di contenuti a Esplora modelli e verrà aggiunto unelemento Istanza di contenuto di gruppo di contenuti sotto il nuovo gruppo di contenuti.

• Il contenuto selezionato nel canvas verrà contrassegnato con un controllo di contenuto di Word overrà posizionato un controllo di contenuto vuoto nel canvas.

Per spostare il cursore fuori della casella del controllo di contenuto, posizionarlo alla fine delcontenuto e premere il tasto freccia a destra.

Nota: Quando il contenuto è stato definito come gruppo di contenuti, non è possibile applicareformattazione al primo e all’ultimo paragrafo del contenuto. Per aggirare questo problema, applicarela formattazione al contenuto prima di definirlo come gruppo di contenuti.

Definizione di criteri per un gruppo di contenuti

I criteri definiti per un gruppo di contenuti determinano quando il gruppo viene incluso nell’outputdel documento. Criteri distinti vengono definiti a livello di istanza di contenuto per determinarequale istanza deve essere selezionata se il gruppo di contenuti è incluso. Per ulteriori informazioni,vedere Definizione dei criteri per le istanze di contenuto, pagina 148.

Per definire i criteri per un gruppo di contenuti, fare clic sul menu a discesa dell’elemento gruppo dicontenuti in Esplora modelli e selezionare Modifica criteri gruppo di contenuti. Verrà

146

Page 147:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

visualizzata la finestra di dialogo Imposta criteri. Per informazioni sulla creazione di espressioni dicriteri nella finestra di dialogo, vedere Definizione della logica del semplice confronto, pagina 145.

Nota: Se il gruppo di contenuti presenta solo un paragrafo separato, quando i criteri per l’inclusionenon vengono soddisfatti, in xPresso for Word 4.2 un paragrafo vuoto viene inserito nell’output.Tuttavia, in xPresso for Word 4.5 e versioni successive non viene inserito alcun contenuto. Se sidesidera lo stesso output della versione 4.2, aggiungere uno spazio subito dopo il controllo dicontenuto del gruppo di contenuti.

Gruppi di contenuti nidificati

Per un controllo anche maggiore sul contenuto dinamico, è possibile creare un gruppo di contenutiche sia all’interno di un altro gruppo di contenuti e sia dipendente dal gruppo “principale”. Adesempio, se si dispone di un’immagine che si desidera visualizzare con un determinato paragrafosolo in istanze specifiche, è possibile “nidificare” il gruppo di contenuti dell’immagine nel gruppo dicontenuti del paragrafo. Quando il gruppo di contenuti del paragrafo soddisfa i criteri di inclusioneed è incluso nell’output, xPresso for Word considera il gruppo di contenuti dell’immagine perl’inclusione. Se anche il gruppo di contenuti dell’immagine soddisfa i criteri di inclusione, l’immagineviene visualizzata nell’output del documento.

Per creare un gruppo di contenuti nidificato, selezionare un intervallo di testo all’interno diun’istanza del gruppo di contenuti padre, quindi fare clic su Gruppo di contenuti nella schedaProgettazione di xPresso for Word sulla barra multifunzione di Word. Verrà aggiunto il nuovogruppo di contenuti sotto il gruppo di contenuti padre.

Evitare di nidificare gruppi di contenuti all’interno di altro contenuto dinamico (ad esempio, loop dicontenuto o altri gruppi di contenuti) in elenchi numerati o puntati, poiché si potrebbero verificareproblemi quando si modifica lo stato attivo di un’istanza tramite Esplora modelli in questi elementinidificati. Ad esempio, il contenuto di un controllo di contenuto può essere spostato all’esterno delcontrollo e, pertanto, non fare più parte del contenuto dinamico. Oppure, lo stile del carattere (adesempio, colore, grassetto o corsivo) del contenuto dinamico potrebbe essere perso.

Creazione di istanze di contenutoxPresso for Word aggiunge automaticamente un’istanza di contenuto quando si crea un gruppo dicontenuti. È possibile creare più istanze di contenuto all’interno del gruppo di contenuti per contenereversioni alternative del testo. Ad esempio, è possibile disporre di diversi paragrafi di apertura peruna lettera, uno per ogni tipo di cliente a cui si desidera inviare la lettera. Se il contenuto all’internodi due istanze è simile, è anche possibile clonare un’istanza esistente per crearne una nuova.

Nota: Le impostazioni di tabulazione vengono mantenute dalla prima istanza creata in un gruppodi contenuti e non possono essere modificate. Tutte le istanze successive nello stesso gruppo dicontenuti utilizzeranno le stesse impostazioni di tabulazione. Per ovviare al problema, è necessariocreare il contenuto dell’istanza su linee di paragrafo differenti e creare più gruppi di contenutianziché più istanze in un unico gruppo di contenuti.

Per garantire prestazioni ottimali, si consiglia di mantenere il numero di istanze in un singolodocumento al di sotto dei 50. Se occorrono più istanze, considerare di posizionarle nel contenuto

147

Page 148:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

universale (con l’opzione Continua layout principale selezionata). Per ulteriori informazioni, vedereCapitolo 10, Utilizzo di contenuto universale.

Aggiunta di un’istanza di contenuto

È possibile aggiungere il numero desiderato di istanze di contenuto a qualsiasi gruppo di contenuti,ma solo un’istanza per un gruppo di contenuti deve essere visualizzata in un documento di output.

Per creare un’istanza di contenuto:

1. Assicurarsi che Esplora modelli sia visibile.

2. (Facoltativo) Selezionare il contenuto nel canvas che si desidera includere nell’istanza.

3. Fare clic sul menu a discesa per il gruppo di contenuti da aggiungere all’istanza, quindiselezionare Crea istanza di contenuto per creare un’istanza vuota oppure Crea istanza dicontenuto da selezione se nel canvas è selezionato del contenuto.In xPresso for Word viene aggiunta una nuova istanza di contenuto al gruppo di contenutiselezionato in Esplora modelli e viene posizionata un’istanza di contenuto nel canvas in unacasella del controllo di contenuto.

Suggerimento: Per spostare il cursore fuori della casella del controllo di contenuto, posizionarlo allafine del contenuto e premere il tasto freccia a destra.

Nota: Quando il contenuto è stato definito come istanza di contenuto, non è possibile applicareformattazione al primo e all’ultimo paragrafo del contenuto. Per aggirare questo problema, applicarela formattazione al contenuto prima di definirlo come istanza di contenuto.

Definizione dei criteri per le istanze di contenuto

In xPresso for Word è possibile scegliere tra diversi tipi di criteri quando si definiscono le istanze dicontenuto. È possibile utilizzare la logica delle espressioni condizionali (if-else) oppure la logica delsemplice confronto (commutazione). La logica delle espressioni condizionali deve essere utilizzataquando occorre utilizzare istruzioni di criteri complesse, mentre la logica del semplice confronto deveessere utilizzata quando è possibile utilizzare un singolo valore di campo di dati per determinarel’inclusione di un’istanza.

È possibile selezionare i tipi di criteri in Esplora modelli a livello di gruppo di contenuti o per ciascunaistanza di gruppo di contenuti. Per selezionare il tipo di criteri, fare clic sul menu a discesa per ilgruppo di contenuti o l’istanza di contenuto, quindi selezionare Logica di espressioni condizionalio Logica del semplice confronto. Le selezioni non si escludono a vicenda; la modifica del tipo dicriterio in una posizione ne determina la modifica per tutte le istanze di contenuto presenti nelgruppo di contenuti.

Per definire i criteri per l’istanza di contenuto dopo aver selezionato il tipo di criterio, in Esploramodelli fare clic sul menu a discesa del gruppo di contenuti o dell’istanza di contenuto, quindi fareclic suModifica criteri istanza di contenuto. Per informazioni sulla definizione della logica delleespressioni condizionali, vedere Definizione della logica delle espressioni condizionali, pagina 144;

148

Page 149:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

per informazioni sulla definizione della logica del semplice confronto, vedere Definizione della logicadel semplice confronto, pagina 145.

Duplicazione di un’istanza di contenuto

Quando è necessario creare un’istanza di contenuto esattamente identica o simile a un’istanzadi contenuto esistente, è possibile clonare l’elemento esistente in Esplora modelli. Il contenutodell’istanza, insieme ai relativi criteri, verrà copiato nella nuova istanza.

Per clonare un’istanza di contenuto, fare clic sul menu a discesa relativo all’istanza in Esplora modellie selezionare Clona istanza di contenuto. In xPresso for Word verrà aggiunta una nuova istanzadenominata Clone di nome al gruppo di contenuti.

Visualizzazione di un contenuto specifico nel modello

Le istanze di contenuto sono versioni differenti dello stesso contenuto. Può esistere una sola istanzadi contenuto alla volta in ciascun gruppo di contenuti nel documento; pertanto è possibile vedere soloil contenuto di un’istanza alla volta.

Per visualizzare il contenuto di una specifica istanza nel canvas, selezionare l’istanza in Esploramodelli. Il contenuto per l’istanza selezionata apparirà nel modello.

Quando un’istanza di contenuto è racchiusa in un singolo paragrafo (in linea con il paragrafo), lacommutazione delle visualizzazioni dell’istanza di contenuto può causare il cambiamento dellaformattazione dell’istanza. Si supponga, ad esempio, di avere due istanze di contenuto visualizzatein una cella di tabella, una formattata per apparire allineata al centro e una formattata per apparireallineata a sinistra. Se si passa dalla visualizzazione dell’istanza allineata al centro a quella allineata asinistra, la formattazione allineata al centro della prima istanza verrà applicata alla seconda istanzaed entrambe appaiono allineate al centro.

Quando si utilizza la funzione Controllo ortografia e grammatica di Word per controllare ildocumento di xPresso for Word, viene controllato solo il contenuto che in quel momento èvisualizzato nel canvas. Pertanto, se vi è contenuto che non è visualizzato, non sarà controllato. Sarànecessario selezionarlo per renderlo visibile nel documento, quindi eseguire nuovamente il controllo.

Utilizzo di selezioni rapide e di variantixPresso for Word consente di utilizzare una combinazione di attributi di selezione rapida e di variantidi istanza di contenuto per applicare un’ulteriore logica di inclusione al contenuto. Gli attributi diselezione rapida forniscono una logica di business automatica per cui non è necessario scrivere deicriteri per determinare l’inclusione del contenuto. Quando si utilizzano le selezioni rapide e levarianti, la logica del contenuto si presenterà nel seguente modo:

Gruppo di contenuti (criteri di attivazione/disattivazione)Istanza di contenuto (selezione in base a criteri)Variante (selezione in base a selezione rapida)Variante (selezione in base a selezione rapida)

149

Page 150:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

Istanza di contenuto (selezione in base a criteri)Variante (selezione in base a selezione rapida)Variante (selezione in base a selezione rapida)

In alcuni casi è possibile utilizzare le istanze di contenuto per produrre lo stesso effetto delle varianti.La soluzione migliore viene decisa in base ai singoli casi. Si supponga ad esempio che in undocumento l’output di un paragrafo debba essere in lingue differenti. È possibile creare un’istanzadi contenuto per ciascuna lingua oppure è possibile creare un’unica istanza di contenuto con unavariante per ciascuna lingua. Se si dispone di una selezione rapida per lingua, l’utilizzo delle variantiè probabilmente la soluzione migliore. Un altro vantaggio dell’utilizzo delle varianti consiste nel fattoche è possibile testare la logica della selezione rapida nell’output direttamente da xPresso for Word.

Le selezioni rapide vengono definite in xAdmin sul Server xPression. Per ulteriori informazioni,vedere la Guida per l’utente di xAdmin. È possibile scaricare elenchi di selezioni rapide dal server eselezionare quali selezioni rapide si desidera attivare nel modello corrente. Per ulteriori informazioni,vedere Impostazione di selezioni rapide in un modello, pagina 150.

Impostazione di selezioni rapide in un modello

Prima di poter creare varianti di contenuto, è necessario definire delle selezioni rapide per il modello.L’impostazione delle selezioni rapide avviene nella pagina di backstage di xPresso.

Visualizzare la pagina di backstage di xPresso (File > xPresso), quindi fare clic su Imposta selezionirapide. Tutte le selezioni rapide correntemente definite nel Server xPression sono visualizzatenell’elenco Inattivi. Fare clic su Scarica ultimi valori dal server per assicurarsi che l’elenco siaaggiornato.

Selezionare una selezione rapida dall’elenco Inattivi e fare clic su Aggiungi selezione rapida adocumento per spostarla nell’elenco Attivi. Tutte le selezioni rapide nell’elenco Attivi potrannoessere associate a varianti di istanza.

Per rimuovere una selezione rapida, selezionarla dall’elenco Attivi e fare clic su Rimuovi selezionerapida da documento. Non è possibile rimuovere una selezione rapida se al momento è in uso inun set di selezioni rapide. In alcuni casi, anche dopo l’eliminazione di tutte le varianti di contenutoche utilizzano la selezione rapida, non è possibile rimuovere la selezione rapida. In questo casosalvare e chiudere il modello e riaprirlo. Dopo la riapertura del modello la selezione rapida dovrebbeessere rimovibile.

Per mappare una selezione rapida a una variabile di modello, selezionarla dall’elenco Attivi e fare clicsuMappa a variabile. Selezionare la variabile e fare clic su Inserisci.

Se una selezione rapida utilizzata o un valore utilizzato di una selezione rapida viene cancellato dalserver, la selezione rapida o il suo valore non viene eliminato dal documento. È possibile continuare autilizzarlo nel documento. La selezione rapida o il valore viene visualizzato nella finestra di dialogoImpostazione selezioni rapide con un’icona di avviso che indica che è stato eliminato dal server e nonpuò essere rimosso dal documento, come mostrato nella seguente immagine.

150

Page 151:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

Creazione di varianti

Le varianti sono versioni di istanze di contenuto per le quali è possibile definire degli attributi diselezione rapida. Le varianti dovrebbero essere create solo quando si dispone di attributi da associarea loro.

Un esempio di utilizzo corretto di varianti è quando si dispone di un contenuto che deve esserefornito in lingue differenti. È possibile creare una variante per il contenuto in ogni lingua. Se sidecidesse invece di utilizzare istanze di contenuto, sarebbe necessario creare dei criteri per ciascunaistanza per controllare l’inclusione, mentre con le varianti si sceglie semplicemente la selezionerapida appropriata.

151

Page 152:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

Nota: Per creare le varianti, è necessario che nel modello siano definite delle selezioni rapide.

Per aggiungere una variante a un’istanza di contenuto, fare clic sul menu a discesa per l’istanza inEsplora modelli e selezionare Aggiungi variante.

La prima variante che viene aggiunta è la variante predefinita che verrà utilizzata da xPressionin assenza di altre varianti più adatte. Non è possibile definire selezioni rapide per la variantepredefinita.

Per definire le selezioni rapide per le varianti aggiuntive, fare clic sul menu a discesa per la variante eselezionareModifica set di selezioni rapide. Per ulteriori informazioni, vedere Gestione di set diselezioni rapide nel modello, pagina 152.

È possibile verificare il modo in cui le varianti e la logica di selezione rapida si risolvono nell’outputdirettamente da xPresso for Word. Per ulteriori informazioni, vedere Verifica del modello, pagina 230.

Gestione di set di selezioni rapide nel modello

Per ciascun modello è possibile creare set di selezioni rapide contenenti i valori di selezione rapidache saranno utilizzati in tutto il documento. I set di selezioni rapide sono definiti a livello di variantenella finestra di dialogo Impostazione selezione rapida. I set di selezioni rapide non utilizzati oobsoleti verranno eliminati automaticamente quando il documento viene chiuso.

Nell’elenco Set di selezioni rapide sono visualizzati tutti i set correntemente definiti per il modello.Da questo elenco è possibile:• Rimuovere il collegamento tra un set e altri riferimenti a quel set. Quando un collegamentoè interrotto, è possibile apportare modifiche a un set per la variante corrente ed evitare che talimodifiche influiscano su altre varianti che utilizzano il set.

• Clonare un set per crearne uno nuovo da modificare in un secondo momento.

• Visualizzare le selezioni rapide correntemente in uso da altre varianti. Quelle presenti nell’elencoNon disponibili sono correntemente utilizzate da varianti di pari livello (varianti sotto la stessaistanza di contenuto).

L’altra parte della finestra di dialogo contiene informazioni sul set di selezioni rapide correntementeselezionato:• Il nome della selezione rapida appare in cima all’elenco. Per impostazione predefinita, il nome èun elenco dei valori selezionati per la selezione rapida. Fare clic su Modifica per digitare unnuovo nome. Fare clic su Reimposta per tornare al nome predefinito.

• Sotto il nome viene visualizzato un riepilogo della selezione rapida. In questo riepilogo sonoelencati tutte le selezioni rapide contenute nel set e i valori correntemente selezionati per ciascuna.

• La tabella visualizza le selezioni rapide disponibili e consente di selezionare i valori che si desideraassociare al set. È possibile selezionare qualsiasi dei singoli valori o, se nel set sono presenti piùselezioni rapide, è possibile selezionare Tutti.

Se il set contiene solo una selezione rapida, la selezione di Tutti è uguale all’impostazionepredefinita della variante iniziale e, dal momento che non è possibile avere due varianti con lestesse impostazioni di selezione rapida, questa operazione non è consentita.

Se il set contiene più selezioni rapide, deve essere selezionato almeno un valore da ciascuna.

152

Page 153:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

In questa pagina è possibile selezionare elementi singoli selezionando la casella di controllo o piùelementi utilizzando la combinazione MAIUSC + clic o CTRL + clic. Quando si selezionano piùelementi, è necessario innanzitutto selezionare gli elementi, quindi selezionare o deselezionare lacasella di controllo per uno degli elementi selezionati. Assicurarsi inoltre di fare clic sul nome osulla casella di controllo per selezionare un elemento. Se si fa clic sull’area a destra dell’elemento,questo non viene selezionato.

Loop di contenutoSe nei dati sono presenti informazioni in cui si desidera eseguire il loop per creare contenuto neldocumento, è possibile aggiungere un loop di contenuto in xPresso for Word. I loop di contenutoconsentono di selezionare un intervallo di contenuto e di fare in modo che il contenuto vengaripetuto nel documento con il nuovo contenuto variabile mentre in xPresso for Word viene eseguitoil loop nei dati.

È necessario, ad esempio, creare un elenco variabile di elementi nel documento. Se si crea un loop dicontenuto che contiene una singola riga dell’elenco con i relativi dati delle variabili, in xPresso forWord verrà eseguito il loop nei dati e verranno create le righe necessarie per completare l’elenco.Se, invece, il file di dati contiene il testo per il documento e si desidera creare un elemento con unastruttura ripetitiva quale un catalogo, è possibile impostare il contenuto variabile nel modello comeloop di testo. In xPresso for Word verrà eseguito il loop nei dati per ottenere il contenuto appropriatoper riempire le pagine del catalogo.

È anche possibile definire criteri di filtro per controllare quando il loop viene elaborato neldocumento. Si tratta di un’opzione utile quando un loop è valido solo in istanze specifiche deldocumento dinamico.

Nota: Se il documento inizia con un loop di contenuto o un gruppo di contenuti, durantel’applicazione dei dati viene visualizzato un messaggio di avviso nella casella di testo RTF, in cuiviene indicato che non è possibile eseguire l’inserimento in più sezioni. Per continuare a lavorare conil documento, ignorare il messaggio e fare clic su OK o chiudere la finestra di dialogo.

Definizione di un loop di contenuto

I loop di contenuto richiedono una variabile di array ripetibile. Assicurarsi di disporre di un arraycontenente tutti i dati di variabile necessari a generare il contenuto.

Per definire un loop di contenuto:

1. Posizionare le variabili e il contenuto statico nel canvas che si desidera includere nel loop.Se si desidera aggiungere il contenuto dopo aver creato il loop, posizionare il cursore nel puntoin cui si desidera che appaia il loop e andare al passaggio 3.

2. Selezionare tutto il contenuto nel canvas per il loop. A causa della modalità di lavoro deicontrolli di contenuto di Word (utilizzati per indicare i loop), l’indicatore del paragrafo finale èsempre incluso nel contenuto del loop. Di conseguenza, un carattere di a capo automatico verràaggiunto alla fine di ciascun elemento del loop, in modo che ogni elemento venga visualizzatosu una propria riga.

153

Page 154:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

3. Creare un loop di contenuto eseguendo una delle operazioni seguenti:• Fare clic su Loop di contenuto nella scheda xPresso sulla barra multifunzione di Word.

• Fare clic sull’elenco a discesa per l’array di loop in Esplora variabili, quindi fare clic su Loop dicontenuto in Inserisci selezione come.

Verrà visualizzata la finestra di dialogo Definisci loop.

4. Fare clic su Scegli variabile per selezionare l’array che si desidera utilizzare per il loop. Seil loop di contenuto è stato creato in Esplora variabili, l’array selezionato qui viene selezionatoautomaticamente.

5. (Facoltativo) Fare clic su Definisci xPath per definire un xPath differente per l’array. Per ulterioriinformazioni, vedere Filtro di un array, pagina 108.

6. Fare clic su OK. In xPresso for Word viene automaticamente inserito un controllo di contenutointorno all’intervallo di contenuto o in corrispondenza del cursore nel modello se non è statoselezionato alcun contenuto. In xPresso for Word il loop di contenuto verrà inoltre aggiuntonella posizione appropriata in Esplora modelli: se il loop è incluso all’interno di un’istanza dicontenuto o di un altro contenitore dinamico, verrà visualizzato in tale contenitore; altrimenti,verrà visualizzato sotto la radice.

Creazione di loop di contenuto nidificati

È possibile nidificare diversi loop di contenuto l’uno nell’altro. Il supporto per i loop nidificati includei loop “all’indietro”, i loop nidificati all’interno di se stessi e i loop con più gerarchie. Un esempiodi loop “all’indietro” è rappresentato da uno scenario in cui se i dati dispongono di un “Elementopadre 1” accompagnato da un elemento figlio “Figlio 1”, è possibile nidificare un loop associato a"Elemento padre 1" in un loop associato a “Figlio 1”.

Evitare di nidificare loop di contenuto all’interno di altro contenuto dinamico (ad esempio gruppi dicontenuti) in elenchi numerati o puntati, poiché si potrebbero verificare problemi quando si modificalo stato attivo di un’istanza tramite Esplora modelli in questi elementi nidificati. Ad esempio, ilcontenuto di un controllo di contenuto può essere spostato all’esterno del controllo e, pertanto, nonfare più parte del contenuto dinamico. Oppure, lo stile del carattere (ad esempio, colore, grassetto ocorsivo) del contenuto dinamico potrebbe essere perso.

Criteri di filtro loop

Per qualsiasi loop di contenuto, è possibile definire criteri di filtro che controllino quando il loop vieneelaborato per l’output del documento. In questo modo è possibile evitare l’elaborazione di un loopper record di dati specifici se non è necessario.

154

Page 155:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

Per definire i criteri di filtro, fare clic sull’elenco a discesa per il loop di contenuto in Esplora modelli eselezionareModifica filtro loop. Verrà visualizzata la finestra di dialogo Imposta criteri. Per ulterioriinformazioni, vedere Definizione della logica delle espressioni condizionali, pagina 144.

155

Page 156:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Aggiunta della variabilità ai modelli

156

Page 157:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 7Utilizzo di immagini

Il supporto delle immagini di xPresso for Word include molti formati e tipi di immagini. Esistonodiversi modi di inserire immagini nel documento, a seconda del tipo di immagine che si desiderautilizzare. Se l’immagine è statica, è possibile inserirla direttamente nel documento di Word. Sel’immagine è dinamica, è possibile utilizzare una variabile immagine o una immagine universaleper inserirla nel documento.

In questo capitolo viene illustrato dettagliatamente l’utilizzo delle immagini nei modelli di xPressofor Word e vengono trattati i seguenti argomenti:• Supporto delle immagini, pagina 157

• Preparazione delle immagini per l’utilizzo nei documenti, pagina 165

• Tipi di immagine di xPresso, pagina 166

• Variabili immagine, pagina 166

• Immagini di contenuto universale, pagina 168

• Utilizzo di immagini all’interno di output PostScript, pagina 170

• Utilizzo di immagini nell’output PDF e PPML, pagina 171

Supporto delle immaginiPer utilizzare immagini nei documenti è necessario considerare numerosi elementi. Prima diprendere qualsiasi decisione, è importante conoscere i formati di immagine supportati dall’engine dipubblicazione di xPublish per ogni formato di output. Nella tabella seguente è illustrati in dettaglio ilsupporto delle immagini per ogni formato di output supportato.

Se il formato di output non supporta un formato immagine, in xPression viene tentata la conversionedel formato in uno supportato. Per ulteriori informazioni, vedere Formati immagine non supportati,pagina 158. In xPression esistono due tipi di supporto immagine: diretto e indiretto. I formatiimmagine supportati direttamente sono supportati dal formato di output e passati direttamentetramite l’engine di pubblicazione. I formati immagine supportati indirettamente sono supportatidal formato di output solo se compressi in modo specifico. Per i formati immagine supportatiindirettamente, xPression estrae e incorpora i dati necessari; questa operazione può influire sulleprestazioni.

Nella tabella seguente è illustrato in dettaglio il supporto immagine xPression per ogni formatodi output supportato.

157

Page 158:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Formatoimmagine

AFP DOCX HTML PCL PDF/PPML PostScript

BMP Nonsupportato

Supportatodirettamente

Supportatodirettamente

Nonsupportato

Nonsupportato

Nonsupportato

EPS Nonsupportato

Nonsupportato

Nonsupportato

Nonsupportato

Nonsupportato

Supportatodirettamente

GIF Nonsupportato

Supportatodirettamente

Supportatodirettamente

Nonsupportato

Supportatoindirettamente

Nonsupportato

JPEG (JFIF) Supportatodirettamente

Supportatodirettamente

Supportatodirettamente

Nonsupportato

Supportatodirettamente

Supportatodirettamente

PDF Nonsupportato

Nonsupportato

Nonsupportato

Nonsupportato

Supportatodirettamente

Nonsupportato

PNG Nonsupportato

Supportatodirettamente

Supportatodirettamente

Nonsupportato

Supportatoindirettamente

Nonsupportato

TIFF (Group4)

Supportatodirettamente

Nonsupportato

Nonsupportato

Supportatodirettamente

Supportatodirettamente

Supportatodirettamente

TIFF(monocromo)

Supportatoindiretta-mente

Nonsupportato

Nonsupportato

Supportatoindiretta-mente

Supportatodirettamente

Supportatodirettamente

TIFF (scaladei grigi)

Nonsupportato

Nonsupportato

Nonsupportato

Nonsupportato

Supportatodirettamente

Supportatodirettamente

TIFF (colore) Nonsupportato

Nonsupportato

Nonsupportato

Nonsupportato

Supportatodirettamente

Supportatodirettamente

WMF Supportato Supportato Supportato Supportato Supportato Supportato

Formati immagine non supportati

I formati immagine non supportati, gestiti dall’engine di pubblicazione xPression Publish, verrannoconvertiti in un formato supportato dal formato di output.

Nella tabella seguente vengono descritti i formati in cui vengono convertite le immagini supportateper ogni formato di output. Una voce “N/A” indica che il formato immagine è supportato peril formato di output (per cui la conversione non è necessaria); una voce “Nessuno” indica chel’immagine non è supportata, ma non viene eseguita alcuna conversione immagine.

Immagineoriginale

AFP DOCX HTML PCL PDF/PPML PostScript

BMP JPEG N/D N/D Nessuno JPEG JPEG

EPS JPEG JPEG,PNG

JPEG,PNG

Nessuno PDF, JPEG,PNG

N/D

GIF JPEG N/D N/D Nessuno N/D JPEG

JPEG (JFIF) N/D N/D N/D Nessuno N/D N/D

158

Page 159:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Immagineoriginale

AFP DOCX HTML PCL PDF/PPML PostScript

PDF JPEG JPEG JPEG Nessuno N/D JPEG

PNG JPEG,Group 4

N/D N/D Nessuno N/D JPEG

TIFF (Group 4) N/D JPEG JPEG N/D N/D N/D

TIFF (monocromo)

Group 4 JPEG JPEG Group 4 N/D N/D

TIFF (scala deigrigi)

Nessuno JPEG JPEG Nessuno N/D N/D

TIFF (colore) Nessuno JPEG JPEG Nessuno N/D N/D

xPression utilizza quindi il valore nelle impostazioni di preferenze immagine del server, che sitrovano nel file DCPI.properties, per selezionare il formato file desiderato. Per ulteriori informazionisull’opzione di preferenza immagine, vedere Impostazione dell’opzione di preferenza immagine,pagina 159.

Impostazione dell’opzione di preferenza immagine

Il tipo di immagine utilizzato durante la pubblicazione è controllato da un’impostazione in un file diconfigurazione. Sul client l’impostazione appare nel file xPRSConfig.xml, mentre sul server xPressionl’impostazione appare nel file DCPI.properties. A ogni formato di output è associato un parametronel file contenente un elenco dei formati immagine supportati. L’ordine dei formati immaginedetermina l’ordine in cui xPression selezionerà un formato immagine da pubblicare.

La posizione del file di configurazione contenente l’opzione di preferenza immagine differisce trail client e ogni server:• Il file xPRSConfig.xml si trova sul client xPresso for Word nella directory di configurazione.

• Il file DCPI.properties sul server xPression si trova nella directory xPressionHome.

L’opzione di preferenza immagine è la stessa in ciascuno dei file di configurazione. Ricercare levoci seguenti:"ImagePreferenceForPDF" value="tif;tiff;pdf;png;jpg;jpeg;gif;bmp""ImagePreferenceForPS" value="pdf;eps;jpg;jpeg;tif""ImagePreferenceForAFP" value="pdf;jpg;jpeg;gif""ImagePreferenceForHTML" value="png;jpeg;jpg;gif;bmp""ImagePreferenceForDOCX" value="png;jpg;gif;bmp""ImagePreferenceForPCL" value="tif;tiff"

Questa impostazione controlla il tipo di immagine utilizzato durante la pubblicazione per ogniformato di output. Se si desidera utilizzare immagini PDF nell’output PDF, spostare pdf all’iniziodell’elenco:ImagePreferenceForPDF=pdf;tif;tiff;png;jpg;jpeg;gif;bmp

Ad esempio, si supponga di creare un documento in cui si incorpora un’immagine EPS. Il documentoverrà pubblicato nell’output PDF e PostScript. Quando si assembla il documento, l’immagine EPSverrà convertita in PNG, JPEG e PDF. Le versioni EPS, PNG, JPEG e PDF dell’immagine verrannotutte incluse nel pacchetto.

159

Page 160:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Il file di configurazione sul server contiene le impostazioni seguenti:<prop name="ImagePreferenceForPDF" value="pdf;tif;tiff;png;jpg;jpeg;gif;bmp"visible="false"/>

<prop name="ImagePreferenceForPS" value="eps;pdfjpg;jpeg;tif visible="false"/>

Quando si pubblica il documento, xPression utilizza la conversione PDF dell’immagine EPSnell’output PDF e l’immagine EPS originale nell’output PostScript.

Scelta del formato di immagine corretto

Attualmente esistono probabilmente diverse centinaia di formati di file di immagine. Fortunatamente,questo numero non è in aumento. Il motivo è che si sono distinti alcuni formati standard chesoddisfano i requisiti funzionali di svariati scenari di utilizzo delle immagini.

Gli aspetti funzionali principali di utilizzo delle immagini sono:• Dimensione dei file. Influisce sensibilmente su tutti i sistemi, comprese le stampanti.

• Fedeltà dei colori. La precisione del meccanismo per la memorizzazione dei colori (da 1 bit a32 bit).

• Supporto della trasparenza. Alcuni formati di immagine possono specificare quali parti delrettangolo dell’immagine sono trasparenti.

Nella tabella seguente vengono descritti alcuni requisiti relativi alle immagini e i formati suggeritiper soddisfare tali requisiti.

Requisito Formato Commenti

Bianco e nero

Dimensione ridotta del file

CITT G4 TIFF Si tratta di un sistema molto compatto e standard permemorizzare immagini monocromatiche.

CITT G4 TIFF è il formato utilizzato dalleapparecchiature fax.

256 colori (8 bit)

Dimensione ridotta del file

GIF Si tratta di un formato compatto, progettato per il web.È adatto alle applicazioni per le quali è necessaria unabassa fedeltà ai colori con i formati elettronici.

Fotografie

Output elettronico

Trasparenza

PNG Si tratta di un formato RGB compatto che supporta latrasparenza.

È ideale per output elettronico, ma non consente digestire la trasparenza in PostScript ed è limitato alcolore RGB.

Elevata qualità del colore

Fotografie (RGB, CMYK)

JPG Il formato JPG consente una riduzione delladimensione del file mediante la rimozione di partidell’immagine.

Il formato JPG è molto compatto ed è ottimo per lefotografie.

160

Page 161:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Requisito Formato Commenti

Elevata qualità del colore

Fotografie, percorsi diritaglio e così via

Tutti i modelli di colore

EPS Questo formato è supportato solo da PostScript e daalcuni device AFP.

Si tratta dell’unico formato adatto per applicazionidi immagini per le quali sono necessari percorsi diritaglio.

Nell’output PDF di xPression, un file EPS verràconvertito in PDF, JPEG e PNG. I file PNG supportanogli eventuali percorsi di ritaglio contenuti nel file EPS.

I canali alfa non sono supportati per la trasparenza.

Immagini PDF

Il supporto PDF nell’output di xPresso for Word può essere classificato in due categorie: immaginiPDF (inferiore a una pagina) e PDF a pagina intera o a più pagine.

Le immagini PDF sono supportate per l’utilizzo nell’output PDF, PostScript e PPML. Le immaginiPDF possono essere incluse in un documento solo come immagini dinamiche. Le immaginidinamiche vengono inserite tramite una variabile immagine, un elemento di contenuto universale o lamodalità online. La modalità online consente di inserire un riferimento a un’immagine memorizzatain un repository ECM accessibile dal server.

Nota: (1) Se si inserisce un file PDF a più pagine utilizzando una variabile immagine o tramite lamodalità online, solo la prima pagina del PDF verrà inserita nel documento come un’immagine. (2) Sesi include un’immagine PDF in un documento pubblicato su un formato di output che non supportaPDF, verrà utilizzato un formato immagine supportato che è stato creato durante una conversioneimmagine. Per ulteriori informazioni, vedere Formati immagine non supportati, pagina 158.

È possibile inserire file PDF a pagina intera o a più pagine nel documento xPresso for Word tramiteun elemento di contenuto universale. È possibile stabilire quali pagine del PDF devono essere inseritenel documento, nonché definire le opzioni di sommario, le opzioni di formattazione e le condizioni diinclusione. Le immagini PDF di contenuto universale possono essere inserite da una directory locale,da un repository del server o tramite una variabile.

Immagini EPS

Le immagini EPS possono essere incluse in un documento solo come immagini dinamiche. Leimmagini dinamiche vengono inserite tramite una variabile immagine, un elemento di contenutouniversale o la modalità online. La modalità online consente di inserire un riferimento a un’immaginememorizzata in un repository ECM accessibile dal server.

161

Page 162:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Immagini JPEG

Se l’immagine JPEG (.jpg, .jpeg) ha un formato irregolare, l’engine di pubblicazione di xPublish non èin grado di utilizzarla per generare output PostScript o AFP. Un’immagine JPEG è “irregolare” secontiene uno degli elementi seguenti:• Più tag SOI (Start of Image: FFD8). Questo tag deve apparire solo una volta all’inizio del file.

• Più tag SOS (Start of Scan: FFDA). Questo tag indica l’inizio della scansione dell’immagine.

È possibile utilizzare un’utility quale IrfanView (/http://www.irfanview.com/) per salvarenuovamente le immagini JPEG irregolari e quindi utilizzare le immagini appena salvate neldocumento.

Immagini TIFF

L’engine di pubblicazione xPression Publish supporta attualmente quattro tipi di immagini TIFF:• Immagini a due livelli (monocromatiche)

• Immagini in scala di grigi

• Immagini a colori RGB

• Immagini di separazione (solo CMYK)

I tipi seguenti di immagini TIFF non sono attualmente supportati:• Immagini palette RGB

• Immagini YCrCb

• Immagini CIE Lab

• Immagini incorporate JPEG

Tenere presenti le seguenti limitazioni per le immagini TIFF:• La trasparenza nelle immagini TIFF non è supportata.

• L’inserimento di un’immagine TIFF nell’intestazione o nel piè di pagina non è supportato.

• La visualizzazione in anteprima dei documenti contenenti immagini TIFF non è supportata.

Nella tabella seguente viene descritto il supporto per le immagini TIFF xPression.

Tipi di immaginiFunzioni Due

livelliScala digrigi

RGB CMYK

Nessuna compressione Sì Sì Sì Sì

CCITT 1D (Huffman modificata) Sì N/D N/D N/D

1D Sì N/D N/D N/D

2D Sì N/D N/D N/D

Fill Bits BeforeEOL

Sì N/D N/D N/D

CCITT G3

Metodo dicompressione

162

Page 163:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Tipi di immaginiFunzioni Due

livelliScala digrigi

RGB CMYK

Modalità noncompressa

No N/D N/D N/D

Normale Sì N/D N/D N/DCCITT G4

Modalità noncompressa

No N/D N/D N/D

Pack Bits Sì Sì Sì Sì

LZW Sì Sì Sì Sì

1 Sì N/D N/D N/D

2 N/D Sì Sì Sì

4 N/D Sì Sì Sì

8 N/D Sì Sì Sì

Bit per campione

16 N/D Sì Sì Sì

Normale Sì N/D N/D N/DOrdineriempimento Invertito Sì N/D N/D N/D

Black is one Sì Sì N/D N/DPresentazionecolore White is one Sì Sì N/D N/D

Planare (ad esempio, RRRGGGBBB) N/D N/D Sì SìPlanare ointerlacciato Interlacciato (ad esempio,

RGBRGBRGB)N/D N/D Sì Sì

Striscia singola Sì Sì Sì SìStrisce

Più strisce Sì Sì Sì Sì

Archiviazione datiimmagine

Affiancate No No No No

Campioni aggiuntivi (trasparenza) No No No No

Immagini WMF

xPresso for Word supporta immagini WMF per tutti i linguaggi di definizione della pagina supportati.Le immagini WMF non possono essere visualizzate in anteprima dal client, ma comparirannonell’output una volta pubblicato sul server. Le immagini WMF non possono essere visualizzate inAnteprima PDF in quanto il formato non è supportato in modo nativo per l’output PDF e xPressionnon esegue la conversione delle immagini sul client. Quando si visualizza in anteprima PDF undocumento contenente un’immagine WMF, l’immagine non verrà visualizzata e nel file di registroverrà riportato un messaggio di errore.

163

Page 164:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Supporto profili colore ICC

I profili colore ICC incorporati nei file EPS, JPEG e PDF possono essere passati tramite xPression aidriver della stampante o ai processori RIP. xPression non può passare profili colore ICC in immaginiTIFF. Per i tipi di immagine supportati, xPression può passare il profilo, ma questo non può essereutilizzato da xPression per la corrispondenza colori. xPression non è a conoscenza del tipo distampante o del processore RIP che verranno utilizzati e pertanto non è in grado di risolvere lacorrispondenza colori.

Il passaggio di profili ICC è supportato nei file EPS quando si esegue l’output su PostScript, nei fileJPEG quando si esegue l’output su PostScript e PDF e nei file PDF quando si esegue l’output su PDF.

Qualsiasi tipo di conversione o elaborazione eseguita sull’immagine dal server xPression interrompeil profilo colore ICC, in particolare la funzione Ricampiona immagine sulla risoluzione di output.

Opzioni di formattazione supportate

Quando si inserisce un’immagine in un documento di xPresso for Word, diventa disponibile la schedaFormato di Strumenti immagine sulla barra multifunzione di Word. xPression non supporta tutte leopzioni di Word per la formattazione delle immagini. Per i dettagli vedere la seguente tabella.

Opzione Supporto

Regola: tutte le opzioni Non supportato

Stili immagini: Bordo immagine Supportati solo Colori RGB in Coloristandard o Altri colori contorno

Stili immagini: Effetti immagine Non supportato

Stili immagini: Forma immagine Non supportato

Disponi: Posizione Supportato solo In linea con il testo

Disponi: Testo a capo Supportati solo In linea con il testo,Incorniciato, Sopra e sotto, Davanti al testoe Dietro al testo

Disponi: Porta in primo piano Non supportato

Disponi: Porta in secondo piano Non supportato

Disponi: Riquadro di selezione Non supportato

Disponi: Allinea Non supportato

Disponi: Raggruppa Non supportato

Disponi: Ruota Non supportato

Dimensioni: Ritaglia Non supportato

Dimensioni: Altezza forma Supportato

Dimensioni: Larghezza forma Supportato

164

Page 165:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Utilizzo degli ancoraggi

Tenere presente quanto segue quando si utilizzano cornici ancorate contenenti immagini:• Quando si include un’immagine in un contenuto dinamico, è necessario assicurarsi chel’ancoraggio dell’immagine sia all’interno del controllo di tale contenuto. Se si sposta l’ancoraggioall’esterno del controllo del contenuto, l’immagine non farà più parte del contenuto dinamico.

• È possibile che le immagini ancorate non vengano visualizzate nella stessa esatta posizionequando il documento viene pubblicato sul server xPression.

• Le cornici ancorate devono essere leggermente più grandi delle immagini in esse contenute perassicurare la corretta pubblicazione delle immagini.

Preparazione delle immagini per l’utilizzo neidocumentiDopo aver scelto il tipo, o i tipi, di immagini che verranno utilizzate nel documento xPresso, èimportante preparare correttamente le immagini in modo che non influenzino in modo negativo leprestazioni. Quando si preparano le immagini per la pubblicazione, è necessario ridurre al minimo ledimensioni. Un’immagine più piccola viene elaborata più rapidamente.

La risoluzione immagine è in genere la prima impostazione da modificare quando si ottimizzanole prestazioni. In linea di massima, tenere presente che la risoluzione delle immagini fotografichenon deve mai essere in genere superiore a 200 DPI. Per determinare una risoluzione accettabileper le immagini, stampare un’immagine rappresentativa a 100, 125, 150, 175, 200, 225 e 250 DPI.Confrontare le immagini e scegliere la risoluzione più bassa che soddisfa i propri requisiti.

In molti casi, può essere difficile stabilire la differenza tra le immagini quando la risoluzione èmaggiore di 125 DPI. Tuttavia, questo è diverso per diversi tipi di immagini. Ad esempio, se siriproducono immagini contenenti testo e line art, la risoluzione deve essere più elevata, ma in generela profondità in bit può essere inferiore. Per questi file l’intervallo di prova può essere compreso tra175 DPI e 400 DPI (o superiore) in base alla qualità del processo di stampa.

I valori DPI consigliati per le immagini a colori (non line art) sono i seguenti:• 150 DPI Qualità accettabile

• 200 DPI Qualità buona

• 250 DPI Qualità migliore

• 300 DPI Massima qualità

• 300-600 DPI solo per processi di stampa laser e offset di alto livello

I valori DPI consigliati per line art (scansioni di testo, line art pregiato) sono i seguenti:• 150 DPI Qualità fax

• 200 DPI Qualità buona

• 250 DPI Qualità migliore

165

Page 166:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

• 300 DPI Qualità molto buona

• 300-600 DPI Qualità di alto livello

Un metodo comunemente usato per ottenere immagini in formato digitale è eseguirne la scansione.Quando si esegue la scansione di immagini, è importante considerare quanto segue:• Il DPI dell’immagine sottoposta a scansione non deve essere uguale al DPI della stampante.Questo può determinare immagini molto più grandi del necessario. Ad esempio, se il DPI dellastampante è 1200, è ancora necessario eseguire la scansione delle immagini a non più di 300 DPI(o il DPI più basso che offre la qualità richiesta). Se si esegue la scansione di tutte le immagini a1200 DPI, la quantità di informazioni contenuta in ciascuna immagine è 800 DPI più grande diquella necessaria a ottenere la qualità richiesta.

• Eseguire la scansione delle immagini al valore di DPI richiesto per l’output. Immagini con DPIinferiore non possono essere successivamente ridimensionate per essere utilizzate su un outputcon DPI più elevato. Ridimensionare un’immagine a 72 DPI in un’immagine a 300 DPI nonmigliora la perdita di dettaglio nei bordi dell’immagine che appare nell’immagine a 72 DPI.

• Se occorre utilizzare l’immagine nell’output di stampa, non eseguire la scansione dell’immaginea 72-96 DPI. Questo intervallo non dispone di risoluzione sufficiente per creare un output distampa accettabile.

• Se occorre utilizzare un’immagine in un dispositivo di stampa e archiviazione, eseguire lascansione dell’immagine al DPI di stampa accettabile, quindi salvare una copia dell’immagine arisoluzione inferiore per l’output su archivio.

Tipi di immagine di xPressoÈ possibile includere due tipi di immagini in un modello di xPresso for Word: statiche e dinamiche.

Le immagini che non cambiano tra le iterazioni dello stesso modello sono definite statiche. Questeimmagini possono essere inserite nel modello utilizzando la funzione Immagine di Word (schedaInserisci > Immagine). Le immagini sono incluse nel modello, escludendo la possibilità dierrori di immagine mancante al momento della pubblicazione. L’utilizzo delle immagini staticherichiede la disponibilità delle immagini al momento della progettazione.

Le immagini che possono cambiare tra le iterazioni dello stesso modello sono definite dinamiche. Èpossibile inserire immagini dinamiche tramite una variabile immagine o un’immagine di contenutouniversale. Le variabili immagine vengono inserite nel documento in xPresso for Word e puntanoa dati contenenti il percorso e il nome di un file esterno. Le immagini di contenuto universaleconsentono di inserire un’immagine memorizzata localmente o in una rete nel server xPression. Inalternativa, è possibile utilizzare un riferimento di variabile.

Variabili immagineLe variabili immagine consentono di includere nel documento un’immagine esterna, che può differirea seconda dei dati. I dati contengono il nome e il percorso dell’immagine. La variabile immagineottiene l’immagine dal percorso definito nei dati e la inserisce nella pagina del documento.

Il percorso dell’immagine può essere fornito come percorso relativo o assoluto o come espressione.

166

Page 167:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Tutti gli elementi dati di tipo stringa nello schema possono essere inseriti nel documento comevariabile immagine. Per ulteriori informazioni, vedere Aggiunta di variabili al modello, pagina 86. Inalternativa, è possibile creare una nuova variabile e definire il percorso immagine come espressionedella variabile.

Nota: le opzioni Posizione e Disposizione testo di Microsoft Word non sono supportate nellevariabili di immagine.

Definizione di un percorso di immagine relativo oassoluto

È possibile strutturare i riferimenti alle variabili immagine mediante un percorso relativo o assoluto.In entrambi i casi, è necessario assicurarsi che le immagini siano presenti nella posizione correttasul client e sul server. Se si specifica l’intero percorso, è inoltre necessario verificare che l’esattopercorso specificato esista sul client e sul server.

Le variabili immagine a cui si fa riferimento tramite percorsi relativi devono trovarsi nella directorydelle immagini sul computer client xPresso for Word, nonché nella directory delle immagini sulserver xPression. Entrambe le directory vengono definite in fase di installazione. In caso di dubbi,rivolgersi all’amministratore di sistema.

La directory delle immagini predefinita sul client xPresso for Word è Your_drive:\ProgramData\xPresso\xPresso_version\Unity Designer\Images

Il percorso della directory sul server è definito nel file xPRSConfig.xml, situato nella directoryxPressionHome.

Per utilizzare un percorso relativo, il riferimento nei dati deve essere strutturato nel seguente modo:<image>logo.jpg<image>. Perché l’immagine logo.jpg sia reperibile per l’anteprima (sul client) e lapubblicazione (sul server), deve trovarsi nella directory delle immagini predefinita del client e delserver.

Definizione del percorso di un’immagine tramiteun’espressione

È possibile definire il percorso di una variabile immagine tramite un’espressione. Se si tratta di unpercorso locale o di rete, è necessario che il percorso sia disponibile sia nel server che nel client. Èpossibile specificare anche il percorso di un repository di Documentum o del database di xPression.La connessione al server Documentum deve essere configurata nel server xPression in modo chexPression Publish possa accedere al repository ed estrarre l’immagine durante la pubblicazione.

Il formato del percorso dovrebbe essere il seguente:

Impostazioni locali: unità/percorso/nome file

Rete: file://nome computer/percorso/nome file

Documentum: ecm::NomeConfigecm:/percorso/nomefile?version=versione

Repository xPression: cr::nomefile?

167

Page 168:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

L’espressione deve essere racchiusa tra virgolette doppie.

Nota: xPression non supporta l’utilizzo del protocollo HTTPS in alcuna connessione.

Immagini di contenuto universaleLe immagini di contenuto universale consentono di inserire nel documento delle immagini che sonomemorizzate in una posizione esterna, come una directory locale o un repository di server. Inserendoun’immagine di contenuto universale nel modello si crea un collegamento di riferimento al filedi immagine. In questo modo l’immagine può essere aggiornata esternamente, senza apportaremodifiche al modello stesso.

Quando si utilizza il contenuto universale dell’immagine memorizzato nel repository xPressionDocumentum, o in un repository Documentum o FileNet aggiuntivo, assicurarsi che esista un solofile con lo stesso nome e numero di versione nel repository. Se esistono più file con lo stesso nome enumero di versione, xPression non è in grado di sapere quale file utilizzare durante la pubblicazionedel documento e potrebbe non includere il file corretto.

Se si inserisce un’immagine di contenuto universale in una casella di testo e l’immagine non èpresente nell’output, regolare le dimensioni della casella di testo finché l’immagine non vienevisualizzata nell’output.

Nota: le opzioni Posizione e Disposizione testo di Microsoft Word non sono supportate nelcontenuto universale immagine.

Per aggiungere contenuto universale:

1. Posizionare il cursore nel documento nel punto in cui si desidera che venga visualizzato ilcontenuto universale nell’output.

2. (Facoltativo) Se l’immagine di contenuto universale risiede in un luogo diverso dal repositorydel server predefinito, fare clic su File > xPresso e selezionare Scegli immagine UC da serverdei contenuti esterno.

3. Fare clic su Contenuto universale nella scheda Progettazione di xPresso for Word della barramultifunzione di Word, quindi selezionare Immagine. Verrà visualizzata la finestra di dialogoInserisci immagine.

4. Selezionare la posizione dalla quale verrà incluso il contenuto universale: Server, Variabile oFile locale.

5. Fare clic sul testo che appare nella casella di riferimento oppure fare clic sul pulsante Sfoglia.• Se come posizione è stato selezionato Server e attualmente si è connessi al server, verràvisualizzata la finestra di dialogo Seleziona file. Le dimensioni e la miniatura di un’immaginevengono visualizzate nella finestra di dialogo Seleziona file quando si seleziona l’immagine.Se il contenuto si trova nel repository predefinito, individuare e selezionare il contenuto efare clic su OK.

Se il contenuto si trova su un repository diverso, seguire le istruzioni in Selezione delcontenuto in un altro repository, pagina 201, quindi individuare e selezionare il contenuto efare clic su Ok.

168

Page 169:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Questa opzione non è disponibile se non si è connessi al server.

• Se come posizione è stato selezionato Variabile, verrà visualizzata la finestra di dialogoSeleziona variabile. Selezionare la variabile che contiene il percorso assoluto e il nome delcontenuto, quindi fare clic su Inserisci. Per ulteriori informazioni, vedere Formattazione diriferimenti file variabili, pagina 200.

• Se come posizione è stato selezionato File locale, verrà aperta la finestra di dialogo Selezionacontenuto universale. Individuare e selezionare il contenuto, quindi fare clic su Apri in Word.

6. Selezionare l’opzione di adattamento dell’immagine:• Nessuna opzione di adattamento. L’immagine viene visualizzata nella pagina con ledimensioni originali.

• Adatta contenuto mantenendo le proporzioni. L’immagine viene ridimensionata in base alledimensioni della cornice immagine mantenendone le proporzioni corrette.

• Adatta contenuto alla cornice. L’immagine viene ridimensionata in base alle dimensioni dellacornice immagine.

• Riempi cornice mantenendo le proporzioni. L’immagine viene ridimensionata in modo dariempire l’intera cornice immagine mantenendone le proporzioni corrette.

7. Selezionare l’opzione di allineamento verticale: In alto, Al centro, In basso.

8. Selezionare l’opzione di allineamento orizzontale: Sinistra, Al centro, Destra.

9. Fare clic su OK. Un elemento di contenuto universale verrà aggiunto in Esplora modelli.

10. (Facoltativo) Fare clic sull’elenco a discesa relativo all’elemento di contenuto universale in Esploramodelli e selezionareModifica criteri per definire i criteri per controllare quando il contenutouniversale viene incluso nel documento principale. Verrà visualizzata la finestra di dialogoImposta criteri. Definire i criteri di inclusione, quindi fare clic su OK. Per ulteriori informazioni,vedere Definizione della logica delle espressioni condizionali, pagina 144.

Nota: Se il formato immagine non è supportato dal tipo di output, l’engine di pubblicazionexPression convertirà l’immagine in un tipo supportato, come specificato nel file xPRSConfig.xml oper la definizione di flusso in xAdmin.

Aggiunta di testo alternativo alle immaginiÈ possibile pubblicare un documento PDF/UA con xPression. È possibile aggiungere del testoalternativo a un’immagine per abilitare l’accessibilità di un output PDF/UA. Per impostazionepredefinita, le immagini non dispongono di testo alternativo e sono contrassegnate come artefatti. Peruna panoramica sul tipo di output PDF/UA, consultare la guida all’elaborazione dell’output PDF/UA.

È possibile aggiungere del testo alternativo sia a immagini statiche che dinamiche.

Aggiunta di testo alternativo a un’immagine

1. In un documento xPresso for Word, selezionare l’immagine a cui aggiungere del testo alternativo.

2. Dalla scheda Progettazione di xPresso for Word della barra multifunzione di Word, fare clicsul pulsante Testo alternativo nella sezione Opzioni. Viene visualizzata la finestra di dialogo

169

Page 170:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Impostazione testo alternativo. È inoltre possibile aprire questa finestra di dialogo nei seguentimodi:• Fare clic con il pulsante destro del mouse sull’immagine e selezionare xWord Designer >Imposta testo alternativo.

• Per una variabile di immagine o un’immagine di contenuto universale, fare clic sul menu adiscesa in Esplora modelli e selezionare Imposta testo alternativo.

3. Nell’elenco Impostazioni locali, selezionare la lingua del testo alternativo.

4. Digitare il testo alternativo nella casella Descrizione. Il testo alternativo non deve superare32768 caratteri.

5. Fare clic su OK.Per una variabile di immagine o un’immagine di contenuto universale, è possibile inoltre aggiungeredelle variabili nel testo alternativo.

Aggiunta di una variabile nel testo alternativo

1. Aprire la finestra di dialogo Impostazione testo alternativo.

2. Fare clic sull’icona Scegli variabile a destra della casella Descrizione.

3. Fare doppio clic sulla variabile che si desidera aggiungere. La variabile è stata aggiunta allacasella di testo nella finestra di dialogo.

4. Digitare il testo in base alle esigenze e fare clic su Inserisci.

5. Fare clic su OK.

Suggerimento: Per visualizzare il testo alternativo impostato, aprire di nuovo la finestra di dialogoImpostazione testo alternativo. Per una variabile di immagine o un’immagine di contenutouniversale, è possibile inoltre visualizzare il testo alternativo in Esplora modelli selezionandoProprietà dal menu a discesa.

Utilizzo di immagini all’interno di outputPostScriptPer ottenere gli effetti desiderati in caso di utilizzo di immagini in output PostScript di xPressionè necessario seguire determinate modalità. Nella tabella seguente sono elencate le funzionalitàdi alcuni tipi di immagine e viene descritto come ottenere tali funzionalità all’interno di outputdel server xPression.

Funzionalitàrichiesta

Formato da utilizzare Commenti

CMYK o altrimodelli di colore

JPEG o EPS In EPS, può essere utilizzato qualsiasi modello dicolore, purché supportato dal device di output.

RGB JPEG, EPS o PNG

Monocromatico(bitmap)

G4 TIFF (formato fax) Si tratta del formato più comune per le immaginia bit singolo.

170

Page 171:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Funzionalitàrichiesta

Formato da utilizzare Commenti

Trasparenza EPS con percorso diritaglio

Si tratta dell’unico formato che consente latrasparenza in PostScript.

Quando si utilizzano file EPS con percorsi diritaglio per PostScript, viene creato un file PNGRGBA per l’utilizzo con il formato PDF. Il coloreRGBA (A sta per alfa e indica il supporto delcanale alfa) consente la trasparenza nel flusso PDFper le immagini EPS.

Tutti gli altri metodi di definizione dellatrasparenza non sono supportati in PostScript.

Opacità Tutto L’opacità è supportata.

Ritaglio Tutto Il ritaglio non è supportato.

Rotazione Tutto La rotazione dell’immagine non è supportata.

Ridimensionamento Tutto Il ridimensionamento è supportato tramite gliattributi della variabile immagine.

Utilizzo di immagini nell’output PDF e PPMLPer ottenere gli effetti desiderati in caso di utilizzo di immagini nell’output PDF o PPML di xPressionè necessario procedere in un certo modo. Nella tabella seguente sono elencate le funzionalità dialcuni tipi di immagine e viene descritto come ottenere tali funzionalità all’interno di output delserver xPression.

Funzionalitàrichiesta

Formato da utilizzare Commenti

CMYK o altrimodelli di colore

JPEG, TIFF o PDF Assicurarsi di non selezionare Ricampionaimmagini su risoluzione di output in Definizioneoutput in xAdmin. Per ulteriori informazioni,vedere la Guida per l’utente di xAdmin.

RGB JPEG, TIFF o PNG

Monocromatico(bitmap)

TIFF Group 4 o TIFFmonocromo

TIFF Group 4 è il formato più comune per leimmagini a bit singolo.

Ritaglio Tutto Il ritaglio è supportato.

Rotazione Tutto La rotazione dell’immagine è supportata.

171

Page 172:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di immagini

Funzionalitàrichiesta

Formato da utilizzare Commenti

Ridimensionamento Tutto Il ridimensionamento è supportato

Trasparenza PDF o PNG PDF è la scelta migliore, in particolare quando ildocumento contiene grafici. In caso contrario, èanche possibile scegliere PNG.

172

Page 173:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 8Utilizzo delle tabelle

Nei documenti xPresso for Word è possibile utilizzare le tabelle di Word per contenere sia dati staticisia dati dinamici. Se non specificato diversamente, le informazioni nelle seguenti sezioni concernonosia le tabelle statiche sia quelle dinamiche del documento.• Supporto alle tabelle di Word, pagina 173

• Definizione delle proprietà della tabella, pagina 174

• Utilizzo di tabelle dinamiche, pagina 177

Nota: Se un contenitore di contenuto, ad esempio contenuto riutilizzabili, un loop, un’area modello eun gruppo di contenuti inizia con una tabella, viene inserito un paragrafo vuoto prima della tabella.Se un contenitore di contenuto finisce con una tabella, viene inserito una paragrafo vuoto dopo latabella. Si tratta di una limitazione nota di Microsoft Word. Se il paragrafo aggiunto non è opportuno,è possibile ridimensionarlo o nasconderlo.

Supporto alle tabelle di WordQuando si utilizzano le tabelle di Word, tenere presente gli elementi di supporto seguenti. Per unelenco completo delle funzionalità di tabella di Word supportate, vedere Tabelle, pagina 321.

Impostazioni di tabella

Non tutte le impostazioni di tabella di Word sono supportate dall’engine di pubblicazione dixPublish. Per questo motivo una tabella potrebbe apparire diversa nel documento visualizzatoin xPresso for Word rispetto a quando si crea un’anteprima PDF del documento o si pubblica ildocumento sul Server xPression.

Ad esempio, la formattazione a righe alterne non è supportata dall’engine di pubblicazione, pertantoquando si esegue l’anteprima PDF del documento, tutte le righe della tabella utilizzeranno la stessaformattazione. Tuttavia quando si applicheranno dei dati al documento in xPresso for Word, latabella sarà visualizzata con la formattazione a righe alterne che era stata applicata.

Se si riempie una cella di tabella con il colore nero e successivamente il testo della cella vieneimpostato su Automatico (nero), il testo apparirà di colore bianco nel documento. Invece, quandosi visualizza in anteprima o si pubblica il documento, il testo apparirà di colore nero e pertantonon risulterà visibile nella cella di tabella nera.

173

Page 174:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

Tenere presenti le seguenti limitazioni quando si utilizzano impostazioni di tabella:• xPresso for Word non supporta celle di tabella di intestazione che si estendono su celle di corpo ocelle di corpo che si estendono su celle di piè di pagina.

• Gli stili del bordo delle celle della tabella “punto-tratto” e “punto-punto-tratto” non sonosupportati nell’output HTML prodotto da documenti di xPresso for Word.

• L’impostazione dell’opzione di tabella Larghezza preferita su Percentuale non è supportata;utilizzare un valore assoluto quando si definisce la larghezza della tabella.

• Le impostazioni di posizionamento tabella (disponibili dalla scheda Tabella di Proprietà tabella)non sono supportate. Se si desidera avere due tabelle affiancate nel documento, è possibile creareuna tabella che abbia l’aspetto di due tabelle, utilizzare tabelle nidificate o un layout di paginaa due colonne.

• In xPresso for Word non è supportata la funzione di trascinamento della selezione per lospostamento delle righe e delle colonne.

Nota:• Se una cella di tabella contiene una variabile, si potrebbe riscontrare che la larghezza della colonnacorrispondente non può essere impostata su una dimensione inferiore a quelle della lunghezzadella variabile. Il problema si verifica quando la larghezza delle colonne di tabella è impostata perl’adattamento automatico. Per risolvere il problema, selezionare la tabella e fare clic su Adattaautomaticamente > Larghezza fissa colonne sulla scheda Layout.

• Quando una tabella contiene delle variabili, del contenuto universale o delle funzioni di tabella, leopzioni Proprietà tabella, Inserisci righe, Inserisci colonne ed Elimina sono disabilitate nelleseguenti situazioni:— Il cursore viene posizionato in una cella contenente variabili, contenuto universale o funzionitabella.

— Il cursore viene posizionato nella cella di una riga contenente variabili, contenuto universale ofunzioni tabella.

Per attivare le opzioni, effettuare una delle seguenti operazioni:— Selezionare l’intera tabella.

— Selezionare le riga o le colonne dell’intera tabella. (Le opzioni di eliminazione vengonodisabilitate per le colonne a destra delle celle contenenti variabili, contenuto universale ofunzioni tabella).

— Selezionare la cella contenente una variabile.

— Se si copia una riga contenente funzioni di tabella o variabili e si aggiunge una riga precedenteincollando la riga copiata, le funzioni di tabella o le variabili nella nuova riga non funzionano.Per evitare il problema, incollare il contenuto copiato in una riga esistente.

Definizione delle proprietà della tabellaIn aggiunta alle opzioni fornite da Word, xPresso for Word fornisce impostazioni avanzate per letabelle. Queste opzioni aggiuntive consentono di definire ulteriori impostazioni di intestazione e pièdi pagina, aggiungere funzioni alla tabella e definire le impostazioni per le righe isolate.

174

Page 175:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

Tutte le proprietà della tabella di xPresso sono disponibili nella scheda Tabelle di xPresso for Word nelgruppo Strumenti tabella sulla barra multifunzione di Word, che viene visualizzata solo quando vieneselezionata una tabella nel canvas. Per modificare le proprietà della tabella, ad esempio le opzioni diintestazioni e piè di pagina, fare clic suModifica nella scheda Tabelle di xPresso for Word; è quindipossibile modificare le proprietà della tabella nella finestra di dialogo Definisci proprietà tabella.

Nota: Dopo aver modificato le opzioni di tabella xPresso di una tabella, viene generatoautomaticamente del testo alternativo per la tabella. Non modificare o eliminare il testo generatoautomaticamente, altrimenti la configurazione delle opzioni di tabella risulterà errata.

Intestazioni e piè di pagina di tabella

In xPresso for Word sono disponibili opzioni di intestazione e piè di pagina specifiche per le tabellecontenute nei documenti di xPresso. Dalle aree Intestazione tabella e Piè di pagina tabella dellafinestra di dialogo Definisci proprietà tabella, è possibile eseguire le seguenti operazioni:• Selezionare il numero di righe di intestazione e di piè di pagina. Il numero di righe di intestazionee piè di pagina non deve superare il numero di righe del corpo della tabella.

• Specificare di saltare la prima riga di intestazione e l’ultima riga di piè di pagina.

• Specificare che l’intestazione e il piè di pagina di tabella devono apparire in ogni colonna dellapagina.

• Specificare che l’intestazione e il piè di pagina di tabella devono apparire una sola volta in ognipagina.

Nota:• Non inserire troppo contenuto in una cella di intestazione o piè di pagina di una tabella,altrimenti, il file PDF di output sarà vuoto.

• Se nella finestra di dialogo Definisci proprietà tabella non sono state impostate le opzioni ditabella, xPresso for Word calcola sempre il numero delle righe di intestazione come zero. Quandosi apre la finestra di dialogo Definisci proprietà tabella per la prima volta, xPresso seleziona ilnumero di righe di intestazione ripetute impostato tramite Microsoft Word nel campo Numerorighe intestazione come impostazione predefinita. È possibile selezionare un altro valore oppureutilizzare quello predefinito in questo campo. Facendo clic su Annulla, il numero di righedell’intestazione in xPresso sarà sempre zero.

Righe isolate nella tabella

La sezione relativa alle righe isolate della finestra Imposta proprietà tabelle consente di controllare leinterruzioni di una tabella. È possibile definire:• Il numero di righe vedove che si desidera includere nella tabella. L’intero impostato in questocampo definisce il numero minimo di righe di una stessa tabella riportate in una nuova pagina.

175

Page 176:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

Ad esempio, se si imposta questo valore su tre, la tabella si interromperà a un limite di pagina enella nuova pagina verranno visualizzate tre o più righe. La tabella si interromperà al limite dipagina solo se è possibile visualizzare tre o più righe nella nuova pagina.

• Il numero di righe orfane che si desidera includere nella tabella. Il numero intero impostato inquesto campo definisce il numero minimo di righe che devono seguire una riga di intestazioneprima che una tabella possa essere interrotta a un limite di pagina.

Ad esempio, se si imposta questo valore su tre, la tabella si interromperà a un limite di pagina solose tre o più righe seguono la riga di intestazione.

• Le righe di tabella che si desidera tenere insieme, senza interruzioni fra una pagina e la successiva.È possibile impostare che le righe vengano tenute insieme specificando la riga di inizio e quelladi fine.

Ad esempio se si specifica da due a quattro nell’opzioneMantieni righe insieme, la seconda, terzae quarta riga della tabella selezionata vengono tenute insieme.

Utilizzo delle funzioni di tabellaxPresso for Word consente di aggiungere funzioni matematiche alle tabelle contenute nel modello.Le funzioni devono essere visualizzate nell’intestazione o nel piè di pagina della tabella e possonoriguardare il totale della pagina o un totale parziale su più pagine. Sono disponibili numerosefunzioni per il calcolo del totale: somma, conta numeri, media, max e min. È inoltre possibileformattare la funzione con le opzioni di formattazione numerica disponibili. Sul canvas, il totaleviene visualizzato nel formato seguente: {totalFunctionName_totalFunctionScope}, ad esempio,{Count_Page} e {Average_Running}.

Per inserire una funzione di tabella, posizionare il cursore in una cella della riga di intestazione odi piè di pagina e selezionare una funzione di tabella dal gruppo Inserisci della scheda Tabelledi xPresso for Word.

Il totale viene calcolato e posizionato nella cella specificata durante la pubblicazione. I campi XMLche forniscono i dati per il calcolo devono essere numerici, senza alcun tipo di formattazione (adesempio, $100 o 100% non sono supportati). Qualsiasi formattazione necessaria deve essere applicataall’elemento della funzione nel modello. Se xPression incontra un carattere non supportato in uncampo, il campo sarà elaborato come se avesse valore 0 (zero) durante il calcolo.

La cella contenente la funzione deve essere di dimensioni sufficientemente grandi da contenereinteramente il più alto totale possibile. La cella non verrà ridimensionata durante la pubblicazione ese il contenuto è troppo grande, andrà oltre i limiti della cella e non sarà visualizzato correttamente.

Nota:• La formattazione dei numeri tedeschi è supportata per le variabili nei calcoli, ma non per i valoristatici nei calcoli.

• Le funzioni non sono supportate nell’output HTML.

176

Page 177:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

Utilizzo di tabelle dinamicheLe tabelle dinamiche sono un’ottima modalità visiva per includere informazioni nel documento,in un formato di facile lettura. Le tabelle dinamiche aumentano e diminuiscono di dimensioni inbase alla quantità di dati che viene visualizzata e dispongono di un numero diverso di righe perogni record nei dati.

È possibile includere una tabella dinamica al documento in due modi: utilizzando una variabiletabella oppure creando una tabella statica di Word e applicando loop di contenuto alle righe.

L’utilizzo di una variabile tabella è una modalità semplice ed efficace per aggiungere una tabella aldocumento. Quando si decide di utilizzare una variabile tabella, è bene considerare quanto segue:• Le variabili tabella sono utili quando la struttura dei dati è molto simile alle righe e alle colonneche si desidera includere nella tabella.

• È possibile selezionare e riordinare le colonne secondo le proprie esigenze.

• Tutti i dati nella variabile tabella devono provenire dallo stesso campo dati padre.

• È supportato il filtro xPath.

Creando una tabella in Word utilizzando l’opzione Inserisci tabella della Barra multifunzione eassegnando quindi dei loop di contenuto alle righe per popolarla, si ottiene più controllo sul formatoe sul flusso del contenuto. Quando si decide di utilizzare una tabella statica, è bene considerarequanto segue:• La tabella supporta la nidificazione di loop di contenuto.

• È possibile scegliere i campi da inserire nelle colonne o nelle righe (poiché è possibile applicareil loop a più righe).

• È possibile includere anche dati che potrebbero non essere nello stesso campo dati padre nellastessa tabella, dal momento che è possibile creare più loop in una tabella.

• È possibile eseguire la mappatura di campi che possono essere in un ordine diverso e in righediverse in una struttura di tabella per la pubblicazione.

• È possibile utilizzare righe statiche per intestazioni o gruppi e contemporaneamente indicareuna riga sotto la quale ripetere i dati.

• È possibile includere questi elementi come intestazioni di continuazione.

• Sono supportati il filtro xPath e il filtro loop.

Per ulteriori informazioni sulla creazione di variabili tabella, vedere Variabili tabella, pagina 177. Perulteriori informazioni sulla modalità di creazione di una tabella dinamica utilizzando una tabelladi Word e dei loop di contenuto, vedere Creazione di una tabella dinamica con loop di contenuto,pagina 179.

Variabili tabella

Le variabili tabella utilizzano i dati contenuti in un elemento dati ripetibile per creare una tabella inun modello di documento. Gli elementi figlio forniscono le colonne di dati per la tabella.

177

Page 178:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

Le variabili tabella vengono create automaticamente quando un elemento dati padre vieneposizionato nel canvas. In alternativa, è possibile creare una variabile tabella utilizzando l’opzioneTabella nella sezione Variabile della scheda xPresso sulla barra multifunzione di Word.

La tabella creata automaticamente dalla variabile tabella contiene una colonna per ciascun elementofiglio nell’elemento padre selezionato, una riga di intestazione contenente il nome di ciascunelemento figlio e una riga di corpo contenente la variabile per ciascun elemento figlio. Non è possibileaggiungere ulteriori righe o colonne alla variabile tabella. È tuttavia possibile scegliere di escluderesingoli elementi figlio (e le relative colonne) dalla tabella quando si procede alla definizione degliattributi di tabella.

Nota:• Se occorre aggiungere una colonna a una tabella che contiene una variabile tabella o un loop dirighe, è necessario aggiungere la colonna copiando e incollando una colonna esistente.

• In un documento di una versione precedente, se si utilizzano le variabili di tabella nelle caselledi testo, si possono verificare degli errori durante il tentativo di archiviazione, verifica evisualizzazione dell’anteprima o pubblicazione del documento. È necessario rimuovere e inseriredi nuovo le variabili di tabella con la versione corrente di xPresso for Word.

Definizione degli attributi della variabile tabella

Nella finestra di dialogo Definisci variabile tabella è possibile definire gli attributi di tabella, inclusele colonne da inserire nella tabella e il relativo ordine di visualizzazione. Una volta creata unavariabile tabella, è possibile formattare la tabella per migliorarne l’aspetto utilizzando le opzioni diformattazione tabella di Word o le opzioni di tabella di xPresso avanzate. Per informazioni sullelimitazioni relative al supporto della formattazione di Word per la release in uso, vedere le notesulla release.

Le opzioni di formattazione della tabella disponibili sono le seguenti:• Array. Consente di modificare il nome dell’array utilizzato per creare la tabella.

• XPath. Consente di definire un nuovo xPath per applicare il filtro all’array. Fare clic sul pulsanteDefinisci xPath per aprire l’Editor xPath.

• Configurazione tabella. Consente di indicare le colonne da inserire nella tabella, il relativo ordinedi inserimento, definire le intestazioni e i piè di pagina della tabella e specificare il formato per levariabili nella tabella. Sono disponibili le opzioni di configurazione seguenti:— Selezionare un elemento dalla colonna Variabile e fare clic su Rimuovi colonna per rimuoverladalla tabella. La colonna rimossa verrà visualizzata sotto l’intestazione Non incluso.

— Selezionare un elemento sotto l’intestazione Non incluso e fare clic su Aggiungi colonnaper aggiungerlo alla tabella.

— Selezionare un elemento nella colonna Variabile e fare clic sui pulsanti Sposta su colonna eSposta giù colonna per spostare la colonna nella posizione desiderata. Le colonne verrannovisualizzate nella tabella con la prima colonna dell’elenco visualizzata come prima colonna (asinistra) della tabella.

— Selezionare un elemento dalla colonna Variabile e fare clic suModifica formato per definireun formato specifico per questa istanza della variabile. Per ulteriori informazioni, vedereFormattazione delle variabili testo, pagina 89.

178

Page 179:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

— Selezionare Riga di intestazione per aggiungere una riga di intestazione alla tabella.Selezionare un elemento dalla colonna Variabile, quindi fare clic suModifica colonna diintestazione tabella per modificare il testo contenuto nell’intestazione di quella colonna.

— Selezionare Riga di piè di pagina per aggiungere una riga di piè di pagina alla tabella.Selezionare un elemento dalla colonna Variabile, quindi fare clic suModifica colonna di piè dipagina tabella per modificare il testo contenuto nel piè di pagina di quella colonna.

Nota: È possibile eliminare le colonne in una variabile tabella solo dalla finestra di dialogo Definiscivariabile tabella, non dal documento.

Limiti della cella

È importante conoscere le seguenti informazioni sui limiti delle celle in xPresso for Word:• Se si posiziona una tabella dinamica in una cella di una tabella statica, i comportamenti diWord e dell’engine di pubblicazione di xPublish differiscono nella modalità di visualizzazionedel contenuto quando questo supera i bordi della cella. Quando si visualizza il documento inxPresso for Word, il contenuto che oltrepassa il limite della cella viene troncato da Word. Tuttavia,quando si visualizza in anteprima o si pubblica il documento utilizzando xPression, verràvisualizzato l’intero contenuto della cella (la tabella dinamica intera). Probabilmente il contenutosi sovrapporrà ad altri elementi presenti nella pagina.

• Le stringhe di testo possono apparire di lunghezze diverse quando si visualizza il documento inxPresso for Word e quando si utilizza la funzionalità Anteprima PDF o si pubblica il documentonel server. Se una stringa di testo è inclusa in una cella della tabella impostata su una dimensionespecifica che non è possibile espandere, il contenuto potrebbe venire troncato nell’output dixPression, ma potrebbe essere interamente visibile quando si visualizza il documento in xPressofor Word.

Creazione di una tabella dinamica con loop di contenuto

Il primo passaggio nell’utilizzare loop di contenuto della tabella per creare una tabella dinamicaconsiste nell’aggiungere una tabella al documento utilizzando la funzionalità Tabella di Word. Unavolta che la tabella è inserita nella posizione corretta nella pagina del documento, è possibile iniziaread aggiungere alla tabella le variabili che popoleranno le celle con i dati. Successivamente è possibileselezionare una o più righe e assegnare loop di contenuto. È possibile disporre di più righe in un loopdi contenuto ed è possibile disporre di più loop di contenuto nella tabella.

Nota: se si seleziona una tabella con un bordo superiore, il loop del bordo superiore potrebbe nonessere eseguito nell’output iDOCX. Per eseguire il loop del bordo superiore nell’output iDOCX,accertarsi di aver selezionato l’opzione Cella nell’elenco Bordi e sfondo > Bordi > Applica a per ilbordo superiore.

Per creare una tabella dinamica con loop di contenuto:

1. Posizionare una tabella nel documento utilizzando il comando Tabella nella scheda Inseriscidella Barra multifunzione. Verrà visualizzato il menu Inserisci tabella.

179

Page 180:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo delle tabelle

2. Selezionare il numero di righe e di colonne necessario per creare uno o più loop. Non è necessarioche la tabella disponga di tutte le righe necessarie a includere i dati generati; le righe necessarieverranno aggiunte automaticamente secondo le necessità. Tuttavia, è necessario disporre di unnumero di righe sufficiente ad aggiungere tutti i controlli di contenuto dinamici (ad esempiovariabili e loop di contenuto). Una volta aggiunto il contenuto dinamico, non sarà più possibileaggiungere righe o colonne alla tabella.

3. Posizionare le variabili dall’array nelle celle appropriate della tabella.

4. Aggiungere alla tabella le intestazioni di colonna e i piè di pagina necessari. Una volta inseritie disposti adeguatamente le intestazioni e il contenuto delle variabili nella tabella, si è pronti acreare uno o più loop di contenuto.

5. Selezionare una o più righe della tabella che si desidera includere in un loop. Accertarsi chele righe selezionate non siano righe dell’intestazione o del piè di pagina; in caso contrario,l’anteprima potrebbe non essere corretta.

6. Fare clic sul menu a discesa dell’array contenente i dati per il loop in Esplora variabili eselezionare Loop di contenuto. In alternativa, fare clic su Loop nella scheda Tabelle di xWordsulla barra multifunzione di Word.Verrà visualizzata la finestra di dialogo Definisci loop.

7. Fare clic su Scegli variabile per selezionare l’array che si desidera utilizzare per il loop. Seil loop di contenuto è stato creato in Esplora variabili, l’array selezionato qui viene selezionatoautomaticamente.

8. (Facoltativo) Fare clic su Definisci xPath per definire un xPath differente per l’array. Per ulterioriinformazioni, vedere Filtro di un array, pagina 108.

9. Fare clic su OK. In xPresso for Word viene automaticamente inserito un controllo di contenutointorno all’intervallo di contenuto o in corrispondenza del cursore nel modello se non è statoselezionato alcun contenuto. In xPresso for Word il loop di contenuto verrà inoltre aggiuntonella posizione appropriata in Esplora modelli: se il loop è incluso all’interno di un’istanza dicontenuto o di un altro contenitore dinamico, verrà visualizzato in tale contenitore; altrimenti,verrà visualizzato sotto la radice.

10. Ripetere i passaggi 5 e 6 per ciascun loop di contenuto che si desidera definire nella tabella.

Nota:• L’utilizzo del tasto CTRL per selezionare più righe di una tabella da includere in un loop dicontenuto non è supportato. Si tratta di un limite di Word relativo al controllo di contenuto.

• Se si selezionano più righe della tabella da includere nel loop, il controllo di contenuto sembreràcontenere solo una delle righe selezionate. Si tratta di una limitazione del controllo di Word. Illoop di contenuto verrà comunque creato correttamente per includere tutte le righe selezionate epotrà essere controllato in Esplora modelli.

180

Page 181:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 9Utilizzo di contenuto riutilizzabile

Il contenuto riutilizzabile permette di aggiungere contenuto da un altro file di pacchetto di xPressofor Word nel modello. In questo modo è possibile condividere contenuto nativo tra i modelli. Ilmodello in cui viene inserito il contenuto riutilizzabile viene definito modello principale o documentoprincipale.

Il contenuto riutilizzabile deve essere utilizzato in istanze in cui il contenuto è incluso in undocumento di xPresso for Word e si desidera poter controllare l’inclusione di aggiornamenti alcontenuto. Se il contenuto è incluso in un tipo di file diverso da un documento di xPresso for Word ose occorre abilitare gli aggiornamenti automatici al contenuto in fase di pubblicazione, è necessarioutilizzare la funzionalità contenuto universale.

Per creare un output PDF/UA, accertarsi che il contenuto riutilizzabile rispetti anche i requisiti dipubblicazione degli output PDF/UA. Ad esempio, i collegamenti ipertestuali devono avere un testoalternativo. Per i requisiti, consultare la guida all’elaborazione dell’output di xPublish. Il testo alternativoe gli artefatti nel contenuto universale devono essere impostati separatamente nei documenti conriferimenti. Il testo alternativo o gli artefatti del contenuto riutilizzabile possono sempre essereimpostati nei documenti principali; in questo modo, tuttavia, le impostazioni potrebbero non essereeffettive negli output PDF/UA.

Nota:• Il contenuto riutilizzabile di un documento di xPresso for Word deve essere creato con xPressionversione 4.5 o successiva.

• Le interruzioni di sezione all’interno di un contenitore non sono supportate. Se un documento diuna versione antecedente alla 4.5 include un contenitore sprovvisto di interruzioni di sezione,non è possibile archiviare il documento nel server più recente.

• Accertarsi che le funzionalità nel contenuto riutilizzabile siano supportate come in un documentoprincipale di xPresso for Word.

In questo capitolo vengono trattati gli argomenti seguenti:• Vantaggi dell’utilizzo del contenuto riutilizzabile, pagina 182

• Inserimento di contenuto riutilizzabile, pagina 182

• Aggiornamento del contenuto riutilizzabile, pagina 184

• Creazione di contenuto riutilizzabile all’interno del modello, pagina 184

181

Page 182:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto riutilizzabile

Vantaggi dell’utilizzo del contenuto riutilizzabileI concetti di contenuto riutilizzabile e di contenuto universale sono simili, ma vengono utilizzati incasi differenti e presentano vantaggi diversi. In questa sezione vengono trattati i vantaggi dell’utilizzodel contenuto riutilizzabile. Per informazioni sull’utilizzo del contenuto universale, vedere Capitolo10, Utilizzo di contenuto universale.

Poiché il contenuto riutilizzabile è limitato solo ai pacchetti di xPresso for Word, il contenuto dainserire è lo stesso tipo di contenuto del modello in cui è inserito. In questo modo è garantita lafedeltà del documento nella fase di pubblicazione.

Il contenuto riutilizzabile è incorporato nel documento e può essere inserito ovunque, inclusoall’interno di un paragrafo.

Il contenuto riutilizzabile mantiene la propria formattazione diretta e utilizzerà lo stile denominatodel modello principale, qualora nel esista uno. Il contenuto riutilizzabile mantiene inoltre tutte leimpostazioni di sezione in esso contenute; tuttavia, in alcuni casi è possibile che un’interruzione disezione continua venga modificata in interruzione di sezione di nuova pagina durante l’inserimento.

La versione del contenuto riutilizzabile utilizzata nel modello al momento dell’archiviazione delmodello nel server è la versione che sarà utilizzata durante la pubblicazione. Non è possibilerecuperare automaticamente una versione differente del contenuto in fase di pubblicazione. Ciòassicura che la versione testata nel documento sia la versione che sarà utilizzata nel documentopubblicato.

Sebbene il documento includa il contenuto riutilizzabile incorporato e non un riferimento adesso, viene mantenuto un collegamento al file memorizzato nel server ed è possibile controllaregli aggiornamenti da Esplora modelli. Se si desidera utilizzare una nuova versione, è possibileaggiornare il contenuto direttamente dall’interno di xPresso for Word. Vedere Aggiornamento delcontenuto riutilizzabile, pagina 184.

Prima di apportare modifiche a un modello con contenuto riutilizzabile, è possibile utilizzare lostrumento di analisi di impatto per vedere gli altri modelli che stanno utilizzando il contenuto inquel momento.

Inserimento di contenuto riutilizzabileIl contenuto riutilizzabile può essere inserito quasi in qualsiasi punto su una pagina, persinoincorporato all’interno di un paragrafo. È possibile inserire più elementi contenuto riutilizzabilenella stessa pagina. Tuttavia, il contenuto riutilizzabile che presenta solo immagini non può essereinserito nell’intestazione.

Il contenuto riutilizzabile può essere inserito solo dal server xPression. Se il contenuto include dellevariabili, sarà possibile mappare queste variabili alle variabili contenute nel modello principaledurante il processo di inserimento.

Nota: Se il contenuto riutilizzabile che si sta inserendo contiene un’interruzione di sezione continuaprima e dopo il contenuto incluso, la seconda interruzione sarà convertita in un’interruzione disezione di nuova pagina durante l’inserimento. Per ovviare al problema, inserire l’interruzione disezione continua nel documento principale dopo aver inserito il contenuto riutilizzabile.

182

Page 183:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto riutilizzabile

Per aggiungere contenuto riutilizzabile:

1. Posizionare il cursore nel documento nel punto in cui si desidera che venga visualizzato ilcontenuto riutilizzabile nell’output.

2. Fare clic su Contenuto riutilizzabile nella scheda xPresso for Word sulla barra multifunzionedi Word, quindi selezionare Contenuto riutilizzabile. Verrà visualizzata la finestra di dialogoInserisci pacchetto xWord.

3. Fare clic sul testo che appare nella casella di riferimento oppure fare clic sul pulsante Sfoglia.Viene visualizzata la finestra di dialogo Seleziona file. Se non si è connessi al server, verrà chiestodi eseguire innanzitutto l’accesso al server.

4. Individuare il contenuto. Per visualizzare altre versioni del contenuto, fare clic sulla freccianella casella del nome del file.

5. Selezionare il contenuto e fare clic su OK.

6. La mappatura delle variabili può essere analizzata nella sezione Mappa variabili della finestra didialogo. Se il contenuto selezionato non contiene variabili, questa sezione sarà vuota. Andareal passaggio 7.Se nel documento principale è utilizzato lo stesso schema del contenuto riutilizzabile, lamappatura avverrà automaticamente. Per modificare la mappatura di una variabile, selezionarela variabile e fare clic suMappa, selezionare quindi la variabile del documento principale allaquale si desidera mappare il contenuto riutilizzabile e fare clic su Inserisci.Se il documento principale non utilizza lo stesso schema, fare clic su Clic per mappare perciascuna variabile da mappare, selezionare la variabile del documento principale alla quale sidesidera mappare la variabile del contenuto riutilizzabile e fare clic su Inserisci.Solo le variabili di tipo xPath sono elencate in questa mappatura di variabili, essendo l’unicotipo supportato di cui eseguire la mappatura tra i documenti. Le variabili Funzione JavaScripte xPresso sono definite solo localmente in un documento. Per ulteriori informazioni, vedereValori di variabili tra documenti, pagina 194.

7. Fare clic su OK. A Esplora modelli viene aggiunto un contenuto riutilizzabile, visualizzatonel modello.

8. (Facoltativo) Fare clic sull’elenco a discesa per il contenuto riutilizzabile in Esplora modellie selezionareModifica criteri per definire i criteri da controllare quando il contenuto è inclusonel documento principale. Verrà visualizzata la finestra di dialogo Imposta criteri. Definire icriteri di inclusione, quindi fare clic su OK. Per ulteriori informazioni, vedere Definizione dellalogica delle espressioni condizionali, pagina 144.

È possibile eliminare il contenuto riutilizzabile facendo client sul relativo menu a discesa eselezionando Elimina. Il contenuto riutilizzabile viene eliminato dal canvas e da Design Explorer manon viene eliminato dal repository dei contenuti.

Nota: Le variabili presenti nel contenuto riutilizzabile sono visualizzate in base a quanto definitonel documento di origine. L’utilizzo dell’opzione Visualizzaz. variab. nel modello principale nonmodifica la visualizzazione delle variabili del contenuto riutilizzabile.

183

Page 184:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto riutilizzabile

Aggiornamento del contenuto riutilizzabileUna volta inserito un contenuto riutilizzabile in un documento, è possibile controllare la presenza diaggiornamenti per verificare se esiste una versione più recente del contenuto.

Se un aggiornamento è disponibile, un simbolo di calendario viene visualizzato accanto al nome delcontenuto in Esplora modelli. Se si passa il cursore sul nome del contenuto, viene visualizzato unmessaggio Non aggiornato con le informazioni sulla versione più recente.

Per aggiornare il contenuto alla versione più recente disponibile, fare clic sul collegamento Aggiornaalla versione più recente nella finestra del messaggio Non aggiornato. Il contenuto viene aggiornatonel modello e il numero della nuova versione viene visualizzato accanto al nome del contenuto inEsplora modelli.

È possibile controllare la presenza di aggiornamenti manualmente o fare in modo che xPresso forWord esegua tale controllo automaticamente all’apertura del modello principale:• Per controllare la presenza di aggiornamenti manualmente, fare clic sul menu a discesa per ilcontenuto in Esplora modelli e selezionare Controlla aggiornamenti.

• Per controllare la presenza di aggiornamenti automaticamente, fare clic sul menu a discesa per ilcontenuto in Esplora modelli e selezionare Controlla aggiornamenti all’apertura.

• È inoltre possibile scegliere Aggiorna alla versione più recente dal menu a discesa.

Quando il contenuto riutilizzabile di xPresso for Word contiene contenuto universale o contenutoriutilizzabile di xPresso for Word nidificato impostato per l’utilizzo della versione qualificata piùrecente e il contenuto nidificato dispone di una versione più recente, in Esplora modelli, l’utente nonviene notificato che il contenuto nidificato non è aggiornato né visualizza l’opzione di aggiornareil contenuto. Tuttavia, la versione più recente del contenuto nidificato è inclusa nell’output dipubblicazione. Per aggiornare il contenuto nidificato, estrarre il contenuto riutilizzabile padre,aggiornare il contenuto riutilizzabile o il contenuto universale utilizzato come riferimento, quindiarchiviare la nuova versione del contenuto riutilizzabile padre. Ora è possibile aggiornare il contenutoriutilizzabile padre nel documento principale e il contenuto nidificato aggiornato viene incluso.

Creazione di contenuto riutilizzabile all’internodel modelloSe si utilizza un modello in cui è presente contenuto che si desidera condividere con altri utenti odocumenti, è possibile trasformarlo in contenuto riutilizzabile direttamente all’interno del modello. Ilcontenuto riutilizzabile può quindi essere memorizzato nel server.

Per creare contenuto riutilizzabile:

1. Nel canvas, selezionare il contenuto da includere nel contenuto riutilizzabile.

2. Fare clic su Contenuto riutilizzabile sulla scheda xPresso della Barra multifunzione di Worde selezionare Crea contenuto riutilizzabile. Viene visualizzata la finestra di dialogo Nuovocontenuto riutilizzabile.

3. Digitare un nome per il contenuto. Scegliere un nome descrittivo in modo da poterlo individuaree riutilizzare facilmente.

184

Page 185:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto riutilizzabile

4. Selezionare se si desidera sostituire il contenuto selezionato nel modello corrente con uncontenuto riutilizzabile o mantenerlo inalterato. La sostituzione del contenuto consente diaggiornarlo successivamente qualora vengano apportate modifiche.

5. Fare clic sul testo che appare nella casella di riferimento oppure fare clic sul pulsante Sfoglia perselezionare un percorso nel server. Viene visualizzata la finestra di dialogo Seleziona categoria.Se non si è connessi al server, verrà chiesto di eseguire innanzitutto l’accesso al server. Selezionarela categoria in cui si desidera salvare il contenuto riutilizzabile, quindi fare clic su OK.

6. (Facoltativo) Digitare un commento da associare al contenuto riutilizzabile.xPresso for Word utilizza la funzionalità di copia/incolla di Microsoft Word per spostare il contenutodal modello originale nel contenuto riutilizzabile. In alcuni casi, si verifica un problema con lafunzionalità di copia/incolla di Word, ovvero gli stili di carattere applicati al testo vengono copiatiin modo errato. Se si nota questo problema, applicare di nuovo manualmente lo stile di caratterecorretto nel contenuto riutilizzabile.

185

Page 186:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto riutilizzabile

186

Page 187:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 10Utilizzo di contenuto universale

xPresso for Word consente di includere contenuto da un’origine esterna nel documento xPresso.Questa funzionalità è denominata “contenuto universale”. Il documento xPresso in cui viene inseritoil contenuto universale viene definito documento principale o modello principale. Il contenutouniversale supporta diversi tipi di contenuto, nonché immagini, che è possibile includere nel modellodi documento xPresso.

Il contenuto universale può essere utilizzato nelle istanze in cui il contenuto esterno non può esserenel formato nativo del modello o quando è necessario disporre della possibilità di aggiornareautomaticamente il contenuto al momento della pubblicazione.

Accertarsi che le funzionalità nel contenuto universale siano supportate come in un documentoprincipale di xPresso for Word.

In questo capitolo vengono trattati gli argomenti seguenti:• Vantaggi dell’utilizzo di contenuto universale, pagina 187

• Tipi di contenuto universale, pagina 188

• Posizioni supportate per il contenuto universale, pagina 188

• Aggiunta di contenuto universale a un modello principale, pagina 190

• Contenuto universale nell’output PDF/UA, pagina 201

• Visualizzare o nascondere il contenuto universale di xPresso for Word, pagina 202

• Apertura di contenuto universale, pagina 203

• Aggiornamento del contenuto universale, pagina 203

• Creazione di contenuto universale, pagina 204

Vantaggi dell’utilizzo di contenuto universaleIl contenuto universale e quello riutilizzabile sono concetti simili, ma hanno casi di utilizzo e vantaggidiversi. In questa sezione vengono trattati i vantaggi dell’utilizzo di contenuto universale. Perinformazioni sul contenuto riutilizzabile, vedere Capitolo 9, Utilizzo di contenuto riutilizzabile.

Il contenuto universale consente di includere contenuto presente in qualsiasi numero di formati difile; ciò significa che non è necessario che il contenuto sia nel formato nativo del modello.

187

Page 188:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

Il contenuto universale consente di selezionare una versione specifica del contenuto da utilizzare nelmodello o è possibile impostare xPression in modo che utilizzi la versione più recente del contenutoal momento della pubblicazione.

Tipi di contenuto universaleI tipi di contenuto da includere come contenuto universale possono essere suddivisi in due categorieprincipali: dinamici e statici. Rientrano tra i contenuti dinamici i pacchetti di documenti di xPressofor Adobe InDesign o xPresso for Word. Questo tipo di contenuto può contenere del contenutodinamico e delle variabili. È possibile mappare le variabili in modo da creare una correlazionetra le variabili nel contenuto esterno e il documento principale. Fanno parte del contenuto staticoi documenti PDF, TIFF o .docx di Word (Word 2007, 2010 o 2013). Questi documenti non possonoincludere contenuti delle variabili. Saranno inclusi nel documento xPresso for Word senza variazioni.È inoltre possibile includere immagini tramite un contenuto immagine universale, tra cui i file PDFin forma di immagini.

Nota:• I documenti .doc di Microsoft Word non possono essere aggiunti come contenuto universale.Tuttavia, i documenti di versioni antecedenti alla 4.5 di xPresso for Word che includono contenutouniversale di tipo .doc di Word sono ancora supportati.

• Dopo l’aggiornamento di xPresso for Word alla versione più recente, per i documenti principalidella versione 4.5 e delle versioni successive che comprendono contenuto universale di versioniprecedenti alla 4.5 o per i documenti di versioni precedenti alla 4.5 che comprendono contenutouniversale della versione 4.5 e delle versioni successive, è necessario modificare l’impostazione delcontenuto universale e farvi nuovamente riferimento per rimappare le variabili.

• xPression non supporta i PDF con firma digitale come contenuto esterno. Per condividere oriutilizzare un documento contenente una firma digitale, inserire il documento come contenutouniversale in un documento master. Pubblicare il documento master per ottenere la firma digitalenel PDF di output. Per ulteriori informazioni sulle firme digitali, vedere Aggiunta di firmedigitali, pagina 138.

È possibile includere il contenuto universale esterno direttamente da un’unità di rete o locale, ilrepository xPression o il repository xPression Documentum (se con licenza), un ECM Server o tramiteuna variabile che contenga il percorso del contenuto.

Nota: Non è supportata l’inclusione di documenti da Documentum che condividano lo stesso nome,lo stesso formato file e lo stesso percorso file con altri documenti come contenuto esterno.

Posizioni supportate per il contenutouniversaleLa posizione del contenuto universale nel documento xPresso for Word può variare a seconda deltipo di contenuto. Nella tabella seguente viene illustrato dove è possibile posizionare i tipi diversi dicontenuto universale all’interno del documento.

188

Page 189:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

Tipo contenuto universale Paragrafo (inline olimite)

Elenco Caselladi testo

Cella ditabella

Intes-tazione/Piè dipagina

PDF No No No No No

TIFF No No No No No

File DOC di Word Sì Sì(inline)

Sì(senzalayout)

Sì(senzalayout)

Sì(senzalayout)

File DOCX di Word Sì Sì(inline)

Sì(senzalayout)

Sì(senzalayout)

Sì(senzalayout)

Pacchetto xInDesign No No No No No

Pacchetto xWord Sì Sì(inline)

Sì(senzalayout)

Sì(senzalayout)

Sì(senzalayout)

Immagine Sì Sì Sì Sì Sì

Nota: I documenti .doc di Word non possono essere inseriti come contenuto universale. Sonosupportati solo i documenti legacy che includono il contenuto universale di tipo .doc.

È possibile inserire solo contenuto universale senza layout in caselle di testo, celle di tabella enell’intestazione o piè di pagina. Se si inserisce l’elemento di contenuto universale in una casella ditesto, è possibile che l’eventuale sommario incluso nel contenuto universale venga perso nell’output.

I contenuti universali di PDF, TIFF e pacchetto xInDesign sono basati su pagina; pertanto,indipendentemente dal punto in cui il riferimento di contenuto universale viene aggiunto aldocumento, il contenuto universale inizia in una nuova pagina nell’output.

Inserimento di contenuto in intestazioni e piè di paginadi tabella

Durante l’inserimento di contenuto universale nell’intestazione o nel piè di pagina di una tabellacontenente una riga per il corpo, una riga per l’intestazione e una riga per il piè di pagina, èimportante verificare che il contenuto della tabella, completa di intestazione e piè di pagina, rientri inuna sola pagina. Se il contenuto è di dimensioni troppo elevate e l’intera tabella non può entrare inuna pagina, xPression considererà la pagina non valida e restituirà una pagina vuota.

189

Page 190:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

Aggiunta di contenuto universale a un modelloprincipaleSe il contenuto universale da aggiungere proviene da un repository di contenuti Documentum, ènecessario disporre di una licenza per xPression Documentum Edition e configurare DocumentumEdition come descritto nella guida all’installazione di xPression.

Le fasi per l’aggiunta di contenuto universale differiscono leggermente a seconda del tipo dicontenuto aggiunto. Le seguenti sezioni contengono le fasi per i diversi tipi di contenuto universale,nonché altre informazioni sull’aggiunta di contenuto universale a un modello principale:

• Creazione di un sommario combinato, pagina 191

• Aggiunta di contenuto del tipo di documento xPresso, pagina 191

• Aggiunta di contenuti di tipo PDF o TIFF, pagina 195

• Aggiunta di contenuto di tipo .docx di Word, pagina 196

• Opzioni di layout, pagina 198

• Formattazione di riferimenti file variabili, pagina 200

• Selezione del contenuto in un altro repository, pagina 201

Quando si utilizza il contenuto universale, fare attenzione a quanto segue:• Le voci di indice (indicatori) visualizzate nel contenuto universale esterno possono essere inclusenell’indice del documento principale. Tuttavia, se anche il contenuto universale contiene unindice, le voci indice del documento principale non appaiono nell’indice del contenuto universale.Per ulteriori informazioni, vedere Indicizzazione del documento, pagina 129.

• Quando si crea un’anteprima PDF del modello principale in xPresso for Word, il contenutouniversale verrà visualizzato nella posizione appropriata del documento PDF principale. Se ilcontenuto universale viene inserito come “File locale”, è necessario verificare che il percorsocompleto del contenuto presente sul server non differisca.

• xPresso for Word non supporta l’applicazione dei dati alla versione 4.2 o precedente del pacchettoxPresso.

• I numeri di pagina del contenuto universale potrebbero non essere corretti nel canvas in quantonon vengono aggiornati automaticamente, ma verranno corretti nell’output di anteprima enell’output pubblicato.

• Una volta inserito il contenuto universale, è possibile eliminarlo facendo clic sul relativo menu adiscesa e selezionando Elimina. Il contenuto universale viene eliminato dal canvas e da DesignExplorer ma non viene eliminato dal repository dei contenuti.

• Quando il contenuto universale di xPresso for Word contiene contenuto riutilizzabile o contenutouniversale di xPresso for Word nidificato impostato per l’utilizzo della versione qualificatapiù recente e il contenuto nidificato dispone di una versione più recente, in Esplora modelli,l’utente non viene notificato che il contenuto nidificato non è aggiornato né visualizza l’opzionedi aggiornare il contenuto. Tuttavia, la versione più recente del contenuto nidificato è inclusanell’output di pubblicazione. Per aggiornare il contenuto nidificato, estrarre il contenutouniversale padre, aggiornare il contenuto riutilizzabile o il contenuto universale utilizzato comeriferimento, quindi archiviare la nuova versione del contenuto universale padre. Ora è possibile

190

Page 191:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

aggiornare il contenuto padre nel documento principale con il contenuto nidificato aggiornatoincluso.

• Quando si inserisce contenuto universale memorizzato in un repository Documentum, assicurarsiche sia l’unico file con quel nome nel repository. Se esistono più file con lo stesso nome, xPressionnon è in grado di riconoscere il file da utilizzare durante la pubblicazione del documento epotrebbe non includere il file corretto.

• Se si dispone di stili con lo stesso nome sia nel documento principale sia nel contenuto universale,accertarsi che le definizioni dello stile siano uguali; in caso contrario, gli stile applicati al contenutouniversale potrebbero non essere corretti nell’output.

• Inserendo del contenuto universale nella prima linea del documento principale, il contenutouniversale non viene visualizzato nel canvas una volta applicati i dati.

Creazione di un sommario combinato

xPresso for Word consente facoltativamente di includere voci da un contenuto universale nelsommario di un modello principale. Questa funzionalità è supportata per tutti i tipi di output tranneHTML. Sono disponibili due modi diversi per eseguire questa operazione:• È possibile includere una singola voce di livello uno nel sommario del modello principale cheidentifica il contenuto universale.

• Nel sommario del modello principale è possibile includere il primo sommario completovisualizzato nel contenuto universale.

• È possibile utilizzare le impostazioni del sommario del modello principale per includere voci dalcontenuto universale. Ad esempio, se il sommario del modello principale è configurato perchéincluda tutti i paragrafi Heading1, allora anche tutti i paragrafi Heading1 nel contenuto universaleverranno inclusi nel sommario del modello principale.

Per garantire il corretto funzionamento di questa opzione, assicurarsi che il contenuto universalecontenga gli stessi tipi di paragrafo che devono essere inclusi nel sommario del modello principale.

Queste opzioni sono disponibili per la selezione dall’elenco a discesa Sommario dopo aver aggiunto ilcontenuto universale al modello principale. Per ulteriori informazioni, vedere Aggiunta di contenutodel tipo di documento xPresso, pagina 191, Aggiunta di contenuti di tipo PDF o TIFF, pagina 195 oAggiunta di contenuto di tipo .docx di Word, pagina 196.

Nota: Se si utilizzano le impostazioni del sommario del modello principale con il contenuto PDFuniversale, verificare che il documento di Word principale contenga gli stili inclusi nel sommario,denominati Titolo# (1-9) per ciascun livello di titolo richiesto nel PDF. Se nel documento principale glistili inclusi nei sommari non sono denominati in modo appropriato, le voci TOC del file PDF nonsaranno visualizzate nel sommario del modello principale.

Aggiunta di contenuto del tipo di documento xPresso

Qualsiasi documento xPresso for Adobe InDesign (.xindd) o xPresso for Word può essere incluso inun documento principale come contenuto universale. Il contenuto del documento xPresso for Wordpuò essere inserito inline con il contenuto del modello, vale a dire che il contenuto del documento

191

Page 192:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

xPresso for Word può essere inserito all’interno di un paragrafo esistente del documento principale.Il contenuto del documento xPresso for Adobe InDesign non può essere inserito inline. Inizia semprein una nuova pagina.

Tenere presenti le seguenti limitazioni quando si inseriscono i documenti xPresso for Word inline:• Il contenuto universale può contenere solo un paragrafo di testo o, in alternativa, un’immagine.

• Il contenuto universale non può contenere tabelle, intestazioni, piè di pagina né interruzionidi sezione.

• Se si desidera mantenere lo stile del paragrafo del contenuto universale, rimuovere lo stile allafine del paragrafo del documento principale in cui si inserisce il contenuto universale; in casocontrario, lo stile della fine del paragrafo principale viene applicato al contenuto universale inline.

• L’applicazione di dati non è supportata per il contenuto universale inline. Il contenuto universaleinline non è visualizzato quando vengono applicati i dati.

Se si aggiunge il contenuto del pacchetto xPresso for Adobe InDesign da file locali o dal servernel proprio modello di documento, l’intero contenuto viene visualizzato in modalità solo letturaall’interno del documento principale. Se al contenuto del pacchetto xPresso for Word si aggiungonofile locali o provenienti dal server, è possibile scegliere se visualizzare l’intero contenuto o visualizzarel’elemento come segnaposto una volta aggiunto il contenuto universale. Per ulteriori informazioni,vedere Visualizzare o nascondere il contenuto universale di xPresso for Word, pagina 202.

Se il documento xPresso for Word o xPresso for Adobe InDesign utilizzato come contenuto universaleè situato localmente nella directory packages, assicurarsi di importare il pacchetto del contenutouniversale nella stessa categoria sul server xPression in cui si trova il documento principale. Se ildocumento è situato in una directory locale diversa dalla directory packages, la stessa struttura didirectory deve apparire sul server xPression e contenere il contenuto universale.

La directory packages si trova nel percorso Your_drive:\ProgramData\xPresso\xPresso_version\Unity Designer\packages

Nota: Il contenuto universale di tipo documento xPresso nidificato è supportato; pertanto, undocumento a cui viene fatto riferimento come contenuto universale in un documento principale puòcontenere al suo interno un riferimento a un contenuto universale di tipo documento xPresso.

Per aggiungere contenuto universale:

1. Posizionare il cursore nel documento nel punto in cui si desidera che venga visualizzato ilcontenuto universale nell’output. Se il cursore è posizionato con un paragrafo, è possibile inseriresolo contenuto universale che contiene un paragrafo.

2. Fare clic su Contenuto universale nella scheda Progettazione di xPresso for Word e selezionarexPresso for Word o xInDesign. Viene visualizzata la finestra di dialogo Inserisci.

3. Selezionare la posizione dalla quale verrà incluso il contenuto universale: Server, Variabile oFile locale.

4. Fare clic sul testo che appare nella casella di riferimento oppure fare clic sul pulsante Sfoglia.• Se come posizione è stato selezionato Server e attualmente si è connessi al server, verràvisualizzata la finestra di dialogo Seleziona file. Se il contenuto si trova nel repositorypredefinito, individuare e selezionare il contenuto e fare clic su OK.

192

Page 193:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

Se il contenuto si trova su un repository diverso, seguire le istruzioni in Selezione delcontenuto in un altro repository, pagina 201, quindi individuare e selezionare il contenuto efare clic su Ok.

Questa opzione non è disponibile se non si è connessi al server.

• Se come posizione è stato selezionato Variabile, verrà visualizzata la finestra di dialogoSeleziona variabile. Selezionare la variabile che contiene il percorso assoluto e il nome delcontenuto, quindi fare clic su Inserisci. Per ulteriori informazioni, vedere Formattazione diriferimenti file variabili, pagina 200.

• Se come posizione è stato selezionato File locale, verrà aperta la finestra di dialogo Selezionacontenuto universale. Individuare e selezionare il contenuto, quindi fare clic su Apri.

5. (Facoltativo) Selezionare la casella di controllo Utilizza la versione qualificata più recente perimpostare xPression in modo che selezioni la versione qualificata più recente del contenutoal momento della pubblicazione. Questa opzione è disponibile solo quando si inserisce ilcontenuto dal server. Quando questa opzione è selezionata, il contenuto utilizzato al momentodella pubblicazione potrebbe non essere uguale a quello visualizzato durante la progettazionedel modello e potrebbe non essere stato verificato. Il contenuto può essere aggiornato anchemanualmente facendo clic con il pulsante destro del mouse sul contenuto e selezionandoAggiorna.

6. Selezionare la posizione all’interno del documento principale in cui deve iniziare il contenutouniversale: Pagina successiva, (avanti) Pagina dispari, (avanti) Pagina pari o Nuovo paragrafo(solo contenuto xPresso for Word). Per il contenuto universale xPresso for Word, se il cursore èposizionato all’interno di un paragrafo, viene selezionato automaticamente All’interno delparagrafo e l’impostazione non può essere modificata.• Affinché siano disponibili le opzioni dei numeri di pagina, selezionare Pagina successiva,Pagina dispari o Pagina pari.

• Se si seleziona Pagina successiva, Pagina dispari o Pagina pari, è possibile inserire undocumento xPresso for Word utilizzando il proprio layout o adottando il layout deldocumento principale a seconda dell’opzione di layout selezionata. Il layout si riferisce alleimpostazioni del layout pagina quali margini, intestazioni, piè di pagina e colonne. Undocumento xPresso for Adobe InDesign può essere inserito solo utilizzando il proprio layout.

• Se si seleziona Nuovo paragrafo o All’interno del paragrafo, il contenuto universale utilizzail layout del documento principale. Se si escludono le interruzioni di sezione nel contenutouniversale, l’ultimo paragrafo del contenuto universale viene unito al paragrafo principale incui è inserito e adotta lo stile di paragrafo del paragrafo principale. Se il controllo di contenutodel contenuto universale non contiene la fine di paragrafo del paragrafo principale, l’ultimoparagrafo nel contenuto universale continua a utilizzare la propria formattazione diretta, checonsiste nella formattazione applicata direttamente sui caratteri tipo colore, dimensione delcarattere, effetto barrato e così via. Se il controllo di contenuto del contenuto universalecontiene la fine di paragrafo del paragrafo principale, la formattazione diretta dell’ultimoparagrafo nel contenuto universale viene eliminata.

• Se si seleziona All’interno del paragrafo, una volta inserito il contenuto universale, l’opzioneA partire da non può essere modificata.

• Per il contenuto di tipo Pacchetto xWord, un’interruzione di sezione continua viene inseritadopo il contenuto universale. Se si desidera che il contenuto del documento principale cheappare dopo il contenuto universale inizi su una nuova pagina, inserire un’interruzione di

193

Page 194:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

sezione pagina successiva, dispari o pari, oppure un’interruzione di pagina nel documentoprincipale dopo l’elemento di contenuto universale.

7. Nella scheda Opzioni, selezionare le opzioni di layout per determinare la modalità divisualizzazione del contenuto nel modello principale. Per informazioni dettagliate sulle opzioni,vedere Opzioni di layout, pagina 198.

8. Esaminare la mappatura delle variabili nella scheda Mappatura variabili. L’espressione XPathutilizzata per personalizzare un vettore a cui si fa riferimento in un object dinamico vieneelencata anche come variabile. Se il contenuto selezionato non contiene variabili, la scheda èvuota. Passare alla fase 9.Se il documento principale utilizza lo stesso schema del contenuto universale, la mappatura siverifica automaticamente. Se si desidera modificare il mapping di una variabile, selezionare lavariabile e fare clic su Elimina mappatura, quindi su Clic per mappare, selezionare la variabiledel documento principale alla quale si desidera mappare la variabile del contenuto universale efare clic su Inserisci.Se il documento principale non utilizza lo stesso schema, selezionare Clic per mappare perogni variabile che si desidera mappare, selezionare la variabile del documento principale a cuimappare la variabile del contenuto universale e fare clic su Inserisci.Solo le variabili di tipo xPath sono elencate in questa mappatura di variabili, essendo l’unicotipo supportato di cui eseguire la mappatura tra i documenti. Le variabili Funzione JavaScripte xPresso sono definite solo localmente in un documento. Per ulteriori informazioni, vedereValori di variabili tra documenti, pagina 194.

9. Fare clic su OK. Un elemento di contenuto universale verrà aggiunto in Esplora modelli.

10. (Facoltativo) Fare clic sull’elenco a discesa relativo all’elemento di contenuto universale in Esploramodelli e selezionareModifica criteri per definire i criteri per controllare quando il contenutouniversale viene incluso nel documento principale. Verrà visualizzata la finestra di dialogoImposta criteri. Definire i criteri di inclusione, quindi fare clic su OK. Per ulteriori informazioni,vedere Definizione della logica delle espressioni condizionali, pagina 144.

Nota: Se il contenuto universale che si sta inserendo contiene una interruzione di sezione continuaprima e dopo il contenuto presente in esso, la seconda interruzione verrà convertita in unainterruzione di sezione della pagina successiva al momento dell’inserimento. Per evitare questoproblema, inserire l’interruzione di sezione continua nel documento principale prima di inserire ilcontenuto universale.

Valori di variabili tra documenti

Le informazioni seguenti sono importanti per comprendere quando utilizzare le variabili neidocumenti principali e con contenuto principali:• È possibile utilizzare tra documenti diversi le variabili definite come variabili xPath. Se la variabileviene definita nel documento principale, viene utilizzata la definizione stessa, invece di cercarlanella voce del contenuto universale.

• Le variabili di tipo Funzione JavaScript e xPresso sono definite localmente, pertanto non possonoessere utilizzate tra documenti diversi. Di conseguenza, se nel documento principale e nella vocedel contenuto universale sono presenti variabili Funzione JavaScript o xPresso con lo stessonome, non si influenzeranno l’una con l’altra.

194

Page 195:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

• Per un documento principale non è possibile accedere al valore di una variabile calcolata inun documento di contenuto universale, anche se il primo contiene una variabile calcolata conlo stesso nome.

• Per un documento di contenuto universale non è possibile accedere al valore di una variabilecalcolata in un documento principale, a meno che lo schema del contenuto universale nonincluda un campo di input aggiuntivo adeguatamente mappato al momento dell’inserimentodel contenuto.

• Al momento di mappare le variabili del contenuto universale, l’utilizzo della funzione Automaprichiede che sia la variabile xPath del documento principale, sia quella del contenuto universaleabbiano lo stesso nome, lo stesso nome di elemento padre e lo stesso tipo.

• Le variabili presenti nel contenuto universale sono visualizzate in base a quanto definito neldocumento di origine. L’utilizzo dell’opzione Visualizzaz. variab. nel modello principale nonmodifica la visualizzazione delle variabili del contenuto universale.

Aggiunta di contenuti di tipo PDF o TIFF

Quando si utilizza contenuto universale PDF o TIFF memorizzato nel repository xPressionDocumentum, o in un repository Documentum o FileNet aggiuntivo, accertarsi che esista un solofile con lo stesso nome e numero di versione nel repository. Se esistono più file con lo stesso nome enumero di versione, xPression non è in grado di sapere quale file utilizzare durante la pubblicazionedel documento e potrebbe non includere il file corretto.

Per aggiungere contenuto universale:

1. Posizionare il cursore nel documento nel punto in cui si desidera che venga visualizzato ilcontenuto universale nell’output.

2. Fare clic su Contenuto universale nella scheda Progettazione di xPresso for Word e selezionarePDF o TIFF. Viene visualizzata la finestra di dialogo Inserisci.

3. Selezionare la posizione dalla quale verrà incluso il contenuto universale: Server, Variabile oFile locale.

4. Fare clic sul testo che appare nella casella di riferimento oppure fare clic sul pulsante Sfoglia.• Se come posizione è stato selezionato Server e attualmente si è connessi al server, verràvisualizzata la finestra di dialogo Seleziona file. Se il contenuto si trova nel repositorypredefinito, individuare e selezionare il contenuto e fare clic su OK.

Se il contenuto si trova su un repository diverso, seguire le istruzioni in Selezione delcontenuto in un altro repository, pagina 201, quindi individuare e selezionare il contenuto efare clic su Ok.

Questa opzione non è disponibile se non si è connessi al server.

• Se come posizione è stato selezionato Variabile, verrà visualizzata la finestra di dialogoSeleziona variabile. Selezionare la variabile che contiene il percorso assoluto e il nome delcontenuto, quindi fare clic su Inserisci. Per ulteriori informazioni, vedere Formattazione diriferimenti file variabili, pagina 200.

• Se come posizione è stato selezionato File locale, verrà aperta la finestra di dialogo Selezionacontenuto universale. Individuare e selezionare il contenuto, quindi fare clic su Apri.

195

Page 196:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

5. Scegliere dove si desidera che inizi il contenuto universale all’interno del documento principale:Pagina successiva, (avanti) Pagina dispari o (avanti) Pagina pari.

6. Selezionare le opzioni di layout per determinare la modalità di visualizzazione del contenutonel modello principale. Per informazioni dettagliate sulle opzioni, vedere Opzioni di layout,pagina 198.

7. Fare clic su OK. Un elemento di contenuto universale verrà aggiunto in Esplora modelli.

8. (Facoltativo) Fare clic sull’elenco a discesa relativo all’elemento di contenuto universale in Esploramodelli e selezionareModifica criteri per definire i criteri per controllare quando il contenutouniversale viene incluso nel documento principale. Verrà visualizzata la finestra di dialogoImposta criteri. Definire i criteri di inclusione, quindi fare clic su OK. Per ulteriori informazioni,vedere Definizione della logica delle espressioni condizionali, pagina 144.

Nota: Se il documento principale che contiene i riferimenti al contenuto universale in formato PDFviene pubblicato nell’output in PDF, i segnalibri del file PDF del contenuto universale non sarannoinclusi nei segnalibri del file PDF nell’output finale; tuttavia, la TOC conterrà le voci dei segnalibri deicontenuti universali.

Aggiunta di contenuto di tipo .docx di Word

I file .docx di Word possono essere aggiunti nel modello xPresso for Word tramite il contenutouniversale. Il contenuto Word Docx può essere inserito all’interno di un paragrafo esistente deldocumento principale (definito inline).

Tenere presenti le seguenti limitazioni quando si inseriscono i documenti Word Docx inline:• Il contenuto universale può contenere solo un paragrafo di testo.

• Il contenuto universale non può contenere immagini, tabelle, intestazioni, piè di pagina néinterruzioni di sezione.

• Se si desidera mantenere lo stile del paragrafo del contenuto universale, rimuovere lo stile allafine del paragrafo del documento principale in cui si inserisce il contenuto universale; in casocontrario, lo stile della fine del paragrafo principale viene applicato al contenuto universale inline.

• L’applicazione di dati non è supportata per il contenuto universale inline. Il contenuto universaleinline non è visualizzato quando vengono applicati i dati.

Quando si utilizza contenuto universale di Word Docx memorizzato nel repository xPressionDocumentum o in un repository Documentum o FileNet aggiuntivo, accertarsi che esista un solofile con lo stesso nome e numero di versione nel repository. Se esistono più file con lo stesso nome enumero di versione, xPression non è in grado di sapere quale file utilizzare durante la pubblicazionedel documento e potrebbe non includere il file corretto.

Nota: I nomi degli stili di carattere non possono essere rinominati nel contenuto di documento diWord 2007 utilizzato come contenuto universale.

Per aggiungere contenuto universale:

1. Posizionare il cursore nel modello nel punto in cui si desidera che venga visualizzato il contenutouniversale nell’output. Se il cursore è posizionato con un paragrafo, è possibile inserire solocontenuto universale che contiene un paragrafo.

196

Page 197:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

2. Fare clic su Contenuto universale nella scheda Progettazione di xPresso for Word e selezionare.DOCX. Viene visualizzata la finestra di dialogo Inserisci.

3. Selezionare la posizione dalla quale verrà incluso il contenuto universale: Server, Variabile oFile locale.

4. Fare clic sul testo che appare nella casella di riferimento oppure fare clic sul pulsante Sfoglia.• Se come posizione è stato selezionato Server e attualmente si è connessi al server, verràvisualizzata la finestra di dialogo Seleziona file. Se il contenuto si trova nel repositorypredefinito, individuare e selezionare il contenuto e fare clic su OK.

Se il contenuto si trova su un repository diverso, seguire le istruzioni in Selezione delcontenuto in un altro repository, pagina 201, quindi individuare e selezionare il contenuto efare clic su Ok.

Questa opzione non è disponibile se non si è connessi al server.

• Se come posizione è stato selezionato Variabile, verrà visualizzata la finestra di dialogoSeleziona variabile. Selezionare la variabile che contiene il percorso assoluto e il nome delcontenuto, quindi fare clic su Inserisci. Per ulteriori informazioni, vedere Formattazione diriferimenti file variabili, pagina 200.

• Se come posizione è stato selezionato File locale, verrà aperta la finestra di dialogo Selezionacontenuto universale. Individuare e selezionare il contenuto, quindi fare clic su Apri.

5. (Facoltativo) Selezionare la casella di controllo Utilizza la versione qualificata più recente perimpostare xPression in modo che selezioni la versione qualificata più recente del contenuto almomento della pubblicazione. Questa opzione è disponibile solo quando si inserisce il contenutodal server. Quando questa opzione è selezionata, il contenuto utilizzato al momento dellapubblicazione potrebbe non essere uguale a quello visualizzato durante la progettazione delmodello e potrebbe non essere stato verificato.

6. Selezionare la posizione all’interno del documento principale in cui deve iniziare il contenutouniversale: Pagina successiva, (avanti) Pagina dispari, (avanti) Pagina pari, Nuovo paragrafo.Se il cursore è posizionato all’interno di un paragrafo, All’interno del paragrafo è selezionatoautomaticamente e non può essere modificato.• Affinché siano disponibili le opzioni dei numeri di pagina, selezionare Pagina successiva,Pagina dispari o Pagina pari.

• Se si seleziona Pagina successiva, Pagina dispari o Pagina pari, il contenuto universalepuò utilizzare il proprio layout o adottare il layout del documento principale a secondadell’opzione di layout selezionata. Il layout si riferisce alle impostazioni del layout paginaquali margini, intestazioni, piè di pagina e colonne.

• Se si seleziona Nuovo paragrafo o All’interno del paragrafo, il contenuto universale utilizzail layout del documento principale. Se si escludono le interruzioni di sezione nel contenutouniversale, l’ultimo paragrafo del contenuto universale viene unito al paragrafo principale incui è inserito e adotta lo stile di paragrafo del paragrafo principale. Se il controllo di contenutodel contenuto universale non contiene la fine di paragrafo del paragrafo principale, l’ultimoparagrafo nel contenuto universale continua a utilizzare la propria formattazione diretta, checonsiste nella formattazione applicata direttamente sui caratteri tipo colore, dimensione delcarattere, effetto barrato e così via. Se il controllo di contenuto del contenuto universalecontiene la fine di paragrafo del paragrafo principale, la formattazione diretta dell’ultimoparagrafo nel contenuto universale viene eliminata.

197

Page 198:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

7. Selezionare le opzioni di layout per determinare la modalità di visualizzazione del contenutonel modello principale. Per informazioni dettagliate sulle opzioni, vedere Opzioni di layout,pagina 198.

8. Fare clic su OK. Un elemento di contenuto universale verrà aggiunto in Esplora modelli.

9. (Facoltativo) Fare clic sull’elenco a discesa relativo all’elemento di contenuto universale in Esploramodelli e selezionareModifica criteri per definire i criteri per controllare quando il contenutouniversale viene incluso nel documento principale. Verrà visualizzata la finestra di dialogoImposta criteri. Definire i criteri di inclusione, quindi fare clic su OK. Per ulteriori informazioni,vedere Definizione della logica delle espressioni condizionali, pagina 144.

Quando si utilizza il contenuto universale dei documenti .docx diWord, tenere presente quanto segue:• Se si unisce contenuto universale di documenti di Word 2007 in un elenco nel modello principale ealla fine del documento con contenuto universale è presente un paragrafo nascosto, i punti elencoche appaiono dopo il contenuto universale nell’elenco potrebbero non essere risolti correttamentecon il resto dell’elenco.

• L’ombreggiatura carattere non è supportata per contenuto universale di documenti di Word2007; l’ombreggiatura non appare nell’output.

• I file Word Docx in cui è attivato il rilevamento delle revisioni non possono essere inclusi in undocumento xPresso for Word come contenuto universale. Per ovviare a questo problema, salvareil contenuto universale disattivando il rilevamento delle revisioni.

• Nelle voci di contenuto universale di documenti di Word 2007 non sono supportati i riferimentiincrociati e i segnalibri.

• Se il contenuto universale di Word Docx che si sta inserendo contiene una interruzione di sezionecontinua prima e dopo il contenuto presente in esso, la seconda interruzione verrà convertita inuna interruzione di sezione della pagina successiva al momento dell’inserimento. Per evitarequesto problema, inserire l’interruzione di sezione continua nel documento principale primadi inserire il contenuto universale.

• Il contenuto universale Word Docx da inserire deve avere lo stesso stile di paragrafo deldocumento principale, in caso contrario si verificheranno problemi di sovrapposizione del testo.

Opzioni di layout

Quando si inserisce contenuto universale, sono disponibili diverse opzioni di layout. Le opzionidisponibili dipendono dal tipo di contenuto che si sta inserendo e dalla posizione, come illustratodi seguito.

• Escludi interruzioni di sezione di UC e utilizza la definizione di sezione del documentoprincipale corrente: quando questa opzione è selezionata, tutte le interruzioni di sezione nelcontenuto universale vengono ignorate e viene utilizzata la definizione di sezione del documentoprincipale corrente per il contenuto universale. Questa opzione è disponibile per il contenutouniversale di xPresso for Word o di Word Docx. Quando questa opzione è selezionata, il contenutouniversale viene inserito inline, indipendentemente dall’opzione A partire da selezionata.

• Includi interruzioni di sezione di UC e utilizza le definizioni di sezione di UC: quando questaopzione è selezionata, le interruzioni di sezione e le definizioni di sezione del contenuto universalesono conservate. Questa opzione non è applicabile al contenuto universale di xPresso for Word o

198

Page 199:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

dei documenti .docx di Word che inizia su un nuovo paragrafo. Per il contenuto universale dixPresso for Word o Word Docx inserito all’interno d un paragrafo, la selezione di questa opzionefa sì che il contenuto universale inizi in un nuovo paragrafo.

• Includi interruzioni di sezione di UC e utilizza la definizione di sezione del documentoprincipale corrente: quando questa opzione è selezionata, ciascuna definizione di sezionedel contenuto universale è sostituita dalla definizione della sezione corrente del documentoprincipale. Questa opzione è applicabile solo al contenuto universale di xPresso for Word o deidocumenti di Word 2007 che inizia su un nuovo paragrafo o su una nuova pagina. Per il contenutouniversale di xPresso for Word o Word Docx inserito all’interno d un paragrafo, la selezione diquesta opzione fa sì che il contenuto universale inizi in un nuovo paragrafo.

• Considera l’elenco UC come contiguo al documento principale: quando questa opzione èselezionata, l’elenco del contenuto universale viene unito all’elenco visualizzato nel documentoprincipale. Sia gli stili che i numeri dell’elenco del contenuto universale sono uniti nell’elencoprincipale. Se si è specificata la numerazione della prima voce di elenco nel contenuto universale,il numero specificato viene ignorato. Se si è specificata la numerazione di una voce di elencodiversa dalla prima nel contenuto universale, il numero specificato viene conservato. I puntielenco con immagine non sono supportati negli elenchi unione. Questa opzione è disponibile peril contenuto universale di xPresso for Word e dei documenti di Word 2007. Di seguito è riportatoun esempio dei risultati uniti:

1. Voce di elenco principale2. Voce di elenco principale3. Voce di elenco contenuto universale4. Voce di elenco contenuto universale5. Voce di elenco principale

• Considera l’elenco UC come indipendente dal documento principale: quando questa opzioneè selezionata, l’elenco del contenuto universale viene considerato indipendente dall’elenco deldocumento principale. Questa opzione è disponibile per il contenuto universale di xPresso forWord e dei documenti di Word 2007. Di seguito è riportato un esempio dei risultati uniti:

1. Voce di elenco principale2. Voce di elenco principale1. Voce di elenco contenuto universale2. Voce di elenco contenuto universale3. Voce di elenco contenuto universale3. Voce di elenco principale

• Numera le pagine UC contigue al documento principale: quando questa opzione è selezionata,la numerazione delle pagine continua dal documento principale nel contenuto universale. Diseguito è riportato un esempio dei risultati uniti:

Pagina 1Inizio contenuto universalePagina 2Pagina 3Fine contenuto universalePagina 4

• Numera le pagine UC indipendentemente dal documento principale: quando questa opzione èselezionata, i numeri delle pagine del contenuto universale vengono conservati. Questa opzione è

199

Page 200:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

applicabile solo quando le interruzioni di sezione del contenuto universale vengono conservate.Di seguito è riportato un esempio dei risultati uniti:

Pagina 1Inizio contenuto universalePagina 1Pagina 2Fine contenuto universalePagina 2

• Includi tutte le pagine: include tutte le pagine visualizzate nel contenuto universale.Deselezionare questa opzione per elencare solo le pagine che si desidera includere. Questaopzione è disponibile solo per contenuto universale PDF e TIFF.

• Opzioni sommario: selezionare una delle seguenti opzioni per la modalità di visualizzazionedesiderata del contenuto universale nel sommario del modello principale:— Escludi UC dal sommario: non viene creata alcuna voce nel sommario del modello principaleper il contenuto universale.

— Includi UC nel sommario utilizzando regole e stili del documento principale: utilizzarele impostazioni del sommario del modello principale per selezionare voci dal contenutouniversale da inserire nel sommario del modello principale.

Ad esempio, se il sommario del documento principale è configurato perché includa tuttii paragrafi Heading1, tutti quelli presenti nel contenuto universale verranno inclusi nelsommario del documento principale.

— Includi UC nel sommario utilizzando regole e stili UC: utilizzare le impostazioni delsommario del contenuto universale per selezionare voci dal contenuto universale da inserirenel sommario del modello principale.

Ad esempio, se il sommario del contenuto universale è configurato perché includa tuttii paragrafi Heading1, tutti quelli presenti nel contenuto universale verranno inclusi nelsommario del documento principale.

— Includi UC nel sommario come una voce singola: è possibile selezionare una delle opzioniseguenti:— Usa nome UC: utilizza il nome del contenuto universale come voce singola nel sommario.

— Valore di testo statico: digitare il testo statico che si desidera utilizzare come voce singolanel sommario per il contenuto universale.

— Variabile: fare clic sul pulsante Sfoglia per selezionare la variabile che fornirà il testoper la voce singola nel sommario.

Queste opzioni sono disponibili quando il contenuto universale inizia in una nuova pagina.

Formattazione di riferimenti file variabili

Se si utilizza una variabile per fornire il nome e la posizione del contenuto universale, esiste unformato specifico richiesto per il riferimento in base alla posizione del contenuto: in locale, su unarete, in un repository Documentum o in un repository di contenuto di database di xPression.

Locale: file:///unità/percorso/nomefile

200

Page 201:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

Rete: file://nomecomputer/percorso/nomefile

Documentum: ecm::NomeConfigecm:/percorso/nomefile?version=versione

Repository xPression: cr::xPressionCRName:/percorso/nomefile?version=versione

Nota: xPression non supporta l’utilizzo del protocollo HTTPS in alcuna connessione.

Selezione del contenuto in un altro repository

È possibile includere contenuto universale nel documento anche se non si trova sul repository serverpredefinito. Può trovarsi nel repository xPression, nel repository xPression Documentum o in unrepository Documentum o FileNet. I repository Documentum e FileNet devono disporre di unaconfigurazione ECM definita in xAdmin prima di poter selezionare del contenuto da tale server.

Per selezionare del contenuto da un repository diverso da quello predefinito:

1. Fare clic su Sfoglia.

2. Selezionare il nome del repository dall’elenco a discesa Server corrente nella finestra di dialogoECM Server.

3. Selezionare la casella di controllo Cambia nome utente o password se è necessario effettuarel’accesso al server con un nome utente e una password diversi da quelli impiegati per accedere alserver da xPresso for Word.

4. Fare clic su Connetti. Se è stata selezionata l’opzione Cambia nome utente o password, vienevisualizzata la finestra di dialogo di accesso. Digitare le proprie credenziali e fare clic su OK.Il contenuto della finestra ECM Server verrà aggiornato con le informazioni delle directorydel nuovo server.

Contenuto universale nell’output PDF/UAÈ possibile progettare un documento PDF/UA con xPresso for Word. Per ulteriori informazioni sultipo di output PDF/UA, consultare la guida all’elaborazione dell’output di xPublish.

Per creare un output PDF/UA, accertarsi che il contenuto universale rispetti anche i requisiti dipubblicazione degli output PDF/UA. Ad esempio, i collegamenti ipertestuali devono avere un testoalternativo. Per i requisiti, consultare la guida all’elaborazione dell’output di xPublish. Le impostazionirelative al testo alternativo e agli artefatti nel contenuto universale devono essere impostateseparatamente nei documenti con riferimenti. Il testo alternativo o gli artefatti del contenutouniversale possono sempre essere impostati nei documenti principali; in questo modo, tuttavia, leimpostazioni potrebbero non essere effettive negli output PDF/UA.

Le opzioni PDF/UA, come il testo alternativo e gli artefatti nel contenuto universale, devonoessere impostate separatamente nei documenti con riferimenti. In un output PDF/UA, il fatto che

201

Page 202:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

il contenuto universale possa essere letto da un lettore PDF/UA conforme dipende dal tipo dicontenuto universale:• I contenuti universali di tipo PDF e TIFF vengono automaticamente generati come artefattie non saranno letti.

• I contenuti universali di immagine vengono trattati come artefatti per impostazione predefinita.Per fare in modo che il contenuto universale dell’immagine non venga considerato come artefattonell’output, aggiungere del testo alternativo al contenuto universale dell’immagine. Per istruzionisu come aggiungere testo alternativo alle immagini, consultare Aggiunta di testo alternativoalle immagini, pagina 169.

• Il contenuto universale dei documenti di xPresso e Microsoft Word saranno letti così come sonostati creati.

• Il contenuto universale .doc di Word verrà letto così come è stato creato ad eccezione del testoalternativo al suo interno. Tuttavia, se il contenuto universale .doc contiene dei collegamentiipertestuali, xPression non riuscirà a pubblicare l’output PDF/UA.

Visualizzare o nascondere il contenutouniversale di xPresso for WordPer visualizzare il contenuto dell’elemento di contenuto universale xPresso for Word nel canvas,xPression deve scaricare il file dal server e inserire il contenuto nel documento principale. Taleoperazione richiede tempi elevati per i documenti contenenti molti elementi di contenuto universalexPresso for Word. Per migliorare le prestazioni, il contenuto universale viene inserito comesegnaposto per impostazione predefinita. Una volta inserito il contenuto universale, è possibilevisualizzarlo come contenuto o come segnaposto.

Nota: Se il contenuto universale contiene interruzioni di sezione, può essere visualizzato solo comesegnaposto. Per un documento di xPresso for Word precedente alla versione 4.5 SP1, è possibile cheesista contenuto universale che contiene interruzioni di sezione visualizzate come contenuto. Inquesto caso, non è possibile aggiungere interruzioni di sezione dopo il contenuto universale. Peraggiungere una interruzione di sezione dopo il contenuto universale, visualizzarlo come segnaposto.In ogni caso, quando il contenuto universale viene visualizzato come segnaposto non è possibilevisualizzarlo di nuovo come contenuto.

Per visualizzare tutto il contenuto universale xPresso for Word:

1. Fare clic su Contenuto universale nella scheda Progettazione di xPresso for Word.

2. Fare clic su Opzioni di visualizzazione UC di xPresso for Word e fare clic suMostra contenutoUC di xPresso for Word.

Per nascondere il contenuto universale xPresso for Word:

1. Fare clic su Contenuto universale nella scheda Progettazione di xPresso for Word.

2. Fare clic suOpzioni di visualizzazione UC di xPresso for Word e selezionareMostra segnapostoUC di xPresso for Word.Tutti gli elementi di contenuto universale xPresso for Word vengono visualizzati comesegnaposto.

202

Page 203:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

Per visualizzare un singolo elemento di contenuto universale xPresso for Word:

1. Fare clic sul menu dell’elemento di contenuto universale xPresso for Word in Esplora modelli.

2. Fare clic su Visualizza contenuto UC in Word.

3. Per il contenuto universale nidificato, viene visualizzata una finestra di dialogo in cui vienechiesto se visualizzare altri elementi di contenuto universale. Fare clic su Sì per visualizzare ilcontenuto degli elementi nidificati oppure fare clic su No per visualizzare solo il contenutodell’elemento corrente.

Nota: Se un documento principale contiene solo contenuto universale nidificato, viene generataun’eccezione quando si visualizza il contenuto degli elementi nidificati. Per risolvere il problema,aggiungere un paragrafo vuoto prima o dopo il contenuto universale.

Per nascondere un singolo elemento di contenuto universale xPresso for Word:

1. Fare clic sul menu dell’elemento di contenuto universale xPresso for Word in Esplora modelli.

2. Fare clic su Visualizza contenuto UC in Word.L’elemento viene visualizzato come segnaposto.

Apertura di contenuto universaleCon xPresso for Word è possibile aprire un contenuto universale xPresso for Word, presente inun documento principale, direttamente dal documento principale. Il documento del contenutouniversale si apre in xPresso for Word, dove è possibile visualizzare il contenuto ma non modificarlo.

Nota: Non è possibile aprire il contenuto universale incluso nel documento principale tramite unavariabile utilizzando questa funzionalità.

Per aprire il contenuto universale xPresso for Word dal documento principale, fare clic sul menuper il contenuto universale xPresso for Word in Esplora modelli, quindi selezionare Apri in Word.Rivedere il contenuto, quindi chiudere il documento senza apportarvi modifiche.

Aggiornamento del contenuto universaleUna volta inserito un contenuto universale in un documento, è possibile controllare la presenza diaggiornamenti per verificare se esiste una versione più recente del contenuto.

Nota: La ricerca di aggiornamenti non è supportata per il contenuto universale di un repositoryDocumentum

Se un aggiornamento è disponibile, un simbolo di calendario viene visualizzato accanto al nome delcontenuto in Esplora modelli. Se si passa il cursore sul nome del contenuto, viene visualizzato unmessaggio Non aggiornato con le informazioni sulla versione più recente.

Per aggiornare il contenuto alla versione più recente disponibile, fare clic sul collegamento Aggiornaalla versione più recente nella finestra del messaggio Non aggiornato. Il contenuto viene aggiornatonel modello e il numero della nuova versione viene visualizzato accanto al nome del contenuto inEsplora modelli.

203

Page 204:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

È possibile controllare la presenza di aggiornamenti manualmente o fare in modo che xPresso forWord esegua tale controllo automaticamente all’apertura del modello principale:• Per controllare la presenza di aggiornamenti manualmente, fare clic sul menu a discesa per ilcontenuto in Esplora modelli e selezionare Verifica aggiornamenti.

• Per controllare la presenza di aggiornamenti automaticamente, fare clic sul menu a discesa per ilcontenuto in Esplora modelli e selezionare Controlla aggiornamenti all’apertura.

• È inoltre possibile scegliere Aggiorna alla versione più recente dal menu a discesa. Questaopzione non sarà disponibile se si seleziona la casella di controllo Utilizza la versione qualificatapiù recente all’inserimento del contenuto, poiché in questo caso xPresso for Word aggiornaautomaticamente il contenuto.

Se si crea una nuova versione di un documento del contenuto universale e si aggiungono variabilia tale documento, le variabili non verranno aggiornate nel documento principale originale. Peraggiornare le variabili, fare clic sul menu per il contenuto universale in Esplora modelli, quindiselezionareModifica impostazioni. Aggiungere nuovamente il contenuto universale dall’URLcorrente.

Creazione di contenuto universaleCon xPresso for Word è possibile creare un contenuto universale condiviso direttamente dalcontenuto presente attualmente nel modello. È possibile selezionare qualsiasi intervallo di contenutosul canvas per creare il contenuto condiviso. Il contenuto viene salvato come documento xPressofor Word e può essere memorizzato a livello locale o sul server, dove può essere utilizzato da altriutenti in altri documenti.

Nota: Se si desidera selezionare un intervallo di contenuti nel modello per creare contenutouniversale ed esiste una interruzione di pagina subito prima del contenuto, assicurarsi che anchel’interruzione di pagina sia selezionata perché in caso contrario la creazione non riuscirà.

Per creare contenuto universale dal modello:

1. Selezionare l’intervallo di contenuto nel modello che si desidera includere nel contenutouniversale. Se si desidera che l’intero modello sia il contenuto universale, non selezionare alcuncontenuto.

2. Fare clic su Contenuto universale della scheda Progettazione di xPresso for Word, quindiselezionare Crea contenuto universale condiviso. Viene visualizzata la finestra di dialogoNuovo contenuto universale.

3. Digitare un nome per il contenuto universale. È preferibile scegliere un nome descrittivo in modoche altri utenti possano individuare e utilizzare il contenuto.

4. Selezionare come si desidera che venga trattato il contenuto nel documento originale:• Nuovo contenuto universale. Sostituisce il contenuto selezionato con un contenuto universaleper il contenuto universale appena creato.

• Non sostituire il contenuto. Mantiene il contenuto selezionato così com’è nel modello.

5. Selezionare l’opzione per memorizzare il nuovo contenuto universale sul server o a livello locale.

204

Page 205:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

6. Fare clic sul pulsante Sfoglia o sul testo visualizzato nella casella di testo.• Se come posizione è stato selezionato Server, viene visualizzata la finestra di dialogo Selezionacategoria. Selezionare la categoria in cui si desidera memorizzare il contenuto, quindi fareclic su OK.

• Se come posizione è stato selezionato Locale, viene visualizzata la finestra di dialogo Cercacartella. Selezionare la cartella in cui si desidera memorizzare il contenuto, quindi fare clicsu OK.

7. Fare clic su OK. Il modello originale rimane aperto.xPresso for Word utilizza la funzionalità di copia/incolla di Microsoft Word per spostare il contenutodal modello originale nel contenuto universale. In alcuni casi, si verifica un problema con lafunzionalità di copia/incolla di Word, ovvero gli stili di carattere applicati al testo vengono copiatiin modo errato. Se si nota questo problema, applicare di nuovo manualmente lo stile di caratterecorretto nel contenuto universale.

Dopo aver creato contenuto universale, non è possibile aggiungere una definizione di pagina ointerruzione di sezione prima del contenuto universale. Per evitare questo problema, visualizzare ilcontenuto universale come segnaposto e quindi aggiungere una definizione di pagina o interruzionedi sezione.

205

Page 206:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di contenuto universale

206

Page 207:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 11Utilizzo di grafici dinamici

La funzionalità dei grafici dinamici di xPresso for Word consente di aggiungere molti tipi diversi digrafici al documento per migliorare la presentazione del contenuto. I grafici rendono il contenuto piùaccattivante per i destinatari e più facile da leggere e da capire.

In questo capitolo vengono trattati gli argomenti seguenti:• Informazioni sui grafici dinamici, pagina 207

• Creazione di un modello di grafico, pagina 212

• Inserimento di un elemento grafico dinamico, pagina 214

• Importazione di un modello di grafico, pagina 214

• Esportazione di un modello di grafico, pagina 214

• Specifica della definizione dei dati, pagina 215

• Aggiunta di testo alternativo a grafici dinamici, pagina 223

Informazioni sui grafici dinamiciI grafici dinamici migliorano molto l’aspetto e la leggibilità del documento. La progettazione delgrafico viene eseguita in un’applicazione distinta denominata Corda Builder, che può essere installatafacoltativamente quando si installa il software xPresso for Word. Una volta creato un modello digrafico in Corda Builder, è possibile importarlo in qualsiasi documento xPresso for Word.

Una volta creato un modello di grafico, è possibile condividerlo tra documenti xPresso diversi. Imodelli di grafico esistenti possono essere importati in un modello di documento xPresso for Wordoppure è possibile creare un nuovo modello di grafico da utilizzare con il documento.

Nella maggior parte dei grafici utilizzati nei documenti xPresso possono essere visualizzati datidinamici (che possono cambiare per ciascun record di dati) o dati statici (che rimangono identici pertutti i record di dati). I dati statici sono definiti in Cobra Builder alla creazione del modello delgrafico e possono essere modificati o essere resi dinamici in xPresso for Word quando il modelloviene importato in un documento.

207

Page 208:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Nota:• Le immagini dei grafici EPS non supportano la trasparenza. Gli elementi che sul grafico sisovrappongono, nell’output saranno coperti.

• Le opzioni Posizione e Disposizione testo di Microsoft Word non sono supportate nei graficidinamici.

Utilizzo di grafici da una versione precedente di xPresso

Con xPresso for Word versione 4.5, la versione di Corda utilizzata dal software è stata aggiornata.Alcune modifiche apportate alla versione di Corda possono comportare una visualizzazione noncorretta di grafici creati in versioni precedenti. Se si trova un grafico che non è più corretto, esportareil modello da xPresso for Word (per ulteriori informazioni, vedere Esportazione di un modello digrafico, pagina 214), quindi aprire il modello nella nuova versione di Corda Builder e modificarlo,infine importarlo di nuovo nel documento xPresso.

Un esempio di modifica tra le versioni di Corda riguarda i grafici combinati, a linee e barre. In unaprecedente versione di Corda (versione 7.1), la prima serie di dati che si definisce è la barra e laseconda serie è la linea. Nelle versioni più recenti di Corda (versione 7.2 e 7.3), la prima serie di datiche si definisce è la linea e la seconda serie è la barra.

Un altro esempio delle differenze è con grafici a torta. In alcuni casi, i grafici a torta creati in Cordaversione 7.2 appaiono più grandi quando vengono pubblicati in xPression 4.5, che utilizza Cordaversione 7.3. Il bordo di questi grafici può apparire tagliato perché eccedono l’area specificata. In altricasi, i grafici a torta appaiono di fatto più piccoli quando vengono pubblicati in xPression versione4.5. In entrambi i casi, aprire il modello di grafico in Corda Builder e modificare la larghezza el’altezza del grafico, modificando impostazioni per elementi quali le etichette, per cercare di ottenerel’aspetto desiderato.

Tipi di grafico supportati

Corda Builder consente di progettare modelli per numerosi tipi di grafici. xPresso for Word supportai tipi di grafico presenti nella classe dati Standard di Corda. I tipi di grafico indicati di seguitosono supportati per l’utilizzo in documenti xPresso tramite dati dinamici o statici. Salvo dovediversamente indicato, per ogni tipo di grafico Corda sono supportati tutti i sottotipi.• Grafici a barre verticali

• Grafici a barre orizzontali

• Grafici a linee

• Grafici a gradini

• Grafici a linee e barre combinate

• Grafici ad area

• Grafici a barre con percentuale

• Grafici X-Y (solo a linea X-Y e a dispersione X-Y)

208

Page 209:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

• Grafici Borsa

• Grafici temporali (solo a linea temporale e a dispersione temporale)

• Grafici a radar

• Grafici Pareto

• Grafici heat-map

• Grafici a torta

• Grafici a ciambella

• Grafici a imbuto

• Grafici a piramide

• Grafici di taratura

Oltre ai grafici sopra elencati supportati per l’utilizzo con dati dinamici o statici, i grafici indicati diseguito sono attualmente supportati solo per l’utilizzo con dati statici:• Grafici a scatola

• Grafici a bolle X-Y

• Grafici combinati X-Y

• Grafici combinati X-Y (scala Y doppia)

• Grafici a bolle temporali

• Grafici combinati temporali

• Grafici combinati temporali (scala Y doppia)

Caratteri per grafici

Una copia di ciascun carattere utilizzato all’interno di un grafico dinamico deve essere posizionatanella directory di caratteri Corda di xPresso for Word: \xPressoCharts\Resources\lib\fsfiles.Ciascun carattere deve esistere anche nella directory dei caratteri del sistema operativo.

Il software di Corda Builder richiede uno speciale formato di carattere di proprietà (.fsd) che gliconsente di generare numerosi tipi di immagine utilizzando vari set di caratteri. Corda Builderviene installato insieme a un piccolo numero di caratteri di uso comune (memorizzati nella cartella\xPressoCharts\Resources\lib\fsfiles). Se si desidera utilizzare un carattere TrueType diverso, èpossibile convertire il carattere utilizzando il Convertitore caratteri Corda.

Nota: (1) Corda non supporta i caratteri OpenType (.OTF) o Type 1. (2) Con i grafici dinamici nonsono supportati i caratteri cinesi.

Il Convertitore caratteri Corda può convertire caratteri che:• Sono caratteri TrueType di Windows.

• Dispongono di una delle mappature del carattere seguenti:— Unicode

— Shift JIS (MS932) (per il Giapponese)

209

Page 210:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

— Big5 (MS950) (per il Cinese tradizionale)

— GBK (conosciuto anche come PRC) (MS936) (per il Cinese semplificato)

— Wansung (MS949) (per il Coreano)

• Non creare caratteri combinando più glifi dal carattere. In caso contrario, la conversione vienecompletata correttamente, ma i caratteri non vengono visualizzati correttamente.

Per importare caratteri su una piattaforma diversa da Windows, copiare i file del carattere TrueType(.ttf) necessari nel sistema in cui è necessario importare i caratteri, quindi convertirli utilizzando ilConvertitore caratteri Corda.

Per convertire un carattere:

1. Avviare Corda Builder.

2. Dal menu File selezionare Convertitore caratteri Corda. Viene visualizzato il Convertitorecaratteri Corda (Corda Font Converter).

3. Assicurarsi la directory elencata nel campo Fonts sia la directory che contiene i caratteri TrueType.Per impostazione predefinita, questa è la directory dei caratteri del sistema. Esplorare perindividuare la directory corretta se è necessario modificare l’impostazione predefinita. I carattericontenuti nella directory selezionata vengono visualizzati nella casella di riepilogo.

4. Specificare una posizione in cui si desidera salvare i file convertiti nel campo Cartella dioutput. Per impostazione predefinita, i caratteri convertiti vengono salvati nel percorso\xPressoCharts\Resources\lib\fsfiles.

5. Nell’elenco Fonts selezionare il carattere da convertire. Non è possibile selezionare più di uncarattere. L’area di Anteprima mostra l’aspetto del carattere selezionato.

6. Nell’area Conversion Options selezionare gli stili dei caratteri che si desidera convertire:Normale, Grassetto, Corsivo e Grassetto corsivo. Non tutti i caratteri TrueType contengonoinformazioni sullo stile. Poiché ogni stile di carattere Corda è memorizzato in un file distinto,ciascuno stile può essere convertito separatamente. Per impostazione predefinita, tutti gli stilisono selezionati per la conversione.

7. Digitare un nome per il carattere convertito nel campo Visualizza nome. Il nome predefinito peril carattere convertito è il nome del carattere TrueType selezionato.

8. Fare clic su Converti. Il carattere viene convertito tramite il Convertitore caratteri Corda. Nellacasella Status viene mostrato lo stato di avanzamento del processo di conversione e vienevisualizzato un messaggio al termine del processo di conversione. Se nella barra di stato nonviene visualizzato un messaggio indicante l’esito positivo dell’operazione o se viene visualizzatoun messaggio di errore, relativo ad esempio all’impossibilità di convertire il carattere di stilenormale, significa che il Convertitore caratteri Corda non è in grado di convertire il caratterespecificato. In questo caso, provare a convertire un carattere diverso.I file dei caratteri convertiti sono memorizzati nella cartella di output specificata e hannol’estensione .fsd. I nomi dei file hanno lunghezza di otto caratteri e sono composti da unacombinazione del nome dello stile e del nome del carattere forniti nel Passaggio 7.

9. Ripetere i passaggi 5-8 per ogni carattere che si desidera convertire. Al termine della conversionedei caratteri, chiudere il Convertitore caratteri Corda.

210

Page 211:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Una volta convertiti i caratteri, è necessario assicurarsi che una copia di ogni carattere sia disponibilenel client e nel server, in modo che i caratteri corretti possano essere utilizzati nei grafici durantel’anteprima e la pubblicazione.

Sul client xPresso for Word, i caratteri devono risiedere nella directory \xPressoCharts\Resources\lib\fsfiles.

Sul server xPression, i caratteri devono risiedere nei percorsi seguenti:• [xPressionHome]\Publish\CordaFontCache

• [xPressionHome]\Publish\Corda\Resources\lib\fsfiles

Nota: Se gli attributi carattere non vengono visualizzati correttamente nell’output, controllare ilregistro xPresso sul client o il registro processo sul server per verificare se eventuali caratteri .fsdnon sono stati rilevati durante la pubblicazione.

Dati del grafico

xPresso for Word supporta grafici che utilizzano ciò che Corda definisce classe dei dati Standard. Laclasse di dati Standard organizza i dati per serie e categorie. Generalmente, in un grafico la serie èrappresentata dalle righe e le categorie sono rappresentate dalle colonne; è tuttavia possibile sceglieredi invertire tale rappresentazione nel modello di grafico.

I grafici nella classe di dati Standard sono costituiti da elementi dati. Ogni elemento dati rappresentaun valore dei dati che determina la dimensione dell’elemento dati. Ciascun elemento dati appartienea una categoria e a una serie e gli elementi dati sono raggruppati in base alla categoria. Tutti glielementi dati di una serie vengono visualizzati con lo stesso colore, a meno che non si sostituisca ilcolore di un elemento. Ogni serie viene rappresentata da un elemento legenda.

I dati dei grafici a torta e dei grafici di Pareto vengono visualizzati in modo leggermente diversorispetto agli altri grafici di classe di dati Standard. Pertanto, anche i relativi requisiti di dati sonoleggermente diversi. Nei grafici a torta viene utilizzata una sola categoria di dati e nei grafici diPareto viene utilizzata una sola serie di dati.

Nell’esempio riportato di seguito, l’elemento QuarterName contiene i dati della categoria mentre glielementi ProductA, ProductB e ProductC contengono la serie di dati.<QuarterName>Q4</QuarterName><ProductA>22000</ProductA><ProductB>14500</ProductB><ProductC>19000</ProductC>

211

Page 212:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Come affermato in precedenza, generalmente in un grafico la serie di dati viene rappresentatadalle righe e la categoria di dati dalle colonne, ma se lo si desidera è possibile modificare questaconfigurazione. Quando si crea il proprio modello di grafico in Corda Builder, è possibile specificarela posizione in cui si desidera visualizzare la serie di dati. È possibile scegliere di mantenere la seriedi dati nelle righe del grafico oppure spostare la serie di dati nelle colonne. Questa impostazione èdefinita nell’Editor di dati di Corda Builder per ogni modello di grafico e non può essere modificatain xPresso for Word.

Dati dinamici e statici

È possibile configurare i grafici xPresso per l’utilizzo di dati dinamici o statici. Nella maggior partedei tipi di grafici Corda è supportato l’utilizzo di entrambi i tipi di dati, ma ve ne sono alcuni incui è supportato solo l’utilizzo dei dati statici. Per ulteriori informazioni, vedere Tipi di graficosupportati, pagina 208.

I dati dinamici consentono di creare un grafico che contiene dati specifici per ciascun record nel file didati, personalizzando il grafico per ciascun destinatario del documento o gruppo di destinatari. I datidinamici possono derivare da elementi variabile o array contenuti nello schema del documento. Nonè necessario che i dati del grafico dinamico risiedano nello stesso array; tali dati possono provenireda variabili singole contenute in array diversi nello schema del documento. Quando si specifica ladefinizione dei dati per un grafico, è possibile scegliere la variabile o l’array da cui derivano i dati perciascun punto dati presente nel modello di grafico.

I dati statici consentono di creare un grafico che contiene gli stessi dati per ciascun record del filedi dati. I dati statici vengono definiti nell’Editor di dati di Corda Builder durante la creazione delmodello di grafico. I dati statici possono essere modificati in xPresso for Word tramite l’utilizzo divalori letterali per i punti di dati nella finestra di dialogo Definizione dati.

Per ulteriori informazioni sulla definizione dei dati per un modello di grafico, vedere Dati del grafico,pagina 211.

Creazione di un modello di graficoI modelli di grafico vengono creati in Corda Builder, un’applicazione di terze parti installatafacoltativamente insieme a xPresso for Word. In questa guida per l’utente non sono contenuteinformazioni sull’utilizzo del software Corda Builder per la creazione di un modello di grafico.Per questo tipo di informazioni, consultare la guida in linea di Corda disponibile all’internodell’applicazione Corda Builder.

Per avviare l’applicazione Corda Builder, individuare il file CordaBuilder. exe e fare doppio clic sulnome del file. Se Corda Builder è stato installato nella posizione predefinita, il file si troverà inC:\xPressoCharts\Builder.

Nota: Se Corda Builder non viene eseguito e non viene visualizzato un messaggio di errore,ciò potrebbe essere dovuto a un aggiornamento dell’ambiente Java Runtime (JRE). Quando SunMicrosystems fornisce aggiornamenti per JRE, a volte cambia la directory di installazione. Perovviare a questo problema, modificare il percorso JRE nel file CordaBuilder.properties. Per ulterioriinformazioni, vedere la Guida di installazione di xPression.

212

Page 213:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Per accedere alla Guida in linea di Corda, fare clic sul pulsante Guida nella barra degli strumenti diCorda Builder. Dalla home page della documentazione di Corda, fare clic sul collegamento a Guidaai grafici di Corda 7 per ulteriori informazioni sui differenti tipi di grafico che è possibile crearenell’applicazione. Fare clic sul collegamento a Guida per l’utente di Corda Builder per informazionisull’utilizzo di Corda Builder per la creazione di modelli di grafico.

L’utilizzo di Corda Builder per la progettazione di modelli di grafico offre all’utente molta flessibilitàe libertà per progettare un grafico esteticamente piacevole e utile per il documento. Fintanto chesi seleziona uno dei tipi di grafico supportati, si dovrebbe essere in grado di progettare qualsiasimodello si desideri e funzionante quando importato in xPresso for Word. Per ulteriori informazioni,vedere Tipi di grafico supportati, pagina 208.

Se si aggiunge una legenda al modello di grafico, tenere presente che Corda Builder richiede che ledimensioni di una legenda non siano inferiori alle dimensioni del testo che deve essere visualizzatonella legenda. Se pertanto si posiziona il grafico in una cornice le cui dimensioni non sono sufficientie contenere il grafico e la legenda, quando il documento viene pubblicato il bordo della legendapotrebbe coincidere con il lato della cornice o essere tagliato dalla cornice.

Corda Builder consente di aggiungere forme alla progettazione di un modello di grafico (perinformazioni sulle forme, vedere la documentazione di Corda). Quando alcuni tipi di graficovengono pubblicati mediante xPression, nel grafico può apparire un’area bianca nel punto in cui eraposizionata la forma. Per evitare questo inconveniente, assicurarsi che l’opzione Tipo riempimentodi Impostazioni forma relativa alla forma sia deselezionata nel pannello Proprietà object di CordaBuilder.

Una volta creato, il modello di grafico deve essere memorizzato in un percorso accessibile a xPressofor Word. I modelli di grafico possono essere utilizzati più volte e in documenti diversi. Poiché i datipossono essere definiti e associati all’interno del documento, lo stesso modello può essere utilizzatoper mostrare numerosi set di dati diversi.

Supporto colore

In Corda Builder, i grafici vengono generati utilizzando i colori RGB. L’utilizzo dei colori CMYK odei colori campione in un modello di grafico è un processo complesso e deve essere tentato soloquando assolutamente necessario.

Sebbene l’uso di sfumature nel testo e nella grafica di xPresso for Word non sia supportato, è possibileutilizzare le sfumature nei grafici Corda. Sfumature circolari, ellittiche, da sinistra a destra, da destraa sinistra, dall’alto in basso e dal basso verso l’alto sono tutte supportate per i grafici nell’outputxPresso for Word.

In Corda Builder non sono supportati gli sfondi trasparenti. Per risolvere il problema, è possibileutilizzare un canvas colorato o includere un’immagine dietro al modello.

Formato data usato nei grafici

Il formato della data utilizzato nei grafici Corda viene stabilito al momento della creazione delmodello in Corda Builder. Una volta importato il modello, non è possibile modificare il formato deidati in xPresso for Word, a meno che il grafico non sia di tipo temporale. Pertanto, quando si importa

213

Page 214:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

un modello per un grafico diverso da quello di tipo temporale in un documento che verrà utilizzatoin un ambiente con impostazioni internazionali diverse da quelle per cui il modello è stato creato, ilformato della data potrebbe non essere corretto.

Inserimento di un elemento grafico dinamicoPer aggiungere un contenuto di grafico dinamico al modello, posizionare il cursore nel modello nellaposizione in cui si desidera visualizzare il grafico dinamico, quindi fare clic su Grafico dinamiconella scheda Progettazione di xPresso for Word della barra multifunzione di Word. Un elementografico dinamico viene visualizzato in Esplora modelli e un segnaposto del grafico dinamico vienevisualizzato sul canvas. È possibile rinominare il grafico tramite l’elenco a discesa dell’elemento inEsplora modelli.

Dopo avere aggiunto l’elemento grafico dinamico, sarà necessario importare un modello di grafico,quindi specificare i dati che devono essere utilizzati con il grafico.

Importazione di un modello di graficoDopo aver aggiunto un elemento grafico dinamico al modello, sarà necessario importare il modellodel grafico da utilizzare nel modello di documento. Se il modello di grafico è stato esportato da unaltro documento xPresso con la definizione dei dati, quando si importa il grafico, è possibile anchescegliere di importare la definizione dei dati.

Per importare un modello di grafico:

1. Fare clic sul menu a discesa dal Contenuto grafico in Esplora modelli, quindi selezionare Importagrafico.

2. Fare clic sul pulsante Sfoglia, quindi individuare e selezionare uno dei seguenti elementi:• Un modello immagine Corda (.itxml).

• Un modello di grafico xPresso (.zip).

• Un modello di grafico xPresso con una definizione dei dati (.zip).

Fare clic su Apri.

3. (Facoltativo) Fare clic su Con definizione dati per importare la definizione dei dati insiemeal modello di grafico. Questa opzione è disponibile solo se si seleziona un modello di graficoxPresso con una definizione dei dati (.zip).

4. Fare clic su OK.

Esportazione di un modello di graficoSe si desidera salvare un modello di grafico attualmente associato a un documento all’esternodi xPresso for Word in modo da poter essere condiviso con altri documenti, è possibile esportareil modello dal documento e salvarlo in una directory locale. Durante il processo di esportazione è

214

Page 215:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

possibile anche esportare la definizione dei dati insieme al modello se si esegue l’esportazione inun file xPresso DDG (.zip).

Per esportare un modello di grafico:

1. Fare clic sul menu a discesa dal Contenuto grafico in Esplora modelli, quindi selezionare Esportagrafico.

2. Selezionare la casella di controllo Con definizione dati per esportare la definizione dei dati insiemeal grafico. Lasciare la casella di controllo deselezionata se si desidera esportare solo il grafico.

3. Fare clic sul pulsante Sfoglia, passare alla directory in cui si desidera salvare il grafico esportatoe digitare un nome per il grafico.

4. Selezionare il tipo di file:• Un modello immagine Corda (.itxml). Questa opzione non è disponibile se è stata selezionatala casella di controllo Con definizione dati.

• xPresso DDG (.zip). Se si seleziona questa opzione, la casella di controllo Con definizione dativiene automaticamente selezionata.

5. Fare clic su Salva, quindi su OK.

Specifica della definizione dei datiLa definizione dei dati per un grafico in xPresso for Word specifica i dati dinamici da utilizzare conil grafico o modifica i dati statici definiti nel modello del grafico. Le opzioni di definizione di dativariano in base al tipo di grafico che viene utilizzato.

Nelle sezioni riportate di seguito viene descritto come definire i dati per ciascun tipo di graficosupportato.• Specifica dei dati per i grafici cumulativi, pagina 215

• Specifica dei dati per i grafici XY e temporali, pagina 217

• Specifica dei dati per i grafici indicatore, pagina 219

• Specifica dei dati per i grafici azionari, pagina 221

• Specifica dei dati per altri tipi di grafici, pagina 221

Specifica dei dati per i grafici cumulativi

Nei tipi di grafici cumulativi come i grafici a torta, piramide, ciambella e imbuto, i datimultidimensionali vengono visualizzati in proporzioni che permettono una migliore comprensionedei rapporti esistenti tra più porzioni di dati.

In Corda Builder sono disponibili più versioni diverse di grafici a torta, piramide, ciambella e imbuto.In xPresso for Word è possibile utilizzare grafici cumulativi con dati dinamici.

215

Page 216:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Specifica dei dati per il grafico a torta, a piramide, a imbuto o a ciambella

1. Fare clic sull’elenco a discesa per l’elemento grafico dinamico in Esplora modelli, quindiselezionare Definisci dati grafico. Viene visualizzata la finestra di dialogo Definizione dati.

2. Selezionare l’origine per il titolo del grafico.• Definizione grafico: xPression utilizza il titolo che è stato definito in Corda Builder per ilmodello di grafico.

• Valore letterale. Digitare il testo letterale da utilizzare per il titolo del grafico nella casella ditesto che diventa attiva accanto alla casella a discesa.

• Variabile valore singolo. Fare clic sul pulsante Sfoglia visualizzato accanto alla casella ditesto. Verrà visualizzata la finestra di dialogo Seleziona variabile. Selezionare l’elemento didati dello schema da utilizzare per fornire il titolo del grafico, quindi fare clic su OK.

3. Selezionare l’origine per i dati del grafico:• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare per fornireil primo punto dati del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi,quindi ripetere per ciascun punto dati. A partire dalla versione 4.5, gli array personalizzatinon sono più supportati. Non è possibile utilizzare gli array personalizzati per i grafici. Èpossibile invece specificare un array predefinito nel campo Variabile e utilizzare le espressionixPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona un elementodall’array predefinito per un punto dati, nella sezione Valore viene visualizzato solo il nomedell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valore vienevisualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilprimo punto dati del grafico nella casella di testo visualizzata nell’elenco. Fare di nuovo clicsu Aggiungi, quindi ripetere per ciascun punto dati.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il primo puntodati del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi, quindi ripetere perciascun punto dati.

4. Selezionare l’origine per i nomi sul grafico:• Definizione grafico: in xPression vengono utilizzati i nomi definiti in Corda Builder per ilmodello del grafico.

• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare perfornire il nome per il primo punto dati del grafico, quindi fare clic su OK. Fare di nuovo clicsu Aggiungi, quindi ripetere per ciascun punto dati. A partire dalla versione 4.5, gli arraypersonalizzati non sono più supportati. Non è possibile utilizzare gli array personalizzati peri grafici. È possibile invece specificare un array predefinito nel campo Variabile e utilizzarele espressioni xPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona unelemento dall’array predefinito per un punto dati, nella sezione Valore viene visualizzato solo

216

Page 217:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

il nome dell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valoreviene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilnome del primo punto dati del grafico nella casella di modifica visualizzata nell’elenco. Faredi nuovo clic su Aggiungi, quindi ripetere per ciascun punto dati.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il nome per ilprimo punto dati del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi, quindiripetere per ciascun punto dati.

5. Fare clic sulla scheda Avanzate.

6. Selezionare l’opzione di ordinamento per i dati nel grafico: Nessun ordinamento, Crescenteoppure Decrescente.

7. Selezionare l’opzione di filtro per i dati nel grafico:• Includi tutti i punti dati. Mantiene tutti i punti dati nel grafico, indipendentemente dalrelativo valore.

• Filtra dati inclusi. Filtra tutti i punti dati che rientrano in una percentuale specifica. Digitarela percentuale nella casella di testo.

• Filtra dati inferiori di. Filtra tutti i punti dati che rientrano in una quantità specifica. Digitarela quantità nella casella di testo.

• Limita punti dati a. Include nel grafico solo un numero specifico di punti dati. Digitare ilnumero di punti dati da includere nella casella di testo.

• Rimuovi dati filtrati. Rimuove completamente dal grafico tutti i dati filtrati. Questa opzionenon è disponibile se è selezionata l’opzione Includi tutti i punti dati.

• Combina dati filtrati. Combina tutti i dati filtrati in un singolo punto dati e lo include nelgrafico. Questa opzione non è disponibile se è selezionata l’opzione Includi tutti i punti dati.

• Etichetta per elementi filtrati. Assegna un’etichetta al punto dati filtrato combinato con iltesto digitato nella casella di testo. Questa opzione è disponibile solo se è stata selezionatal’opzione Combina dati filtrati.

8. Nella finestra di dialogo Definizione dati fare clic su OK.

Specifica dei dati per i grafici XY e temporali

In xPresso for Word è possibile utilizzare grafici a linee XY, a dispersione XY, a linee temporali e adispersione temporali con dati dinamici.

Specifica dei dati per il grafico a linea XY, a dispersione XY, a linea temporale o adispersione temporale

1. Fare clic sull’elenco a discesa per l’elemento grafico dinamico in Esplora modelli, quindiselezionare Definisci dati grafico. Viene visualizzata la finestra di dialogo Definizione dati.

217

Page 218:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

2. Selezionare l’origine per i dati della serie X:• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare perfornire il primo punto dati della serie X del grafico, quindi fare clic su OK. Fare di nuovo clicsu Aggiungi, quindi ripetere per ciascun punto dati. A partire dalla versione 4.5, gli arraypersonalizzati non sono più supportati. Non è possibile utilizzare gli array personalizzati peri grafici. È possibile invece specificare un array predefinito nel campo Variabile e utilizzarele espressioni xPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona unelemento dall’array predefinito per un punto dati, nella sezione Valore viene visualizzato soloil nome dell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valoreviene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilprimo punto dati della serie X del grafico nella casella di testo visualizzata nell’elenco. Fare dinuovo clic su Aggiungi, quindi ripetere per ciascun punto dati.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il primo puntodati della serie X del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi, quindiripetere per ciascun punto dati.

3. Selezionare l’origine per la serie di dati Y, quindi fare clic su Aggiungi. Se si seleziona:• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare perfornire il primo punto dati della serie Y del grafico, quindi fare clic su OK. Fare di nuovo clicsu Aggiungi, quindi ripetere per ciascun punto dati. A partire dalla versione 4.5, gli arraypersonalizzati non sono più supportati. Non è possibile utilizzare gli array personalizzati peri grafici. È possibile invece specificare un array predefinito nel campo Variabile e utilizzarele espressioni xPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona unelemento dall’array predefinito per un punto dati, nella sezione Valore viene visualizzato soloil nome dell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valoreviene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilprimo punto dati della serie Y del grafico nella casella di testo visualizzata nell’elenco. Fare dinuovo clic su Aggiungi, quindi ripetere per ciascun punto dati.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il primo puntodati della serie Y del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi, quindiripetere per ciascun punto dati.

218

Page 219:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

4. Selezionare l’origine per le etichette della serie, quindi fare clic su Aggiungi. Se si seleziona:• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare perfornire la prima etichetta della serie del grafico, quindi fare clic su OK. Fare di nuovo clicsu Aggiungi, quindi ripetere per ciascun punto dati. A partire dalla versione 4.5, gli arraypersonalizzati non sono più supportati. Non è possibile utilizzare gli array personalizzati peri grafici. È possibile invece specificare un array predefinito nel campo Variabile e utilizzarele espressioni xPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona unelemento dall’array predefinito per un punto dati, nella sezione Valore viene visualizzato soloil nome dell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valoreviene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per laprima etichetta della serie del grafico nella casella di testo visualizzata nell’elenco. Fare dinuovo clic su Aggiungi, quindi ripetere per ciascun punto dati.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire la primaetichetta della serie del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi, quindiripetere per ciascun punto dati.

5. Nella finestra di dialogo Definizione dati fare clic su OK.

Specifica dei dati per i grafici indicatore

In Corda Builder sono disponibili vari tipi di grafici indicatore differenti. In xPresso for Word èpossibile utilizzare ognuno di questi tipi di grafici con dati dinamici.

Specifica dei dati per un grafico indicatore

1. Fare clic sull’elenco a discesa per l’elemento grafico dinamico in Esplora modelli, quindiselezionare Definisci dati grafico. Viene visualizzata la finestra di dialogo Definizione dati.

2. Selezionare l’origine per il valore del grafico indicatore:• Definizione grafico: xPression utilizza il valore che è stato definito in Corda Builder per ilmodello di grafico.

• Valore letterale. Immettere il testo del valore letterale da utilizzare per il valore nella caselladi testo che diventa attiva accanto alla casella a discesa.

• Valore variabile singolo. Fare clic sul pulsante Sfoglia visualizzato accanto alla casella ditesto. Verrà visualizzata la finestra di dialogo Inserisci variabile. Selezionare la variabile chesi desidera utilizzare per fornire il valore e fare clic su OK.

219

Page 220:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

3. Selezionare l’origine per i dati dell’intervallo minimo:• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

• Variabile valore ripetuto. Fare clic sul pulsante Sfoglia accanto alla casella di testo visualizzatanell’elenco. Verrà visualizzata la finestra di dialogo Inserisci variabile. Selezionare l’elementodi dati dello schema padre ripetibile da utilizzare per fornire i punti dati dell’intervallominimo del grafico, quindi fare clic suOK. A partire dalla versione 4.5, gli array personalizzatinon sono più supportati. Non è possibile utilizzare gli array personalizzati per i grafici. Èpossibile invece specificare un array predefinito nel campo Variabile e utilizzare le espressionixPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona un elementodall’array predefinito per un punto dati, nella sezione Valore viene visualizzato solo il nomedell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valore vienevisualizzato il valore xPath.

• Valore letterale. Immettere il testo del valore letterale da utilizzare per i dati dell’intervallominimo nelle caselle di testo che diventano attive nell’elenco.

• Variabile valore singolo. Fare clic sul pulsante Sfoglia accanto a una delle caselle di testovisualizzate nell’elenco. Verrà visualizzata la finestra di dialogo Inserisci variabile. Selezionarel’elemento di dati dello schema da utilizzare per fornire il primo punto dati dell’intervallominimo del grafico, quindi fare clic su OK. Ripetere per tutti i valori dei dati che si desideraaggiungere.

4. Selezionare l’origine per i dati dell’intervallo massimo:• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

• Variabile valore ripetuto. Fare clic sul pulsante Sfoglia accanto alla casella di testovisualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inserisci variabile.Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare per fornire i puntidati dell’intervallo massimo del grafico, quindi fare clic su OK. A partire dalla versione4.5, gli array personalizzati non sono più supportati. Non è possibile utilizzare gli arraypersonalizzati per i grafici. È possibile invece specificare un array predefinito nel campoVariabile e utilizzare le espressioni xPath per l’array. Dopo aver impostato l’array predefinito,se si seleziona un elemento dall’array predefinito per un punto dati, nella sezione Valore vienevisualizzato solo il nome dell’elemento. Se si seleziona un elemento da un array diverso, nellasezione Valore viene visualizzato il valore xPath.

• Valore letterale. Immettere il testo del valore letterale da utilizzare per i dati dell’intervallomassimo nelle caselle di testo che diventano attive nell’elenco.

• Variabile valore singolo. Fare clic sul pulsante Sfoglia accanto a una delle caselle di testovisualizzate nell’elenco. Verrà visualizzata la finestra di dialogo Inserisci variabile. Selezionarel’elemento di dati dello schema da utilizzare per fornire il primo punto dati dell’intervallomassimo del grafico, quindi fare clic su OK. Ripetere per tutti i valori dei dati che si desideraaggiungere.

5. Nella finestra di dialogo Definizione dati fare clic su OK.

Nota: Il numero di intervalli di dati definiti in xPresso for Word deve essere uguale al numero diintervalli di dati definiti in Corda Builder, in caso contrario verranno utilizzati gli intervalli di datidefiniti in Corda Builder.

220

Page 221:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Specifica dei dati per i grafici azionari

In Corda Builder sono disponibili vari tipi di grafici azionari differenti. In xPresso for Word èpossibile utilizzare ciascuno di questi tipi di grafici con dati dinamici.

Nota: Non è possibile specificare l’origine per il nome della serie di un grafico azionario. In xPressionviene utilizzato sempre il nome della serie definito in Corda Builder per il modello del grafico.

Specifica dei dati per un grafico azionario

1. Fare clic sull’elenco a discesa per l’elemento grafico dinamico in Esplora modelli, quindiselezionare Definisci dati grafico. Viene visualizzata la finestra di dialogo Definizione dati.

2. Fare clic sul pulsante Sfoglia accanto alla casella di testo Data. Verrà visualizzata la finestra didialogo Inserisci variabile. Selezionare l’elemento array che si desidera utilizzare per fornire ilvalore della data e fare clic su OK.

3. Fare clic sul pulsante Sfoglia accanto alla casella di testo Max. Verrà visualizzata la finestra didialogo Inserisci variabile. Selezionare l’elemento array che si desidera utilizzare per fornire ilvalore massimo e fare clic su OK.

4. Fare clic sul pulsante Sfoglia accanto alla casella di testo Min. Verrà visualizzata la finestra didialogo Inserisci variabile. Selezionare l’elemento array che si desidera utilizzare per fornireil valore minimo e fare clic su OK.

5. Fare clic sul pulsante Sfoglia accanto alla casella di testo Chiudi. Verrà visualizzata la finestra didialogo Inserisci variabile. Selezionare l’elemento array che si desidera utilizzare per fornire ilvalore di chiusura e fare clic su OK.

6. Fare clic sul pulsante Sfoglia accanto alla casella di testo Apri. Verrà visualizzata la finestra didialogo Inserisci variabile. Selezionare l’elemento array che si desidera utilizzare per fornire ilvalore di apertura e fare clic su OK.

7. Nella finestra di dialogo Definizione dati fare clic su OK.

Specifica dei dati per altri tipi di grafici

In Corda Builder sono disponibili vari tipi di grafici, ad area, cartesiano, a barre, heat-map, di Pareto oa radar. In xPresso for Word è possibile utilizzare ciascuno di questi tipi di grafici con dati dinamici.

Specifica dei dati per il grafico ad area, cartesiano, a barre, heat-map, di Pareto o aradar

1. Fare clic sull’elenco a discesa per l’elemento grafico dinamico in Esplora modelli, quindiselezionare Definisci dati grafico. Viene visualizzata la finestra di dialogo Definizione dati.

2. Selezionare l’origine per i dati della categoria:• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare per forniretutti i punti dati della categoria del grafico, quindi fare clic su OK. A partire dalla versione4.5, gli array personalizzati non sono più supportati. Non è possibile utilizzare gli array

221

Page 222:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

personalizzati per i grafici. È possibile invece specificare un array predefinito nel campoVariabile e utilizzare le espressioni xPath per l’array. Dopo aver impostato l’array predefinito,se si seleziona un elemento dall’array predefinito per un punto dati, nella sezione Valore vienevisualizzato solo il nome dell’elemento. Se si seleziona un elemento da un array diverso, nellasezione Valore viene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilprimo punto dati della categoria del grafico nella casella di testo visualizzata nell’elenco. Faredi nuovo clic su Aggiungi, quindi ripetere per ciascun punto dati.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il primo puntodati della categoria del grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi, quindiripetere per ciascun punto dati.

• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

3. Selezionare un’origine di nomi di categoria nel grafico:• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare per forniretutti i nomi della categoria per il grafico, quindi fare clic su OK. A partire dalla versione4.5, gli array personalizzati non sono più supportati. Non è possibile utilizzare gli arraypersonalizzati per i grafici. È possibile invece specificare un array predefinito nel campoVariabile e utilizzare le espressioni xPath per l’array. Dopo aver impostato l’array predefinito,se si seleziona un elemento dall’array predefinito per un punto dati, nella sezione Valore vienevisualizzato solo il nome dell’elemento. Se si seleziona un elemento da un array diverso, nellasezione Valore viene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilprimo nome della categoria del grafico nella casella di testo visualizzata nell’elenco. Fare dinuovo clic su Aggiungi e ripetere per ciascun nome di categoria.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il primo nomedella categoria per il grafico, quindi fare clic su OK. Fare di nuovo clic su Aggiungi e ripetereper ciascun nome di categoria.

• Definizione grafico: xPression utilizza i dati che sono stati definiti in Corda Builder per ilmodello di grafico.

4. Selezionare l’origine del nome della serie:• Variabile valore ripetuto. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema padre ripetibile da utilizzare perfornire il nome della serie, quindi fare clic su OK. A partire dalla versione 4.5, gli arraypersonalizzati non sono più supportati. Non è possibile utilizzare gli array personalizzati peri grafici. È possibile invece specificare un array predefinito nel campo Variabile e utilizzarele espressioni xPath per l’array. Dopo aver impostato l’array predefinito, se si seleziona unelemento dall’array predefinito per un punto dati, nella sezione Valore viene visualizzato solo

222

Page 223:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

il nome dell’elemento. Se si seleziona un elemento da un array diverso, nella sezione Valoreviene visualizzato il valore xPath.

• Valore letterale. Fare clic su Aggiungi, quindi digitare il testo letterale da utilizzare per ilnome della serie nella casella di testo visualizzata nell’elenco.

• Variabile valore singolo. Fare clic su Aggiungi, quindi sul pulsante Sfoglia accanto allacasella di testo visualizzata nell’elenco. Verrà visualizzata la finestra di dialogo Inseriscivariabile. Selezionare l’elemento di dati dello schema da utilizzare per fornire il nome dellaserie, quindi fare clic su OK.

• Definizione grafico: xPression utilizza il nome della serie che è stato definito in Corda Builderper il modello di grafico.

5. Nella finestra di dialogo Definizione dati fare clic su OK.

Aggiunta di testo alternativo a grafici dinamiciÈ possibile pubblicare un documento PDF/UA con xPression. Per abilitare l’accessibilità dei grafici, èpossibile aggiungere del testo alternativo durante la progettazione.

Per impostazione predefinita, nei grafici dinamici in un output PDF/UA non viene specificato alcuntesto alternativo; di conseguenza, i grafici sono contrassegnati come artefatti. Per una panoramica sultipo di output PDF/UA, consultare la guida all’elaborazione dell’output PDF/UA.

Nota: xPresso considera i grafici di Microsoft Word che sono stati inseriti facendo clic su Inserisci >Grafico dalla barra multifunzione di Word come immagini statiche. È possibile inoltre aggiungervidel testo alternativo e visualizzarlo nell’output PDF/UA. Per ulteriori istruzioni su come aggiungeredel testo alternativo alle immagini statiche, consultare Aggiunta di testo alternativo alle immagini,pagina 169.

Aggiunta di testo alternativo a un grafico dinamico

1. In un documento xPresso for Word, selezionare il grafico a cui aggiungere del testo alternativo.

2. Dalla scheda Progettazione di xPresso for Word della barra multifunzione di Word, fare clicsul pulsante Testo alternativo nella sezione Opzioni. Viene visualizzata la finestra di dialogoImpostazione testo alternativo. È inoltre possibile aprire questa finestra di dialogo nei seguentimodi:• Fare clic con il pulsante destro del mouse sul grafico e selezionare xWord Designer > Impostatesto alternativo.

• Fare clic sul menu a discesa in Esplora modelli e selezionare Imposta testo alternativo.

3. Nell’elenco Impostazioni locali, selezionare la lingua del testo alternativo.

4. Digitare il testo alternativo nella casella Descrizione. Il testo alternativo non deve superare 32768caratteri. È possibile inoltre aggiungere delle variabili facendo clic sull’icona Scegli variabile adestra della casella Descrizione e specificando le variabili nella finestra di dialogo visualizzata.

5. Fare clic su OK.

223

Page 224:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di grafici dinamici

Suggerimento: Per visualizzare il testo alternativo impostato, aprire di nuovo la finestra di dialogoImpostazione testo alternativo. È possibile inoltre visualizzare il testo alternativo in Esplora modelliselezionando Proprietà dal menu a discesa.

224

Page 225:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 12Impostazione di artefatti per idocumenti PDF/UA

xPresso for Word consente di progettare documenti per un output PDF/UA. In un documentoPDF/UA, i contenuti che non contribuiscono al contenuto principale del documento (ad esempio inumeri di pagina) vengono contrassegnati come artefatti e non verranno letti dai lettori conformi.È facoltativamente possibile specificare i paragrafi come artefatti in xPresso for Word. Per ulterioriinformazioni sul tipo di output PDF/UA, consultare la guida all’elaborazione dell’output di xPublish.

In questo capitolo vengono trattati gli argomenti seguenti:• Impostazione dei paragrafi come artefatti, pagina 225

• Impostazione dei paragrafi secondari come artefatti, pagina 226

• Visualizzazione degli artefatti paragrafo nel documento, pagina 227

• Rimozione delle impostazioni degli artefatti paragrafo, pagina 227

Impostazione dei paragrafi come artefattixPression contrassegna automaticamente intestazioni e piè di pagina, immagini senza testo alternativoe grafici della pagina come artefatti. Con xPresso for Word, è possibile impostare facoltativamente iparagrafi come artefatti, come i paragrafi nelle celle di tabella e le istanze di contenuto.

Se si imposta un paragrafo come artefatto, le immagini, i collegamenti ipertestuali e i controllimodulo al suo interno diventano automaticamente artefatti, anche quando è stato impostato deltesto alternativo o delle descrizioni di comando.

Consultare le seguenti indicazioni durante l’impostazione degli artefatti:• L’impostazione dell’artefatto non può essere copiata o incollata e può essere rimossa durantel’eliminazione del testo del paragrafo. Per evitare la perdita delle impostazioni degli artefatti,impostare gli artefatti dopo aver completato il modello.

• I paragrafi senza alcun contenuto non possono essere impostati come artefatti.

• In alcuni scenari, l’utente potrebbe avere bisogno che una parte del paragrafo non venga lettada un lettore conforme, ad esempio i caratteri speciali come i puntini di sospensione (...) e gliasterischi (*) utilizzati per separare il contenuto e non per trasmettere informazioni. In questi casi,è possibile includere il contenuto senza significato nella cella di una tabella e impostare questacella come artefatto.

225

Page 226:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Impostazione di artefatti per i documenti PDF/UA

• Per impostare gli artefatti nel contenuto riutilizzabile o nel contenuto universale, accertarsi che leimpostazioni vengano eseguite separatamente nei documenti con riferimenti.

• Se un paragrafo artefatto contiene dei collegamenti ipertestuali o dei controlli modulo, l’outputPDF/UA potrebbe non essere riconosciuto come valido dagli strumenti di convalida PDF/UA.Per superare la convalida, è necessario che i sommari non siano impostati come artefatti e che iparagrafi non siano impostati come artefatti quando contengono collegamenti. Inoltre, se si stacreando un PDF/UA compilabile, è necessario che i paragrafi non siano impostati come artefattiquando contengono controlli modulo.

• Se un paragrafo è impostato come artefatto, il contenuto universale inline o il contenutoriutilizzabile all’interno di un paragrafo erediterà l’impostazione dell’artefatto; tuttavia, gli altritipi di contenuto universale o contenuto riutilizzabile non la erediteranno.

• Quando si inserisce un pacchetto di xPresso for Word come contenuto universale all’inizio di unparagrafo vuoto con le opzioniA partire da > Nuovo paragrafo ed Escludi interruzioni di sezionedi UC e utilizza la definizione di sezione del documento principale corrente selezionate, nonchéquando il contenuto universale è composto da un solo un paragrafo, l’impostazione dell’artefattosul paragrafo principale potrebbe generare un output non corretto. Per risolvere questo problema,aggiungere uno spazio dopo il contenuto universale nel paragrafo principale, in modo da rendereil contenuto universale inline ed ereditare l’impostazione dell’artefatto del paragrafo principale.

Impostazione di un paragrafo come artefatto

1. Nel documento di xPresso, fare clic in qualsiasi punto del paragrafo che si desidera impostarecome artefatto.

Suggerimento: è possibile inoltre impostare più paragrafi come artefatti selezionandoli. Perimpostare tutti i paragrafi di una tabella o di un’istanza di contenuto come artefatti, selezionarel’intera tabella o istanza di contenuto.

2. Dalla barra multifunzione di Word, selezionare Progettazione di xPresso for Word > sezioneOpzioni > Artifact paragrafo. Viene visualizzata la finestra di dialogo Artifact paragrafo.

3. Accertarsi che la casella di controllo Impostare il paragrafo come artefatto nell’output PDF/UAsia selezionata e fare clic su OK.

Impostazione dei paragrafi secondari comeartefattiSe gruppi di contenuti vengono impostati come Artefatto, verranno visualizzati nella struttura adalbero di Esplora progettazione quando il filtro è Artefatto.

Impostazione di un paragrafo secondario come artefatto

1. Nel documento di xPresso selezionare il testo che si desidera impostare come artefatto.

2. Nella barra multifunzione di Word fare clic su Gruppo di contenuti.

3. In Esplora modelli fare clic su Gruppo di contenuti > Artefatto.

Nota: Tutto il contenuto (ad esempio, il contenuto universale, il contenuto riutilizzabile) in un gruppodi contenuti artefatto diventerà un artefatto.

226

Page 227:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Impostazione di artefatti per i documenti PDF/UA

Visualizzazione degli artefatti paragrafo neldocumentoÈ possibile visualizzare gli artefatti paragrafo impostati nel documento. Fare clic in qualsiasi puntodel documento e selezionare Progettazione di xPresso for Word > sezione Opzioni > Artifactparagrafo per aprire la finestra di dialogo Artifact paragrafo. Fare clic sul pulsante Precedente oSuccessivo per cercare gli artefatti paragrafo impostati. Se nessuno dei due pulsanti è disponibile ela casella di controllo Impostare il paragrafo come artefatto nell’output PDF/UA è selezionata, ilparagrafo corrente è il solo artefatto paragrafo del documento.

Quando si utilizza il pulsante Precedente o Successivo per cercare gli artefatti paragrafo neldocumento, non è possibile cercare i seguenti elementi:• Istanze di contenuto non attualmente selezionate in un gruppo di contenuti

• Contenuto universale

• Contenuto riutilizzabile

Se si deseleziona il contrassegno di artefatto per il gruppo di contenuti, e non esiste alcun artefatto nelfiltro, xPresso for Word mostrerà tutti i filtri ed espanderà tutto il contenuto dinamico.

Rimozione delle impostazioni degli artefattiparagrafoPer rimuovere le impostazioni degli artefatti paragrafo, completare i passaggi seguenti:

1. Selezionare i paragrafi per cui rimuovere le impostazioni degli artefatti.

2. Dalla barra multifunzione di Word, selezionare Progettazione di xPresso for Word > sezioneOpzioni > Artifact paragrafo. Viene visualizzata la finestra di dialogo Artifact paragrafo.

3. Accertarsi che la casella di controllo Impostare il paragrafo come artefatto nell’output PDF/UAsia deselezionata e fare clic su OK.

Nota: Per eliminare un paragrafo impostato come artefatto, è necessario prima rimuoverel’impostazione dell’artefatto. In caso contrario, l’impostazione dell’artefatto potrebbe venire estesa alparagrafo che segue quello eliminato.

227

Page 228:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Impostazione di artefatti per i documenti PDF/UA

228

Page 229:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 13Verifiche e controlli dei modelli

Una volta completato lo sviluppo del modello, è possibile verificarlo e controllarlo nel server. Lapubblicazione di documenti viene eseguita sul server di xPression. È possibile ottenere un’anteprimaPDF sul computer client xPresso for Word. Una volta salvato il documento sul server, è possibileprodurre output AFP, DOCX, HTML, PostScript, PDF, PPML e TIFF tramite xDashboard.

In questo capitolo vengono descritte le seguenti opzioni di output del documento:• Informazioni di diagnostica, pagina 229

• Analisi di impatto, pagina 230

• Verifica del modello, pagina 230

• Archiviazione di un modello, pagina 232

Informazioni di diagnosticaxPresso for Word fornisce una posizione centrale in cui è possibile accedere ai file di registro, nonchéraccogliere i file di registro che potrebbe essere necessario inviare al supporto tecnico di EMCDocument Sciences se si riscontrano problemi con un documento.

L’area Risorse di diagnostica viene visualizzata nella sezione in basso a destra della pagina dibackstage di xPresso (File > xPresso) e contiene i seguenti collegamenti:• Registro di Progettazione di Xpresso for Word. Apre il file xWordDesigner.log inun visualizzatore. Il file xWordDesigner.log contiene informazioni sulle operazioni eseguite daxPresso for Word. È possibile effettuare una ricerca nel file di registro facendo clic su Trova edigitando una stringa di ricerca nella casella visualizzata.

• Registro Assemblaggio sfondo. Apre il file xPresso.log in un visualizzatore. Il filexPresso.log contiene informazioni sulle operazioni eseguite dal Server xPression. È possibileeffettuare una ricerca nel file di registro facendo clic su Trova e digitando una stringa di ricercanella casella visualizzata.

• Raccogli file diagnostici. Crea un file compresso che contiene sia il file xWordDesigner.log che il file xPresso.log e lo salva nella directory C:\Utenti[utente]\AppData\Roaming\EMCDocument Sciences\xWord Designer\Work\Temp.

229

Page 230:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

Analisi di impattoxPresso for Word consente di determinare i documenti o gli altri contenuti che verrebbero coinvoltidalla modifica di una parte del contenuto. Nell’analisi di impatto vengono visualizzati gli altricontenuti collegati all’elemento, inclusi nell’elemento o ai quali l’elemento è collegato. Ciò consentedi comprendere esattamente l’impatto di una parte specifica del contenuto o di una versione delcontenuto sugli altri contenuti.

Per eseguire l’analisi di impatto, fare clic sul menu a discesa per l’elemento in Esplora modelli, quindiselezionare Analisi di impatto. L’opzione Analisi di impatto è disponibile nei menu per il contenutouniversale e nei contenuti riutilizzabili contenuti nei modelli principali e del dashboard ECM.

Nota: L’analisi di impatto non è applicabile ai documenti non archiviati.

Nella finestra di dialogo Analisi di impatto sono visualizzate le rappresentazioni visive deicollegamenti tra l’elemento selezionato e gli altri documenti. Nella finestra di dialogo è possibileeseguire le seguenti operazioni:• Modificare il tipo di visualizzazione: Mappa o Diagramma.

• Modificare il layout di visualizzazione: Visualizzazione estesa, Dall’alto verso il basso, Dal bassoverso l’alto, Da sinistra a destra, Da destra a sinistra.

• Modificare lo zoom di visualizzazione.

• Ripristinare le impostazioni predefinite di visualizzazione.

• Selezionare un numero di versione differente per un elemento di contenuto universale o dicontenuto riutilizzabile per vederne l’uso.

• Salvare l’immagine in un file di immagine, salvare i dati in un file di testo oppure stamparel’immagine o i dati. È possibile salvare o stampare l’immagine solo quando il fattore di zoom divisualizzazione è inferiore al 100%.

Nota: Le informazioni sui documenti xDesign non sono visualizzate nella finestra di dialogo Analisidi impatto.

Verifica del modelloxPresso for Word consente di verificare il modello, nonché i criteri e i dati utilizzati in esso, e digenerare l’anteprima dell’output. In questo modo è possibile assicurarsi che le configurazioni delmodello produrranno il risultato desiderato quando verrà pubblicato il modello.

Sono disponibili varie modalità di verifica e di visualizzazione di anteprima del modello, in base allefunzioni di output utilizzate. Per scegliere una modalità, fare clic suModalità nella sezione Verifica evisualizza anteprima della scheda Progettazione di xPresso for Word, quindi selezionare:• Dati per verificare i criteri del contenuto dinamico e le variabili contenute nel modello.

• Canali per verificare il canale di output e l’impostazione di regione del modello.

• Selezioni rapide per verificare la logica di selezione rapida definita nel modello.

Viene visualizzato Esplora modelli del visualizzatore anteprima EMC per ciascuna modalità.Vengono visualizzate le funzioni di navigazione di Esplora modelli per ciascuna modalità, ma i

230

Page 231:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

dettagli di anteprima sono differenti in base alla modalità. Esplora modelli consente di passareda una modalità disponibile all’altra.

Verifica dei dati campione

Tenere presente le seguenti considerazioni quando si applicano dati al documento:• La funzione “applica dati” non funziona se il documento contiene immagini statiche TIF o unavariabile di immagine che fa riferimento a un’immagine TIF o a contenuto universale TIF. Pervisualizzare l’anteprima, utilizzare l’anteprima PDF.

• L’applicazione di dati non è supportata per il contenuto universale inline. Il contenuto universaleinline non è visualizzato quando vengono applicati i dati.

• Se vengono applicati dati a un documento, l’impostazione Collegamento a precedente perintestazioni e piè di pagina viene rimosso. Per evitare problemi di modifica delle intestazioni e deipiè di pagina, configurare l’impostazione Collegamento a precedente dopo l’applicazione dei dati.

• Quando si applicano dati al documento, in xPresso for Word non vengono visualizzati i risultatidei calcoli del subtotale. I subtotali possono essere visualizzati in modalità di anteprima.

La modalità dei dati campione consente di verificare i criteri e le variabili nel canvas per un recordcliente specifico. È inoltre possibile creare un file di output di anteprima per il record selezionato chepuò essere utilizzato anche per verificare un canale.

Per verificare i dati nel canvas, selezionare un file di dati, quindi selezionare un record cliente. Èpossibile utilizzare i pulsanti Precedente e Successivo per trovare un record cliente oppure fare clicsull’elenco a discesa per selezionarne uno. Il contenuto del modello nel canvas viene aggiornato pervisualizzare l’output per il record selezionato.

È possibile creare un file di output di anteprima per verificare come apparirà il contenuto del modellonell’output pubblicato. L’output è in formato PDF a meno che non si sia selezionato un canalespecifico nelle opzioni Canali per l’anteprima. In questo caso l’output viene definito dal canale (PDF,HTML o testo). Per ulteriori informazioni, vedere Verifica dei canali, pagina 231.

Verifica dei canali

La modalità Canali consente di verificare il canale del modello e l’impostazione di regione delmodello. Quando si seleziona un canale da verificare, il canvas viene aggiornato per consentire divisualizzare il contenuto corretto per il canale. Il contenuto corretto deve essere costituito da tutte leregioni del modello definite per il canale selezionato. Qualsiasi regione definita solo per altri canalinon dovrebbe essere visualizzata nel canvas. Se si fa clic su Elimina per la selezione del canale,viene ripristinata l’impostazione <qualsiasi>.

È inoltre possibile creare un file di output di anteprima per verificare il canale durante lapubblicazione. Fare clic sulla modalità Dati campione per visualizzare le opzioni di anteprima conle opzioni relative al canale. Selezionare un canale, quindi fare clic su Anteprima. Il tipo di outputviene determinato dal canale selezionato: PDF, HTML o testo. I file di output di anteprima generatimediante i canali vengono pubblicati tramite il server anziché il client. Tutte le risorse esterne devonoessere disponibili nel server, altrimenti non saranno visualizzabili nell’output di anteprima. Se non si

231

Page 232:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

esegue l’accesso al server, è possibile eseguire la verifica dei dati sul canvas ma non è possibilegenerare l’output di anteprima.

Verifica delle selezioni rapide

La modalità Selezioni rapide consente di verificare le varianti di contenuto del modello utilizzandovari valori di selezione rapida. Se si seleziona un valore per ciascuna selezione rapida, il canvas vieneaggiornato per consentire di visualizzare il contenuto corretto per le selezioni di valori. Se si fa clic suElimina per una selezione rapida, viene ripristinato il valore <qualsiasi>.

Archiviazione di un modelloDopo aver creato un nuovo modello o aver apportato modifiche a un modello estratto, è necessarioarchiviare il modello nel server. Una volta archiviato nel server, il modello è disponibile per esserevisualizzato o modificato da altri utenti o per essere pubblicato.

Se si desidera lasciare aperta una copia del modello dopo l’archiviazione, utilizzare l’opzioneConserva file estratti nella finestra di dialogo di archiviazione. In questo modo è possibile continuarea utilizzare il documento conservandone una copia di sicurezza. Se non si seleziona l’opzioneConserva file estratti, la copia locale del modello viene rimossa durante il processo di archiviazione.

Il processo di archiviazione è diverso in base al repository utilizzato per l’archiviazione: RepositoryxPression oppure Repository xPression Documentum.

Nota: Assicurarsi di aver selezionato il repository corretto nell’opzione Repository dei contenuti diConnessione server nella pagina di backstage di xPresso.

Nota: Se si desidera salvare un modello dal server nel disco locale con un nome diverso, utilizzare ilmenu Salva con nome (File > Salva con nome) da MS Word. Non rinominare il modello da Esplorarisorse. In caso contrario, si verificherà un errore la volta successiva in cui si accede al server e si apreil modello poiché verrà controllato l’URL del server. In tal caso, è possibile disconnettersi dal server,aprire il modello e salvarlo con un nome diverso.

Archiviazione nel repository xPression

È possibile archiviare un modello nel server dalla pagina di backstage di xPresso o da Esplora modelli.

Quando si archivia un modello, il numero di versione viene selezionato automaticamente. Per idocumenti nuovi, viene sempre applicata la versione 1.0. Per i documenti esistenti, viene applicata laversione minore successiva e se non è disponibile (già in uso nel sistema), viene creata una nuovaversione derivata. Per ulteriori informazioni, vedere Definizione delle versioni del repositoryxPression, pagina 23.

Nota: assicurarsi di aver selezionato xPression nell’opzione CR dell’area Opzioni della schedaProgettazione di xPresso for Word della barra multifunzione di Word oppure l’opzione Repositorydei contenuti di Connessione server nella pagina di backstage di xPresso.

232

Page 233:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

Per archiviare un modello:

1. Visualizzare la pagina di backstage di xPresso (File > xPresso)oppure Esplora modelli.

2. Nella pagina di backstage, fare clic su Archivia documento attivo.In Esplora modelli, fare clic sul menu a discesa per la radice modello e selezionare Aggiungi alserver (per un documento nuovo) oppure Archivia (per un documento esistente).

3. Fare clic su Seleziona posizione server e selezionare la categoria, se si tratta di un nuovo modello.Se si tratta di un modello esistente, la categoria è già selezionata e non è possibile modificarla.

4. (Facoltativo) Aggiungere un commento da associare all’archiviazione di questo modello (finoa 255 caratteri).

5. (Facoltativo) Deselezionare la casella di controllo Conserva file estratti per chiudere il documentonel client. Lasciarla selezionata se si desidera mantenere aperto il documento nel client perapportare ulteriori modifiche.

6. Fare clic su OK.

Archiviazione nel repository xPression Documentum

È possibile archiviare un modello nel server dalla pagina di backstage di xPresso o da Esploramodelli. Il processo di archiviazione varia leggermente a seconda che venga eseguita l’archiviazionedi un nuovo documento o di un documento modificato.

Archiviazione di un nuovo documento

Quando si archivia un nuovo documento nel repository xPression Documentum, è necessariodeterminare il percorso del server in cui memorizzarlo, nonché specificare il nome del documento.

Nota: assicurarsi di aver selezionato Documentum nell’opzione CR dell’area Opzioni della schedaProgettazione di xPresso for Word della barra multifunzione di Word oppure l’opzione Repositorydei contenuti di Connessione server nella pagina di backstage di xPresso.

Per archiviare un nuovo documento:

1. Visualizzare la pagina di backstage di xPresso (File > xPresso)oppure Esplora modelli.

2. Nella pagina di backstage fare clic su Aggiungi documento a repository ECM.In Esplora modelli, fare clic sul menu a discesa per la radice modello e selezionare Archivia.

3. Selezionare Repository xPression Documentum dall’elenco a discesa Server corrente.

4. Individuare e selezionare il percorso del server in cui memorizzare il file.

5. Digitare un nome per il file, inclusa l’estensione (.xword). Il tipo di file sarà un pacchetto didocumenti, poiché tutti i documenti vengono compressi prima di essere inseriti nel server. Se nonsi riesce a includere l’estensione, si possono verificare problemi quando si cerca di archiviare undocumento da un altro strumento di progettazione xPresso con lo stesso nome.

6. Fare clic su Archivia. Al termine del processo di archiviazione, xPresso for Word chiudeautomaticamente il documento.

233

Page 234:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

Archiviazione di un documento modificato

Quando si archivia un documento nel repository xPression Documentum precedentemente estratto emodificato, è necessario selezionare un numero di versione per la copia modificata del documento.Non sarà necessario specificare il nome del documento o il percorso del server in cui memorizzarlo,poiché queste informazioni saranno uguali a quelle riportate quando il documento è stato estratto.

Nota: Assicurarsi di aver selezionato Documentum nell’opzione CR dell’area Opzioni della schedaProgettazione di xPresso for Word della barra multifunzione di Word oppure l’opzione Repositorydei contenuti di Connessione server nella pagina di backstage di xPresso.

Per archiviare un documento modificato:

1. Visualizzare la pagina di backstage di xPresso (File > xPresso)oppure Esplora modelli.

2. Nella pagina di backstage, fare clic su Archivia documento attivo.In Esplora modelli, fare clic sul menu a discesa per la radice modello e selezionare Archivia.Verrà visualizzata la finestra di dialogo Imposta versione.

3. Selezionare la versione del modello: stessa versione, nuova versione minore o nuova versioneprincipale.

4. Fare clic su OK. Al termine del processo di archiviazione, xPresso for Word chiudeautomaticamente il documento.

Problemi con l’archiviazione di documenti

Se si esegue xPresso for Word su una virtual machine, quando si archivia un documento, xPresso forWord potrebbe arrestarsi in modo anomalo. Per evitare il problema dell’arresto anomalo, aprire undocumento di xPresso for Word, fare clic su File > Info, quindi su Proprietà > Proprietà avanzate eselezionare Salva miniature per tutti i documenti Word nella scheda Riepilogo.

Dopo aver archiviato un documento, i valori Archiviato da di tutte le versioni dei documentiprecedenti vengono modificati e impostati sull’utente corrente. Ad esempio, se si archivia la versione1.0 come Utente 1 e poi la versione 1.1 come Utente 2, il valore Archiviato da della versione 1.0cambia e diventa Utente 2.

Modelli di assemblaggioI modelli di assemblaggio raggruppano tutti gli elementi necessari per creare un documentoxPresso in un unico file. Quando si archivia un documento sul server, il documento viene inseritoautomaticamente in un pacchetto (assemblato) sul server. È inoltre possibile assemblare il documentoe salvarlo sul disco locale come indicato di seguito.

1. Visualizzare la pagina di backstage di xPresso (File > xPresso).

2. Nella pagina di backstage fare clic su Esporta in formato pacchetto (legacy).

234

Page 235:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

3. Immettere il nome del file e fare clic su Salva.

235

Page 236:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Verifiche e controlli dei modelli

236

Page 237:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 14Utilizzo di modelli precedenti allaversione 4.5

La versione 4.5 di xPresso for Word e le versioni successive hanno subito modifiche significativerispetto alle versioni precedenti. Di conseguenza, è necessario aggiornare i modelli di versioniprecedenti alla 4.5 prima di aprirli nella versione più recente del client. Se si estrae un modello di unaversione precedente alla 4.5, l’aggiornamento viene eseguito automaticamente nello stesso momento.Se si desidera utilizzare un modello precedente alla versione 4.5 senza aggiornarlo, la versione piùrecente di xPresso for Word consente inoltre di estrarre un modello di una versione precedente alla4.5 come versione precedente. È possibile quindi modificare il modello con la versione precedente delclient e archiviarlo nel repository dei contenuti con la versione più recente del client.

In questo capitolo vengono trattati gli argomenti seguenti:• Modifiche introdotte dall’aggiornamento, pagina 237

• Aggiornamento di un modello di una versione precedente alla 4.5, pagina 243

• Estrazione di un modello di una versione precedente alla 4.5 come la versione precedente,pagina 244

• Archiviazione di un modello di una versione precedente alla 4.5 come la versione precedente,pagina 245

• Aggiunta di un modello di una versione precedente alla 4.5 al server, pagina 246

Modifiche introdotte dall’aggiornamentoDa xPresso 4.5, la progettazione delle variabili è stata modificata, la struttura delle variabili, adesempio, viene unita alla struttura dello schema in Esplora variabili; le variabili sono denominatein base alla struttura dello schema e non è più possibile creare cartelle personalizzate o vettoripersonalizzati. Per essere compatibili con i riferimenti delle variabili presenti nei modelli di unaversione precedente alla 4.5, dopo l’aggiornamento, tutte le variabili e i vettori dei modelli di unaversione precedente alla 4.5 vengono visualizzati in Variabili cliente legacy in Esplora variabili, comeillustrato in Figura 1, pagina 238. I nomi e i tipi delle variabili e dei vettori non vengono modificati.Anche i vettori personalizzati restano invariati. È possibile modificare gli array personalizzatiesistenti ma non è possibile crearne di nuovi.

237

Page 238:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Figura 1. Cartella Variabili cliente legacy

Nella seguente tabella vengono riportate altre modifiche introdotte dall’aggiornamento:

Elementi presenti indocumenti di unaversione precedentealla 4.5

Risultato dell’aggiornamento Esempi

Funzione JavaScript Il formato delle variabili acui si fa riferimento nelleespressioni JavaScript vienemodificato nel seguenteformato:

resolver.getValueByName(“Variabile”)

• Prima dell’aggiornamento:

StringDD_MM_YYYYToDutchDate(brief.QBTOTDAT)

• Dopo l’aggiornamento

StringDD_MM_YYYYToDutchDate(resolver.getValueByName("brief:QBTOTDAT"))

Javascript globale Gli elementi JavaScript globalivengono elencati nell’elencoJavaScript globale.

Il formato delle variabili acui si fa riferimento nelleespressioni Javascript vienemodificato nel seguenteformato:

resolver.getValueByName(“Variabile”)

• Prima dell’aggiornamento:

StringDD_MM_YYYYToDutchDate(brief.QBTOTDAT)

• Dopo l’aggiornamento

StringDD_MM_YYYYToDutchDate(resolver.getValueByName("brief:QBTOTDAT"))

238

Page 239:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Elementi presenti indocumenti di unaversione precedentealla 4.5

Risultato dell’aggiornamento Esempi

JavaScript esterno Se si utilizzano variabilinei file JavaScript esterni,aggiornare manualmente ilformato delle variabili cuiviene fatto riferimento nelleespressioni Javascript nelmodo seguente:

resolver.getValueByName(“Variabile”)

Cartelle Le cartelle vengono convertitein vettori personalizzati.I valori xPath di questgliarray personalizzati sonovuoti e non possono esseremodificati.

• Prima dell’aggiornamento:

ABC della cartella

• Dopo l’aggiornamento:

ABC del array personalizzato

Proprietà deldocumento

Le proprietà del documentovengono convertite nelleimpostazioni delle proprietàdel documento delle variabili.Una sola variabile non puòessere mappata a più variabilidi output.

• Prima dell’aggiornamento:

La variabile di output OP1 vienemappata alla variabile VAR1.

La variabile di output OP21 vienemappata alla variabile VAR1.

• Dopo l’aggiornamento:

Le variabili di output OP1 eOP2 vengonomemorizzate come variabili di outputmappate nell’impostazione Proprietà deldocumento della variabile VAR1.

Le impostazioniA partire da delcontenuto universaledi xPresso for Word

Le impostazioni A partireda, Pagina successiva, Paginadispari e Pagina pari nonvengono modificate.

L’impostazione A partireda, Pagina corrente vienemodificata in All’interno delparagrafo o Nuovo paragrafoa seconda delle impostazionidel layout.

Il contenuto universale con l’impostazioneA partire da Pagina corrente el’impostazione di layout Senza layoutdi un documento di una versioneprecedente alla 4.5 viene convertito incontenuto universale inline.

Il contenuto universale con l’impostazioneA partire da Pagina corrente el’impostazione di layout Con layoutviene convertito in contenuto universalecon l’impostazione A partire da Nuovoparagrafo e l’impostazione di layout Usalayout UC.

239

Page 240:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Elementi presenti indocumenti di unaversione precedentealla 4.5

Risultato dell’aggiornamento Esempi

Versione delcontenuto universaledi xPresso for Worde xPresso for AdobeInDesign

Versione = CORRENTE neicollegamenti di riferimento èstata modificata in Versione =PIÙ RECENTE.

Se si utilizza un riferimentovariabile, è ancorapossibile utilizzareversion=CURRENT.

• Prima dell’aggiornamento:

Il collegamento del contenuto universaleè:

cr::xPression Repository:/PCD

_UC_Contact/PCD_UC_REF_Var?

version=CURRENT

Dopo l’aggiornamento:

Il collegamento del contenuto universaleè:

cr::xPression Repository:

/PCD_UC_Contact/PCD_UC_REF

_Var?version=LATEST

Istanza di contenutodel gruppo dicontenuti

Ogni istanza di contenutoha una variante predefinita,invisibile per impostazionepredefinita fino a quando siabilitano le selezioni rapideper il modello.

• Prima dell’aggiornamento:

Gruppo di contenuti AIstanza di contenuto A

• Dopo l’aggiornamento:

Gruppo di contenuti AIstanza di contenuto AVariante A

Variabili di testoglobali

La Cartella variabili globaliviene rimossa.

Ogni variabile di testo vienevisualizzata nella strutturadei modelli in base allarelativa posizione nel canvas.

• Prima dell’aggiornamento:

La variabile di testo Var1 viene elencatanella Cartella variabili globali

• Dopo l’aggiornamento:

La variabile di testo Var1 è elencataall’interno della struttura di modellisenza una cartella. La posizione nellastruttura dei modelli è determinata dallaposizione della variabile di testo nelcanvas.

240

Page 241:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Elementi presenti indocumenti di unaversione precedentealla 4.5

Risultato dell’aggiornamento Esempi

Indicatori La Cartella indicatoriviene rimossa. Ciascunindicatore viene elencatonella definizione di pagina incui è stato inserito in Esploramodelli.

• Prima dell’aggiornamento:

Indicatore_1 viene elencato nella Cartellaindicatori

• Dopo l’aggiornamento:

Indicatore_1 viene elencato inDefinizione di pagina 1.

Blocchi di controllodel contenuto

I blocchi di controllo delcontenuto vengono rimossi.

Non disponibile

Risultati diversi di calcoli numerici per le variabilifunzione xPresso

Per le variabili funzione xPresso, è possibile includere i calcoli nell’espressione di funzione xPresso. Irisultati dei calcoli in xPression versione 4.5 e successive, tuttavia, potrebbero essere diversi dairisultati nelle versioni precedenti a xPression 4.5. Quando si elabora un calcolo, le versioni precedentideterminano il tipo numerico di risultati intermedi, in base al tipo di numeri utilizzati nel calcolo.Ad esempio, nelle versioni precedenti alla 4.5, per il calcolo dei numeri interi 62/30*30, xPressionottiene un risultato intermedio intero di 2 per il calcolo secondario 62/30, quindi calcola 2*30 e ottieneil risultato finale di 60.

In xPression versione 4.5 e successive, invece, viene utilizzato il tipo doppio per tutti i risultatiintermedi dei calcoli. Utilizzando lo stesso esempio 62/30*30, xPression ottiene il risultato intermediodi tipo doppio 2.066666666666667, calcola 2.066666666666667*30 e ottiene il risultato finale di 62. Acausa di questa modifica, i risultati dei calcoli con i numeri di tipo intero e con i numeri di tipoa virgola mobile in xPression 4.5 e versioni successive potrebbero essere diversi ma più precisi diprima. I calcoli dei numeri di tipo doppio e le funzioni di xPression rimangono inalterati.

Nella tabella seguente vengono illustrati esempi di risultati diversi dello stesso calcolo in documentidi una versione precedente alla 4.5 e in documenti successivi.

Calcoli Risultati nei documenti di unaversione precedente alla 4.5

Risultati nei documentiversione 4.5 e successive

4599f/0.15f 30659.998 30660.0

30*(62/30) 60 62

62/30*30 60 62

30*62/30 62 62

241

Page 242:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Fedeltà

È opportuno tenere conto dei seguenti problemi di fedeltà causati dall’aggiornamento.

Impostazione del grassetto

In xPression 4.2, l’impostazione del grassetto viene ignorata in alcuni casi. Questo problema èstato risolto nella versione 4.5 e nelle versioni successive. Di conseguenza, il testo normale in undocumento 4.2 può diventare grassetti dopo l’aggiornamento.

Valori RGB dei colori

xPression 4.5 e le versioni successive utilizzano una edizione di Standard ECMA-376 diversa dalleversioni precedenti. I valori RGB dei colori possono essere definiti in modo diverso in edizioni diversedello Standard ECMA-376. Ad esempio, il valore RGB di lightGrey è C0C0C0 nella prima edizione,D3D3D3 nella edizione più recente. Di conseguenza i valori RGB dei colori di un documento possonosubire una modifica dopo l’aggiornamento.

Spaziatura dei caratteri

La spaziatura dei caratteri è supportata a partire dalla versione 4.5 SP1. Dopo aver aggiornato ildocumento di una versione precedente alla 4.5, è possibile trovare alcuni caratteri del documentospostati in basso quando viene abilitata la spaziatura. Per ottenere lo stesso output precedente,disattivare la spaziatura dei caratteri. Per ulteriori informazioni sulla spaziatura, vedere Spaziatura ecrenatura, pagina 338.

Mantieni con il successivo

In xPression 4.2, la funzionalità Mantieni con il successivo non funziona correttamente. Dopo averaggiornato un documento 4.2, è possibile trovare alcuni paragrafi impostati come Mantieni con ilsuccessivo spostati in alto o in basso nell’output poiché la funzionalità Mantieni con il successivo èsupportata in xPression 4.5 e versioni successive. Per ottenere lo stesso output precedente, rimuoverela proprietà Mantieni con il successivo dei paragrafi spostati.

Formattazione diretta in un contenuto universale

Dopo aver eseguito l’aggiornamento, si perde la formattazione diretta applicata nel contenutouniversale. Per risolvere il problema, applicare gli stili dei nomi anziché la formattazione diretta nelcontenuto universale.

242

Page 243:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Istanze di contenuto

Potrebbe essere presente un gruppo di contenuti nel documento che comprende diverse istanzedi contenuto che, a loro volta, contengono solo un paragrafo e a cui sono applicati diversi stili diparagrafo. Tuttavia gli stili di paragrafo di tutte le istanze di contenuto rimangono inalterati dopol’aggiornamento. Per risolvere il problema, aggiungere un paragrafo nascosto per ciascuna istanza dicontenuto.

Aggiornamento di un modello di una versioneprecedente alla 4.5Nel repository dei contenuti possono essere memorizzati modelli di una versione precedente allaversione 4.5 e modelli di versioni successive. È possibile determinare la versione del client utilizzatoper creare un modello dalla colonna Versione strumento di creazione della finestra di dialogo ECMDashboard o ECM Server. Selezionare un modello di una versione precedente alla 4.5 ed estrarlo. Ilmodello di una versione precedente alla 4.5 viene aggiornato automaticamente con l’estrazione.

Se si desidera modificare un modello di una versione precedente alla 4.5 prima di aggiornarlo, èpossibile estrarlo come versione precedente e modificarlo nella versione precedente del client. Perulteriori informazioni sull’estrazione come la versione precedente, vedere Estrazione di un modellodi una versione precedente alla 4.5 come la versione precedente, pagina 244.

Nota: xPresso for Word non supporta la funzionalità di adattamento automatico ai contenuti.Rimuovere questa proprietà di tabella in un documento prima di aggiornarla.

Per estrarre e aggiornare un modello di una versione precedente alla 4.5 dalrepository xPression

1. Visualizzare la pagina di backstage di xPresso.

2. Selezionare xPression dall’elenco a discesa Repository dei contenuti.

3. Nel repository dei contenuti xPression dell’area Connessione server della pagina, fare clic suEstrai, Visualizza, Crea versione derivata, Flusso di lavoro. Viene visualizzato il dashboardECM. Vengono elencati tutti i modelli di documento per i quali si dispone dei diritti di accesso.

4. Selezionare il documento che si desidera estrarre. Se sono disponibili più versioni del modello,per impostazione predefinita viene elencata la versione più recente. Per visualizzare le versioniprecedenti, fare clic sulla freccia accanto al nome file.

5. Fare clic su Estrai e modifica, quindi fare clic su Sì.

Per estrarre e aggiornare un modello di una versione precedente alla 4.5 dalrepository xPression Documentum

1. Visualizzare la pagina di backstage di xPresso.

2. Fare clic su Estrai, inDocumentum, nell’area Connessione server della pagina. Viene visualizzatala finestra di dialogo ECM Server.

3. Individuare e selezionare il documento che si desidera estrarre. Se nel server sono salvate piùversioni di un documento, l’icona accanto al nome documento mostra un cerchio verde al suo

243

Page 244:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

interno anziché blu. Fare doppio clic sull’icona con il cerchio verde per visualizzare un elencoa discesa da cui è possibile selezionare la versione da aprire.

4. Fare clic suModifica, quindi fare clic su Sì per aggiornare il modello.L’aggiornamento non viene salvato fino a quando non si archivia il modello come una nuovaversione. La versione originale del modello viene mantenuta come lo stesso modello di una versioneprecedente alla 4.5.

Se un modello aggiornato include un contenuto universale di una versione precedente alla 4.5,mappare manualmente le variabili utilizzate nel contenuto universale alle variabili del documentoprincipale; in caso contrario, le variabili del contenuto universale non potranno essere risoltecorrettamente.

Estrazione di un modello di una versioneprecedente alla 4.5 come la versioneprecedenteSe non si desidera aggiornare un modello di una versione precedente alla 4.5 o apportare modifiche aun modello di una versione precedente alla 4.5 prima di aggiornarlo, è possibile estrarre il modellocome versione precedente.

Per estrarre un modello dal repository xPression come la versione precedente

1. Visualizzare la pagina di backstage di xPresso.

2. Nel repository dei contenuti xPression dell’area Connessione server della pagina, fare clic suEstrai, Visualizza, Crea versione derivata, Flusso di lavoro. Viene visualizzato il dashboardECM. Vengono elencati tutti i modelli di documento per i quali si dispone dei diritti di accesso.

3. Selezionare il documento che si desidera estrarre. Se sono disponibili più versioni del modello,per impostazione predefinita viene elencata la versione più recente. Per visualizzare le versioniprecedenti, fare clic sulla freccia accanto al nome file.

4. Fare clic su Azioni pacchetto legacy e selezionare Estrai.

5. Il documento viene estratto nell’unità locale e viene visualizzata una finestra di dialogo. Fareclic sul collegamento nella finestra di dialogo per aprire la cartella padre oppure fare clic su OKper chiudere la finestra di dialogo.

244

Page 245:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Per estrarre un modello dal repository xPression Documentum come la versioneprecedente

1. Visualizzare la pagina di backstage di xPresso.

2. Fare clic su Estrai, inDocumentum, nell’area Connessione server della pagina. Viene visualizzatala finestra di dialogo ECM Server.

3. Individuare e selezionare il documento che si desidera estrarre. Se nel server sono salvate piùversioni di un documento, l’icona accanto al nome documento mostra un cerchio verde al suointerno anziché blu. Fare doppio clic sull’icona con il cerchio verde per visualizzare un elencoa discesa da cui è possibile selezionare la versione da aprire.

4. Fare clic suModifica, quindi selezionare No per estrarre il modello come la versione precedente.È ora possibile aprire il modello con una versione precedente del client e modificarlo.

Archiviazione di un modello di una versioneprecedente alla 4.5 come la versioneprecedenteUna volta estratto un modello di una versione precedente alla 4.5 come versione precedente emodificato il modello, è possibile archiviarlo nel repository dei contenuti come versione precedentemediante la versione più recente del client.

Per archiviare un modello di una versione precedente alla 4.5 nel repository xPressioncome la versione precedente

1. Visualizzare la pagina di backstage di xPresso.

2. Nel repository dei contenuti xPression dell’area Connessione server della pagina, fare clic suEstrai, Visualizza, Crea versione derivata, Flusso di lavoro.

3. Selezionare il documento estratto.

4. Fare clic su Azioni pacchetto legacy e selezionare Archivia.

5. Selezionare la versione che si desidera utilizzare e fare clic su OK.

245

Page 246:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Utilizzo di modelli precedenti alla versione 4.5

Per archiviare un modello di una versione precedente alla 4.5 nel repository xPressionDocumentum come la versione precedente

1. Visualizzare la pagina di backstage di xPresso.

2. Selezionare Documentum dall’elenco a discesa Repository dei contenuti.

3. Fare clic su Archivia pacchetto locale Pre-4.5 come, selezionare il documento che si desideraarchiviare e fare clic su Apri.

4. Selezionare il documento con lo stesso nome dal repository e fare clic su Archivia.

5. Selezionare la versione che si desidera utilizzare e fare clic su OK.

Aggiunta di un modello di una versioneprecedente alla 4.5 al serverSe si dispone di documenti di una versione precedente alla 4.5 locali, è possibile archiviarli nel serveraggiornato senza eseguirne l’aggiornamento. Questa funzionalità funziona solo per il repositoryxPression.

1. Visualizzare la pagina di backstage di xPresso.

2. Nel repository dei contenuti xPression dell’area Connessione server della pagina, fare clic suEstrai, Visualizza, Crea versione derivata, Flusso di lavoro.

3. Fare clic su Azioni pacchetto legacy e su Aggiungi al server.

4. Fare clic suSì per continuare.

5. Selezionare il documento da archiviare e fare clic suApri.

6. Selezionare una categoria per il documento.

7. (Facoltativo) Aggiungere un commento da associare all’archiviazione di questo modello (finoa 255 caratteri).

8. Fare clic su OK.

246

Page 247:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 15Visualizzazione in anteprima deldocumento

È possibile visualizzare l’anteprima degli output PDF o PDF/UA del documento con un lettoreadeguato installato nel computer. In questo capitolo viene descritto come visualizzare l’anteprimadegli output PDF del documento da xPresso for Word.

È possibile creare l’anteprima di un output PDF indipendentemente dal fatto che si abbia effettuatola connessione al server o meno. Tuttavia, se un documento contiene del contenuto universale, èconsigliabile accedere al server; in caso contrario il contenuto universale non sarà presente nell’outputdi anteprima. L’output di anteprima PDF viene sempre generato dal lato client locale. Per generarel’anteprima PDF vengono utilizzati i caratteri presenti sul computer locale.

È possibile visualizzare i tag di un documento PDF/UA solo con un lettore PDF/UA conforme; incaso contrario, il documento PDF/UA assume lo stesso aspetto di un normale documento PDF. Pergenerare un output PDF/UA, accertarsi che le opzioni PDF/UA relative al testo alternativo e agliartefatti siano impostati correttamente. Per le impostazioni PDF/UA necessarie, consultare la guidaall’elaborazione dell’output di xPublish. Le opzioni PDF/UA relative al contenuto universale devonoessere impostate separatamente nei documenti con riferimenti.

Nota: è consigliabile che le dimensioni del file XML di cui si visualizza l’anteprima non superino 25MB. A causa dei limiti di memoria, le dimensioni massime del file XML dipendono dalle dimensioni edalla complessità dei documenti. Ad esempio, per un tipico documento di cinque pagine, il file XMLpotrebbe non superare i 100 MB. Se si verificano problemi di memoria, dividere il file XML.

xPresso for Word dispone di due pulsanti di anteprima: Anteprima e Anteprima multipla• Con il pulsante Anteprima, è possibile visualizzare l’anteprima solo del primo record nell’originedati.

• Con Anteprima multipla, è possibile selezionare più record di dati e creare gli output PDFcontemporaneamente.

Anteprima con il primo recordÈ possibile visualizzare l’anteprima di output PDF, PDF/UA o PDF compatibile con il primo recordnell’origine dati.

247

Page 248:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Visualizzazione in anteprima del documento

Anteprima con il primo record

1. Aprire il documento, fare clic su Anteprima nella scheda Progettazione di xPresso for Worddalla barra multifunzione di Word e selezionare un’opzione dall’elenco. Le opzioni AnteprimaPDF compilabile e Anteprima PDF/UA compilabile servono per i documenti con campi moduloo controlli modulo.

2. Nella finestra di dialogo visualizzata, selezionare il file di dati da utilizzare e fare clic su Apri.

3. Salvare l’output PDF in base alle esigenze selezionando Salva con nome dal menu File diAdobe Reader.

4. Chiudere Adobe Reader.Se xPresso for Word genera un errore simile a “Impossibile trovare il carattere sostitutivoCourier New” durante il processo di anteprima, verificare che il valore TtfFontPath nel filexPRSConfig.xml sia impostato nella directory dei caratteri del sistema nel computer. Il filexPRSConfig.xml si trova nella directory di configurazione.

Anteprima con più recordÈ possibile selezionare più record di dati e creare gli output PDF.

Anteprima con più record di dati

1. Dalla barra multifunzione di Word, fare clic su Anteprima multipla nella scheda Progettazionedi xPresso for Word.

2. Nella finestra di dialogo visualizzata, selezionare il file di dati da utilizzare e fare clic su Apri.Viene visualizzata la finestra di dialogo Visualizza in anteprima più record.

3. Per visualizzare l’anteprima di output PDF/UA, PDF compilabile o PDF/UA compilabile,selezionare una o entrambe le caselle di controllo PDF/UA e PDF compilabile.

4. Selezionare i record in Elenco di record e fare clic su Genera.

Nota: per gli output PDF/UA e PDF/UA compilabile, verrà visualizzato un messaggio diconferma di avvenuta creazione dell’output. Per individuare la posizione degli output, fare clicsuMostra il risultato del file in Esplora nella finestra di messaggio.

5. Gli output generati vengono elencati nel campo PDF generati della finestra di dialogo Visualizzain anteprima più record Per aprire i file, selezionarli dall’elenco e fare clic sul pulsanteAnteprimanella parte inferiore della finestra di dialogo. È inoltre possibile fare doppio clic sul nome del fileper aprire un singolo file.

Specifica di un altro file di datixPresso for Word memorizza il file di dati selezionato la prima volta. Quando si fa clic su Anteprimao su Anteprima multipla la seconda volta, si apre direttamente la finestra di dialogo Visualizza inanteprima più record senza bisogno di specificare di nuovo il file di dati.

248

Page 249:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Visualizzazione in anteprima del documento

Specifica di un altro file di dati

1. Fare clic su Verifica e visualizza anteprima nella scheda Progettazione di xPresso for Wordper aprire Esplora modelli.

2. Nel pannello Dati campione, fare clic sul pulsante Sfoglia per selezionare un file di dati, quindisu Apri.

3. Fare clic su Torna a Progettazione per uscire da Esplora modelli.

Nota: L’utilizzo delle funzioni Annulla e Ripeti di Word per modificare il file XML da utilizzarequando si visualizza un documento in anteprima non è supportato.

249

Page 250:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Visualizzazione in anteprima del documento

250

Page 251:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 16Creazione di output multicanale

L’output di canali multipli consente la pubblicazione di un singolo modello di documento attraversocanali di output differenti. Ciò rende possibile sviluppare un singolo modello di documento e,utilizzando modelli shell, fornire informazioni in diversi modi. I canali xPression possono creareoutput impaginato, HTML o di solo testo. Ad esempio, potrebbe essere necessario fornire undocumento stampato al cliente e inviare anche un email contenente le stesse informazioni.

L’output a più canali richiede il client xPresso for Word e il client xPresso for Dreamweaver. Ilcontenuto del documento viene creato in xPresso for Word. In xPresso for Dreamweaver viene creatauna shell di modello che definirà l’aspetto dell’output in HTML, ma il contenuto del messaggioproverrà principalmente dal modello di xPresso for Word. Il contenuto viene mappato attraversol’utilizzo di punti di inserimento.

I punti di inserimento vengono inseriti nella shell del modello di xPresso for Dreamweaver nelleposizioni in cui si desidera visualizzare il contenuto specifico. È possibile inserire più punti diinserimento in una shell. Completato l’inserimento dei punti nella shell, salvarli sul server. In xPressofor Word è possibile selezionare il modello di shell e visualizzare tutti i punti di inserimento. Aquesto punto è possibile mappare il contenuto presente in determinate aree del modello di xPressofor Word ai punti di inserimento di xPresso for Dreamweaver. Quando si pubblica il documento,l’output HTML utilizzerà il modello della shell di xPresso for Dreamweaver per il layout con ilrelativo contenuto che verrà inserito attraverso i punti di inserimento.

Nota: l’utilizzo di caratteri grandi nel documento potrebbe causare la sovrapposizione del testonell’output HTML. Regolare le dimensioni dei caratteri nel documento per ottenere l’outputdesiderato.

In questo capitolo vengono trattati gli argomenti seguenti:• Associazione di canali a un modello, pagina 251

• Aree modelli, pagina 252

• Utilizzo dei canali nel modello, pagina 253

Associazione di canali a un modelloI canali vengono definiti nel server xPression di xAdmin. È possibile selezionare i canali che sidesidera attivare in un modello tramite la funzione Imposta canali nella pagina di backstage dixPresso.

251

Page 252:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Creazione di output multicanale

Impostazione dei canali:

1. Visualizzare la pagina di backstage di xPresso (File > xPresso).

2. Fare clic su Imposta canali. Per accedere all’elenco dei canali disponibili, è necessario essereconnessi al server.

3. Fare clic suScarica ultimi valori dal server per assicurarsi di visualizzare l’elenco aggiornatodei canali disponibili.

4. Selezionare i canali che si desidera rendere disponibili per il modello e fare clic su Aggiungicanale a documento per spostarli nell’elenco Attivi.

5. Fare clic su OK.

Aree modelliQuando si utilizza l’output multicanale, il modello di xPresso for Word include tutto il contenutoper tutti i vari canali di output. È possibile che non tutto il contenuto sia valido per tutti i canali. Èpossibile includere alcune parti del contenuto in tutti i canali e altre parti solo in canali specifici.

Le aree del modello servono a suddividere il contenuto e a identificare i canali validi. Un’area puòessere valida per tutti i canali o solo per alcuni.

Per identificare una sezione del contenuto come area del modello, selezionare il contenuto sulcanvas, quindi fare clic su Area modelli nella scheda Progettazione di xPresso for Word della barramultifunzione di Word. Le aree di modello possono essere create solo sui limiti di paragrafo; non èpossibile selezionare testo specifico all’interno del paragrafo per creare un’area.

Nota: Assicurarsi di non aggiungere alcun contenuto a un paragrafo designato come area di modelloal di fuori del controllo del contenuto dell’area.

Modifica delle dimensioni dell’area

Dopo aver creare un’area di modello, è possibile regolare le dimensioni dell’area e del relativocontenuto. Se l’impostazione delle dimensioni determina una sovrapposizione con un’altra area delmodello, questa diverrà un’area nidificata nella prima area.

Per regolare le dimensioni, utilizzare le opzioni di espansione e di riduzione presenti nel menu adiscesa per l’area del modello in Esplora modelli:• Espandi verso l’alto. Consente di incrementare le dimensioni dell’area in modo da includereil paragrafo sopra il limite corrente dell’area.

• Espandi verso il basso. Consente di incrementare le dimensioni dell’area in modo da includere ilparagrafo sottostante il limite corrente dell’area.

• Riduci dall’alto. Consente di ridurre le dimensioni dell’area in modo da escludere il paragrafosopra il limite superiore dell’area. Se nell’area è presente un solo paragrafo, non viene applicataalcuna modifica.

• Riduci dal basso. Consente di ridurre le dimensioni dell’area in modo da escludere il paragrafosotto il limite inferiore dell’area. Un paragrafo vuoto non verrà rimosso di per sé, verrà rimosso

252

Page 253:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Creazione di output multicanale

con il paragrafo che si trova prima di esso. Se nell’area è presente un solo paragrafo, non vieneapplicata alcuna modifica.

Associazione di canali a un’area

Per impostazione predefinita, l’area di modello è associata a tutti i canali attivi nel modello.

Per selezionare canali specifici per un’area:

1. Fare clic sul menu a discesa dell’area in Esplora modelli, quindi selezionareModifica canali.

2. Fare clic sul pulsante Tutti i canali per abilitare la rimozione dei canali dall’elenco Attivi.

3. Selezionare uno o più canali nell’elenco Attivi e fare clic su Rimuovi per spostare i canalinell’elenco Inattivi.

4. Fare clic su OK.

Utilizzo dei canali nel modelloUna volta associati dei canali a un modello, diventa disponibile Esplora layout HTML nel pannelloEsplora modelli. In Esplora layout HTML sono elencati i canali attivi per il modello e le aree almomento definite nel modello.

Per i canali di tipo HTML, è possibile selezionare il file HTML o xPresso for Dreamweaver utilizzatocome modello di shell per l’output di quel canale:• Per selezionare un file HTML per un canale, fare clic sul menu a discesa relativo al canale eselezionareMappa layout HTML.

Individuare e selezionare il file HTML che si desidera utilizzare come modello di shell per ilcanale. I file HTML devono essere memorizzati in una directory locale.

• Per selezionare un file xPresso for Dreamweaver per un canale, fare clic sul menu a discesa relativoal canale e selezionareMappa layout HTML del pacchetto Dreamweaver.

Selezionare il documento di xPresso for Dreamweaver che si desidera utilizzare come modellodi shell per il canale. I documenti di xPresso for Dreamweaver devono essere memorizzati nelServer xPression.

Se si desidera modificare il file di mapping, selezionare Annulla mappatura layout HTML nel menua discesa dei canali, quindi selezionare un nuovo file.

Associazione di punti di inserimento a un’area

Quando in un canale viene utilizzato un documento di xPresso for Dreamweaver come modello dishell, è possibile selezionare un punto di inserimento da associare alle aree del modello che utilizzanoquel canale. I punti di inserimento indicano a xPression in quale punto posizionare il contenutoall’interno del modello di Dreamweaver.

253

Page 254:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Creazione di output multicanale

Espandere il canale mappato al documento di xPresso for Dreamweaver in Esplora layout HTML.Tutti i punti di inserimento contenuti nel documento sono elencati in una struttura.

Selezionare un punto di inserimento nella struttura. Tutte le aree del modello associate al canaleverranno visualizzate nella sezione Aree modelli con accanto delle caselle di controllo.

Selezionare le caselle di controllo accanto alle aree di modello che si desidera associare al puntodi inserimento.

Ecco un esempio della sintassi del punto di inserimento nella shell HTML:<xPresso type="insertionpoint" name="Information">Information</xPresso>

Associazione di canali a flussi di outputQuando si aggiungono documenti di xPresso for Word a un flusso per la pubblicazione, è inoltrepossibile configurare il flusso di output per selezionare il contenuto in base ai canali. I canali vengonodefiniti nel server xPression di xAdmin ed è possibile consultarli nei flussi di output. Quando siassocia il flusso a un canale, xPression seleziona il contenuto del canale specificato per l’output. Perulteriori informazioni, vedere la Guida per l’utente di xAdmin.

254

Page 255:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Capitolo 17Protezione

xPresso for Word supporta i tipi di protezione Sola lettura e Controllo modulo per bloccare parti didocumento specifiche con modifiche e consentire la protezione sola lettura e la protezione modulispecificando una password statica o dinamica oppure basata su variabili. L’abilitazione di questaprotezione consente di pubblicare documenti di Word nel formato di output iDOCX proteggendotali documenti dalla modifica (protezione sola lettura) o utilizzandoli come moduli protetti dacompilare (protezione controllo modulo). Se la password è statica, l’utente deve digitare i caratteriche non richiedono una maschera della password; se la password è una variabile, è necessario unriferimento della variabile.

Nota:• Non è consigliabile impostare l’intervallo modificabile in gruppi di contenuti, istanze dicontenuto, loop, variabili di tabella e aree. In caso contrario, l’intervallo potrebbe non esserecorretto nell’output .docx risultante. Se si desidera che il contenuto nel controllo contenuto siamodificabile, specificare un intervallo più grande che includa l’intero controllo contenuto e unariga vuota o uno spazio prima e dopo il controllo contenuto.

• Quando si specifica la protezione per l’ultima riga della tabella che si trova all’interno di ungruppo di contenuti o un loop, diventa modificabile anche il paragrafo vuoto dopo la tabella.

• Dopo avere specificato il tipo di protezione, anche se la password non è specificata, il contenutobloccato non potrà essere modificato.

• La lunghezza della password in Microsoft Word è al massimo di 16 caratteri, pertanto le passwordpiù lunghe di 16 caratteri vengono troncate automaticamente. È possibile utilizzare qualsiasicarattere della tastiera per impostare la password.

• La password fa distinzione tra maiuscole e minuscole e se si sceglie una variabile come password,deve essere un valore formattato. Digitare il valore formattato come password, in caso contrario,immettere il valore originale come password. Se la password è un valore formattato, digitare ilvalore formattato come password, in caso contrario, immettere il valore originale come password.

255

Page 256:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Protezione

Impostazione della protezione sola lettura inxPresso for WordQuando si seleziona una protezione sola lettura, il documento di output risultante viene protetto conle eccezioni specificate come intervallo modificabile in Microsoft Word. È possibile selezionare una opiù parti del documento modificabile quando il documento è protetto.

Per impostare la protezione sola lettura

1. In Microsoft Word, passare a File > xPresso e fare clic sul link Imposta protezione documento.Viene visualizzata la finestra di dialogo.

2. In Impostazione protezione documento selezionare l’opzione Abilita protezione documento.

3. Selezionare l’opzione Sola lettura nell’elenco a discesa Tipo di protezione.

4. Impostare le impostazioni della password desiderate. È possibile scegliere tra il tipo di passwordstatica o variabile e quindi salvare le modifiche e pubblicare il documento.

Impostazione della protezione modulo inxPresso for WordQuando si imposta la protezione modulo, solo determinati controlli modulo sono modificabili neidocumenti risultanti. La protezione modulo è utile quando all’utente del documento viene richiestodi immettere informazioni aggiuntive in determinate aree del documento, ad esempio controllicaselle di testo o controlli elenco a discesa.

Per impostare la protezione modulo

1. In Microsoft Word, passare a File > xPresso e fare clic sul link Imposta protezione documento.Viene visualizzata la finestra di dialogo.

2. In Impostazione protezione documento selezionare l’opzione Abilita protezione documento.

3. Selezionare l’opzione Controllo modulo nell’elenco a discesa Tipo di protezione.

4. Impostare le impostazioni della password desiderate. È possibile scegliere tra il tipo di passwordstatica o variabile.

5. Salvare le modifiche e pubblicare il documento.

Limitazioni per l’impostazione dell’intervallo didocumento modificabile in Microsoft WordSe si seleziona il tipo di protezione sola lettura, è necessario specificare l’intervallo modificabile neldocumento, in caso contrario questo documento appare bloccato.

Per specificare l’intervallo di documento modificabile, fare clic sul pulsante Imposta intervallomodificabile nella scheda xPression della Barra multifunzione.

256

Page 257:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Protezione

Nota:• Il pannello Limita modifica della scheda Revisione consente di specificare l’intervallomodificabile, ma non è consigliabile selezionare l’opzione Applica protezione perché sostituisce lafunzionalità di protezione di xPresso for Word e blocca il modello di progettazione in MicrosoftWord per l’uso con altre applicazioni Document Sciences.

• Si consiglia di non pubblicare il documento risultante con le impostazioni di protezione abilitatecome documenti di Microsoft Word (.docx). Utilizzare i formati PDF, PostScript o altri formatidi documento.

• Se si desidera contrassegnare il contenuto riutilizzabile come modificabile, compresa la caselladi testo, specificare questo contenuto riutilizzabile come intervallo modificabile (anziché neldocumento master). In caso contrario, il contenuto della casella di testo non potrà esseremodificato.

• Nell’output IDocx, l’intervallo modificabile può non avere effetto quando si sovrappone con ilcontenuto dinamico, come gruppo di contenuti, loop, loop righe o area modelli. Il motivo è chel’intervallo modificabile dispone di una posizione di inizio e di fine in Microsoft Word. Se unintervallo modificabile si sovrappone con il controllo contenuto, l’inizio e la fine dell’intervallomodificabile potrebbero non corrispondere dopo il processo di assemblaggio dell’iDocx, pertantol’impostazione dell’intervallo modificabile non avrà alcun effetto.

257

Page 258:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Protezione

258

Page 259:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice A

Funzioni xPath

Quando si creano variabili in xPresso for Word con un tipo origine di xPath, è possibile utilizzare lefunzioni xPath nell’espressione variabile. In questo capitolo vengono descritte le funzioni disponibiliper essere utilizzate nelle espressioni delle variabili di xPath:• Funzioni stringa, pagina 259

• Funzioni booleane, pagina 263

• Funzioni numeriche, pagina 264

• Funzioni dei set di nodi, pagina 265

Per ulteriori informazioni su xPath, vedere http://www.w3.org/TR/xpath.

Funzioni stringaLe funzioni stringa seguenti possono essere utilizzate nella creazione di un’espressione di variabilexPath.

• concat(string, string, string*), pagina 259

• contains(), pagina 260

• normalize-space(string), pagina 260

• starts-with(string, string), pagina 260

• string(object), pagina 260

• string-length(string), pagina 261

• substring(string, number, number), pagina 261

• substring-after(string, string), pagina 262

• substring-before(string, string), pagina 262

• translate(string, to-match, replace-with), pagina 262

concat(string, string, string*)

La funzione concat restituisce la concatenazione dei relativi argomenti.

259

Page 260:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

Esempioconcat(’This is’, ’ ’, ’my string’)

Restituisce This is my string.

contains()

La funzione contains restituisce true se la stringa del primo argomento contiene la stringa delsecondo argomento; in caso contrario restituisce false.

Esempiocontains("This is my string", "is my")

Restituisce true, perché "This is my string" contiene la stringa “is my”.

normalize-space(string)

La funzione normalize-space restituisce la stringa argomento con spazi normalizzati rimuovendo glispazi iniziali e finali e sostituendo sequenze di spazi con un singolo spazio. I caratteri di spazio sonogli stessi consentiti dalla produzione di S in XML. Se l’argomento viene omesso, viene inserito perimpostazione predefinita il nodo di contesto convertito in una stringa, in altre parole il valore dellastringa del nodo di contesto.

starts-with(string, string)

La funzione starts-with restituisce true se la prima stringa argomento inizia con la seconda stringaargomento; in caso contrario, restituisce false.

string(object)

La funzione string converte qualsiasi valore in una stringa.• Un set di nodi viene convertito in una stringa restituendo il valore della stringa del nodo nel primoset di nodi nell’ordine del documento. Se il set di nodi è vuoto, viene restituita una stringa vuota.

• Un numero viene convertito in una stringa, come segue:

— NaN è convertito nella stringa NaN.

— Zero positivo viene convertito nella stringa 0.

— Zero negativo viene convertito nella stringa 0.

— Infinito positivo viene convertito nella stringa Infinity.

260

Page 261:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

— Infinito negativo viene convertito nella stringa -Infinity.

— Se il numero è un intero, viene rappresentato sotto forma decimale come Numero privo divirgole decimali e di zero iniziali, preceduto dal segno meno (-) se si tratta di un numeronegativo. In caso contrario, il numero viene rappresentato sotto forma decimale come Numerocon punto decimale con almeno una cifra prima del punto decimale e almeno una cifra dopoil punto decimale, preceduto da un segno meno (-) se si tratta di un numero negativo; nondevono essere presenti zero iniziali prima del punto decimale tranne che per l’unica cifradecimale richiesta immediatamente prima del punto decimale; oltre l’unica cifra richiestadopo il punto decimale devono essere presenti tante altre cifre decimali quante necessarie perdistinguere in modo univoco il numero da tutti gli altri valori numerici IEEE 754.

• Il valore booleano false viene convertito nella stringa false. Il valore booleano true viene convertitonella stringa true.

• Un object di tipo diverso rispetto ai quattro tipi di base viene convertito in una stringa in base altipo specifico a cui appartiene.

Se l’argomento viene omesso, viene utilizzato per impostazione predefinita un set di nodi con ilnodo di contesto come unico membro.

Nota: La funzione string non deve essere utilizzata per convertire numeri in stringhe per lapresentazione agli utenti. A fornire questa funzionalità ci pensano la funzione format-numbere l’elemento xsl:number in [XSLT].

string-length(string)

La funzione string-length restituisce il numero di caratteri presenti nella stringa, spazi inclusi.

substring(string, number, number)

La funzione substring restituisce la sottostringa della stringa, a partire dalla posizione specificata conil primo numero, con la lunghezza specificata nel secondo numero (vedere il primo esempio). Se ilsecondo numero non viene specificato, restituisce la sottostringa a partire dalla posizione specificatanel primo numero e continuando fino alla fine della stringa (vedere il secondo esempio).

Esempisubstring("12345",2,3)

Restituisce "234".substring("12345",2)

Restituisce "2345".

261

Page 262:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

substring-after(string, string)

La funzione substring-after restituisce tutti i caratteri presenti nella prima stringa che seguono laprima occorrenza della seconda stringa o una stringa vuota se la prima stringa non contiene laseconda stringa.

Esempisubstring-after("1999/04/01","/")

Restituisce 04/01.substring-after("1999/04/01","19")

Restituisce 99/04/01.

substring-before(string, string)

La funzione substring-before restituisce i caratteri presenti nella prima stringa che precede la primaoccorrenza della seconda stringa o una stringa vuota se la prima stringa non contiene la secondastringa.

Esempiosubstring-before("1999/04/01","/")

Restituisce 1999.

translate(string, to-match, replace-with)

La funzione translate restituisce la string con le occorrenze di caratteri inclusi in match sostituite conil carattere nella posizione corrispondente in replace-with (vedere il primo esempio). Se è presenteun carattere in match senza nessun carattere nella posizione corrispondente in replace-with (perchématch è più lungo di replace-with), le occorrenze di tale carattere in string verranno rimosse (vedere ilsecondo esempio). Se un carattere ricorre più di una volta in match, la prima occorrenza determina ilcarattere da sostituire. Se replace-with è più lungo di match, i caratteri in eccesso saranno ignorati.

Nota: La funzione translate non rappresenta una soluzione sufficiente per la conversione dellemaiuscole/minuscole in tutte le lingue.

Esempitranslate("bar","abc","ABC")

Restituisce la stringa BAr.translate("--aaa--","abc-","ABC")

Restituisce "AAA".

262

Page 263:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

Funzioni booleaneÈ possibile utilizzare le seguenti espressioni booleane quando si crea un’espressione di variabile xPath.

• boolean(object), pagina 263

• false(), pagina 263

• lang(string), pagina 263

• not(boolean), pagina 264

• true(), pagina 264

boolean(object)

La funzione boolean valuta se un’espressione è true o false come indicato di seguito.• Un numero è true se e solo se non è zero positivo o negativo o NaN.

• Un set di nodi è true se e solo se non è vuoto.

• Una stringa è true se e solo se la sua lunghezza non è pari a zero.

• Un object di tipo diverso rispetto ai quattro tipi di base viene convertito in un valore booleano inbase al tipo specifico a cui appartiene.

false()

La funzione false restituisce false.

lang(string)

La funzione lang restituisce true o false a seconda che la lingua del nodo di contesto, come specificatodagli attributi xml:lang, sia la stessa o sia una lingua secondaria di quella specificata dalla stringaargomento. La lingua del nodo di contesto è determinata dal valore dell’attributo xml:lang del nododi contesto, oppure, se il nodo di contesto non ha un attributo xml:lang, dal valore dell’attributoxml:lang del predecessore più vicino del nodo di contesto che include un attributo xml:lang. Se taleattributo non è presente, lang restituisce false. Se tale attributo è presente, lang restituisce true se ilvalore dell’attributo è uguale all’argomento, ignorando maiuscole/minuscole, oppure se è presenteun suffisso che inizia con - e il valore dell’attributo è uguale all’argomento ignorando tale suffissoe le maiuscole/minuscole. Ad esempio, lang("en") restituirebbe:

Esempiolang("en")

Restituisce true se il nodo di contesto è uno di questi cinque elementi:<para xml:lang="en"><div xml:lang="en"><para/></div>

263

Page 264:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

<para xml:lang="EN"/><para xml:lang="en-us"/>

not(boolean)

La funzione not restituisce true se l’argomento è false e false in caso contrario.

true()

La funzione true restituisce true.

Funzioni numericheÈ possibile utilizzare le seguenti espressioni numeriche quando si crea un’espressione di variabilexPath.

• ceiling(number), pagina 264

• floor(number), pagina 264

• number(object), pagina 264

• round(number), pagina 265

• sum(node-set), pagina 265

ceiling(number)

La funzione ceiling restituisce il valore dell’espressione arrotondata per eccesso a un valore intero.

floor(number)

La funzione floor restituisce il valore dell’espressione arrotondata per difetto a un valore intero.

number(object)

La funzione number converte l’argomento (testo PCDATA) in un numero secondo quanto indicatodi seguito.• Una stringa composta da uno spazio opzionale seguito da un segno meno opzionale seguito da unnumero seguito da uno spazio viene convertita nel numero IEEE 754 più vicino (in base alla regola

264

Page 265:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

di arrotondamento al numero più vicino IEEE 754) secondo il valore matematico rappresentatodalla stringa; qualsiasi altra stringa viene convertita in NaN.

• Il valore booleano true viene convertito in 1; il valore booleano false viene convertito in 0.

• Un set di nodi viene prima convertito in una stringa come in seguito a una chiamata alla funzionestring e quindi convertito nello stesso modo come argomento della funzione string.

• Un object di tipo diverso rispetto ai quattro tipi di base viene convertito in un numero in base altipo specifico a cui appartiene.

Se l’argomento viene omesso, viene utilizzato per impostazione predefinita un set di nodi con ilnodo di contesto come unico membro.

Nota: La funzione number non deve essere utilizzata per la conversione di dati numerici presenti inun elemento in un documento XML a meno che l’elemento non sia di un tipo che rappresenti datinumerici in un formato neutro/indipendente dalla lingua (che sarebbe in genere trasformato in unformato specifico per la lingua per la presentazione a un utente). Inoltre, la funzione number nonpuò essere utilizzata a meno che il formato neutro/indipendente dalla lingua utilizzato dai relativielementi sia coerente con la sintassi XPath per un Number.

round(number)

La funzione round restituisce il valore dell’espressione arrotondato al numero intero più vicino.Se esistono due numeri di questo tipo, verrà restituito quello più vicino a infinito positivo. Sel’argomento è NaN, viene restituito NaN. Se l’argomento è infinito positivo, verrà restituito infinitopositivo. Se l’argomento è infinito negativo, verrà restituito infinito negativo. Se l’argomento è zeropositivo, verrà restituito zero positivo. Se l’argomento è zero negativo, verrà restituito zero negativo.Se l’argomento è inferiore a zero, ma maggiore o uguale a -0,5, verrà restituito zero negativo. Pergli ultimi due casi, il risultato della chiamata della funzione round non è lo stesso risultato che siottiene aggiungendo 0,5 e chiamando quindi la funzione floor.

sum(node-set)

La funzione sum restituisce la somma, per ciascun nodo del set di nodi dell’argomento, del risultatodella conversione dei valori stringa del nodo in un numero.

Funzioni dei set di nodiÈ possibile utilizzare le seguenti espressioni per i set di nodi quando si crea un’espressione divariabile xPath.

• count(node-set), pagina 266

• last(), pagina 266

• local-name(node-set), pagina 266

• name(node-set), pagina 266

265

Page 266:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

• namespace-uri(node-set), pagina 266

• position(), pagina 267

count(node-set)

La funzione count restituisce il numero di nodi presenti nel set di nodi dell’argomento.

last()

La funzione last restituisce un numero uguale alla dimensione del contesto (il numero di nodipresenti all’interno) nell’elenco del nodo di contesto.

local-name(node-set)

La funzione local-name restituisce il nome del primo nodo del set di nodi. Se il set di nodidell’argomento è vuoto o se il primo nodo non ha un nome esteso, verrà restituita una stringa vuota.Se l’argomento viene omesso, viene utilizzato per impostazione predefinita un set di nodi con ilnodo di contesto come unico membro.

name(node-set)

La funzione name restituisce una stringa che contiene il nome del nodo di contesto, compreso ilprefisso dello spazio dei nomi. Se il set di nodi dell’argomento è vuoto o se il primo nodo non ha unnome esteso, verrà restituita una stringa vuota. Se l’argomento viene omesso, viene utilizzato perimpostazione predefinita un set di nodi con il nodo di contesto come unico membro.

Nota: La stringa restituita dalla funzione name sarà la stessa stringa restituita dalla funzionelocal-name tranne che per i nodi elemento e i nodi attributo.

namespace-uri(node-set)

La funzione namespace-uri restituisce l’URI dello spazio dei nomi del nome esteso del nome nelset di nodi dell’argomento primo nell’ordine del documento. Se il set di nodi dell’argomento èvuoto, il primo nodo non ha un nome esteso o l’URI dello spazio dei nomi del nome esteso è null,verrà restituita una stringa vuota. Se l’argomento viene omesso, viene utilizzato per impostazionepredefinita un set di nodi con il nodo di contesto come unico membro.

Nota: La funzione namespace-uri attualmente non è supportata in xPression.

266

Page 267:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

position()

La funzione position restituisce un numero uguale alla posizione di un nodo in un set di nodi,secondo l’ordine del documento.

Esempioposition( )=2

Restituisce il secondo elemento di un set di nodi.

267

Page 268:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPath

268

Page 269:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice B

Funzioni xPresso

Quando si creano variabili in xPresso for Word, è possibile utilizzare delle funzioni nelle definizionidi variabili. Se non specificato diversamente, le funzioni possono utilizzare un valore letterale o unoschema come argomento. In questo capitolo vengono descritte le funzioni disponibili per l’uso inespressioni variabili:• Funzioni numeriche, pagina 269

• Funzioni logiche, pagina 270

• Funzioni group, pagina 271

• Funzioni stringa, pagina 273

• Funzioni Datetime, Date e Time, pagina 276

Funzioni numericheLe funzioni numeriche seguenti possono essere utilizzate nella creazione di un’espressione variabile:

• abs, pagina 269

• floor, pagina 270

• ceil, pagina 270

• round, pagina 270

• stringToInteger, pagina 270

Le funzioni numeriche non possono utilizzare variabili o xPath negli argomenti; accettano soloinput numerici.

abs

La funzione abs accetta un valore double per l’argomento numeric_value e restituisce in valore double.abs(numeric_value)

Restituisce il valore assoluto di numeric_value.

Esempio: abs(-2) Restituisce: 2

269

Page 270:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

floor

La funzione floor accetta un valore double o float per l’argomento numeric_value e restituisce unvalore double o float.floor(numeric_value)

Restituisce il maggior valore in virgola mobile (più vicino all’infinito positivo) minore di numeric_valuee uguale a un numero intero matematico.

Esempio: floor(2.3) Restituisce: 2

ceil

La funzione ceil accetta un valore double o float per l’argomento numeric_value e restituisce un valoredouble o float.ceil (numeric_value)

Restituisce il minor valore in virgola mobile (più vicino all’infinito negativo) non minore dinumeric_value e uguale a un valore intero matematico.

Esempio: ceil(2.3) Restituisce: 3

round

La funzione round accetta un valore double per l’argomento numeric_value e restituisce un valoredouble.round(numeric_value)

Restituisce un numero intero.

Esempio: round(1.678) Restituisce: 2

stringToInteger

La funzione stringToInterger accetta un valore della stringa per l’argomento string_value e restituisceun valore intero.stringToInteger(string_value)

Converte il valore intero di string_value.

Esempio: stringToInteger(“124”) Restituisce: 124

Funzioni logicheLe funzioni logiche seguenti possono essere utilizzate nella creazione di un’espressione variabile.false

270

Page 271:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

Costante logica.true

Costante logica.isNull(variable_field)

Determina se variable_field restituisce un valore null. Questa funzione restituisce "true" se l’elementovariabile non esiste nei dati o se il valore della variabile è vuoto.

Campi vuoti e dati assenti

Un campo dati vuoto è un campo nei dati senza valore. Un campo dati assente è un campo noncontenuto nei dati. Ad esempio, i dati campione seguenti mostrano un campo dati vuoto:<TESTDATA><CLIENTACCOUNT></CLIENTACCOUNT></TESTDATA>

Se il campo <CLIENTACCOUNT> è assente anziché vuoto, gli stessi dati hanno l’aspetto seguente:<TESTDATA></TESTDATA>

I campi dati vuoti e assenti vengono gestiti nello stesso modo in xPression. Lo svantaggio di questocomportamento è che non è possibile distinguere tra una stringa di lunghezza 0 e una stringa divalore null.

I valori booleani non sono mai NULL in quanto vengono valutati a FALSE.

Funzioni groupLe funzioni group non possono utilizzare valori letterali negli argomenti; accettano solo variabili. Lefunzioni group seguenti possono essere utilizzate nella creazione di un’espressione variabile:

• groupCount, pagina 271

• groupSum, pagina 272

• groupMax, pagina 272

• groupMin, pagina 273

groupCount

La funzione groupCount accetta un campo XML per l’argomento variable_scope e restituisce unvalore intero. Il valore restituito include i record nel documento XML, ma non in array singoli infase di caricamento.groupCount(variable_scope)

Restituisce il numero totale di record in variable_scope.

271

Page 272:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

Nell’esempio seguente, QuarterPeriod:InvestmentA è una variabile con valore di tipo intero e valoridi 1.000, 2.000 e 4.000. QuarterPeriod è l’ambito.

Esempio: groupCount($QuarterPeriod$) Restituisce: 3

groupSum

La funzione groupSum accetta un campo XML per gli argomenti variable_field e variable_scope erestituisce un valore dello stesso tipo di variable_field.groupSum(variable_field, variable_scope)

Restituisce la sommatoria di variable_field in variable_scope.

Nell’esempio seguente, QuarterPeriod:InvestmentA è una variabile con valore di tipo intero e valoridi 1.000, 2.000 e 4.000. QuarterPeriod è l’ambito.

Esempio: groupSum($QuarterPeriod:InvestmentA$,$QuarterPeriod$) Restituisce:7.000

Utilizzo di groupSum in un loop nidificato

Se si desidera utilizzare la funzione groupSum per calcolare la somma di ciascun loop all’interno delloop nidificato, è necessario compilare diversi espressioni in modo specifico.

Per calcolare la somma di tutti gli elementi “Premium” all’interno dell’elemento loopnidificato “\nestedLoop\Data\Table\Premium”, è necessario eseguire le operazioniseguenti:

1. Creare una nuova variabile Funzione xPresso denominata “NewVariable1”.

2. Eseguire la mappatura della variabile creando questa espressione:groupSum($Table:Premium$, $Table$)

3. Creare un’altra variabile Funzione xPresso nuova denominata “NewVariable2”.

4. Eseguire la mappatura della variabile creando questa espressione:groupSum($NewVariable1$, $Data$)

5. Creare una terza variabile Funzione xPresso nuova denominata “NewVariable3”.

6. Eseguire la mappatura della variabile creando questa espressione:groupSum($NewVariable2$, $nestedLoop$)

È possibile utilizzare quindi NewVariable3 nel modello per inserire la somma premium.

groupMax

La funzione groupMax accetta un campo XML per gli argomenti variable_field e variable_scope erestituisce un valore dello stesso tipo di variable_field.groupMax(variable_field, variable_scope)

272

Page 273:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

Restituisce il valore massimo di variable_field in variable_scope.

Nell’esempio seguente, QuarterPeriod:InvestmentA è una variabile con valore di tipo intero e valoridi 1.000, 2.000 e 4.000. QuarterPeriod è l’ambito.

Esempio: groupMax($QuarterPeriod:InvestmentA$,$QuarterPeriod$) Restituisce:4.000

groupMin

La funzione groupMin accetta un campo XML per gli argomenti variable_field e variable_scope erestituisce un valore dello stesso tipo di variable_field.groupMin(variable_field, variable_scope)

Restituisce il valore minimo di variable_field in variable_scope.

Nell’esempio seguente, QuarterPeriod:InvestmentA è una variabile con valore di tipo intero e valoridi 1.000, 2.000 e 4.000. QuarterPeriod è l’ambito.

Esempio: groupMin($QuarterPeriod:InvestmentA$,$QuarterPeriod$) Restituisce: 1.000

Funzioni stringaLe funzioni stringa seguenti possono essere utilizzate nella creazione di un’espressione variabile.

• length, pagina 273

• contains, pagina 274

• toLowerCase, pagina 274

• toUpperCase, pagina 274

• trim, pagina 274

• substring, pagina 275

• Posizione, pagina 119

• replace, pagina 275

• numericToString, pagina 275

length

La funzione length accetta un valore della stringa per l’argomento string_value e restituisce unvalore della stringa.length(string_value)

Restituisce il numero di caratteri di string_value.

Nell’esempio seguente, AccNum è una variabile con valore “123456789”.

273

Page 274:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

Esempio: length($AccNum$) Restituisce: 9

contains

La funzione contains accetta un valore della stringa per gli argomenti string_value e string_to_find erestituisce un valore booleano.contains(string_value, string_to_find)

Restituisce true se string_value contiene string_to_find; in caso contrario restituisce false.

Nell’esempio seguente, AccNum è una variabile con valore “123456789”.

Esempio: contains($AccNum$,"456") Restituisce: true

toLowerCase

La funzione toLowerCase accetta un valore stringa per l’argomento string_value e restituisce unvalore stringa.toLowerCase(string_value)

Converte tutti i caratteri in string_value in lettere minuscole.

Nell’esempio seguente, LastName è una variabile con valore “Smith”.

Esempio: toLowerCase($LastName$) Restituisce: smith

toUpperCase

La funzione toUpperCase accetta un valore della stringa per l’argomento string_value e restituisce unvalore della stringa.toUpperCase(string_value)

Converte tutti i caratteri in string_value in lettere maiuscole.

Nell’esempio seguente, LastName è una variabile con valore “Smith”.

Esempio: toUpperCase($LastName$) Restituisce: SMITH

trim

La funzione trim accetta un valore della stringa per l’argomento string_value e restituisce un valoredella stringa.trim(string_value)

Rimuove gli spazi iniziali e finali, le tabulazioni e i caratteri di nuova riga da string_value.

Esempio: trim (“ Agent ”) Restituisce: “Agent”

274

Page 275:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

substring

La funzione substring accetta un valore della stringa per l’argomento string_value, un valore interoper gli argomenti start e end e restituisce un valore della stringa.substring(string_value, start, end)

Restituisce una sottostringa formata da caratteri end–start , che inizia dall’indice start e termina conl’indice end di string_value.

Nell’esempio seguente, AccNum è una variabile con valore “123456789”.

Esempio: substring($AccNum$),4,2) Restituisce: “56”

position

La funzione position accetta un valore della stringa per gli argomenti string_to_search e string_to_find erestituisce un valore intero.position(string_to_search, string_to_find)

Restituisce la posizione della sottostringa string_to_find in string_to_search oppure-1 se non la trova.

Nell’esempio seguente, AccNum è una variabile con valore “123456789”.

Esempio: position($AccNum$,56) Restituisce: 5

replace

La funzione replace accetta un valore della stringa per gli argomenti string_value, string_to_find ereplacement_string e restituisce un valore della stringa.replace(string_value, string_to_find, replacement_string)

Cerca string_to_find in string_value e sostituisce ogni occorrenza con replacement_string.

Nell’esempio seguente, AccNum è una variabile con valore “123456789”.

Esempio: replace($AccNum$),12,99) Restituisce: “993456789”

numericToString

La funzione numericToString accetta un valore double, float o intero per l’argomento numeric_valuee restituisce un valore della stringa.numericToString(numeric_value)

Converte un numero in una stringa.

Esempio: numericToString( 23.5) Restituisce: “23.5”

275

Page 276:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

Funzioni Datetime, Date e TimeI campi Data, Ora e DataOra devono essere visualizzati nei dati utilizzando un formato specifico:• Data: aaaa-mm-gg (ad esempio: 2003-05-19)

• Ora: hh:mm:ss (ad esempio: 11:22:50)

• DataOra: aaaa-mm-ggThh:mm:ss (ad esempio: 2002-01-05T03:15:30)

Le funzioni datetime, date e time possono essere utilizzate per la creazione di un’espressione variabile.

• addYear, pagina 276

• addMonth, pagina 276

• addDay, pagina 276

• now, pagina 277

addYear

La funzione addYear accetta una variabile di tipo datetime o date per l’argomentodatetime_or_date_value, un valore intero per l’argomento numeric_value e restituisce un valore datetimeo date a seconda del valore di input.addYear(datetime_or_date_value, numeric_value)

Restituisce un valore datetime o date con l’aggiunta di numeric_value anni a datetime_or_date_value.

Nell’esempio seguente, DateDue è una variabile con valore “2006-03-21”.

Esempio: addYear($DateDue$,20) Restituisce: 2026-03-21

addMonth

La funzione addMonth accetta una variabile di tipo datetime o date per l’argomentodatetime_or_date_value, un valore intero per l’argomento numeric_value e restituisce un valore didatetime o date a seconda del valore di input.addMonth(datetime_or_date_value, numeric_value)

Restituisce un valore datetime o date con l’aggiunta di numeric_valuemesi a datetime_or_date_value.

Nell’esempio seguente, DateDue è una variabile con valore “2006-03-21”.

Esempio: addMonth($DateDue$,2) Restituisce: 2006-05-21

addDay

La funzione addDay accetta una variabile di tipo datetime o date per l’argomentodatetime_or_date_value, un valore intero per l’argomento numeric_value e restituisce un valore didatetime o date a seconda del valore di input.

276

Page 277:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

addDay(datetime_or_date_value, numeric_value)

Restituisce un valore datetime o date con l’aggiunta di numeric_value giorni a datetime_or_date_value.

Nell’esempio seguente, DateDue è una variabile con valore “2006-03-21”.

Esempio: addDay($DateDue$,2) Restituisce: 2006-03-23

now

La funzione now restituisce un valore di datetime.now()

Restituisce la data e l’ora correnti.

277

Page 278:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni xPresso

278

Page 279:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice C

Funzioni JavaScript

Quando si creano variabili in xPresso for Word con un tipo origine di JavaScript, è possibile utilizzarele funzioni JavaScript nell’espressione variabile. In questo capitolo vengono descritte le funzionidisponibili per essere utilizzate nelle espressioni delle variabili di JavaScript.• Funzioni object, pagina 279

• Funzioni numeriche, pagina 280

• Funzioni stringa, pagina 288

• Funzioni DataOra, pagina 295

• Funzioni array, pagina 299

Per ulteriori informazioni su JavaScript, vedere http://www.mozilla.org/js/language/E262–3.pdf.

Funzioni objectLe funzioni object seguenti possono essere utilizzate nella creazione di un’espressione variabile.

• toString(), pagina 279

• toLocaleString(), pagina 280

• valueOf(), pagina 280

toString()La funzione toString esegue i passaggi seguenti per restituire un valore:

1. Viene recuperata la proprietà [[Class]] dell’object.

2. Viene calcolato un valore di stringa concatenando le tre stringhe "[object ", Result(1) e "]".

3. Viene restituito Result(2).

279

Page 280:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

toLocaleString()

La funzione toLocaleString restituisce il risultato della chiamata a toString().

Nota: La funzione toLocaleString fornisce a tutti gli object un’interfaccia toLocaleString generica,anche se non tutti possono utilizzarla. Attualmente Array, Number e Date forniscono i propri metoditoLocaleString dipendenti dalle impostazioni internazionali.

valueOf()

La funzione valueOf restituisce il valore this. Se l’object è il risultato della chiamata del costruttore diobject con un object host, a livello di implementazione viene definito se valueOf restituisce il valorethis o un altro valore, ad esempio l’object host originariamente passato al costruttore.

Funzioni numericheLe funzioni numeriche seguenti possono essere utilizzate nella creazione di un’espressione variabile:

• Math.abs(number), pagina 281

• Math.acos(number), pagina 281

• Math.asin(number), pagina 281

• Math.atan(number), pagina 282

• Math.ceil(number), pagina 282

• Math.cos(number), pagina 282

• Math.exp(number), pagina 283

• Math.floor(number), pagina 283

• Math.log(number), pagina 283

• Math.max(number1, number2), pagina 284

• Math.min(number1, number2), pagina 284

• Math.pow(base, exponent), pagina 284

• Math.random(), pagina 285

• Math.round(number), pagina 285

• Math.sin(number), pagina 286

• Math.sqrt(number), pagina 286

• Math.tan(number), pagina 286

• eval(x), pagina 286

• isNaN(testValue), pagina 287

• parseInt(string [,radix]), pagina 287

280

Page 281:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

• parseFloat(string), pagina 287

• isFinite(number), pagina 287

• toFixed(fractionDigits), pagina 288

• toExponential(fractionDigits), pagina 288

• toPrecision(precision), pagina 288

Nota: In JavaScript, i numeri di nodo a virgola mobile non sono precisi. Pertanto, è consigliabile nonutilizzare i valori float per calcolare una quantità esatta, ad esempio per i calcoli monetari.

Math.abs(number)

La funzioneMath.abs restituisce il valore assoluto di number; il risultato ha lo stesso ordine digrandezza di number ma con un segno positivo.• Se number è NaN, il risultato è NaN

• Se number è − 0, il risultato è +0.

• Se number è −∞, il risultato è +∞.

Math.acos(number)

La funzioneMath.acos restituisce l’arcocoseno di number. Il risultato è espresso in radianti e intervallida +0 a +π. Se number è al di fuori dell’intervallo suggerito, il valore restituito è sempre 0.• Se number è NaN, il risultato è NaN.

• Se number è maggiore di 1, il risultato è NaN.

• Se number è minore di −1, il risultato è NaN.

• Se number è 1, il risultato è +0.

Math.asin(number)

La funzioneMath.asin restituisce l’arcoseno di number. Il risultato è espresso in radianti e intervallida −π/2 a +π/2. Se number è al di fuori dell’intervallo suggerito, il valore restituito è sempre 0.

• Se number è NaN, il risultato è NaN.

• Se number è maggiore di 1, il risultato è NaN.

• Se number è minore di −1, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

281

Page 282:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Math.atan(number)

La funzioneMath.atan restituisce l’arcotangente di number. Il risultato è espresso in radiantie intervalli da −π/2 a +π/2.

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞, il risultato è un’approssimazione a +π/2 dipendente dall’implementazione.

• Se number è −∞, il risultato è un’approssimazione a −π/2 dipendente dall’implementazione.

Math.ceil(number)

La funzione Math.ceil restituisce il valore numerico minore (più vicino a −∞) che non sia minore dinumber e sia uguale a un numero intero matematico. Se number è già un numero intero, il risultatosarà number.

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞, il risultato è +∞.

• Se number è −∞, il risultato è −∞.

• Se number è minore di 0 ma è maggiore di -1, il risultato è −0.

Il valore diMath.ceil(x) è lo stesso del valore di -Math.floor(-x).

Math.cos(number)

La funzioneMath.cos restituisce il coseno di number, un valore numerico compreso tra -1 e 1, cherappresenta il coseno dell’angolo. L’argomento è espresso in radianti.

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è 1.

• Se number è −0, il risultato è 1.

• Se number è +∞, il risultato è NaN.

• Se number è −∞, il risultato è NaN.

282

Page 283:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Math.exp(number)

La funzioneMath.exp restituisce la funzione esponenziale di number (e innalzato alla potenza dinumber, dove e è la base dei logaritmi naturali).

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è 1.

• Se number è −0, il risultato è 1.

• Se number è +∞, il risultato è +∞.

• Se number è − ∞, il risultato è +0.

Math.floor(number)

La funzioneMatch.floor restituisce il valore numerico maggiore (più vicino a +∞) che non siamaggiore di number e sia uguale a un numero intero matematico. Se number è già un numero intero, ilrisultato sarà number.

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞, il risultato è +∞.

• Se number è −∞, il risultato è −∞.

• Se number è maggiore di 0 ma minore di 1, il risultato è +0.

Nota: Il valore diMath.floor(x) è lo stesso del valore di -Math.ceil(-x).

Math.log(number)

La funzione Math.log restituisce il logaritmo naturale di number. Se il valore del numero è esternoall’intervallo suggerito, il valore restituito è sempre −1.797693134862316e+308.

• Se number è NaN, il risultato è NaN.

• Se number è minore di 0, il risultato è NaN.

• Se number è +0 o − 0, il risultato è − ∞.

• Se number è 1, il risultato è +0.

• Se number è +∞, il risultato è +∞.

283

Page 284:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Math.max(number1, number2)

La funzioneMath.max, con zero o più argomenti, restituisce il maggiore dei valori risultanti.• Se non sono specificati argomenti, il risultato è −∞.

• Se un valore è NaN, il risultato è NaN.

• Quando vengono confrontati i valori per determinare il valore maggiore, +0 è consideratomaggiore di − 0.

La proprietà length della funzioneMath.max è 2.

Math.min(number1, number2)

La funzioneMath.min, con zero o più argomenti, restituisce il minore dei valori risultanti.• Se non sono specificati argomenti, il risultato è +∞.

• Se un valore è NaN, il risultato è NaN.

• Quando vengono confrontati i valori per determinare il valore maggiore, +0 è consideratomaggiore di − 0.

La proprietà length della funzioneMath.min è 2.

Math.pow(base, exponent)

La funzioneMath.pow restituisce il risultato dell’elevazione di base all’exponent di potenza.• Se esponente è NaN, il risultato è NaN.

• Se exponent è +0, il risultato è 1, anche se base è NaN.

• Se exponent è −0, il risultato è 1, anche se base è NaN.

• Se base è NaN e exponent è diverso da zero, il risultato è NaN.

• Se abs(base)>1 e exponent è +∞, il risultato è +∞.

• Se abs(base)>1 e exponent è − ∞, il risultato è +0.

• Se abs(base)= =1 e exponent è +∞, il risultato è NaN.

• Se abs(base)= =1 e exponent è −∞, il risultato è NaN.

• Se abs(base)<1 e exponent è + ∞, il risultato è +0.

• Se abs(base)<1 e exponent è −∞, il risultato è +∞.

• Se base è +∞ e exponent>0, il risultato è +∞.

• Se base è + ∞ e exponent<0, il risultato è +0.

• Se base è −∞ e exponent>0 e exponent è un numero intero dispari, il risultato è −∞.

• Se base è −∞ e exponent>0 e exponent non è un numero intero dispari, il risultato è +∞.

284

Page 285:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

• Se base è −∞ e exponent<0 e exponent è un numero intero dispari, il risultato è −0.

• Se base è − ∞ e exponent<0 e exponent non è un numero intero dispari, il risultato è +0.

• Se base è +0 e exponent> 0, il risultato è +0.

• Se base è +0 e exponent<0, il risultato è + ∞.

• Se base è −0 e exponent>0 e exponent è un numero intero dispari, il risultato è −0.

• Se base è − 0 e exponent>0 e exponent non è un numero intero dispari, il risultato è +0.

• Se base è −0 e exponent<0 e exponent è un numero intero dispari, il risultato è −∞.

• Se base è −0 e exponent<0 e exponent non è un numero intero dispari, il risultato è +∞.

• Se base<0 e base è un numero finito e exponent è un numero finito e exponent non è un numerointero, il risultato è NaN.

Math.random()

La funzioneMath.random restituisce un valore numerico con segno positivo, maggiore o ugualea 0 ma minore di 1, selezionati in modo casuale o pseudo casuale. Questa funzione non utilizzaargomenti. Questa funzione è disponibile solo per piattaforme UNIX.

Math.round(number)

La funzioneMath.round restituisce il valore numerico più vicino a number e uguale a un numerointero matematico. Se la parte frazionaria di un numero è 0,5 o maggiore, l’argomento è arrotondatoal successivo intero più alto. Se la parte frazionaria di un numero è minore di 0,5, l’argomento èarrotondato al successivo intero più basso. Se due valori numerici interi sono ugualmente vicini anumber, il risultato è il valore numerico più vicino a +∞. Se number è già un numero intero, il risultatosarà number.• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞, il risultato è +∞.

• Se number è −∞, il risultato è −∞.

• Se number è maggiore di 0 ma minore di 0,5, il risultato è +0.

• Se number è minore di 0 ma è maggiore o uguale a -0,5, il risultato è −0.

Nota: (1) Math.round(3.5) restituisce 4, but Math.round(–3.5) restituisce –3. (2) Il valore diMath.round(numero) è lo stesso del valore di Math.floor(x+0.5), tranne quando numero è − 0 o èminore di 0 ma maggiore o uguale -0,5; in questi casi Math.round(numero) restituisce − 0, maMath.floor(x+0.5) restituisce +0.

285

Page 286:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Math.sin(number)

La funzioneMath.sin restituisce il seno di number, un valore numerico compreso tra –1 e 1, cherappresenta il seno dell’angolo. L’argomento è espresso in radianti.

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞ o −∞, il risultato è NaN.

Math.sqrt(number)

La funzioneMath.sqrt restituisce la radice quadrata di number. Se il valore di number è al di fuoridell’intervallo suggerito, il valore restituito è sempre 0.

• Se number è NaN, il risultato è NaN.

• Se number è minore di 0, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞, il risultato è +∞.

Math.tan(number)

La funzioneMath.tan restituisce la tangente di number, un valore numerico che rappresenta latangente dell’angolo. L’argomento è espresso in radianti.

• Se number è NaN, il risultato è NaN.

• Se number è +0, il risultato è +0.

• Se number è −0, il risultato è −0.

• Se number è +∞ o −∞, il risultato è NaN.

eval(x)

Quando la funzione eval viene chiamata con un solo argomento x, vengono eseguiti i passaggiriportati di seguito.1. Se x non è un valore stringa, viene restituito x.

2. Viene analizzato x come un programma. Se l’analisi non riesce, viene restituita un’eccezioneSyntaxError.

3. Valutare il programma dalla fase 2.

286

Page 287:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

4. Se Result(3).type è normal e il suo valore di completamento è un valore V, viene restituito ilvalore V.

5. Se Result(3).type è normal e il suo valore di completamento è vuoto, viene restituito il valoreundefined.

6. Result(3).type deve essere generato. Genera Result(3).value come un’eccezione.

Se il valore della proprietà eval viene utilizzato in modo diverso rispetto a una chiamata diretta (valea dire in modo diverso dall’uso esplicito del relativo nome come identificativo MemberExpressionin una CallExpression), o se la proprietà eval viene assegnata, può essere generata un’eccezioneEvalError.

isNaN(testValue)

La funzione isNaN valuta un argomento e restituisce true se il risultato è NaN (Not a Number); incaso contrario, restituisce false. Questa funzione è disponibile solo per piattaforme UNIX.

parseInt(string [,radix])

La funzione parseInt analizza la string e restituisce il numero intero della radix (o base) specificata. Lospazio iniziale nella stringa viene ignorato. Se radix non è definito o è 0, si presume che sia 10 trannenel caso in cui il numero inizi con la coppia di caratteri 0x o 0X, nel qual caso si presume una radix di16. Una radix con il numero -16 può anche iniziare con la coppia di caratteri 0x o 0X.

Nota: parseInt può interpretare solo una parte iniziale della stringa come un valore intero; ignora icaratteri che non possono essere interpretati come parte della notazione di un numero intero e nonviene fornita alcuna indicazione del fatto che tali caratteri sono stati ignorati.

Una radice di 10 indica di eseguire la conversione in un numero decimale, ottale (base 8), esadecimale(base 16) e così via. Per radici maggiori di 10, le lettere dell’alfabeto indicano cifre maggiori di 9. Adesempio, per numeri esadecimali (base 16), vengono utilizzate le lettere da A a F.

parseFloat(string)

La funzione parseFloat analizza la string e restituisce un numero a virgola mobile.

Nota: Se parseFloat incontra un carattere diverso da un segno (+ o -), un numero (0-9), un puntodecimale o un esponente, restituisce il valore fino a quel punto e ignora quel carattere e tutti i caratterisuccessivi. Non viene fornita alcuna indicazione del fatto che tali caratteri sono stati ignorati.

isFinite(number)

La funzione isFinite applica ToNumber al relativo argomento, quindi restituisce false se il risultato èNaN, +∞ o −∞; in caso contrario restituisce true.

287

Page 288:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

toFixed(fractionDigits)

La funzione toFixed Restituisce una stringa contenente il numero rappresentato in notazione avirgola fissa con cifre fractionDigits dopo il punto decimale. Se fractionDigits non è definito, sipresume il valore 0.

La proprietà length della funzione toFixed è 1.

Nota: L’output di toFixed può essere più preciso di toString per alcuni valori perché toStringvisualizza solo un numero di cifre significative per distinguere il numero dai valori numericiadiacenti. Ad esempio, (1000000000000000128).toString() restituisce "1000000000000000100", mentre(1000000000000000128).toFixed(0) restituisce "1000000000000000128".

toExponential(fractionDigits)

La funzione toExponential Restituisce una stringa contenente il numero rappresentato in notazioneesponenziale con una sola cifra prima della parte frazionaria della mantissa e fractionDigits cifre dopola parte frazionaria della mantissa. Se fractionDigits non è definito, includere tutte le cifre dellamantissa necessarie per specificare il numero in modo univoco (in modo simile a ToString tranne chein questo caso il numero è sempre restituito in notazione esponenziale).

La proprietà length della funzione toExponential è 1.

toPrecision(precision)

La funzione toPrecision restituisce una stringa contenente il numero rappresentato in notazioneesponenziale con una sola cifra prima della parte frazionaria della mantissa e cifre con precisione –1dopo la parte frazionaria della mantissa o in notazione fissa con cifre significative. Se precision non èdefinita, chiamare toString.

La proprietà length della funzione toPrecision è 1.

Funzioni stringaLe funzioni numeriche seguenti possono essere utilizzate nella creazione di un’espressione variabile:

• charAt(index), pagina 289

• charCodeAt(pos), pagina 289

• concat( [string1 [, string2 [, ]]]), pagina 289

• indexOf(searchValue, [fromIndex]), pagina 290

• lastIndexOf(searchValue, [fromIndex]), pagina 290

• localeCompare(that), pagina 290

• match(regexp), pagina 291

288

Page 289:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

• replace(searchValue, replaceValue), pagina 291

• substring(indexA, indexB), pagina 292

• search(regexp), pagina 292

• slice(start, end), pagina 293

• split(separator, limit), pagina 293

• toLowerCase(), pagina 294

• toLocaleLowerCase(), pagina 294

• toUpperCase(), pagina 294

• toLocaleUpperCase(), pagina 295

• length, pagina 295

charAt(index)

La funzione charAt restituisce una stringa contenente il carattere di index nella stringa risultante dallaconversione dell’object in una stringa. I caratteri in una stringa sono indicizzati da sinistra a destra.L’indice del primo carattere è 0 e l’indice dell’ultimo carattere è stringName.length - 1. Se in quellaposizione non è presente nessun carattere o se index non è compreso nell’intervallo, il risultato è unastringa vuota. Il risultato è un valore stringa, non un object String.

Nota: La funzione charAt è intenzionalmente generica; non richiede che il relativo valore sia un objectStringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

charCodeAt(pos)

La funzione charCodeAt restituisce un numero (un numero intero non negativo inferiore a 216) cherappresenta il valore punto di codice del carattere nella posizione pos della stringa ottenuta dallaconversione dell’object in stringa. Se in quella posizione non è presente alcun carattere, il risultato èNaN.

Nota: La funzione charCodeAt è intenzionalmente generica; non richiede che il relativo valore sia unobject Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

concat( [string1 [, string2 [, ]]])

Quando si chiama la funzione concat con zero o più argomenti string1, string2 e così via, restituisceuna stringa composta dai caratteri dell’object (convertito in una stringa) seguiti dai caratteri di ciascunargomento string1, string2 e così via (dove ciascun argomento è convertito in una stringa). Il risultatoè un valore stringa, non un object String.

La proprietà length del metodo concat è 1.

289

Page 290:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Nota: La funzione concat è intenzionalmente generica; non richiede che il relativo valore sia un objectStringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

indexOf(searchValue, [fromIndex])

La funzione indexOf restituisce l’indice all’interno dell’object stringa chiamante della primaoccorrenza del valore specificato, iniziando la ricerca da fromIndex. I caratteri della stringa sonoindicizzati da sinistra a destra. L’indice del primo carattere è 0 e l’indice dell’ultimo carattereè stringName.length - 1. Se searchValue viene visualizzato come sottostringa del risultato dellaconversione dell’object in una stringa, in una o più posizioni maggiori o uguali a fromIndex, vienerestituito l’indice di tale posizione minore; in caso contrario viene restituito -1. Se fromIndex non èdefinito, si presume il valore 0, in modo che venga cercata tutta la stringa.

La proprietà length del metodo indexOf è 1.

Nota: La funzione indexOf è intenzionalmente generica; non richiede che il relativo valore sia unobject Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

lastIndexOf(searchValue, [fromIndex])

La funzione lastIndexOf restituisce l’indice all’interno dell’object stringa chiamante dell’ultimaoccorrenza del valore specificato. La stringa chiamante viene ricercata procedendo all’indietro,partendo da fromIndex. I caratteri della stringa sono indicizzati da sinistra a destra. L’indice del primocarattere è 0 e l’indice dell’ultimo carattere è stringName.length - 1. Se searchValue viene visualizzatocome sottostringa del risultato della conversione dell’object in una stringa, in una o più posizioniminori o uguali a fromIndex, viene restituito l’indice di tale posizione maggiore; in caso contrarioviene restituito -1. Se fromIndex non è definito, si presume il valore length della stringa, in modo chevenga cercata tutta la stringa.

La proprietà length del metodo lastIndexOf è 1.

localeCompare(that)

Se si chiama il metodo localeCompare con un argomento, viene restituito un numero diverso daNaN che rappresenta il risultato di un confronto stringhe sensibile alle impostazioni internazionalidell’object this (convertito in una stringa) con that (convertito in una stringa). Le due stringhevengono confrontate in un modo definito dall’implementazione. Il risultato deve ordinare le stringhenell’ordinamento specificato dalla impostazioni internazionali predefinite del sistema, e sarà negativo,zero o positivo, a seconda che, rispettivamente, la stringa this venga prima di that nell’ordinamento,le stringhe siano uguali, o che la stringa this venga dopo that nell’ordinamento.

Il metodo localeCompare, se considerato come una funzione dei due argomenti this e that, è unafunzione di confronto coerente sul set di tutte le stringhe. Inoltre, localeCompare restituisce 0 o–0 quando viene eseguito il confronto di due stringhe considerate regolarmente equivalenti dallostandard Unicode.

290

Page 291:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Nota: La funzione localeCompare è intenzionalmente generica; non richiede che il relativo valoresia un object Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo.

match(regexp)

Se regexp non è un object la cui proprietà [[Class]] è "RegExp", viene sostituito con il risultatodell’espressione new RegExp(regexp). Utilizzare la stringa per denotare il risultato della conversionedel valore this in una stringa. Quindi effettuare una delle azioni seguenti:• Se regexp.global è false: viene restituito il risultato ottenuto chiamando RegExp.prototype.exec suregexp con la stringa come parametro.

• Se regexp.global è true: impostare la proprietà regexp.lastIndex su 0 e chiamareRegExp.prototype.exec più volte, fino a quando non saranno trovate corrispondenze. Se vienetrovata una corrispondenza con una stringa vuota (in altre parole, se il valore di regexp.lastIndexnon viene modificato), aumentare regexp.lastIndex di 1. Utilizzare n come numero dicorrispondenze. Il valore restituito è un array con la proprietà length impostata su n e le proprietàda 0 a n–1 corrispondenti ai primi elementi dei risultati di tutti i richiami corrispondenti diRegExp.prototype.exec.

Nota: La funzionematch è intenzionalmente generica; non richiede che il relativo valore sia un objectStringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

replace(searchValue, replaceValue)

Utilizzare la stringa per denotare il risultato della conversione del valore this in una stringa.

Se searchValue è un’espressione regolare (un object la cui proprietà [[Class]] è "RegExp"),eseguire le operazioni seguenti: se searchValue.global è false, ricercare la stringa per la primacorrispondenza dell’espressione regolare searchValue. Se searchValue.global è true, ricercare lastringa per tutte le corrispondenze dell’espressione regolare searchValue. Effettuare la ricerca comein String.prototype.match, compreso l’aggiornamento di searchValue.lastIndex. Utilizzare m perindicare il numero di parentesi di cattura rimaste in searchValue.

Se searchValue non è un’espressione regolare, utilizzare searchString come ToString(searchValue) ecercare la stringa per la prima occorrenza di searchString. Utilizzare m come 0.

Se replaceValue è una funzione, per ogni sottostringa corrispondente, chiamare la funzione coni seguenti argomenti m + 3. L’argomento 1 è la sottostringa corrispondente. Se searchValue èun’espressione regolare, i successivi argomenti m sono tutte le catture nel MatchResult. L’argomentom + 2 è l’offset all’interno della stringa in cui si è verificata la corrispondenza e l’argomento m + 3 è lastringa. Il risultato è un valore stringa derivato dall’input originale sostituendo ogni sottostringacorrispondente con il valore restituito corrispondente della chiamata alla funzione, convertito instringa se necessario.

In caso contrario, utilizzare newstring per denotare il risultato della conversione di replaceValue inuna stringa. Il risultato è un valore stringa derivato dalla stringa di input originale sostituendo ognisottostringa corrispondente con una stringa derivata da newstring sostituendo i caratteri in newstringcon il testo sostitutivo secondo quanto specificato nella tabella seguente. La sostituzione con $ viene

291

Page 292:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

effettuata da sinistra a destra e una volta eseguita tale sostituzione, il nuovo testo sostitutivo nonsarà soggetto ad ulteriori sostituzioni. Ad esempio, "$1,$2".replace(/(\$(\d))/g, "$$1-$1$2") restituisce"$1-$11,$1-$22". Un carattere $ in newstring che non corrisponde ad alcuna delle forme riportatesotto resta invariato.

Caratteri Testo sostitutivo

$$ $

$& La sottostringa corrispondente.

$‘ La parte di string che precede la sottostringa corrispondente.

$’ La parte di string che segue la sottostringa corrispondente.

$n La nesima cattura, dove n è una singola cifra da 1 a 9 e $n non è seguito da unacifra decimale. Se n≤m e la nesima cattura non è definita, utilizzare invece lastringa vuota. Se n> m, il risultato è definito dall’implementazione.

$nn La nnesima cattura, dove nn è un numero decimale a due cifre compreso tra 01e 99. Se nn≤m e la nnesima cattura non è definita, utilizzare invece la stringavuota. Se nn> m, il risultato è definito dall’implementazione.

Nota: La funzione replace è intenzionalmente generica; non richiede che il relativo valore sia unobject Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

substring(indexA, indexB)

La funzione substring restituisce un set secondario di un object Stringa. I caratteri in una stringasono indicizzati da sinistra a destra. L’indice del primo carattere è 0 e l’indice dell’ultimo carattereè stringName.length - 1. Se indexA è minore di indexB, la funzione substring restituisce il setsecondario che inizia con il carattere in indexA e termina con il carattere prima di indexB. Se indexA èmaggiore di indexB, la funzione substring restituisce il set secondario che inizia con il carattere inindexB e termina con il carattere prima di indexA. Se indexA è uguale a indexB, la funzione substringrestituisce una stringa vuota.

La proprietà length della funzione substring è 2.

Nota: La funzione substring è intenzionalmente generica; non richiede che il relativo valore sia unobject Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

search(regexp)

Se regexp non è un object la cui proprietà [[Class]] è "RegExp", viene sostituito con il risultatodell’espressione new RegExp(regexp). Utilizzare la stringa per denotare il risultato della conversionedel valore this in una stringa.

Nel valore string viene cercata l’occorrenza del modello di espressione regolare regexp a partire dalsuo inizio. Il risultato è un numero che indica l’offset all’interno della stringa in cui è stata trovatacorrispondenza del modello oppure –1 se non esiste corrispondenza.

292

Page 293:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Nota: (1) Questa funzione ignora le proprietà lastIndex e global di regexp. La proprietà lastIndex diregexp non viene modificata. (2) La funzione search è intenzionalmente generica; non richiede che ilrelativo valore sia un object Stringa. Pertanto può essere trasferita ad altri tipi di object per essereutilizzata come metodo.

slice(start, end)

La funzione slice accetta due argomenti, start e end e restituisce una sottostringa del risultato dellaconversione dell’object in una stringa, partendo dalla posizione di carattere start e continuando, senzaincluderla, fino alla posizione di carattere end (o fino alla fine della stringa se l’argomento end non èdefinito). Se il valore start è negativo, viene considerato come (sourceLength+start) dove sourceLength èla lunghezza della stringa. Se il valore end è negativo, viene considerato come (sourceLength+end) dovesourceLength è la lunghezza della stringa. Il risultato è un valore stringa, non un object String.

La proprietà length del metodo slice è 2.

Nota: La funzione slice è intenzionalmente generica; non richiede che il relativo valore sia un objectStringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

split(separator, limit)

La funzione split restituisce un object Array in cui è stato memorizzato il risultato della conversionedi questo object in una stringa. Le sottostringhe sono determinate ricercando da sinistra a destra leoccorrenze di un separatore; queste occorrenze non fanno parte delle sottostringhe nell’array restituito,ma servono per dividere il valore stringa. Il valore del separatore può essere una stringa di qualsiasilunghezza o un object RegExp (ad esempio, un object la cui proprietà [[Class]] sia "RegExp").

Il valore di separator può essere una stringa vuota, un’espressione regolare vuota o un’espressioneregolare in grado di corrispondere a una stringa vuota. In questo caso, separator non corrispondealla sottostringa vuota all’inizio o alla fine della stringa di input e non corrisponde alla sottostringavuota alla fine della precedente corrispondenza del separatore. (Ad esempio, se separator è la stringavuota, la stringa viene suddivisa in singoli caratteri; la lunghezza dell’array del risultato è ugualealla lunghezza della stringa e ciascuna sottostringa contiene un solo carattere). Se separator èun’espressione regolare, viene considerata solo la prima corrispondenza in una determinata posizionedella stringa, anche se il backtracking potrebbe produrre una corrispondenza di sottostringa nonvuota in quella posizione. (Ad esempio, "ab".split(/a*?/) viene valutato nell’array ["a","b"], mentre"ab".split(/a*/) viene valutato come array["","b"].)

Se questo object è (o viene convertito in) una stringa vuota, il risultato dipende da se separatorcorrisponde alla stringa vuota. In caso affermativo, l’array risultante non conterrà elementi. In casocontrario, l’array risultante conterrà un solo elemento, vale a dire la stringa vuota.

Se separator è un’espressione regolare che contiene parentesi di cattura, ogni volta che il separatorecorrisponde, i risultati (inclusi eventuali risultati non definiti) delle parentesi di cattura sono unitinell’array di output. (Ad esempio, "A<B>bold</B>and<CODE>coded</code>".split(/<(\/)?([^<>]+)>/)viene valutato nell’array ["A", undefined, "B", "bold", "/", "B", "and", undefined, "CODE", "coded","/", "CODE", ""].)

293

Page 294:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Se separator non è definito, l’array risultante contiene una sola stringa, che il valore this (convertitoin una stringa). Se limit non è definito, l’array di output viene troncato in modo che contenga unnumero di elementi non superiori a limit.

La proprietà length della funzione split è 2.

Nota: (1) La funzione split è intenzionalmente generica; non richiede che il relativo valore sia unobject Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.(2) La funzione split ignora il valore di separator.global per i separatori che sono object RegExp.

toLowerCase()

La funzione toLowerCase converte singolarmente i caratteri della stringa in caratteri minuscoli. Sequesto object non è già una stringa, viene convertito in una stringa. Il risultato è un valore stringa,non un object String. La funzione toLowerCase non influisce sul valore di stringName.

I caratteri vengono convertiti singolarmente. Il risultato di ciascuna conversione è il carattereoriginale, a meno che il carattere abbia un equivalente minuscolo Unicode, nel qual caso viene inveceutilizzato l’equivalente minuscolo.

Nota: (1) Il risultato deve essere derivato in base al case mapping dei database di caratteri Unicode.(2) La funzione toLowerCase è intenzionalmente generica; non richiede che il relativo valore sia unobject Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo.

toLocaleLowerCase()

La funzione toLocaleLowerCase agisce esattamente come toLowerCase tranne che il suo risultatodeve essere quello corretto per le impostazioni internazionali correnti dell’ambiente host. Ci saràsolo una differenza nei pochi casi (ad esempio, il turco) in cui le regole della lingua sono in conflittocon i normali case mapping Unicode.

Nota: La funzione toLocaleLowerCase è intenzionalmente generica; non richiede che il relativovalore sia un object Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzatacome metodo.

toUpperCase()

La funzione toUpperCase agisce esattamente come toLowerCase, con la differenza che i caratterivengono mappati all’equivalente maiuscolo secondo quanto specificato nel database di caratteriUnicode. La funzione toUpperCase converte singolarmente i caratteri della stringa in caratterimaiuscoli. Se questo object non è già una stringa, viene convertito in una stringa. Il risultato è unvalore stringa, non un object String. La funzione toUpperCase non influisce sul valore di stringName.

Nota: (1) Dato che sia toUpperCase che toLowerCase presentano un funzionamento sensibile alcontesto, le funzioni non sono simmetriche. In altre parole, s.toUpperCase().toLowerCase() nonè necessariamente uguale a s.toLowerCase(). (2) La funzione toUpperCase è intenzionalmente

294

Page 295:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

generica; non richiede che il relativo valore sia un object Stringa. Pertanto può essere trasferita ad altritipi di object per essere utilizzata come metodo.

toLocaleUpperCase()

La funzione toLocaleUpperCase agisce esattamente come toUpperCase tranne che il suo risultatodeve essere quello corretto per le impostazioni internazionali correnti dell’ambiente host. Ci saràsolo una differenza nei pochi casi (ad esempio, il turco) in cui le regole della lingua sono in conflittocon i normali case mapping Unicode.

Nota: La funzione toLocaleUpperCase è intenzionalmente generica; non richiede che il relativovalore sia un object Stringa. Pertanto può essere trasferita ad altri tipi di object per essere utilizzatacome metodo.

length

Il numero di caratteri nel valore stringa rappresentato da questo object String. Una volta creato unobject String, questa proprietà non è modificabile.

Funzioni DataOraLe funzioni datetime seguenti possono essere utilizzate nella creazione di un’espressione di variabili:

• Date.parse(dateString), pagina 296

• getDate(), pagina 296

• getYear(), pagina 296

• getMonth(), pagina 296

• getDay(), pagina 296

• getTime(), pagina 297

• getHours(), pagina 297

• getMinutes(), pagina 297

• getSeconds(), pagina 297

• getTimezoneOffset(), pagina 297

• setDate(dayValue), pagina 297

• setHours(hoursValue), pagina 297

• setMinutes(minutesValue), pagina 298

• setMonth(monthValue), pagina 298

• setSeconds(value), pagina 298

295

Page 296:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

• setTime(value), pagina 298

• setYear(value), pagina 298

• toGMTString(), pagina 298

• toLocaleString(), pagina 298

• Date.UTC(year, month, day [, hrs] [, min] [, sec]), pagina 299

Date.parse(dateString)

La funzione Date.parse utilizza una dateString (ad esempio ’19 marzo 2002’) e restituisce il numerodi millisecondi a partire dal 1 gennaio 1970 00:00:00, ora locale. Questa funzione è utile perl’impostazione di valori di data basati su valori stringa, ad esempio in combinazione con la funzionesetTime e l’object Date.

getDate()

La funzione getDate restituisce il giorno del mese per la data specificata. Il valore restituito dagetDate è un intero compreso tra 1 e 31.

getYear()

La funzione getYear restituisce l’anno nella data specificata. Il valore restituito da getYear è l’annomeno 1900. Se ad esempio l’anno è 1976, il valore restituito è 76.

getMonth()

La funzione getMonth restituisce il mese nella data specificata. Il valore restituito da getMonth è unintero compreso tra zero e undici. Zero corrisponde a gennaio, uno a febbraio e così via.

getDay()

La funzione getDay restituisce il giorno della settimana per la data specificata. Il valore restituito dagetDay è un intero che corrisponde al giorno della settimana: zero per domenica, uno per lunedì,due per martedì e così via.

296

Page 297:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

getTime()

La funzione getTime restituisce il valore numerico corrispondente all’ora della data specificata. Ilvalore restituito da getTime è il numero di millisecondi a partire dal 1 gennaio 1970 00:00:00. Èpossibile utilizzare questa funzione per assegnare una data e un’ora a un altro object data.

getHours()

La funzione getHours restituisce l’ora della data specificata. Il valore restituito da getHours è unintero compreso tra 0 e 23.

getMinutes()

La funzione getMinutes restituisce i minuti nella data specificata. Il valore restituito da getMinutes èun numero intero compreso tra 0 e 59.

getSeconds()

La funzione getSeconds restituisce i secondi nella data specificata. Il valore restituito da getSecondsè un numero intero compreso tra 0 e 59.

getTimezoneOffset()

La funzione getTimezoneOffset restituisce l’offset del fuso orario in minuti per le impostazioniinternazionali correnti. La differenza di fuso orario è la differenza tra l’ora locale e l’ora GMT. L’oralegale impedisce che questo valore sia una costante.

setDate(dayValue)

La funzione setDate imposta il giorno del mese per la data specificata.

setHours(hoursValue)

La funzione setHours imposta l’ora per la data specificata.

297

Page 298:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

setMinutes(minutesValue)

La funzione setMinutes imposta i minuti per la data specificata.

setMonth(monthValue)

La funzione setMonth imposta il mese per la data specificata.

setSeconds(value)

La funzione setSeconds imposta i secondi per la data specificata.

setTime(value)

La funzione setTime imposta il valore di un object data. Utilizzare la funzione setTime per assegnareuna data e un’ora a un altro object data.

setYear(value)

La funzione setYear imposta l’anno per la data specificata.

La proprietà length della funzione setYear è 3.

toGMTString()

La funzione toGMTString converte una data in una stringa, mediante le convenzioni GMT Internet.Il formato esatto del valore restituito da toGMTString varia in base alla piattaforma.

L’object Funzione che è il valore iniziale di toGMTString è lo stesso object Funzione valore inizialedi toUTCString.

toLocaleString()

La funzione toLocaleString restituisce un valore stringa. Il contenuto della stringa dipendedall’implementazione, ma deve rappresentare la data nel fuso orario corrente, in un formato chiaro eleggibile, che corrisponda alle convenzioni delle impostazioni internazionali correnti per l’ambientehost.

298

Page 299:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

Date.UTC(year, month, day [, hrs] [, min] [, sec])

Quando la funzioneDate.UTC viene chiamata con meno di due argomenti, il funzionamento dipendedall’implementazione. Quando la funzione UTC viene chiamata con un numero di argomenti che vada due a sette, calcola la data da anno, mese e (facoltativamente) data, ora, minuti e secondi.

La proprietà length della funzione Date.UTC è 7.

Nota: La funzione Date.UTC differisce dal costruttore di date in due modi: restituisce un valore oracome numero, anziché creare un object Data, ed interpreta gli argomenti in UTC anziché comeora locale.

Funzioni arrayLe funzioni array seguenti possono essere utilizzate nella creazione di un’espressione di variabili.

• toString(), pagina 299

• toLocaleString(), pagina 300

• concat( [item1 [, item2 [, ]]]), pagina 300

• join(separator), pagina 300

• pop(), pagina 300

• push( [item1 [, item2 [, ]]]), pagina 301

• reverse(), pagina 301

• shift(), pagina 301

• slice(), pagina 301

• sort(), pagina 302

• splice(start, deleteCount [, item1 [, item2 [, ]]]), pagina 302

• unshift( [item1 [, item2 [, ]]]), pagina 302

• length, pagina 303

toString()

Il risultato della chiamata della funzione toString è identico a quello che si ottiene invocando ilmetodo incorporato join per questo object senza nessun argomento. La funzione toString non ègenerica; genera un’eccezione TypeError se il relativo valore non è un object Array. Pertanto non puòessere trasferita ad altri tipi di object per essere utilizzata come metodo.

299

Page 300:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

toLocaleString()

La funzione toLocaleString converte gli elementi dell’array in stringhe utilizzando i relativimetodi toLocaleString, queste stringhe vengono quindi concatenate, separate da occorrenze di unastringa separatore che è stata derivata in un’implementazione definita in base alle impostazioniinternazionali. Il risultato della chiamata di questa funzione deve essere analogo a quello di toString,tranne che deve essere specifico delle impostazioni internazionali.

La funzione toLocaleString non è generica; genera un’eccezione TypeError se il relativo valore non èun object Array. Pertanto non può essere trasferita ad altri tipi di object per essere utilizzata comemetodo.

concat( [item1 [, item2 [, ]]])

Se la funzione concat viene chiamata con zero o più argomenti item1, item2 e così via, restituisce unarray contenente gli elementi di array dell’object seguiti dagli elementi di ciascun argomento in ordine.

La proprietà length della funzione concat è 1.

Nota: La funzione concat è intenzionalmente generica; non richiede che il relativo valore siaun object Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione concat a un object Host dipendedall’implementazione.

join(separator)

La funzione join converte gli elementi dell’array in stringhe, queste stringhe vengono quindiconcatenate, separate da occorrenze di un separatore. Se non viene fornito alcun separatore, vieneutilizzata una virgola singola.

La proprietà length della funzione join è 1.

Nota: La funzione join è intenzionalmente generica; non richiede che il relativo valore sia un objectArray. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo. Lapossibilità di applicare correttamente la funzione join a un object Host dipende dall’implementazione.

pop()

La funzione pop rimuove l’ultimo elemento dell’array dall’array e lo restituisce.

Nota: La funzione pop è intenzionalmente generica; non richiede che il relativo valore sia un objectArray. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo. Lapossibilità di applicare correttamente la funzione pop a un object Host dipende dall’implementazione.

300

Page 301:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

push( [item1 [, item2 [, ]]])

La funzione push aggiunge gli argomenti alla fine dell’array, nell’ordine in cui appaiono. La nuovalunghezza dell’array viene restituita come risultato della chiamata.

La proprietà length del metodo push è 1.

Nota: La funzione push è intenzionalmente generica; non richiede che il relativo valore siaun object Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione push a un object Host dipendedall’implementazione.

reverse()

La funzione reverse riorganizza gli elementi dell’array in modo da invertirne l’ordine. L’object vienerestituito come risultato della chiamata.

Nota: La funzione reverse è intenzionalmente generica; non richiede che il relativo valore siaun object Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione reverse a un object Host dipendedall’implementazione.

shift()

La funzione shift rimuove il primo elemento dell’array dall’array e lo restituisce.

Nota: La funzione shift è intenzionalmente generica; non richiede che il relativo valore sia unobject Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione shift a un object Host dipendedall’implementazione.

slice()

La funzione slice accetta due argomenti, start ed end e restituisce un array contenente gli elementidell’array compresi tra quello iniziale e quello finale escluso (o la fine dell’array se l’argomento endnon è definito). Se il valore start è negativo, viene considerato come (length+start) dove length è lalunghezza dell’array. Se il valore end è negativo, viene considerato come (length+end) dove length èla lunghezza dell’array.

La proprietà length del metodo slice è 2.

Nota: La funzione slice è intenzionalmente generica; non richiede che il relativo valore sia unobject Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione slice a un object Host dipendedall’implementazione.

301

Page 302:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

sort()

La funzione sort ordina gli elementi dell’array. L’ordinamento non è necessariamente stabile (ovvero,elementi che se confrontati sono uguali non rimangono necessariamente nell’ordine originale). Seil metodo comparefn non è definito, deve essere una funzione che accetta due argomenti x e y erestituisce un valore negativo se x < y, zero se x = y o un valore positivo se x > y.

Nota: La funzione sort è intenzionalmente generica; non richiede che il relativo valore sia un objectArray. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata come metodo. Lapossibilità di applicare correttamente la funzione sort a un object Host dipende dall’implementazione.

splice(start, deleteCount [, item1 [, item2 [, ]]])

Se si chiama la funzione splice con due o più argomenti start, deleteCount e (facoltativamente) item1,item2 e così via, gli elementi deleteCount dell’array che iniziano in corrispondenza dell’indice dell’arraystart vengono sostituiti dagli argomenti item1, item2 e così via.

La proprietà length della funzione splice è 2.

Nota: La funzione splice è intenzionalmente generica; non richiede che il relativo valore siaun object Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione splice a un object Host dipendedall’implementazione.

unshift( [item1 [, item2 [, ]]])

La funzione unshift aggiunge gli argomenti all’inizio dell’array, in modo tale che il loro ordineall’interno dell’array sia identico a quello in cui appaiono nell’elenco argomenti.

La proprietà length della funzione unshift è 1.

Nota: La funzione unshift è intenzionalmente generica; non richiede che il relativo valore siaun object Array. Pertanto può essere trasferita ad altri tipi di object per essere utilizzata comemetodo. La possibilità di applicare correttamente la funzione unshift a un object Host dipendedall’implementazione.

302

Page 303:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

length

La proprietà length di questo object Array è sempre numericamente maggiore del nome di ogniproprietà il cui nome è un indice dell’array.

303

Page 304:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzioni JavaScript

304

Page 305:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice D

Formattazione a livello di pagina

Le funzionalità di formattazione a livello di pagina includono: tutte le opzioni disponibili nella schedaLayout di pagina della Barra multifunzione di Word, intestazioni e piè di pagina e numerazionedelle pagine.

In questo capitolo vengono descritte tutte le funzionalità di formattazione a livello di paginasupportate da xPresso for Word:• Opzioni di impostazione della pagina, pagina 305

• Opzioni relative alle interruzioni di pagina e di sezione, pagina 307

• Opzioni relative alle colonne, pagina 308

• Opzioni relative all’intestazione e al piè di pagina, pagina 309

• Opzioni di numerazione pagine, pagina 310

• Campi di Microsoft Word, pagina 315

Nota: xPresso for Word supporta le funzionalità elencate di seguito; tutte le altre funzionalità nonelencate in modo esplicito non sono supportate.

Opzioni di impostazione della paginaPer impostare le dimensioni della pagina, la larghezza e la profondità dei margini, il tipo di carta,l’orientamento e le altre opzioni di impostazioni della pagina per il documento di xPresso for Word èpossibile definire queste impostazioni in Word.

Le seguenti opzioni di impostazione della pagina sono visualizzate nella scheda Layout di paginadella barra multifunzione di Word:

• Opzioni relative ai margini, pagina 306

• Opzioni relative alla carta, pagina 306

• Opzioni di layout, pagina 307

305

Page 306:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Opzioni relative ai margini

Le opzioni di Word relative ai margini della pagina sono definite nella scheda Layout di pagina dellaBarra multifunzione di Word, nel gruppo Imposta pagina. Per accedere a queste opzioni fare clic suMargini nel gruppo Imposta pagina e selezionareMargini personalizzati dal menu o espandereil gruppo Imposta pagina.

La scheda Margini contiene le seguenti opzioni.

Funzionalità Supporto

Margini: superiore, inferiore, sinistro, destro √

Dimensioni rilegatura Non supportato

Posizione rilegatura Non supportato

Orientamento √

Pagine: Più pagine: Normali √

Pagine: Più pagine: Margini simmetrici Non supportato

Pagine: Più pagine: 2 pagine per foglio Non supportato

Pagine: Più pagine: Formato libro Non supportato

Opzioni relative alla carta

Le opzioni di Word relative alla carta sono definite nella scheda Layout di pagina della Barramultifunzione di Word, nel gruppo Imposta pagina. Per accedere alle opzioni è possibile espandere ilgruppo Imposta pagina e fare clic sulla scheda Carta.

La scheda Carta contiene le seguenti opzioni.

Funzionalità Supporto

Dimensioni carta √

Larghezza √

Altezza √

Alimentazione (vedere Alimentazione,pagina 306)

Alimentazione

È possibile specificare un cassetto di alimentazione della carta nel gruppo Alimentazione. xPresso forWord supporta solo i cassetti numerati presenti negli elenchi Prima pagina e Altre pagine. In talemodo è possibile specificare quando estrarre la carta da un cassetto specifico.

306

Page 307:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Opzioni di layout

Le opzioni di Word relative al layout sono definite nella scheda Layout di pagina della Barramultifunzione di Word, nel gruppo Imposta pagina. Per accedere a queste opzioni è possibileespandere il gruppo Imposta pagina e fare clic sulla scheda Layout.

La scheda Layout contiene le seguenti opzioni.

Funzionalità Supporto

Inizio sezione Le opzioni Continua, Nuovapagina, Pagina pari e Paginadispari sono supportate

Nuova colonna non èsupportata

Intestazioni e piè di pagina: Diversi perpagine pari e dispari

Intestazione e piè di pagina: Diversi perla prima pagina

Distanza dal bordo Non supportato

Allineamento verticale (vedereAllineamento verticale, pagina 307)

Numeri di riga Non supportato

Bordi Non supportato

Inoltre, xPresso for Word non supporta la funzione Dividi interruzione di pagina e segno diparagrafo che si trova in pulsante Microsoft Office > Opzioni di Word > Avanzate > Opzioni dilayout.

Allineamento verticale

xPresso for Word supporta la giustificazione, lo scorrimento in alto e in basso e la centratura di testoverticale. La giustificazione verticale viene realizzata regolando la spaziatura tra i paragrafi (“blocco”)o la spaziatura tra i paragrafi e le righe (“cardatura”), come specificato dall’input della composizione.

Opzioni relative alle interruzioni di pagina e disezioneLe opzioni di Word relative alle interruzioni di pagina e di sezione sono definite nella scheda Layoutdi pagina della Barra multifunzione di Word, nel gruppo Imposta pagina. Per accedere a questeopzioni è possibile fare clic su Interruzioni.

Il menu Interruzioni contiene le seguenti opzioni.

307

Page 308:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Funzionalità Supporto

Interruzione di pagina √

Colonna √

Disposizione testo Non supportato

Interruzione di sezione √

Interruzione di sezione √

Interruzione di sezione √

Interruzione di sezione √

Gestione delle definizioni di sezione

Se il documento contiene più di un set di definizioni di sezione, tenere presenti queste linee guida pergarantire l’utilizzo della formattazione appropriata.• È possibile modificare la formattazione esistente a livello di sezione solo facendo precedere lemodifiche da un’interruzione di sezione.

• Le modifiche alle colonne vengono mantenute anche dopo un’interruzione di sezione continua.

Opzioni relative alle colonneLe colonne sono supportate in xPresso for Word, ma le colonne di larghezza diversa non sonosupportate. Se si utilizzano colonne di larghezza diversa, l’engine di pubblicazione di xPublishutilizza la larghezza di colonna inferiore. Sono anche supportate le interruzioni di colonna manuali.È necessario posizionare le interruzioni di sezione davanti e dietro l’area della colonna.

In Microsoft Word le opzioni relative alle colonne sono definite nella scheda Layout di pagina dellaBarra multifunzione di Word, nel gruppo Imposta pagina. Per accedere a queste opzioni fare clicsu Colonne e quindi fare clic su Altre colonne.

La finestra di dialogo Colonne contiene le seguenti opzioni.

Funzionalità Supporto

Valori preimpostati √

Numero di colonne √

Linea separatrice Non supportato

Larghezza e spaziatura √

Stessa larghezza per tutte le colonne √

Bilanciamento colonne √

308

Page 309:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Bilanciamento colonne

Nei documenti xPresso for Word con più colonne di testo, l’engine di pubblicazione di xPublishbilancia le colonne per garantire che ogni colonna contenga la stessa quantità di testo. Per non forzareil bilanciamento delle colonne, inserire un’interruzione di colonna nel contenuto.

Inserimento di un colonna nel documentoPer utilizzare la formattazione delle colonne di Microsoft Word:

1. Posizionare il cursore nel punto in cui si desidera creare l’area della colonna e inserireun’interruzione di sezione. Se si desidera che la colonna inizi in una nuova pagina, scegliereun’interruzione di sezione Pagina successiva.

2. Fare clic sulla scheda Layout di pagina e fare clic su Colonne.

3. Nel menu Colonne, selezionare il numero di colonne da applicare.

4. Le colonne verranno visualizzate nel documento con il cursore posizionato nella colonna sinistra.Quando il testo raggiunge la parte inferiore della prima colonna, Microsoft Word continuaautomaticamente il flusso del testo nella seconda colonna.Per interrompere manualmente una colonna e passare alla successiva, selezionare unaInterruzione di colonna dal menu Interruzioni.

Opzioni di data e oraÈ possibile accedere a queste opzioni facendo clic sul pulsante Data e ora del menu Inserisci.

La finestra di dialogo Date e ora contiene le seguenti opzioni.

Funzionalità Supporto

Usa caratteri a larghezza intera Non supportato

Aggiorna automaticamente √

Opzioni relative all’intestazione e al piè dipaginaLe opzioni di Word relative alle intestazioni e ai piè di pagina sono definite nella scheda Inserisci dellaBarra multifunzione di Word, nel gruppo Intestazione e piè di pagina. Per accedere a queste opzioni èpossibile fare clic su Intestazioni o Piè di pagina e quindi fare clic suModifica intestazione o suModifica piè di pagina. Sulla Barra multifunzione di Word è visualizzata la scheda di progettazionestrumenti di intestazione e piè di pagina

Che contiene le seguenti opzioni relative alle intestazioni e ai piè di pagina.

309

Page 310:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Funzionalità Supporto

Numero di pagina √

Inserisci data e ora √

Parti rapide Le opzioni Data, Ora, Pagina,PageRef e NumPages sonosupportate.

Seq, TC, Sommario e Indicenon sono supportati.

Immagine √

ClipArt √

Diversi per la prima pagina √

Diversi per pagine pari e dispari √

Mostra testo documento √

Intestazione dall’alto √

Piè di pagina dal basso √

Inserisci tabulazione allineamento Non supportatonell’intestazione e nel pièdi pagina.

Opzioni di numerazione pagineLe opzioni di Word relative alla numerazione delle pagine sono definite nella scheda Inserisci dellaBarra multifunzione di Word, nel gruppo Intestazione e piè di pagina. Per accedere a queste opzioni èpossibile fare clic su Numero di pagina.

Nota: Se la numerazione delle pagine non è corretta nell’output pubblicato, controllare l’impostazioneInizio sezione nella scheda Layout impostazione pagina. L’opzione Inizio sezione non è supportatain xPresso for Word, pertanto accertarsi di impostarla sul valore predefinito di Nuova pagina. Perulteriori informazioni, vedere Opzioni di layout, pagina 307.

Per aggiungere numeri di pagina al documento, è possibile utilizzare i metodi seguenti. Le opzioniincludono le opzioni della barra multifunzione nonché quelle in testo nascosto.

Funzionalità Supporto

Inserisci: Numero di pagina: In alto √

Inserisci: Numero di pagina: In basso √

Inserisci: Numero di pagina: Margini Non supportato

310

Page 311:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Funzionalità Supporto

Inserisci: Numero di pagina: Posizione corrente √

Campo pagina √

Campo NUMPAGES √

Campo SEQ Non supportato

Inserisci X di Y √

Per un elenco di tutti i campi supportati, vedere Campi di Microsoft Word, pagina 315.

Per ogni posizione del numero di pagina, sono disponibili i tipi di formato seguenti per la partesuperiore della pagina.

Funzionalità Supporto

Semplicità: numero normale 1, 2, 3 √

Pagina X: linea 1, 2 √

Pagina X di Y: numero in grassetto 1, 2, 3 √

Numero normale: numero tra parentesi 1 √

Numero normale: numero tra parentesi 2 Non supportato

Numero semplice: punti Non supportato

Numero normale: grande in corsivo 1, 2 √

Numero normale: normale 1, 2, 3 √

Numero normale: caratteri tilde √

Numero normale: linea verticale Non supportato

Numero normale: struttura verticale 1, 2 Non supportato

Numero normale: numero molto grande √

Numero normale: numero grande a colori 1 √

Numero normale: numero grande a colori 2 √

Numero normale: numero grande a colori 3 √

Numero normale: grande in corsivo √

Numero normale: normale √

Numero normale: tabulazione 1 Non supportato

Numero normale: tabulazione 2 Non supportato

Numero normale: linea spessa Non supportato

Numero normale: linea sottile Non supportato

Numero normale: tre linee Non supportato

Numero normale: caratteri tilde √

311

Page 312:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Funzionalità Supporto

Numero normale: linea superiore 1 Non supportato

Numero normale: linea superiore 2 Non supportato

Numero normale: due barre 1 √

Numero normale: due barre 2 √

Numero normale: struttura verticale 1 Non supportato

Numero normale: struttura verticale 2 Non supportato

Con forme: cerchio, rettangolo arrotondato 1, 2, 3 Non supportato

Per ogni posizione del numero di pagina, sono disponibili i tipi di formato seguenti per la parteinferiore della pagina.

Funzionalità Supporto

Semplicità: numero normale 1, 2, 3 √

Pagina X: linea 1, 2, 3 √

Pagina X: numero pagina 1, 2 √

Pagina X di Y: numeri in grassetto 1, 2, 3 √

Numero normale: numero tra parentesi √

Numero semplice: punti Non supportato

Numero normale: numero grande √

Numero normale: numero grande a colori √

Numero normale: grande in corsivo √

Numero normale: normale √

Numero normale: tabulazione 1, 2 Non supportato

Numero normale: linea spessa Non supportato

Numero normale: linea sottile Non supportato

Numero normale: tre linee Non supportato

Testo normale: caratteri tilde √

Numero normale: linea superiore Non supportato

Numero normale: due barre √

Con forme: freccia 1, 2 Non supportato

Con forme: riquadro corsivo 1, 2 √

Con forme: cerchio Non supportato

Con forme: piega Non supportato

Con forme: mosaico Non supportato

Con forme: cerchio vuoto 1, 2, 3 Non supportato

312

Page 313:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Funzionalità Supporto

Con forme: ellisse Non supportato

Con forme: barra multifunzione Non supportato

Con forme: rettangolo arrotondato 1, 2, 3 Non supportato

Con forme: scorrimento Non supportato

Con forme: quadrato 1, 2, 3 √

Con forme: pagine in pila 1, 2 Non supportato

Con forme: stella Non supportato

Con forme: triangolo 1, 2 Non supportato

Opzioni di formattazione dei numeri di pagina

La finestra di dialogo Formato numero di pagina consente di specificare le opzioni di formattazionerelative ai numeri di pagina. Per accedere alla finestra di dialogo è possibile fare clic su Numero dipagina e selezionare Formato pagina Numeri.

Questa finestra di dialogo contiene le seguenti opzioni.

Funzionalità Supporto

Formato numero: 1, 2, 3, ... √

Formato numero: -1, -2, -3, ... Non supportato

Formato numero: a, b, c, ... √

Formato numero: A, B, C, ... √

Formato numero: i, ii, iii,... √

Formato numero: I, II, III, ... √

Includi numero di capitolo Non supportato

Numerazione pagine: Continua dalla sezioneprecedente

Numerazione pagine: Comincia da √

Inserimento del numero di paginaPer inserire numeri di pagina:

1. Fare clic sulla scheda Inserisci.

2. Dal gruppo Intestazione e piè di pagina, fare clic su Numero di pagina.

3. Scegliere la posizione del numero di pagina e selezionare il formato di quest’ultimo.

313

Page 314:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Inserimento del numero di pagine con il campoNUMPAGESPer inserire il numero di pagine con il campo NUMPAGES:

1. Posizionare il cursore nel punto in cui si desidera che appaia il numero di pagine.

2. Fare clic sulla scheda Inserisci.

3. Nel gruppo Testo, espandere Parti rapide e fare clic su Campo.

4. In Categorie, selezionare Informazioni documento.

5. In Nomi dei campi, selezionare NumPages.

6. Fare clic sul pulsante Codici di campo per aprire l’area delle proprietà Avanzate del campo, in cuiè possibile aggiungere un identificatore per il campo NUMPAGES. L’identificatore può essereuna lettera, un numero o una parola (ad esempio, NUMPAGES 1).

7. Fare clic su OK.

Inserimento di Pagina X di Y in intestazioni e piè dipagina

È possibile inserire il numero di pagina e il numero di pagine nelle intestazioni e nei piè di paginautilizzando la funzione Pagina X di Y. xPression utilizza i campi PAGE e NUMPAGES di Word perfornire queste informazioni quando il documento viene assemblato. Una volta eseguito l’inserimento,è possibile modificare la formattazione del carattere per il campo del numero di pagina, per i campodel numero di pagine o per entrambi. Questa funzionalità viene talvolta indicata come “Pagina Ndi M.”

Per inserire Pagina X di Y nell’intestazione o nel piè di pagina:

1. Fare clic sulla scheda Inserisci.

2. Dal gruppo Intestazione e piè di pagina, fare clic su Numero di pagina per espandere l’elemento.

3. Scegliere la posizione del numero di pagina e selezionare il formato Pagina X di Y.

4. Il numero di pagina e il numero di pagine verranno visualizzati nella posizione selezionata.È possibile passare dalla visualizzazione dei codici di campo (PAGE e NUMPAGES) allavisualizzazione del risultato dei campi premendo ALT + F9.

Riavvio della numerazione pagine per il contenuto universale

Il conteggio delle pagine per Pagina X di Y continua nel contenuto universale per impostazionepredefinita, ma se il contenuto è in formato xPresso for Word o Word Docx, la numerazione delcontenuto può procedere indipendentemente.

314

Page 315:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

Per riavviare la numerazione pagine nel contenuto universale:

1. Fare clic sul menu per il contenuto universale xPresso for Word o Word Docx in Esplora modelli,quindi selezionareModifica impostazioni. Viene visualizzata la finestra di dialogo ModificaUniversalContentType.

2. Selezionare Personalizzato nell’elenco a discesa Opzioni di layout. Per ulteriori informazionisulle opzioni di layout, vedere Opzioni di layout, pagina 198.

3. Deselezionare la casella di controllo Usa numerazione pagine intelligente.La formattazione del numero di pagina nel contenuto universale segue sempre il formato stabilito nelcontenuto, mai quello del documento principale.

Campi di Microsoft WordxPression supporta alcuni dei seguenti campi di Microsoft Word. Per accedere a queste opzioni, fareclic sulla scheda Inserisci, quindi su Parti rapide nel gruppo Testo e selezionare Campo.

Sono supportati i seguenti campi:• Data

• Ora

• Pagine

• PageRef

• NumPages

• Seq

• TC

• Sommario

• Indicizza

315

Page 316:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di pagina

316

Page 317:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice E

Formattazione a livello di paragrafo

In questo capitolo vengono descritte le seguenti funzionalità di formattazione a livello di paragrafodisponibili in Word:• Configurazione della formattazione a livello di paragrafo, pagina 317

• Sillabazione, pagina 320

• Tabelle, pagina 321

• Bordi e sfondo, pagina 325

• Elenchi puntati, pagina 327

• Elenchi numerati, pagina 329

Nota: xPresso for Word supporta le funzionalità elencate di seguito; tutte le altre funzionalità nonelencate in modo esplicito non sono supportate.

Configurazione della formattazione a livello diparagrafoLa maggior parte delle funzionalità di formattazione a livello di paragrafo sono visualizzate nelgruppo Paragrafo nella scheda Home della Barra multifunzione di Word. Espandere il gruppoParagrafo per visualizzare la finestra di dialogo Paragrafo e le seguenti funzioni:

• Opzioni dei paragrafi: Rientri e spaziatura, pagina 317

• Opzioni dei paragrafi: Tabulazioni, pagina 319

• Opzioni dei paragrafi: Distribuzione testo, pagina 319

• Bordi, pagina 319

Opzioni dei paragrafi: Rientri e spaziatura

Per accedere a queste opzioni è possibile fare clic sulla scheda Home della Barra multifunzione diWord ed espandere il gruppo Paragrafo. La scheda Rientri e spaziatura contiene le opzioni seguenti.

317

Page 318:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Funzionalità Supporto

Allineamento √(Tutte le opzioni ad eccezione diRipartito)

Livello struttura √

Rientro: a sinistra e a destra (vedere Rientro,pagina 318)

Rientro: speciale (prima riga sporgente)(vedere Rientro, pagina 318)

Rientri simmetrici Non supportato

Spaziatura: prima e dopo √

Interlinea √

Non aggiungere spazio tra paragrafi dellostesso stile

Allineamento giustificato

Quando è selezionata l’opzione Giustificato, xPresso for Word allinea sia il lato sinistro che il latodestro del paragrafo aumentando la dimensione degli spazi tra ogni parola, finché la riga nonriempie l’intera larghezza dell’area del testo. Tra le parole non viene aggiunto alcuno spazio. Lagiustificazione orizzontale non viene applicata all’ultima riga del paragrafo.

Rientro

xPresso for Word supporta il rientro di paragrafo positivo e negativo per consentire il normalerientro della prima linea di un paragrafo. Se si imposta il rientro Prima riga o Sporgente, nella casellaRientra di è possibile impostare la misura in base alla quale far rientrare il testo. xPresso for Wordsupporta le stesse unità di misura di Word. È possibile digitare l’unità di misura che si desiderautilizzare (ad esempio, “20 pi”, “10 mm”) o impostare l’unità predefinita nell’area Impostazioniavanzate di Visualizzazione della finestra Opzioni di Word, accessibile facendo clic su Opzioni diWord nel menu Office.

Capolettera

xPresso for Word non supporta la funzione Capolettera. I paragrafi che utilizzano la capoletteraverranno generati come paragrafi normali.

318

Page 319:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Opzioni dei paragrafi: Tabulazioni

Per accedere a queste opzioni è possibile fare clic sulla scheda Home, espandere il gruppo Paragrafoe fare clic su Tabulazioni.

La finestra di dialogo Tabulazioni contiene le seguenti opzioni.

Funzionalità Supporto

Posizione tabulazioni √

Allineamento √

(Tutte le opzioni eccetto Al centroe Barra)

Carattere di riempimento √

Nota: Le posizioni relative delle tabulazioni non sono supportate.

Opzioni dei paragrafi: Distribuzione testo

L’engine di pubblicazione di xPublish porta a capo il testo a seconda della larghezza delle parole.Sulle interruzioni di riga influiscono le impostazioni di sillabazione scelte. Per accedere a questeopzioni fare clic sulla scheda Home, espandere il gruppo Paragrafo e fare clic sulla schedaDistribuzione testo.

La scheda Distribuzione testo contiene le seguenti opzioni.

Funzionalità Supporto

Controlla righe isolate √

Mantieni con il successivo √

Mantieni assieme le righe √

Anteponi interruzione √

Ometti numeri di riga Non supportato

Non sillabare √

Opzioni casella di testo: Testoravvicinato

Tipografia asiatica Sconosciuto

Bordi

Linee doppie e linee sottili-spesse-piccole-interruzione non sono supportate nei bordi paragrafo.Nell’output verranno visualizzate come linee continue.

319

Page 320:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

SillabazionePer determinare come interrompere una parola alla fine di una riga, l’engine di pubblicazionedi xPublish esegue le ricerche di parole in base ad algoritmi e dizionari. Per apportaredelle modifiche al dizionario di sillabazione, è possibile trovare il dizionario di xPressionin Your_drive:\ProgramData\xPresso\xPresso_version\xPresso forWord\Office_version\Hyphen

Questo dizionario utilizza il formato XML e segue gli standard FOP (Formatting Object Processor)di settore.

È possibile specificare la sillabazione dell’ultima parola di una colonna o di una pagina comeimpostazione predefinita. Quando una sola parola è troppo lunga per la riga corrente, l’engine dipubblicazione di xPublish posiziona automaticamente la parola sulla riga successiva disponibile.

In questa sezione sono illustrati gli argomenti seguenti:

• Trattini supportati, pagina 320

• Opzioni di sillabazione, pagina 320

• Forzatura della sillabazione automatica, pagina 321

Trattini supportati

xPresso for Word supporta i caratteri trattino seguenti:• Trattino semplice (U+002D), noto anche come segno meno (-)

• Trattino facoltativo (U+00Ad)

• Trattino unificatore (U+2011)

L’algoritmo di sillabazione dell’engine di pubblicazione di xPublish gestisce il trattino semplicein modo diverso rispetto a Microsoft Word. Microsoft Word considera il trattino semplice comecarattere normale. Di conseguenza, una parola può non interrompersi in corrispondenza di untrattino semplice.

L’algoritmo dell’engine di pubblicazione di xPublish verifica che il trattino semplice abbia unapriorità superiore rispetto al trattino facoltativo e al trattino creato automaticamente dal dizionariodi sillabazione.

Opzioni di sillabazione

Per accedere alle opzioni di sillabazione è possibile fare clic sulla scheda Layout di pagina, fare clic suSillabazione e quindi fare clic su Opzioni sillabazione.

La finestra di dialogo Opzioni sillabazione contiene le seguenti opzioni.

Funzionalità Supporto

Sillaba automaticamente documento √

320

Page 321:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Funzionalità Supporto

Sillabazione manuale √

Sillaba parole maiuscole Non supportato

Area di sillabazione Non supportato

Righe consecutive sillabate Non supportato

Forzatura della sillabazione automaticaPer eseguire la forzatura della sillabazione automatica e impedire che alcune parti diun documento vengano sillabate:

1. Selezionare il testo che non si desidera sillabare.

2. Visualizzare le opzioni Distribuzione testo. A tale scopo fare clic sulla schedaHome, espandere ilgruppo Paragrafo e fare clic sulla scheda Distribuzione testo.

3. Selezionare l’opzione Non sillabare nella scheda Distribuzione testo.

4. Fare clic su OK per applicare l’impostazione.

TabellexPresso for Word supporta le funzionalità più utilizzate di Word relative alle tabelle, tra cui lastruttura di base delle celle, bordi e ombreggiatura semplici, identificazione della tabella, righe diintestazione e unione orizzontale delle celle. Sono supportate tabelle con un massimo di 29 colonnesenza ombreggiatura o con un massimo di 14 ombreggiate. È possibile utilizzare i formati di tabelladisponibili in Word. Tenere presente tuttavia che l’ombreggiatura a righe alterne non è attualmentesupportata. Quando si utilizza una struttura di tabella che richiede l’ombreggiatura a righe alterne,ogni riga della tabella nell’output finale utilizzerà l’ombreggiatura visualizzata nella prima rigadella struttura della tabella.

In questa sezione sono illustrati gli argomenti seguenti:

• Opzioni per l’inserimento di tabelle, pagina 322

• Proprietà tabella: opzioni della scheda Tabella, pagina 322

• Proprietà tabella: opzioni della scheda Riga, pagina 323

• Proprietà tabella: opzioni della scheda Colonna, pagina 323

• Proprietà tabella: opzioni della scheda Cella, pagina 323

• Opzioni di stile delle tabelle, pagina 324

• Opzioni di bordi e sfondo, pagina 324

• Creazione di tabelle, pagina 324

321

Page 322:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Opzioni per l’inserimento di tabelle

Per accedere alle opzioni di inserimento di tabelle, fare clic sulla scheda Inserisci, quindi su Tabella equindi fare clic su Inserisci tabella.

La finestra di dialogo Inserisci tabella contiene le seguenti opzioni.

Funzionalità Supporto

Numero di colonne √

Numero di righe √

Larghezza fissa colonne √

Adatta al contenuto √

Adatta alla pagina √

Imposta come predefinito per le nuovetabelle

Proprietà tabella: opzioni della scheda Tabella

Dopo avere inserito la tabella, posizionare il cursore all’interno della tabella stessa, fare clic con ilpulsante destro del mouse e selezionare Proprietà tabella. In alternativa, è possibile fare clic sullascheda Layout in Strumenti, tabella scheda e quindi fare clic su Proprietà nel gruppo Tabella.

La scheda Tabella contiene le seguenti opzioni.

Funzionalità Supporto

Larghezza preferita √

(Tutte le opzioni ad eccezione diPercentuale)

Allineamento √

Rientro da sinistra √

Disposizione testo Non supportato

Posizionamento Non supportato

Bordi e sfondo Vedere Bordi e sfondo, pagina 325.

Opzioni: Margini cella predefiniti √

Opzioni: Spaziatura tra celle predefinita Non supportato

Opzioni: Adatta automaticamente alcontenuto

Non supportato

322

Page 323:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Proprietà tabella: opzioni della scheda Riga

Dopo avere inserito la tabella, posizionare il cursore all’interno della tabella stessa, fare clic con ilpulsante destro del mouse, selezionare Proprietà tabella e quindi fare clic sulla scheda Riga.

La scheda Riga contiene le seguenti opzioni.

Funzionalità Supporto

Specifica altezza √

Permetti la divisione della riga tra le pagine Non supportato

Ripeti come riga di intestazione in ogni pagina √

Ripeti come riga di intestazione in ogni pagina

Questa opzione consente di ripetere la riga corrente all’inizio di ogni pagina e deve essere selezionataogni volta che si crea una tabella in xPresso for Word.

Proprietà tabella: opzioni della scheda Colonna

Dopo avere inserito la tabella, posizionare il cursore all’interno della tabella stessa, fare clic con ilpulsante destro del mouse, selezionare Proprietà tabella e quindi fare clic sulla scheda Colonna.

La scheda Colonna contiene le seguenti opzioni.

Funzionalità Supporto

Larghezza preferita √

(Tutte le opzioni ad eccezione di Pollici)

Proprietà tabella: opzioni della scheda Cella

xPresso for Word supporta righe di tabella con un massimo di 30 celle in ciascuna. Le celle possonoessere suddivise o unite orizzontalmente. Dopo avere inserito la tabella, posizionare il cursoreall’interno della tabella stessa, fare clic con il pulsante destro del mouse, selezionare Proprietà tabellae quindi fare clic sulla scheda Cella.

La scheda Cella contiene le seguenti opzioni.

Funzionalità Supporto

Larghezza preferita √

Allineamento verticale √

323

Page 324:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Funzionalità Supporto

Opzioni: Margini cella √

Opzioni: Testo a capo Non supportato

Opzioni: Adatta testo Non supportato

Allineamento del contenuto delle celle

Oltre all’allineamento verticale, è possibile definire l’allineamento del contenuto delle celle. A talescopo, fare clic con il pulsante destro del mouse su una cella della tabella e scegliere Allineamentocelle. Tutte le opzioni di Allineamento celle sono supportate.

Nota: l’orientamento del testo non è supportato dalle celle della tabella.

Opzioni di stile delle tabelle

Per accedere alle opzioni Stile tabella è possibile fare clic sulla scheda Struttura in Strumenti tabellasulla Barra multifunzione di Word.

Il gruppo di opzioni Stile tabella contiene le seguenti opzioni.

Funzionalità Supporto

Riga di intestazione √

Riga Totale √

Righe alternate evidenziate √

Prima colonna √

Ultima colonna √

Colonne alternate evidenziate √

Tutti gli stili di tabella definiti dal sistema elencati nel gruppo Stili tabella nella scheda Struttura diStrumenti tabella e gli stili personalizzati sono supportati in xPresso for Word.

Opzioni di bordi e sfondo

Consultare Finestra di dialogo Bordi e sfondo, pagina 325.

Creazione di tabelle

È possibile utilizzare tabelle di Microsoft Word nei documenti di xPresso for Word per formattare eallineare il testo, posizionare immagini o come formato per le tabelle dinamiche. È possibile creare

324

Page 325:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

una tabella dalla scheda Inserisci sulla barra multifunzione di Word. Ogni volta che si crea unatabella con una riga di intestazione in xPresso for Word, è necessario selezionare Ripeti come rigadi intestazione in ogni pagina. Questa opzione consente di ripetere la riga corrente nella partesuperiore di ogni pagina.

Per creare una tabella:

1. Fare clic sulla scheda Inserisci.

2. Fare clic su Tabella e selezionare Inserisci tabella.

3. Selezionare il numero di righe e di colonne e fare clic su OK.

Nota: Si consiglia di utilizzare la larghezza fissa della tabella anziché il valore in percentuale.Se le proprietà della tabella vengono specificate in percentuale (anziché usando la larghezzafissa), il layout di tabella viene modificato in Microsoft Word 2013 in base al seguente documentohttps://support.microsoft.com/en-us/kb/2740483.

Bordi e sfondoIl menu Bordi e sfondo disponibile nel gruppo Paragrafo della scheda Home e nel gruppo Stili tabelladella scheda Struttura in Strumenti tabella contiene tutte le opzioni per bordi, sfondo e riga.

In questa sezione sono illustrate le opzioni seguenti:

• Finestra di dialogo Bordi e sfondo, pagina 325

• Linee orizzontali, pagina 327

Finestra di dialogo Bordi e sfondo

È possibile accedere alla finestra di dialogo Bordi e sfondo dalla scheda Home facendo clic suBordi e sfondo > Bordi e sfondo oppure dalla scheda Struttura in Strumenti tabella facendo clicsu Bordi > Bordi e sfondo.

Nota: se viene impostato un bordo per un paragrafo nella cella di una tabella, il bordo nell’output dipubblicazione potrebbe essere diverso da quello che si vede in Microsoft Word.

Opzioni della scheda Bordi

La scheda Bordi contiene le seguenti opzioni.

Funzionalità Supporto

Stile bordo Solo i primi 7 stili sono supportati

Colore bordo √

Spessore bordo √

Anteprima: posizione bordo √

325

Page 326:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Stili supportati per i bordi

I seguenti stili dei bordi sono supportati:

Posizione bordo

Per le tabelle, xPression non supporta i bordi in formato Linea diagonale. Ogni riga di tabella puòsupportare in totale una combinazione di 30 bordi di cella a sinistra e a destra e/o celle ombreggiate. Ibordi tra celle contano come un solo bordo. Il numero complessivo di bordi di cella verticali e di celleombreggiate non può superare 30.

Per i paragrafi, xPression supporta sia il bordo esterno che il bordo interno. Il bordo esterno è il bordointorno al paragrafo o a gruppi di paragrafi (quando ne è stato evidenziato più di uno). Il bordointerno è visibile nella sezione Anteprima solo se si sono evidenziati più paragrafi. Il bordo internodivide ciascun paragrafo nell’intervallo selezionato di paragrafi.

Opzioni di Bordo testo

Per accedere alle opzioni di Bordo testo selezionare il testo desiderato, passare a Progettazione, fareclic su Bordi pagina > Bordi e sfondo > Applica a.

Funzionalità Supporto

Stile bordo Non supportato

Colore bordo Non supportato

Spessore bordo Non supportato

Linea orizzontale Sconosciuto

Opzioni della scheda Bordi pagina

La scheda Bordi pagina contiene le seguenti opzioni.

Funzionalità Supporto

Stile bordo Non supportato

326

Page 327:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Funzionalità Supporto

Colore bordo Non supportato

Spessore bordo Non supportato

Motivo bordo Non supportato

Opzioni della scheda Sfondo

xPresso for Word supporta le seguenti opzioni nella scheda Sfondo.

Funzionalità Supporto

Riempimento √

Motivi √

Stile: cancella √

Stile: continua √

Colore √

Applica a √

Linee orizzontali

È possibile inserire una linea orizzontale dalla scheda Home facendo clic su Bordi e sfondo > Lineaorizzontale oppure dalla scheda Struttura in Strumenti tabella facendo clic su Bordi > Lineaorizzontale.

È possibile accedere alle opzioni di formattazione per la linea orizzontale selezionando la linea sulcanvas, facendo clic con il pulsante destro del mouse e selezionando Formato linea orizzontale.

Nella finestra di dialogo Formato linea orizzontale, tutte le opzioni sono supportate. Per le opzioniLarghezza e Altezza, solo l’opzione Pollici è supportata per l’impostazioneMisura in; l’opzionePercentuale non è supportata.

Elenchi puntatiÈ possibile aggiungere elenchi puntati al documento in tre modi: utilizzando l’apposita funzionalitàdi Microsoft Word, mediante stili o creando manualmente elenchi puntati personalizzati. xPresso forWord supporta l’utilizzo di qualsiasi carattere valido come punto elenco.

Nota: Gli stili elenchi puntati potrebbero non apparire correttamente nell’output diverso da PDF.L’output HTML, ad esempio, non supporta alcuni caratteri punto elenco.

327

Page 328:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

In questa sezione sono illustrati gli argomenti seguenti:

• Opzioni degli elenchi puntati, pagina 328

• Creazione di un semplice elenco puntato, pagina 328

• Creazione di elenchi puntati con stili Microsoft, pagina 329

• Creazione di elenchi puntati per output AFP, pagina 329

Opzioni degli elenchi puntati

Per accedere alle opzioni relative agli elenchi puntati fare clic sulla scheda Home, fare clicsull’elemento Elenco puntato nel gruppo Paragrafo e selezionare Definisci nuovo punto elenco.

La finestra di dialogo Definisci nuovo punto elenco contiene le seguenti opzioni.

Funzionalità Supporto

Carattere punto elenco: simbolo √

Carattere punto elenco: immagine √

Carattere punto elenco: carattere √

Allineamento √

Punti elenco immagine

Tenere presente quanto segue quando si utilizzano i punti elenco immagine:• I punti elenco immagine non sono supportati negli elenchi intelligenti di contenuto universale(per ulteriori informazioni, vedere Opzioni di layout, pagina 198).

• I punti elenco immagine possono essere visualizzati con dimensioni differenti nell’output finalerispetto a Word.

Creazione di un semplice elenco puntatoPer creare un semplice elenco puntato:

1. Posizionare il cursore nel punto in cui si desidera inserire un elenco puntato.

2. Fare clic sulla scheda Home.

3. Fare clic su Elenco puntato.

4. Selezionare uno stile per i punti elenco o fare clic su Definisci nuovo punto elenco per crearneuno.

328

Page 329:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Creazione di elenchi puntati con stili MicrosoftPer creare un elenco puntato utilizzando gli stili:

1. Posizionare il cursore nel punto in cui si desidera creare l’elenco puntato con lo stile desiderato.

2. Fare clic sulla scheda Home sulla Barra multifunzione di Word, espandere il gruppo Stili e fareclic su Nuovo stile.

3. Definire il nome e le opzioni di formattazione dello stile.

4. Fare clic su Formato e scegliere Numerazione.

5. Fare clic sulla scheda Elenco puntato.

6. Selezionare uno stile esistente o fare clic su Definisci nuovo punto elenco per creare uno stilepersonalizzato e fare clic su OK.

Creazione di elenchi puntati per output AFP

Se si desidera generare output AFP ed è necessario creare un elenco puntato, è necessario utilizzare latabella codici T1001252, poiché la tabella codici consigliata, T1001148 non include alcun caratterepunto elenco.

Per creare un elenco puntato per output AFP:

1. Posizionare il cursore nel punto in cui si desidera inserire un elenco puntato.

2. Fare clic sulla scheda Home sulla Barra multifunzione di Word, fare clic su Elenco puntatoe fare clic su Definisci nuovo punto elenco.

3. Fare clic su Simbolo.

4. Selezionare il carattere dall’elenco Tipo di carattere.

5. Nel campo di testo Codice carattere, digitare 2022 e selezionare Unicode (hex) dall’elenco da.

6. Fare clic su OK per chiudere tutte le finestre di dialogo aperte. Word utilizzerà il simbolo dipunto elenco selezionato dalla tabella codici T1001252.

Elenchi numeratixPresso for Word supporta le opzioni elenco di Word con alcune limitazioni. Le strutture deglielenchi numerati sono supportate solo su 9 livelli e lo stile Elenco non è supportato. I formatinumerati a più livelli che iniziano con un punto (.), come .1, .1.1, .1.2, non sono supportati.

In questa sezione sono illustrati gli argomenti seguenti:

• Opzioni degli elenchi numerati, pagina 330

• Opzioni delle strutture di elenchi numerati, pagina 330

• Menu Proprietà elenchi numerati, pagina 331

• Creazione di un semplice elenco numerato, pagina 331

329

Page 330:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

• Creazione di elenchi numerati con il campo Seq, pagina 332

• Elenchi numerati a su più livelli con il campo Seq, pagina 332

Opzioni degli elenchi numerati

Per visualizzare le opzioni degli elenchi numerati, fare clic sulla scheda Home, fare clic suNumerazione e selezionare Definisci nuovo formato numero.

La finestra di dialogo Definisci nuovo formato numero contiene le seguenti opzioni.

Funzionalità Supporto

Stile numero Sono supportati solo i seguenti stili:• 1, 2, 3, ...

• I, II, III, ...

• i, ii, iii, ...

• A, B, C, ...

• a, b, c, ...

• 一, 二, 三(简) ...

• 甲, 乙, 丙, ...

• 子, 丑, 寅, ...

• 1°, 2°, 3°, ...

• Uno, Due, Tre, ...

• Primo, Secondo, Terzo, ...

• 01, 02, 03, ...

Formato numero √

Allineamento √

Opzioni delle strutture di elenchi numerati

Per accedere alle opzioni degli elenchi a più livelli, fare clic sulla scheda Home, fare clic su Elencoa più livelli e selezionare Definisci nuovo elenco a più livelli.

La finestra di dialogo Definisci nuovo elenco a più livelli contiene le opzioni seguenti. Fare clic sulpulsante Altro > > per visualizzare tutte le opzioni.

330

Page 331:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Funzionalità Supporto

Livello Sono supportati fino a 9 livelli

Collega livello a stile √

Nome elenco campo ListNum √

Formato numero √

Stile numero √

Converti in numeri √

Allineamento numero √

Allinea a √

Rientro testo √

Numero seguito da √

Aggiungi tabulazione a √

Menu Proprietà elenchi numerati

Quando si utilizzano gli elenchi numerati e gli elenchi numerati a più livelli, è possibile accedere adaltre opzioni facendo clic con il pulsante destro del mouse su un numero dell’elenco. Nella seguentetabella vengono illustrate solo le opzioni relative alla numerazione.

Funzionalità Supporto

Reinizia da 1 √

Non disponibile per gli elenchi apiù livelli.

Continua numerazione √

Imposta valore di numerazione Supportato solo negli elenchi alivello singolo e nel primo livellodegli elenchi numerati.

Creazione di un semplice elenco numeratoPer creare un semplice elenco numerato:

1. Posizionare il cursore nel punto in cui si desidera iniziare un nuovo elenco numerato.

2. Fare clic sulla scheda Home.

331

Page 332:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

3. Fare clic su Numerazione automatica.

4. Selezionare un formato di numero esistente o fare clic su Definisci nuovo formato numero.

5. Se si sceglie di definire un nuovo formato, selezionare un stile, un formato e un tipo diallineamento, quindi fare clic su OK. Per ulteriori informazioni, vedere Opzioni degli elenchinumerati, pagina 330.

Creazione di elenchi numerati con il campo Seq

I campi costituiscono uno strumento flessibile e potente per generare elenchi numerati. I campiutilizzano contatori, detti identificatori, per calcolare, specificare e reimpostare valori numerici. Èpossibile reimpostare i campi su un valore specifico utilizzando l’opzione \r. Utilizzare inoltrequesta opzione per generare più elenchi all’interno dello stesso documento. È necessario applicareattributi di formattazione ai campi Seq, tramite stili o con la formattazione diretta. È inoltre necessarioposizionare manualmente i caratteri speciali quali le parentesi o i separatori decimali.

Per creare un elenco numerato con il campo Seq:

1. Posizionare il cursore nel punto in cui si desidera inserire il numero per un elenco numerato.

2. Fare clic sulla scheda Inserisci, nel gruppo Testo fare clic su Parti rapide e selezionare Campo.

3. Dall’elenco Categorie, selezionare Numerazione.

4. Dall’elenco dei nomi di Campo, selezionare Seq.

5. Nella sezione Proprietà campo avanzate è visualizzata la casella Codici di campo. Ogni campoSeq contiene un identificatore (nome) che lo pone in relazione agli altri campi Seq con lo stessonome. L’identificatore è un nome che consente di distinguere un elenco di campi dall’altro. InCodici di campo, digitare un identificatore dopo SEQ.

6. Fare clic su Opzioni. Verrà visualizzata la finestra di dialogo Opzioni campo.

7. Nella scheda Parametri generici, in Formattazione, scegliere un formato di numerazione, adesempio 1, 2 3..., quindi fare clic su Aggiungi al campo.

8. Fare clic su OK due volte. Nel documento verrà visualizzato il primo numero.

9. Formattare manualmente il campo Seq aggiungendo un punto o una parentesi dopo il numero.

10. Utilizzare gli stili o applicare una formattazione diretta per il tipo di carattere, le dimensioni e illayout, a seconda delle esigenze del documento.

11. Per riprodurre il campo Seq e tutta la formattazione applicata ad esso, selezionare il campo Seq egli eventuali caratteri di formattazione associati e utilizzare la funzione di copia e incolla.

Elenchi numerati a su più livelli con il campo Seq

È inoltre possibile utilizzare il campo Seq in combinazione con gli stili per creare elenchi numerati supiù livelli. Per creare l’effetto a più livelli, per questo tipo di elenchi vengono utilizzati più stili.

332

Page 333:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

Per creare il primo livello di numerazione:

1. Creare lo stile di paragrafo per il primo livello.

2. Individuare la sezione Rientri nella finestra di dialogo Paragrafo - Rientri e spaziatura. Nell’elencoSpeciale, selezionare Sporgente per creare un rientro sporgente per lo stile. Per ulterioriinformazioni, vedere Opzioni dei paragrafi: Rientri e spaziatura, pagina 317.

3. Nell’elenco Rientra di, specificare un valore per il rientro sporgente e fare clic su OK.

4. Posizionare il cursore all’inizio della riga.

5. Definire un campo Seq, specificare un identificatore e fare clic su Opzioni.

6. Specificare la formattazione per il campo.

7. Fare clic su OK e fare di nuovo clic su OK.

8. Applicare lo stile e copiare il campo Seq in tutti i paragrafi di primo livello.

9. Su una nuova riga, creare il secondo livello di numerazione creando lo stile di paragrafo disecondo livello.

10. Nella scheda Paragrafo, in Rientri specificare un rientro a sinistra per creare il secondo livellodi rientro.

11. Nell’elenco Speciale, selezionare Sporgente per creare un rientro sporgente per lo stile.

12. Nell’elenco Rientra di, specificare un valore per il rientro sporgente e fare clic su OK.

13. Posizionare il cursore all’inizio della prima riga del testo del secondo livello.

14. Definire un campo Seq, specificare un identificatore e fare clic su Opzioni.

15. Specificare la formattazione per il campo.

16. Fare clic su OK e fare di nuovo clic su OK.

17. Applicare lo stile e copiare il campo Seq in tutti i paragrafi di secondo livello.

18. Fare clic con il pulsante destro del mouse su ogni campo Seq e fare clic su Aggiorna campo.

Riavvio della numerazione negli elenchi Seq

Per riavviare un elenco numerato Seq:

1. Posizionare il cursore nel punto in cui si desidera riavviare un elenco numerato o avviare unnuovo elenco numerato utilizzando lo stesso identificatore Seq.

2. Fare clic sulla scheda Inserisci, quindi su Parti rapide nel gruppo Testo e selezionare Campo.

3. In Categorie, selezionare Numerazione.

4. In Nomi dei campi, selezionare Seq.

5. Digitare un nuovo identificatore dopo SEQ e fare clic su Opzioni.

6. Fare clic sulla scheda Parametri specifici.

7. Selezionare l’opzione \r e fare clic su Aggiungi al campo. L’opzione del \r imposta il campo suqualsiasi valore definito dall’utente dopo l’opzione stessa nella casella di testo Codice di campo.

333

Page 334:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di paragrafo

8. Digitare il numero 1 dopo l’opzione \r. La casella di testo Field Code deve rispettare la sintassiseguente:

SEQ identifier\r 1

dove identifier è l’identificatore creato nel passaggio 5.

9. Fare clic su OK due volte. Il numero 1 verrà visualizzato come codice di campo.

334

Page 335:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice F

Formattazione a livello di carattere

In questo capitolo sono descritte tutte le funzionalità di formattazione a livello di carattere disponibilinella finestra di dialogo Carattere:• Configurazione della formattazione a livello di carattere, pagina 335

• Caratteri speciali, pagina 339

• WordArt, pagina 340

• Equazione, pagina 341

Nota: xPresso for Word supporta le funzionalità elencate di seguito; tutte le altre funzionalità nonelencate in modo esplicito non sono supportate.

Configurazione della formattazione a livello dicarattereLa maggior parte delle funzionalità di formattazione a livello di carattere vengono visualizzatenella finestra di dialogo Carattere. Per accedere a queste opzioni è possibile fare clic sulla schedaHome ed espandere il gruppo Carattere.

In questa sezione sono illustrate le opzioni seguenti:

• Opzioni relative al carattere, pagina 335

• Opzioni relative al carattere: Avanzate, pagina 337

• Opzioni aggiuntive per i caratteri, pagina 339

Opzioni relative al carattere

Per accedere alle opzioni di formattazione a livello di carattere, fare clic sulla scheda Home edespandere il gruppo Carattere.

Funzionalità Supporto

Carattere √

Stile √

335

Page 336:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

Funzionalità Supporto

Dimensione √

Colore carattere √

Stile sottolineatura: solo parole Non supportato

Stile sottolineatura: singola √

Stile sottolineatura: doppia Non supportato

Stile sottolineatura: spessa Non supportato

Stile sottolineatura: punteggiata √

Stile sottolineatura: tratteggiata √

Stile sottolineatura: punto-tratto √

Stile sottolineatura: punto-punto-tratto √

Stile sottolineatura: ondulata √

Altro stile di sottolineatura Non supportato

Colore sottolineatura √

Effetti: Barrato √

Effetti: Barrato doppio Non supportato

Effetti: Apice √

Effetti: Pedice √

Effetti: Ombreggiatura Non supportato

Effetti: Contorno Non supportato

Effetti: In rilievo Non supportato

Effetti: Incassato Non supportato

Effetti: Maiuscoletto √

Effetti: Tutto maiuscole √

Effetti: Nascosto √

Sottolineatura e barrato

Lo spessore predefinito della sottolineatura o del segno di barrato dipende dalla dimensione delcarattere. Lo spessore può essere configurato. xPresso for Word utilizza i valori di offset e spessoreche recupera dal file del carattere TrueType.

336

Page 337:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

Apice e pedice

Per apice e pedice, l’engine di pubblicazione di xPublish utilizza le seguenti impostazioni predefinite:• Dimensione = 60%

• Offset linea di base = 50%

Effetti di testo

Per accedere alle opzioni di formattazione degli effetti di testo, fare clic sulla schedaHome, espandereil gruppo Carattere e fare clic sul pulsante Effetti di testo. Verrà visualizzata la finestra di dialogoFormato effetti testo.

Funzionalità Supporto

Riempimento testo Non supportato

Contorno testo Non supportato

Stile contorno Non supportato

Ombreggiatura Non supportato

Riflesso Non supportato

Alone e contorni sfumati Non supportato

Formato 3D Non supportato

Effetti: Maiuscoletto √

Effetti: Tutto maiuscole √

Effetti: Nascosto √

Segno di enfasi Non supportato

Opzioni relative al carattere: Avanzate

Per accedere alle opzioni di spaziatura dei caratteri, fare clic sulla scheda Home, espandere il gruppoCarattere e fare clic sulla scheda Avanzate.

La scheda Avanzate contiene le seguenti opzioni:

Funzionalità Supporto

Scala √

Spaziatura √

Posizione Non supportato

Crenatura caratteri √

Legature Non supportato

337

Page 338:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

Funzionalità Supporto

Spaziatura numeri Non supportato

Formati numerici Non supportato

Set stilistici Non supportato

Usa alternative contestuali Non supportato

Scala

La funzionalità Scala è abilitata per impostazione predefinita. Per disabilitare la funzionalità Scala, ènecessario modificare una proprietà di configurazione in entrambi i seguenti file:

• Il file xPRSConfig.xml che si trova sul client xPresso for Word nella directory di configurazione.

• Il file DCPI.properties che si trova sul server xPression nella directory xPressionHome.

La seguente proprietà è disponibile nel file xPRSConfig.xml nel client:<prop name="EnableScalingCharacter" value="true" />

La proprietà corrispondente è disponibile nel file DCPI.properties nel server:EnableScalingCharacter=true

Per disabilitare la funzionalità Scala, impostare il valore su false in entrambi i file di configurazione.

Spaziatura e crenatura

Le proprietà EnableKerning e EnableTracking sono effettive solo sugli output PDF, PS, AFP ePCL. Gli output DOCX e HTML non sono interessati.

Il supporto per spaziatura e crenatura non è abilitato per impostazione predefinita. Per abilitare laspaziatura o la crenatura, è necessario modificare una proprietà di configurazione nei file seguenti:

• File xPRSConfig.xml, posizionato nella directory di configurazione del client xPresso for Word.

• File DCPI.properties, posizionato nella directory xPressionHome del server xPression.

Nota: Nel lato server, è possibile trovare inoltre il file xPRSConfig.xml nella directoryxPressionHome, con dei contenuti diversi da quelli presenti nel client. Se le proprietà esistono giàin DCPI.properties, non aggiungerle manualmente al file xPRSConfig.xml nel server.

Individuare le seguenti proprietà nel file xPRSConfig.xml del client:<prop name="EnableTracking" value="false" /><prop name="EnableKerning" value="false" />

Le proprietà corrispondenti nel file DCPI.properties sono:EnableTracking=falseEnableKerning=false

Per abilitare la spaziatura (avvicinamento) o la crenatura, impostare il valore appropriato su truein entrambi i file di configurazione.

338

Page 339:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

Opzioni aggiuntive per i caratteri

Nella tabella seguente sono elencate alcune opzioni aggiuntive per i caratteri disponibili da MicrosoftWord.

Funzionalità Supporto

Animazione testo Non supportato

Evidenziato √

Sfondo √

Caratteri specialiIl server xPression supporta il set di caratteri ISO Latin-1. Questo set di caratteri contiene tutte lelettere dell’alfabeto latino utilizzate in tutte le lingue dell’Europa occidentale, comprese le vocaliaccentate e il simbolo di copyright.

Per i documenti pubblicati sono spesso necessari caratteri speciali, simboli e caratteri internazionali.Per utilizzare i caratteri speciali in un documento xPresso for Word, utilizzare i caratteri del tipodi carattere Symbol.

In questa sezione sono illustrati gli argomenti seguenti:

• Supporto dei caratteri speciali di Microsoft Word, pagina 339

• ALT + combinazioni di numeri, pagina 340

Supporto dei caratteri speciali di Microsoft Word

Per visualizzare un elenco di caratteri speciali di Microsoft Word è possibile fare clic sulla schedaInserisci, fare clic su Simboli nel gruppo Simboli, selezionare Altri simboli e quindi fare clic sullascheda Caratteri speciali.

In questa tabella è descritto il supporto dei caratteri speciali per xPresso for Word.

Funzionalità Supporto

Spazio lungo Non supportato

Spazio breve Non supportato

Spazio unificatore √

1/4 spazio lungo Non supportato

Trattino lungo √

Trattino breve √

Trattino facoltativo √

Trattino unificatore √

339

Page 340:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

Funzionalità Supporto

Simboli √

Virgolette √

Glossario

Nella scheda Inserisci del gruppo Testo fare clic suParti rapide, selezionare AutoText, quindi fare clicsu Save Selection in AutoText Gallery.

Funzionalità Supporto

Numero pagina corrente √

Numero totale di pagine √

Stile numero arabo √

Stile numero romano √

Stile numero alfabetico √

Doppio byte Sconosciuto

ALT + combinazioni di numeri

È possibile accedere a caratteri non presenti sulla tastiera tramite il tasto ALT standard di Windows +diverse combinazioni di numeri. Ad esempio, tenendo premuto il tasto ALT mentre si digita 0169 siottiene il simbolo di copyright (©).

Ulteriori informazioni sulle combinazioni di quattro cifre sono disponibili nell’utilità Mappa caratteriin Strumenti di sistema di Windows. Selezionare un carattere dalla mappa caratteri di Windows. Sinoti la combinazione di tasti nell’angolo inferiore destro della finestra.

WordArtLa funzionalitàWordArt non è supportata da xPresso for Word. È possibile accedere alla funzionalitàdalla scheda Inserisci.L’output delWordArt viene generato come paragrafo racchiuso in una caselladi testo. Se il contenuto è assente, provare ad allargare la casella di testo.

CapoletteraLa funzionalità Capolettera non è supportata da xPresso for Word. È possibile accedere allafunzionalità dalla scheda Inserisci.

340

Page 341:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

Riga della firmaLa funzionalità Object non è supportata da xPresso for Word. È possibile accedere alla funzionalitàdalla scheda Inserisci.

ObjectLa funzionalità Riga della firma non è supportata da xPresso for Word. È possibile accedere allafunzionalità dalla scheda Inserisci.

EquazionexPression non supporta la funzione Equazione di Microsoft Word accessibile dalla scheda Inseriscinella Barra multifunzione di Word.

341

Page 342:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Formattazione a livello di carattere

342

Page 343:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Appendice G

Funzionalità speciali di Microsoft Word

In questo capitolo vengono descritte altre funzionalità di Microsoft Word e il modo in cui sonosupportate in xPresso for Word:• Creazione di righelli orizzontali e verticali, pagina 343

• Caselle di testo e cornici, pagina 346

• Colore, pagina 346

• Note a piè di pagina, pagina 346

• Riga della firma, pagina 347

• Object, pagina 347

• Smart Art, pagina 347

Nota: xPresso for Word supporta le funzionalità elencate di seguito; tutte le altre funzionalità nonelencate in modo esplicito non sono supportate.

Creazione di righelli orizzontali e verticalixPresso for Word supporta la possibilità di tracciare righelli verticali e orizzontali tramite MicrosoftWord.

Per tracciare una linea orizzontale o verticale:

1. Fare clic sulla scheda Inserisci e fare clic su Forme nel gruppo Illustrazioni per visualizzareil menu Forme.

2. Selezionare Linea.

3. Tracciare la linea orizzontale o verticale facendo clic sul punto di inizio e trascinando il mouse pertrascinare la linea fino alla larghezza desiderata.

343

Page 344:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzionalità speciali di Microsoft Word

Opzioni dei righelli orizzontali e verticali: colori dellelinee e stili

Per visualizzare le opzioni dei righelli, fare clic con il pulsante destro del mouse su una linea esistentee fare clic su Formato forma.

La finestra di dialogo Formato forma contiene le seguenti opzioni relative ai colori delle lineee agli stili.

Funzionalità Supporto

Colore della linea √

Stile linea: tipo di tratteggio Punto, punto quadrato etratteggio

Stile linea: larghezza √

Stile linea: impostazioni freccia Non supportato

Stile linea: tipo di composto Sono supportate solo le opzioniSemplice e Double

Nota: se in una linea viene utilizzato il tipo di tratteggio "punto quadrato", questo non può esserevisualizzato quando si apre l’output iDOCX con Microsoft Word.

Opzioni dei righelli orizzontali e verticali: Dimensioni

Per visualizzare le opzioni relative alle dimensioni dei righelli, individuare il gruppo Dimensioninella scheda Formato in Strumenti di disegno.

La scheda Dimensioni contiene le seguenti opzioni.

Funzionalità Supporto

Altezza √

Larghezza √

Rotazione Non supportato

Proporzioni: Altezza/Larghezza Non supportato

Proporzioni: Blocca proporzioni Non supportato

Proporzioni: Rispetto alle dimensioni originali Non supportato

xPresso for Word non supporta le caselle salvate da Microsoft Word come immagini statiche. xPressofor Word e non supporta direttamente neanche le caselle di testo. È tuttavia possibile inserire unacasella di testo e convertirla in cornice.

344

Page 345:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzionalità speciali di Microsoft Word

Opzioni dei righelli orizzontali e verticali: disposizionetesto

Per visualizzare le opzioni di layout dei righelli, individuare il gruppo Disponi nella scheda Formatoin Strumenti di disegno. Selezionare Testo a capo > Altre opzioni di layout per aprire la finestra didialogo Layout.

La scheda Disposizione testo contiene le seguenti opzioni.

Funzionalità Supporto

Disposizione testo: in linea con il testo √

Disposizione testo: quadrato Supportato

Disposizione testo: ravvicinato Non supportato

Disposizione testo: dietro al testo Supportato

Disposizione testo: davanti al testo Supportato

Opzioni dei righelli orizzontali e verticali: posizione

Per visualizzare le opzioni di layout dei righelli, individuare il gruppo Disponi nella scheda Formatoin Strumenti di disegno. Selezionare Posizione > Altre opzioni di layout per aprire la finestra didialogo Layout.

La scheda Posizione contiene le seguenti opzioni.

Funzionalità Supporto

Orizzontale: Allineamento Non supportato

Orizzontale: Layout libro Non supportato

Orizzontale: Posizione assoluta Non supportato

Orizzontale: Posizione relativa Non supportato

Verticale: Allineamento Non supportato

Verticale: Posizione assoluta Non supportato

Verticale: Posizione relativa Non supportato

Opzioni: sposta object con testo Non supportato

Opzioni: Blocca ancoraggio Non supportato

Opzioni: Consenti sovrapposizione Non supportato

Opzioni: Layout in cella di tabella Non supportato

345

Page 346:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzionalità speciali di Microsoft Word

FiligranaxPresso for Word non supporta le filigrane.

TemixPresso for Word supporta i temi di colori e caratteri e l’orientamento del testo nei temi. I temi deglieffetti non sono supportati. Per accedere a Temi, passare alla scheda Progettazione della Barramultifunzione di Word e fare clic suTemi.

Sfondo paginaxPresso for Word non supporta il bordo pagina e il colore.

Caselle di testo e cornicixPresso for Word supporta le caselle di testo e le cornici. Per ulteriori informazioni, vedere Utilizzodelle caselle di testo di Microsoft Word, pagina 115.

ColorexPresso for Word consente di selezionare un colore arbitrario da utilizzare per il testo, per i righelli eper gli altri elementi compositivi. Supporta il colore RGB impostato in modo esplicito in MicrosoftWord.

SommarioLe opzione del sommario non sono supportate nei documenti di xPresso for Word.

Note a piè di paginaLe note a piè di pagina create utilizzando la funzionalità Inserisci nota a piè di pagina di MicrosoftWord non sono supportate nei documenti di xPresso for Word.

346

Page 347:  · Sommario Prefazione ........................................................................................................................... 17 Capitolo1

Funzionalità speciali di Microsoft Word

Controlli per sviluppatoriI controlli per sviluppatori non sono supportati nei documenti di xPresso for Word.

Riga della firmaLe righe della firma create tramite Inserisci > Testo > Riga della firma non sono supportate neidocumenti di xPresso for Word.

ObjectGli object creati tramite Inserisci > Testo > Object non sono supportati nei documenti di xPressofor Word.

Smart ArtSmart Art non è supportato nei documenti di xPresso for Word.

347