Elementos do SAP Tingui compatíveis

As interfaces do SAP contêm uma série de controles específicos com os quais é possível interagir, conforme exemplificado nesta página.

Botões do SAP

Representa qualquer botão encontrado nas janelas do SAP WinGUI. Há vários tipos, cada qual definido por um elemento específico:

Ícones

Os ícones são botões interativos que não exibem rótulos de texto.

Botões de pressão

Um botão de pressão é um elemento de interface gráfica simples, que dá acesso direto a um comando no aplicativo.

Botões de rádio

Os botões de rádio apresentam um conjunto de opções. Há pelo menos dois botões de rádio em uma lista e você pode selecionar somente um.

Você pode usar a atividade Click para interagir com botões.

Agenda do SAP

A Agenda do SAP permite selecionar datas ou períodos individuais.

Você pode usar a atividade Select Dates in Calendar para interagir com o calendário SAP.

Observação: esse controle SAP não é suportado pela gravação no Studio.

Caixa de seleção do SAP

Os elementos de caixa de seleção representam uma lista de várias escolhas. É possível selecionar uma, mais ou nenhuma das opções.

Você pode usar a atividade Click para interagir com caixas de seleção.

Menu de contexto do SAP

Representa uma lista de itens dentro de um menu de contexto. Observe que vários menus de contexto child podem estar disponíveis em um menu de contexto parent.

Você pode usar a atividade Click para interagir com o menu de contexto de SAP.A estrutura de detecção de elementos AA é necessária para a seleção interativa.

Caixa de diálogo do SAP

Representa uma janela externa que pode conter tipos diferentes de outros controles do SAP como botões, mensagens de texto ou janelas pop-up.

Os seletores dentro de uma caixa de diálogo são gerados de acordo com o elemento que representam.

Se você deseja fechar uma caixa de diálogo usando o botão Fechar, é necessário usar a estrutura de deteção do elemento AA.

Você pode usar atividades UIAutomation como Click ou Type Into para interagir com as caixas de diálogo.

Listas suspensas do SAP

As listas suspensas permitem selecionar itens de listas predefinidas.

Você pode usar a atividade Select Item para interagir com itens de lista.

Conteúdo HTML do SAP

Os controles HTML são usados para exibir conteúdo HTML dentro do SAP WinGUI.

Para interagir com uma página HTML dentro do SAP WinGUI, você precisa usar o framework de detecção de elemento AA. As atividadesUIAutomation podem ser usadas para criar processos para conteúdo HTML SAP.

Campo de entrada do SAP

Representa um campo especializado que aceita entradas do usuário.

Você pode usar a atividade Type Into para interagir com campos de entrada.

SAP Logon

SAP Logon é um programa instalado localmente que você usa para fazer logon diretamente em um sistema SAP.

Você pode usar a atividade SAP Logon para abrir o SAP.

Esta atividade requer dois parâmetros:

• O nome exato da conexão SAP, exibido na janela do SAP Logon ou do SAP Logon Pad usado para fazer logon no sistema SAP.

• O caminho para o programa SAP Logon ou SAP Logon Pad. O caminho padrão é obtido da entrada do registro do sistema correspondente.

  
  

  

  
  
  Observação: a função Indicar na tela não é necessária. A interface de script do SAP é usada para se conectar ao seu sistema SAP.

SAP Login

Oferece a possibilidade de fazer logon em um sistema SAP.

Você pode usar a atividade SAP Login.

A lista suspensa Várias Opções de Logon possibilita que você decida qual ação deve ser realizada se um usuário tentar fazer logon no sistema várias vezes e as informações de licença de várias janelas pop-ups de logon são exibidas. Você pode selecionar dentre as seguintes opções:

• Continuar com este logon e finalizar quaisquer outros logons no sistema
• Continuar com este logon, sem encerrar nenhum outro logon no sistema
• Finalizar este logon

Menu do SAP

Permite que você selecione itens do Menu do SAP. O Menu do SAP somente fica disponível na janela principal do SAP WinGUI.

