Uso de fragmentos de script

Um fragmento de script contém um objeto de script. Um objeto de script contém funções ou valores JavaScript reutilizáveis que são armazenados separadamente de qualquer objeto de formulário específico, como analisador de data ou uma chamada de serviço da web. Normalmente, você usa os objetos de script para criar funções e métodos personalizados que deseja usar em muitos locais em um formulário. O uso de objetos de script reduz a quantidade geral de scripts necessários para realizar ações repetitivas.

Fragmentos de script incluem apenas objetos de script que aparecem como filhos de variáveis na paleta Hierarquia. Os fragmentos não podem conter scripts associados com outros objetos de formulário, por exemplo, scripts de eventos, como validar, calcular ou inicializar.

Você cria um fragmento de script a partir da paleta Hierarquia.

Você edita fragmentos de script da mesma forma que outros fragmentos.

    Propriedades do fragmento de script

    Ao selecionar um fragmento de script, a guia Objeto de script na paleta Objeto exibe as propriedades do fragmento.

    Arquivo de origem

    Define o arquivo de origem para a referência de fragmento. Esta propriedade é visível apenas quando o objeto selecionado é uma referência de fragmento.

    Nome do fragmento

    Define o nome do fragmento. Clique no botão Informações do fragmento para exibir as informações do fragmento.

    Esta propriedade é visível apenas quando a referência do fragmento ou um fragmento definido em um arquivo de origem é selecionado. Quando o objeto selecionado é uma referência de fragmento, esta propriedade não aparece se o arquivo de origem não for especificado. A lista Nome do fragmento inclui todos os fragmentos no arquivo de origem especificado. A opção Personalizar suporta diretamente a configuração de uma expressão SOM ou de um valor de ID como a referência de fragmento e suporta a implementação na Arquitetura de formulários XML.

      Criação de fragmentos de script

      É possível criar um fragmento de script de funções comuns que pode ser reutilizado em diversos formulários. Para criar um fragmento de script, você cria um objeto de script que contém as funções a serem reutilizadas em diversos designs de formulário. O fragmento de script pode incluir somente um objeto de script.

      1. Crie um objeto de script.

      2. Na paleta Hierarquia, clique com o botão direito do mouse no objeto de script e selecione Fragmentos > Criar fragmento.

        Nota: É possível também criar um fragmento de script arrastando o objeto de script da paleta Hierarquia para a paleta Biblioteca de fragmentos.

      3. Para usar um nome de fragmento diferente, na caixa Nome, digite um nome para o fragmento.

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

      5. 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 novo fragmento na Biblioteca de fragmentos. Na lista Biblioteca de fragmentos, selecione a Biblioteca de fragmentos onde deseja salvar o arquivo do fragmento. Para usar um nome de arquivo diferente, na caixa Nome do arquivo, digite o nome do arquivo para o fragmento. Se não quiser substituir a seleção pelo novo fragmento, desmarque Substituir seleção por referência a novo fragmento do formulário.

        • Para definir o fragmento no arquivo atual, selecione Criar novo fragmento no documento atual.

      6. Clique em OK.

        Inserção de fragmentos de script

        É possível usar fragmentos de script para reutilizar funções JavaScript em diversos formulários. Ao criar um design de formulário, você insere uma referência a um fragmento de script existente e o fragmento aparece no design de formulário.

        Não é possível inserir um fragmento em um documento XFAF.

        Nota: 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:

        1. Na biblioteca de fragmentos, selecione o fragmento de script.

        2. Arraste o fragmento para um subformulário ou objeto variáveis na paleta Hierarquia.

        Para inserir um fragmento de script pelo menu Inserir:

        1. Selecione Inserir > Fragmento.

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

        3. Selecione o arquivo e clique em OK. O fragmento aparece como um filho do objeto de variáveis no subformulário raiz.