Usar Bibliotecas

Bibliotecas são um meio de criar instruções reutilizáveis para o KCM Designer quando Modelos Mestres são executados. Enquanto Includes são compilados em Modelos Mestres, as Bibliotecas são componentes independentes e dinâmicos.

Bibliotecas contêm tipos diferentes de funções e procedimentos, tais como:

Funções de formatação usadas para formatar Campos em Blocos de Texto.

É possível estender a lista de funções disponíveis definindo suas próprias funções de formato em uma Biblioteca.
Funções de filtro usadas para filtrar Blocos de Texto em Listas de Blocos de Texto.

As seguintes restrições se aplicam ao remover ou renomear Bibliotecas:

As funções da Biblioteca não podem ser renomeadas ou removidas após a Biblioteca de Códigos ter sido desbloqueada.
Uma Biblioteca não poderá ser renomeada ou removida se um objeto se referir a uma das funções que ela contém.

Para obter mais informações sobre as funções e procedimentos reutilizáveis que uma Biblioteca pode conter, consulte os tópicos nas Bibliotecas e pontos de saída do Kofax Communications Manager Template Scripting Language Developer's Guide (Guia do desenvolvedor de linguagem de script de Modelos do Kofax Communications Manager).

Criar e editar Biblioteca

Navegue até Modelos Mestres > Bibliotecas.
Clique em Bibliotecas e, em seguida, em Nova biblioteca no painel Novo à direita.

A janela Nova biblioteca é exibida.
Insira um nome para a nova Biblioteca e um nível e clique em OK.

Devem ser atribuídos números de níveis exclusivos a todas as Bibliotecas. Os números de nível determinam a ordem em que o conteúdo é carregado. As bibliotecas de níveis superiores têm prioridade sobre as bibliotecas de níveis inferiores. O nível padrão é 100.

A nova Biblioteca é exibida em Bibliotecas.
Clique na nova Biblioteca e, em seguida, em Editar no painel Exibir e editar à direita.

A Biblioteca é aberta no Editor de biblioteca. Se você tiver o Microsoft Word 2016 ou posterior, uma Biblioteca baseada em Word será aberta no Microsoft Word.

Adicione ou cole o código necessário na Biblioteca. Observe que estas funções devem ser posicionadas entre as declarações # BEGIN e END #, por exemplo:

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

As declarações # BEGIN e END # também podem ser escritas da seguinte forma:

#BEGIN

...

END#

Salve a Biblioteca e feche o editor.
Se ocorrer um erro, clique em Exibir documento de erro.