Usar Bibliotecas

Las Bibliotecas son una forma de crear instrucciones reutilizables para KCM Designer cuando se ejecuten Plantillas maestras. Mientras que los Includes se compilan en Plantillas maestras, las Bibliotecas son componentes dinámicos, completamente autocontenidos.

Las Bibliotecas contienen distintos tipos de funciones y procedimientos, como:

  • Funciones de formato que se usan para aplicar formato a Campos en Bloques de texto

    Puede ampliar la lista de funciones disponibles definiendo sus propias funciones de formato en una Biblioteca.

  • Las funciones de filtrar se utilizan para filtrar Bloques de texto en Listas de bloques de texto.

A la hora de eliminar o cambiar el nombre de Bibliotecas, hay una serie de restricciones:

  • Las funciones de la Biblioteca no se pueden renombrar ni eliminar después de que se haya desbloqueado la Biblioteca de código (Code Library).
  • Una Biblioteca no se puede renombrar ni eliminar si hay algún objeto que haga referencia a una de las funciones en la biblioteca.
Para obtener más información sobre las funciones y procedimientos reutilizables que puede tener una Biblioteca, consulte los temas en Bibliotecas y los puntos de salida en la Kofax Communications Manager Template Scripting Language Developer's Guide [Guía del desarrollador del lenguaje de scripts de plantillas de Kofax Communications Manager].

Crear y editar una Biblioteca

  1. Acceda a Plantillas maestras > Bibliotecas.
  2. Haga clic en Bibliotecas y luego en Nueva biblioteca en el panel Nuevo de la derecha.

    Aparece la ventana Nueva biblioteca.

  3. Especifique un nombre para la Biblioteca nueva y un nivel, y haga clic en Aceptar.

    Todas las bibliotecas deben tener asignados números de nivel únicos. Los números de nivel determinan el orden en el que se cargan los contenidos. Las bibliotecas de niveles altos tienen prioridad sobre las bibliotecas de niveles inferiores. El nivel predeterminado es 100.

    La Biblioteca nueva aparece en Bibliotecas.

  4. Haga clic en la nueva Biblioteca y luego en Editar, en el panel Ver y editar de la derecha.

    La Biblioteca se abre en el Editor de biblioteca. Si tiene Microsoft Word 2016 o posterior, se abrirá una Biblioteca basada en Word.

  5. Agregue o pegue el código necesario a la Biblioteca. Tenga en cuenta que las funciones que se indican aquí deben colocarse entre las declaraciones # BEGIN y END #, por ejemplo:

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

    Las declaraciones # BEGIN y END # también se pueden escribir de la siguiente manera:

    #BEGIN
    
    ...
    
    END#
  6. Guarde la Biblioteca y cierre el editor.
    Si se produce un error, haga clic en Mostrar Documento de errores.