Você pode usar a atividade SAP Select Menu Item para interagir com um item de menu.

Observação: esse controle SAP não é suportado pela gravação no Studio.

Imagem do SAP

Exibe uma imagem no SAP WinGUI.

Você pode usar a atividade SAP Click Picture on Screen para clicar em uma imagem específica.

Observação: esse controle SAP não é suportado pela gravação no Studio.

Barra de Status do SAP

Representa uma seção, na parte de baixo da janela do SAP WinGUI que exibe mensagens. Ela não mostra informações do sistema e sobre o logon.

Você pode usar a atividade SAP Read Statusbar para extrair o tipo de mensagem, texto e dados de uma barra de status SAP.

Observação: esse controle SAP não é suportado pela gravação no Studio.

Informações de sessão do SAP

Exibe informações detalhadas sobre a sessão atual do SAP, como o Sistema, Cliente, Usuário conectado ou programa aberto no momento e transação.

Os seguintes atributos seletores opcionais estão disponíveis no UIExplorer e podem ser usados com outras atividades, como Get Attribute ao criar sua automação SAP:

sapClient, sapLanguage, sapProgram, sapScreen, sapSession,sapSysName, sapSysNumber, sapSysSessionId, sapTransaction, sapUser

Guia do SAP

A Guia do SAP representa um conjunto de botões permitem acessar informações e controles específicos.

Você pode usar a atividade CLick para selecionar uma única guia por vez ou você pode usar a atividade Select Item para escolher a guia de interesse de uma lista.

Caso de automação especial

Algumas transações de SAP têm a barra / em seus nomes, o que pode levar a problemas de identificação enquanto estiver usando um curinga no seletor.

Por exemplo, na Transação de SAP: /COCKPIT/1, o seletor para uma das Guias SAP dentro da transação pode ser:

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

A parte dinâmica do seletor é: SAPLDISPLAY46:0389, onde o número 0039 está mudando dinamicamente e não permite uma identificação estável.

A estrutura do seletor é:

Para fins de identificação estável, você precisaria usar o curinga entre os separadores de hierarquia e, em seguida, todas (e apenas) as barras entre aqueles separadores/barras precisam ser substituídas por ?

Antes de <sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

Após <sap id='usr/subSUB_MAIN:?COCKPIT?SAPLDISPLAY46:038*/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

Tabelas do SAP

A Tabela do SAP representa um conjunto padrão de controles para os elementos exibidos em uma estrutura tabular.

Operações Comuns

No SAP, existem vários tipos de tabelas disponíveis. As mais comumente usadas são as tabelas Padrão (padrão), Tabelas de Grade e tabelas ALV. Com o Studio, é possível automatizar todo tipo de Tabela do SAP.

Você pode usar as seguintes atividades para interagir com as Tabelas do SAP e seu respectivo conteúdo:

• Click
• Get Text
• Type Into
• Marcar

Tabela Padrão do SAP

A Tabela Padrão do SAP é compatível com todas as operações comuns que estão disponíveis, conforme mencionado acima.

Tabela da Grade do SAP

A Tabela de Grade do SAP é compatível com todas as operações comuns que estão disponíveis, conforme mencionado acima, e também com as operações de Selecionar/Desmarcar e Extração de Dados.

Selecionar/Desmarcar

Com ajuda da atividade Click ou da atividade Check você é capaz de realizar todas as operações necessárias durante o seu projeto de automação SAP, como:

• Coluna Selecionar/Desmarcar
• Linha Selecionar/Desmarcar
• Selecionar/Desmarcar Todos
  
  

  

  
  

Filtragem de células de tabela

Você pode realizar todas as operações comuns, conforme mencionado acima, em uma célula da tabela.

Usando a atividade Table Cell Scope, você também pode filtrar o conteúdo das células da tabela (para colunas e linhas). Você pode identificar colunas em uma tabela SAP por seu nome de exibição, mas também por outros atributos, como ColumnName. Além disso, você pode filtrar colunas e linhas para usar qualquer outra propriedade para identificar elementos.

