Como criar e inserir fragmentos

É possível criar um fragmento em um arquivo XDP separado ou no design de formulário atual. Ao criar o fragmento em um arquivo separado, é possível substituir os objetos selecionados por uma referência ao arquivo do fragmento. Se a seleção não for substituída por uma referência de fragmento, o fragmento será criado, mas a seleção permanecerá inalterada e não estará conectada ao novo fragmento. Ao deixar a seleção inalterada, você salva as etapas para quando precisar criar diversos fragmentos parecidos.

Criar o fragmento no arquivo atual é útil quando você deseja definir diversos fragmentos em um arquivo. Criar diversos fragmentos em um arquivo pode facilitar a atualização de diversos fragmentos, especialmente quando os fragmentos são parecidos.

Nota: Não é possível criar um fragmento em um formulário criado importando um arquivo PDF como arte-final. Para obter mais informações, consulte Importação de documentos PDF como arte-final.

Fragmentos são identificados pelo nome do fragmento. Ao criar o fragmento em um arquivo separado, também é possível especificar o local e o nome do arquivo. O nome do fragmento não precisa corresponder ao nome do arquivo.

O nome do fragmento aparece na Biblioteca de fragmentos quando você clica em OK na caixa de diálogo Criar fragmento. Quando você cria um fragmento no design do formulário atual e o salva como um arquivo XDP, o nome do fragmento aparece na Biblioteca de fragmentos quando você salva o arquivo.

Ao criar um fragmento, é possível selecionar um subformulário existente ou selecionar um ou mais objetos. Se objetos que não estão em um subformulário forem selecionados, os objetos serão vinculados em um subformulário quando o fragmento for criado.

Nota: Após a criação de um fragmento selecionando objetos existentes, atualize as referências de script no fragmento para refletir que os objetos estão vinculados em um novo subformulário.

Você pode usar o menu para criar um fragmento, ou pode arrastar os objetos selecionados para a Biblioteca de fragmentos. Ao criar um fragmento arrastando a seleção para a Biblioteca de fragmentos, a opção de criação do fragmento no arquivo atual fica indisponível.

Salve os arquivos de origem do fragmento como arquivos XDP. Se um arquivo de origem do fragmento for salvo como um arquivo PDF, os fragmentos não poderão ser referenciados em outros formulários.

Ao criar um fragmento em um aplicativo do LiveCycle e verificá-lo, ele é salvo no repositório e aparece na visualização Aplicativos no Workbench.

Crie fragmentos de script a partir de objetos de script, em vez de subformulários, e crie-os a partir da paleta Hierarquia.

Para obter mais informações sobre a criação e inserção de fragmentos de script, consulte Usando Fragmentos de Script.

Criar um fragmento

  1. Selecione os objetos a serem incluídos no fragmento. É possível selecionar um fragmento ou diversos objetos.

  2. Selecione Editar > Fragmentos > Criar fragmento.

  3. (Opcional) Na caixa Descrição, digite uma descrição do fragmento.

  4. Selecione um método para criação do fragmento:

    • Para definir o fragmento em um arquivo XDP separado armazenado na Biblioteca de fragmentos, selecione Criar fragmento na Biblioteca de fragmentos.

      • Na versão independente do Designer, selecione a Biblioteca de fragmentos onde deseja salvar o arquivo do fragmento.

      • No Designer com Workbench, na lista da Biblioteca de fragmentos, selecione uma pasta de aplicativos do LiveCycle onde deseja salvar o arquivo do fragmento. Não é possível selecionar a pasta do aplicativo raiz.

      • (Opcional) Para usar um nome de arquivo diferente, na caixa Nome do arquivo digite o nome do arquivo para o fragmento.

      • Para referenciar o novo fragmento no atual design de formulário, selecione Substituir seleção por referência a novo fragmento do formulário e então clique em OK.

Como inserir referências de fragmento

É possível usar fragmentos para reutilizar o conteúdo em diversos formulários. Ao criar um design de formulário, insira uma referência em um fragmento existente, e o fragmento aparecerá no design de formulário.

Depois de inserir uma referência de fragmento, é possível reposicioná-la no design de formulário.

Se estiver usando o Designer com o Workbench, é possível inserir um referência em um fragmento que está fora da pasta de aplicativo raiz ou que não esteja em um aplicativo do Workbench. No entanto, é preciso copiar o fragmento e os arquivos aos quais ele faz referência no aplicativo atual. Os arquivos são copiados na mesma pasta do formulário atual e as referências aos arquivos são atualizadas.

Nota: Não é possível inserir um fragmento em um formulário que foi criado importando um arquivo PDF como arte-final. (Consulte Importação de documentos PDF como arte-final.)
Para visualizar os fragmentos na paleta Biblioteca de fragmentos, selecione Mostrar painel de visualização no menu da paleta.

Para inserir um fragmento da paleta Biblioteca de fragmentos:

 Conclua uma destas ações:
  • Arraste o fragmento até o design de formulário.

    Nota: Não é possível arrastar um fragmento da paleta Biblioteca de fragmentos para um subformulário que é filho de um conjunto de subformulários. Ocorre a alteração do cursor e o Designer exibe um ícone de aviso (um círculo com uma linha diagonal) para indicar que esta operação é ilegal.
  • Clique duas vezes no fragmento.

Para inserir um fragmento do menu Inserir

  1. Selecione Inserir > Fragmento.

  2. Navegue até o arquivo que contém o fragmento.

  3. Selecione o arquivo.

  4. Se o arquivo contiver mais de um fragmento, selecione o fragmento.

  5. Clique em OK. O fragmento aparece no centro da página visível.