Uso di Librerie

Le Librerie consentono di creare istruzioni riutilizzabili per KCM Designer, durante l'esecuzione dei Modelli principali. Mentre gli Includes sono compilati nei Modelli principali, le Librerie sono componenti autonomi e dinamici.

Le Librerie contengono tipi di funzioni e procedure diversi, ad esempio:

Funzioni di formattazione usate per formattare i Campi nei Blocchi di testo.

È possibile ampliare l'elenco delle funzioni disponibili definendo le funzioni di formato proprie, in una Libreria.
Funzioni filtro usate per filtrare i Blocchi di testo negli Elenchi blocchi di testo.

La rimozione o la ridenominazione delle Librerie sono soggette alle restrizioni di seguito:

Le funzioni della Libreria non possono essere ridenominate o rimosse dopo che sia stata sbloccata la Libreria del codice.
Una Libreria non può essere ridenominata o rimossa se un oggetto fa riferimento a una delle funzioni che questa contiene.

Per ulteriori informazioni sulle funzioni e le procedure riutilizzabili che possono essere contenute in una Libreria, consultare gli argomenti sulle Librerie e i punti di uscita nella Kofax Communications Manager Template Scripting Language Developer's Guide (Guida dello sviluppatore per il linguaggio di scripting del modello di Kofax Communications Manager).

Creazione e modifica di una Libreria

Passare a Modelli principali > Librerie.
Fare clic su Librerie e quindi su Nuova libreria nel riquadro Nuovo a destra.

Si apre la finestra Nuova libreria.
Immettere un nome per la nuova Libreria e fare clic su OK.

A tutte le librerie devono essere assegnati numeri di livello univoci. I numeri di livelli determinano l'ordine di caricamento dei contenuti. Le librerie con livelli elevati hanno la priorità rispetto alle altre con livelli inferiori. Il livello predefinito è 100.

La nuova Libreria viene visualizzata in Librerie.
Fare clic sulla nuova Libreria e quindi su Modifica nel riquadro Visualizza e modifica a destra.

La Libreria si apre in Editor della libreria. Se si dispone di Microsoft Word 2016 o superiore, in Microsoft Word si apre una Libreria basata su Word.

Aggiungere o incollare il codice necessario per la Libreria. Notare che qui le funzioni devono essere collocate tra le istruzioni # BEGIN e END #, come nell’esempio:

#
BEGIN

EXPORT FUNC TEXT set_headers(CONST TEXT brand; CONST TEXT document_type)
DO
  FIELDSET Headers
  TEXT path := "\Headers and footers\" + brand + "\" + document_type + "\" 

  TEXT text_block := path + "Header"
  IF text_block_exists(text_block; 0) THEN
    TEXTBLOCK VAR text_block
    ASSIGN_TO Headers.First
  FI

  ASSIGN text_block := path + "Header"
  IF text_block_exists(text_block; 0) THEN
    TEXTBLOCK VAR text_block
    ASSIGN_TO Headers.Odd
  FI

  ASSIGN text_block := path + "Header"
  IF text_block_exists(text_block; 0) THEN
    TEXTBLOCK VAR text_block
    ASSIGN_TO Headers.Even
  FI

  ASSIGN set_headers := headers(Headers.First; Headers.Odd; Headers.Even)
OD

END
#

Le istruzioni # BEGIN e END # possono anche essere scritte come di seguito:

#BEGIN

...

END#

Salvare la Libreria e chiudere l'editor.
Se si verifica un errore, fare clic su Mostra documento errori.