Caso a dica de ferramenta de coluna tenha um nome semelhante a outra coluna, alteramos automaticamente a identificação dessa coluna para um atributo diferente, ColumnNamecomo , conforme visto no exemplo abaixo.

Você também pode utilizar a filtragem avançada no Número da linha, que permite a identificação com base em múltiplos atributos, como pode ser visto no exemplo abaixo.

Extração de Dados

Extração de dados permite extrair dados estruturados das Tabelas SAP, conforme exemplificado abaixo.

Se você estiver automatizando uma tabela com várias colunas que têm o mesmo nome, o mecanismo de coleta incrementará os nomes de coluna automaticamente, (por ex., column1, column2, column3 etc.).

A atividade Extract Structure Data fornece possibilidades adicionais ao extrair dados da tabela SAP GridView.Você pode usar os seguintes valores para o parâmetro columns_name_source para definir a forma como você deseja obter as informações da tabela:

• Mais longo — O nome completo da coluna é extraído e usado.
• Mais curto — O nome reduzido da coluna é extraído e usado.
• Exibido — O nome visível/exibido no SAP WinGUI é usado.
• Técnico — O nome técnico do cabeçalho da coluna é extraído e usado.
• Dica de ferramenta — o nome da dica de ferramenta que é exibido ao se passar o mouse sobre um nome de coluna.
  
  

  

  
  

Tabela ALV do SAP

A Tabela ALV do SAP suporta todas as operações comuns que estão disponíveis, conforme mencionado acima, e também com a Extração de Dados para tabelas de cabeçalhos simples e múltiplas, e Extração de Tela. Uma ou várias tabelas ALV na tela do SAP podem ser extraídas.

Extração de Dados

Isso funciona exatamente da mesma maneira mencionada acima sobre a Extração de Dados para as Tabelas de Grade do SAP. Preste atenção que, em alguns casos, o nome da dica de ferramenta da coluna pode ser diferente do nome de exibição nas Tabelas ALV do SAP.

Use o parâmetro columns_name_source='Tooltip' para definir a maneira correta para se obter as informações da tabela.

Várias tabelas de cabeçalho

O Studio pode extrair os dados adequados de tabelas que têm cabeçalhos espalhados em duas ou mais linhas.

Para fazer isso, os metadados apresentam o seguinte:

join_type = ['LeftOuter' | 'Inner']

Essas opções correspondem aos joins do SQL com os respectivos nomes. O left outer join também extrai linhas para as quais apenas o primeiro cabeçalho está presente. Os outros valores de coluna que faltam são preenchidos com um texto de espaço reservado NULL: null_value_text = ['(null)' | 'any other user provided value']

A junção interna extrai apenas as linhas com dados completos, ignorando aquelas sem dados para todos os cabeçalhos.

Extrair da Tela

Se decidir usar a Extração de Tela, recomendamos utilizar o método de coleta FullText e assinalar a caixa de seleção Ignorar Ocultos. Observe que apenas o texto visível na tela do SAP é extraído usando esse método.

Para saber mais sobre Extração de Telas, acesse esta página.

ColorIndex

Os atributos ColorIndex, ColorIntensified e ColorInverse permitem que você identifique a cor de segundo plano dos elementos.

Isso pode ser usado em cenários de automação de processos com robôs e automação de testes.

Nome do atributo	Tipo de Objeto
ColorIndex	int32
ColorIntensified	boolean
ColorInverse	boolean

Tabela hierárquica do SAP ALV

A tabela hierárquica do SAP ALV representa uma lista de elementos organizados em uma tabela com estrutura hierárquica.

Você pode usar a atividade Expand ALV Hierarchical Table para identificar qualquer célula dentro da tabela hierárquica do SAP ALV. Após a identificação da célula, é possível realizar todas as atividades típicas de interface gráfica, como Click, Get Text e outras.

