Substituir ações de teste de componente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • Altere as propriedades de teste de um componente de página específico usando atributos HTML específicos de Automated Test Framework.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Quando Automated Test Frameworkrecupera um componente, ele determina quais interações ele oferece suporte, como se é um componente configurável ou clicável. Se o componente for configurável, Automated Test Frameworkdetermina o tipo de campo que pode ser definido. Se Automated Test FrameworkDetermina incorretamente as ações ou os tipos de campo do componente personalizado, ou seu componente contém vários elementos DOM que devem ser tratados como uma entidade, defina-os explicitamente usando atributos HTML específicos para Automated Test Framework.

    Usando atributos sn-atf-clickable e sn-atf-settable

    Uso sn-atf-clicável e. sn-atf-configurável atributos para especificar que um elemento e seus elementos secundários devem ser tratados como um componente clicável personalizado ou configurável personalizado.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Abra a página de IU personalizada que você deseja testar.
    2. Adicione o. sn-atf-clicável ou sn-atf-configurável atributo ao elemento que está sendo testado.
      <div sn-atf-clickable="true" sn-atf-disabled id="customClickable">
      	<button id="customButton">Click me</button>
      </div>
      <div sn-atf-settable="true" id="customSettable" sn-atf-component-value="A default value">
      	<input id="customInput" value="A default value"></input>
      </div>
      Nota:
      Você pode usar qualquer um deles sn-atf-clicável ou sn-atf-configurável atributo para especificar se um elemento deve ser tratado como um componente clicável personalizado ou configurável personalizado. Não é possível usar os dois atributos no mesmo elemento.
    3. Use o. sn-atf-clicável ou sn-atf-configurável atributo.
      • sn-atf-clicável : Se você adicionou o. sn-atf-clicável ATF clica no componente enviando um sn-atf-clique Evento para o elemento DOM com sn-atf-clicável atributo. Você deve adicionar um ouvinte de eventos (por exemplo, usando AddEventListener ) Para este elemento DOM e implemente sua lógica de clique personalizada para o componente. Você pode interagir com um componente clicável personalizado usando Clique em Componente etapa de teste.
        Tabela 1. Atributos de componente clicáveis
        Nome de atributo Descrição
        sn-atf-desabilitado A presença deste atributo opcional (independentemente do seu valor) informa ao ATF que este componente está desabilitado
        Nota:
        Se este atributo estiver ausente, o ATF considera que este componente está habilitado por padrão.
        valor-componente-atf-sn Uma cadeia de caracteres ou objeto JSON que informa ao ATF o valor atual deste componente
      • sn-atf-configurável : Se você adicionou o. sn-atf-configurável ATF define o valor do componente enviando um valor de configuração sn-atf Evento para o elemento DOM com sn-atf-configurável atributo. Você deve adicionar um ouvinte de eventos (por exemplo, usando AddEventListener ) Para este elemento DOM e implemente sua lógica de valor de conjunto personalizado para o componente. O valor que precisa ser definido pode ser acessado com event.detail.newvalue . . evento o argumento é passado para o manipulador de eventos. Você pode interagir com um componente configurável personalizado usando Defina valores de componente etapa de teste.
        Tabela 2. Atributos de componente configuráveis
        Nome de atributo Descrição
        sn-atf-desabilitado A presença deste atributo opcional (independentemente do seu valor) informa ao ATF que este componente está desabilitado.
        Nota:
        Se este atributo estiver ausente, o ATF considera que este componente está habilitado por padrão.
        valor-componente-atf-sn Uma cadeia de caracteres ou objeto JSON que informa ao ATF o valor atual deste componente.
        sn-atf-data-type Tipo opcional de campo a ser apresentado ao usuário ao criar uma etapa. O padrão é cadeia de caracteres. Por exemplo, glide_date_time , referência, booliano etc.
        sn-atf-data-type-params Objeto JSON com mais detalhes de tipo de dados.

    Exemplo

    //A custom clickable component
    
    <div sn-atf-clickable="true" sn-atf-disabled id="customClickable">
    	<button id="customButton">Click me</button>
    </div>
    <script>
    	var customClickableDiv = document.getElementById("customClickable");
    	customClickableDiv.addEventListener('sn-atf-click', function() {
    		document.getElementById('customButton').click();
    	});
    </script>
    //A custom settable component
    
    <div sn-atf-settable="true" id="customSettable" sn-atf-component-value="A default value">
    	<input id="customInput" value="A default value"></input>
    </div>
    <script>
    	var customSettableDiv = document.getElementById("customSettable");
    	customSettableDiv.addEventListener('sn-atf-setvalue', function(event) {
    		var newValue = event.detail.newValue;
    		document.getElementById("customInput").value = newValue;
    	});
    </script>

    Usando o atributo sn-atf-class

    Use o. classe sn-atf Atributo para especificar o objeto JavaScript a ser usado ao testar um componente clicável ou configurável personalizado. Escreva um objeto JavaScript personalizado para especificar as ações de teste disponíveis para um componente personalizado.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Os designers de teste podem especificar manualmente as ações de teste disponíveis para um componente personalizado escrevendo um objeto JavaScript personalizado e atribuindo o componente A. classe sn-atf atributo. Defina o valor do atributo como o nome do objeto JavaScript que contém as ações de teste do componente. Os componentes personalizados testáveis devem ser clicáveis ou configuráveis, e essa classificação determina as funções e propriedades necessárias para o objeto JavaScript. Consulte Etapas de teste de IU personalizadapara requisitos de componente de página testável.

    Procedimento

    1. Abra a página de IU personalizada que você deseja testar.
    2. Adicione o. classe sn-atf Atributo ao elemento que está sendo testado e defina o valor como o nome do objeto JavaScript incorporado na página que manipula as funções getValue(), setValue(), click() ou isDisabled().
      <div sn-atf-class="MyClickableComponent">
          <label for="a_clickable_checkbox">MyClickableComponent</label>
          <input type="checkbox" id="a_clickable_checkbox" checked="true"/>
      </div>
    3. Crie o objeto JavaScript especificado em classe sn-atf e adicione as funções e o atributo necessários para identificar seu componente de página personalizada como um componente de página clicável ou configurável.
      Tabela 3. Funções de componente clicáveis
      Nome da função Descrição
      inicializar() Obtém os valores iniciais do componente. Inserir:
      $super(element, area)
      clique() Seleciona o componente. Retorna um objeto JSON com estas propriedades:

      sucesso : verdadeiro se o componente puder ser clicado.

      Nota:
      Aciona o mecanismo de espera inteligente da etapa de teste de IU.
      getValue() Obtém o valor do elemento. Retorna um objeto JSON com estas propriedades:
      • sucesso : verdadeiro se o valor for recuperado.
      • resultado : o valor do componente.
      IsDesabilitado() Se o componente está desabilitado. Retorna um objeto JSON com estas propriedades:
      • sucesso : verdadeiro se o componente estiver desabilitado.
      • resultado : verdadeiro se o componente estiver desabilitado.
      Tabela 4. Funções de componente configuráveis
      Nome da função Descrição
      inicializar() Obtém os valores iniciais do componente. Inserir:
      $super(element, area)
      Valor(novoValor) Define o valor do componente. Veja o segundo exemplo abaixo. Retorna um objeto JSON com estas propriedades:

      sucesso : verdadeiro se o valor estiver definido.

      Nota:
      Aciona o mecanismo de espera inteligente da etapa de teste de IU.
      getValue() Obtém o valor do elemento. Retorna um objeto JSON com estas propriedades:
      • sucesso : verdadeiro se o valor for recuperado.
      • resultado : o valor do componente.
      IsDesabilitado() Se o componente está desabilitado. Retorna um objeto JSON com estas propriedades:
      • sucesso : verdadeiro se o componente estiver desabilitado.
      • resultado : verdadeiro se o componente estiver desabilitado.
      Tabela 5. Atributo de componente configurável
      Nome de atributo Descrição
      IsSettable: Verdadeiro Identifica o componente como um componente de página configurável.
    4. Ao criar seu componente personalizado no Jelly, adicione <g2:atf_only> Marcadores ao redor do objeto JavaScript especificado no classe sn-atf atributo.
      Essas tags garantem que o sistema execute o objeto JavaScript somente durante o teste automatizado.

    Exemplo

    //A custom clickable component
    
    <form>
         <div sn-atf-class="MyClickableComponent">
             <label for="a_clickable_checkbox">MyClickableComponent</label>
             <input type="checkbox" id="a_clickable_checkbox" checked="true"/>
         </div>
    </form>
    <script>
    var MyClickableComponent = {
    
        // The constructor must have this signature, but you can perform additional setup after the $super(element, area) call
        initialize: function($super, element, area) {
            $super(element, area);
        },
    
        click: function() {
            document.getElementById('a_clickable_checkbox').click();
            return {success: true};
        },
    
        // The function returns an object with a result attribute of type String
        getValue: function() {
            var isChecked = document.getElementById('a_clickable_checkbox').checked ? "true" : "false";
            return {success: true, result: isChecked};
        },
    
        // The function returns an object with a result attribute of type Boolean
        isDisabled: function() {
            if (document.getElementById('a_clickable_checkbox').disabled)
                return {success: true, result: true};
    
            return {success: true, result: false};
        },
    
    };
    </script>
    //A custom settable component
    
    <form>
        <div sn-atf-class="MySettableComponent">
            <label for="a_settable_checkbox">MySettableComponent</label>
            <input type="checkbox" id="a_settable_checkbox" checked="true"/>
        </div>
    </form>
    <script>
    var MySettableComponent = {
    
        // This attribute is required for settable components
        isSettable: true,
    
        // The constructor must have this signature, but you can perform additional setup after the $super(element, area) call
        initialize: function($super, element, area) {
            $super(element, area);
        },
    
        // The value parameter is a string
        setValue: function(value) {
            document.getElementById('a_settable_checkbox').checked = (value == "true");
            return {success: true};
        },
    
        // The function returns an object with a result attribute of type String
        getValue: function() {
            var isChecked = document.getElementById('a_settable_checkbox').checked ? "true" : "false";
            return {success: true, result: isChecked};
        },
    
        // The function returns an object with a result attribute of type Boolean
        isDisabled: function() {
            if (document.getElementById('a_settable_checkbox').disabled)
                return {success: true, result: true};
    
            return {success: true, result: false};
        },
    
    };
    </script>

    Seletor de referência e registro

    Use etapas de IU personalizadas para manipular os valores do sn-reference-picker e. seletor de registro sn diretivas angular. O valor em um seletor de referência retorna o. sys_id do registro escolhido. O valor em um seletor de registro retorna o campo Valor escolhido para esse seletor de registro. Ambos os elementos podem ser definidos selecionando um registro para definir como seu valor.