Há duas formas de trabalhar com a atividade: no tempo do design ou no tempo de execução.

Período de design

Durante o tempo do design, você tem que selecionar qualquer célula de interesse dentro da tabela. A atividade captura as coordenadas dessa célula na atividade. As alterações são possíveis a qualquer momento.

Runtime

A célula de destino é definida no foco, e o UiElement correspondente é retornado como um argumento de saída.

Navegue dentro da tabela

Por exemplo, quero obter informações sobre o tempo do voo (6:01) para uma companhia aérea específica (AA) e para um número de voo específico (17).

A coluna Nível/Focalizado: define qual elemento é definido como focalizado.

A coluna Nível 0/Cabeçalho: define qual coluna e valor encontrar na coluna do cabeçalho.

A coluna Nível 1/Posição: define qual coluna e valor encontrar na coluna da posição.

As coordenadas da célula que contém 6:01 são armazenadas como valor de saída, tipo de variável UiElement.

Lista em árvore ALV do SAP

A Árvore ALV do SAP representa uma lista de elementos organizados em uma estrutura de árvore.

Você pode usar a atividade Expand ALV Tree para selecionar um nó ALV e exibir o caminho do nó na atividade. Isso permite que você use qualquer outra atividade compatível para que funcione com o elemento especificado.

Textedit do SAP

O Controle de Textedit do SAP representa um campo /editor de texto editável.

Você pode usar as seguintes atividades para interagir com esse controle:

• A atividade Type Into para campos de texto.
• A atividade Send Hotkey para botões que suportam teclas de atalho ou a atividade Click Image para botões.

Barra de Ferramentas do SAP

A barra de ferramentas do SAP representa um conjunto de botões com os quais você pode interagir. No SAP, há vários tipos de barras de ferramentas, dependendo da Transação do SAP ou Programa do SAP.

• Barra de Ferramentas do Sistema SAP (1)
• Barra de Ferramentas do Aplicativo do SAP (2)
• Barra de Ferramentas Especial do SAP (3)
• Barra de Ferramentas do SAP GridTable (4)
• Serviços de Objeto Genéricos do SAP (5)

Você pode usar a atividade Click Toolbar Button para interagir com botões dentro das barras de ferramentas.

Observação: esse controle SAP não é suportado pela gravação no Studio.

Código de Transação do SAP

Representa um código alfanumérico que permite acessar as funções do SAP ou executar os programas do SAP.

Apenas o código da transação é necessário quando você usa a atividade SAP Call Transaction.

O código da transação é executado na janela atual do SAP GUI.

Observação:

Ao fornecer um código de transação (por exemplo VA01), a atividade envia o comando /nVA01 + Enter (keystroke) para chamar uma transação.

Observe que as alterações que não forem salvas na transação atual serão descartadas sem aviso.

Árvore do SAP

A Árvore do SAP representa uma lista de elementos organizados em uma estrutura de árvore. Vários tipos de controles de Árvore do SAP estão disponíveis:

• Árvore Simples

  
  

  

  
  

• Árvore em Lista

  
  

  

  
  

• Árvore de Coluna

  
  

  

  
  

Você pode usar a atividade Click ou Get Text para interagir com um nó ou item em qualquer um dos tipos de controle SAP Tree.

Observação: ao interagir com as árvores do SAP, recomendamos o uso da propriedade SimularClique.

Expand Tree

Se a árvore contiver um grande número de elementos child, a seleção é realizada da seguinte maneira:

1. Expanda a árvore no SAP WinGUI e selecione o elemento de interesse.
2. Utilize a opção Indicar na tela para selecionar a Árvore do SAP inteira.

Os nós do item selecionado são exibidos na atividade.

Observação: esse controle SAP não é suportado pela gravação no Studio.

Se a árvore estiver recolhida e o nó ou item de interesse não estiver visível, você precisará usar a atividade SAP Expand Tree, que expande a árvore pai para um nó ativo ou um item ativo.