Ações de automação do SAP

As ações de automação sap fornecem um conjunto de ferramentas para ajudar a simplificar e automatizar seus fluxos de trabalho sap. Usando essas ações, você pode iniciar facilmente o aplicativo SAP GUI, criar novas sessões, selecionar itens de menu, iniciar e encerrar transações e muito mais.

Com as ações do grupo de automação do SAP, você pode interagir facilmente com os elementos da interface do usuário do SAP clicando neles, preenchendo campos de texto e extraindo seus dados. Basta inserir o valor do atributo da ID do elemento da interface do usuário do SAP. Se você não souber o valor da ID, poderá usar o seletor de elementos da interface do usuário do Power Automate para desktop para capturar o elemento SAP necessário e recuperar o valor da ID. Quando você captura um elemento de interface do usuário do SAP dessa maneira, apenas o valor de ID do elemento é recuperado e nenhum elemento de interface do usuário é adicionado ao repositório de elementos de interface do usuário do fluxo da área de trabalho.

Nossas ações de automação do SAP também podem ser perfeitamente integradas a outras ações disponíveis no Power Automate para desktop, incluindo o grupo de ações de automação da interface do usuário. Esse grupo de ações permite capturar todos os elementos da interface do usuário da GUI do SAP e adicioná-los ao repositório de elementos da interface do usuário do fluxo da área de trabalho. Ao combinar nossas ações de automação da GUI do SAP com o grupo de ações de automação da interface do usuário, você pode criar fluxos de trabalho RPA avançados que automatizam até mesmo os processos SAP mais complexos.

Observação

O Power Automate para desktop suporta automação com A GUI do SAP versão 750 ou posterior.

Limitações conhecidas

SAP Web UIs

Ações de interface do usuário ou automação da Web ou ações sap não funcionam em formulários SAP abertos no navegador inserido do SAP (Web Dynpro). Uma solução alternativa para essa limitação é tentar abrir essa página diretamente em um navegador autônomo e automatizá-la usando ações de Automação da Web.

Iniciar o SAP

Abra o aplicativo da GUI do SAP e conecte-se a um sistema SAP.

Você tem duas opções de modo de conexão:

  • Use o nome SAP ou o endereço IP na descrição do servidor. Para usar essa opção, você precisa das credenciais de logon e das permissões de acesso necessárias. A descrição do servidor é um nome ou descrição legível do sistema SAP.
  • Use o servidor cadeia de conexão. O servidor cadeia de conexão normalmente inclui o nome do servidor ou o endereço IP, o número da instância e a ID do sistema. A cadeia de conexão do servidor é um formato específico para identificar e conectar-se a um sistema SAP.

Você tem várias opções de logon:

  • Encerre este logon: essa opção encerra o logon da ação específica.
  • Continue esse logon e encerre qualquer outro logons: essa opção substitui a instância sap existente pelo logon específico.
  • Continue esse logon sem encerrar outros logons no sistema: essa opção cria uma nova sessão SAP.

Observação

A GUI do SAP não permite mais de seis conexões ativas (sessões) com um sistema SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Modo de conexão N/A Descrição do servidor e cadeia de conexão do servidor Descrição do servidor Especifique como se conectar ao servidor da GUI do SAP.
Modo de logon N/A Logon manual e logon único (SSO) Logon manual Especifique como fazer logon no servidor da GUI do SAP, entre manualmente no servidor inserindo seu nome de usuário e sua senha ou usando o logon único (SSO).
Descrição do servidor Sim Valor do texto Especifica o nome do sistema SAP ou o endereço IP da conexão.
string de conexão Sim Valor do texto Especifica a cadeia de conexão para o servidor GUI do SAP. A cadeia de conexão é um identificador exclusivo que especifica o nome do servidor, o número do sistema e outros detalhes da conexão.
Cliente Não Valor do texto Especifica o número do cliente SAP para conexão.
Username Não Valor do texto Especifica o ID do usuário SAP para logon.
Password Sim Valor do texto Especifica a senha do usuário SAP para logon.
Linguagem Não Valor do texto Especifica o idioma de logon do SAP para a interface do usuário.
Várias opções de logon Não Encerre este logon, continue este logon e encerre quaisquer outros logons, Continue este logon sem encerrar nenhum outro logon no sistema Terminar este logon Várias opções de logon especificam como o sistema SAP se comporta quando o usuário tenta fazer logon quando já está conectado.

Variáveis produzidas

Argumento Tipo Description
SAPInstance Instância do SAP A instância do SAP a ser usada com ações de automação SAP. A instância SAP refere-se à janela SAP específica.
CurrentSAPLoginTerminated Valor booliano Se o logon SAP que está sendo executado com a ação específica foi terminado ou não.
OtherSAPLoginTerminated Valor booliano Se os outros logons do SAP foram terminados ou não.

Exceções

Exceção Description
A ação de logon da GUI do SAP falha Indica um problema ao entrar em um sistema GUI do SAP.

Attach

Anexe o aplicativo SAP GUI em execução a uma instância SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Modo Anexar Não Primeiro plano ou último ativado, título da janela Título da janela Especifica o modo para vincular a instância SAP a uma janela. Se você selecionar a opção Primeiro Plano ou última ativada, a instância sap será anexada à sessão SAP em primeiro plano. Se não houver nenhuma sessão SAP em primeiro plano, ela será anexada à última sessão SAP que você iniciou e ainda não foi fechada.
Título da janela Sim Texto Especifica o título da janela SAP à qual a instância está vinculada. Você pode selecionar o título da janela na lista suspensa de sessões SAP existentes ou inseri-lo manualmente.

Variáveis produzidas

Argumento Tipo Description
SAPInstance Instância do SAP A instância do SAP a ser usada com ações de automação SAP. A instância SAP refere-se à janela SAP específica.

Exceções

Exceção Description
Anexar a erro do SAP Indica um problema ao vincular a uma instância SAP.

Criar sessão SAP

Cria uma sessão SAP com base na mesma instância SAP.

Observação

A GUI do SAP não permite mais de seis conexões ativas (sessões) com um sistema SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.

Variáveis produzidas

Argumento Tipo Description
SAPInstance Instância do SAP A instância do SAP a ser usada com ações de automação SAP. A instância SAP refere-se à janela SAP específica.

Exceções

Exceção Description
Falha ao criar nova ação de sessão SAP Indica um problema ao criar uma nova sessão do SAP.

Selecionar o item de navegação do SAP

Selecione um item de menu do SAP na barra de ferramentas do aplicativo da janela da SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
Nome do item de navegação Não Valor do texto O nome do item na barra de ferramentas de navegação a ser selecionado, como 'Sistema'. Você também pode especificar uma opção em um submenu usando o símbolo '>' para indicar a relação pai-filho. Por exemplo, 'Programa > Executar' significa que foi selecionada a opção 'Executar', que faz parte do submenu em 'Programa'.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Erro de item da barra de ferramentas de navegação selecionado pelo SAP GUI Indica um problema ao selecionar um item da barra de ferramentas de navegação.

Selecionar item de menu do SAP

Selecione um item de menu SAP na barra de ferramentas da janela. Insira manualmente o nome do item no respectivo parâmetro de entrada, no mesmo idioma em que a tela da GUI do SAP está sendo exibida.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
Nome do item de menu Não Valor do texto O nome do item de menu na barra de ferramentas a ser selecionada, como 'Salvar'. Insira o nome do item de menu como ele é exibido na instalação do SAP do computador.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
A ação de seleção do item de menu do SAP falha Indica um problema ao selecionar um item de menu.

Encerrar conexão de SAP

Fecha a conexão SAP para a instância sap selecionada. Ao fechar a conexão, você encerra todas as instâncias relacionadas a essa conexão específica.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
A ação de fechar sessão do SAP falha Indica um problema ao fechar uma sessão do SAP.

Iniciar transação SAP

Abre um código de transação específico em uma sessão existente.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
Código da transação Não Valor do texto O código de transação que você deseja executar.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Falha ao iniciar ação de transação do SAP Indica um problema ao iniciar uma transação do SAP.

Encerrar transação SAP

Fecha a transação do SAP em uma instância SAP específica e retorna ao menu de acesso fácil do SAP. Você deve iniciar uma transação SAP antes para a sessão SAP específica.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Falha ao encerrar a ação de transação do SAP Indica um problema ao finalizar uma transação do SAP.

Clique no elemento da interface do usuário do SAP

Interage por meio da ação de clique em qualquer elemento da interface do usuário de uma janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
Tipo de elemento Não Elemento SAP básico, caixa de seleção, rótulo, lista suspensa, elemento grade Elemento do SAP básico Selecione o tipo de elemento SAP com o qual você deseja interagir. A opção "Clique no elemento SAP" executa uma ação de clique em qualquer elemento SAP, como botões, botões de opção, guias, campos de texto ou árvores.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Use o botão a seguir para indicar o elemento sap UI na tela SAP ou inserir o valor manualmente.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Use o botão a seguir para indicar o elemento sap UI na tela SAP ou inserir o valor manualmente.
Definir o estado da caixa de seleção do SAP como Sim Marcada, Desmarcada Marcados Especifique se a caixa de seleção fica marcada ou desmarcada.
Operação de rótulo do SAP Sim Expandir, Recolher, Escolher Expandir Especifique se deseja expandir ou recolher o rótulo do SAP.
Valor de opção suspensa Sim Valor do texto Especificar se a opção suspensa está selecionada.
Elemento da grade do SAP Sim Célula, Linha, Cabeçalho, Lista, Botão, Botão da Barra de Ferramentas, Caixa de Seleção, Botão de Opção Célula Selecione o tipo de elemento da grade SAP com o qual você deseja interagir.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Clique em erro de Elemento da GUI do SAP Indica falha no clique.

Obter detalhes do elemento da interface do usuário do SAP

Obtém o valor do atributo de um elemento da interface do usuário do SAP em uma janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Use o botão a seguir para indicar o elemento sap UI na tela SAP ou inserir o valor manualmente.
Nome do atributo Não Valor do texto Próprio texto O atributo cujo valor é recuperado.

Variáveis produzidas

Argumento Tipo Description
AttributeValue Valor do texto O valor do atributo do elemento da interface do usuário do SAP.

Exceções

Exceção Description
Erro ao obter detalhes do elemento do SAP Indica um problema ao recuperar o atributo do elemento de interface do usuário.

Preencher campo de texto do SAP no elemento

Preenche uma caixa de texto em uma janela SAP com o texto especificado.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
SAPInstance Não Instância do SAP Selecione a variável que mantém a instância SAP na qual você deseja trabalhar. Defina essa variável em uma ação de login anterior do SAP.
ID do elemento do SAP Não Numérico A ID do elemento SAP. Esse parâmetro determina o elemento da interface do usuário no SAP com o qual a ação interage. Use o botão a seguir para indicar o elemento de interface do usuário sap na tela SAP ou inserir o valor manualmente.
Texto para preencher Não Entrada direta criptografada ou Valor do texto O texto que preencherá o campo de texto do SAP
Se o campo não estiver em branco Sim Substituir texto, acrescentar texto Substituir texto Especifique se o conteúdo existente deve ser substituído ou acrescentado.

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Erro ao Preencher Valor do Campo de Texto do SAP Indica um problema ao preencher o campo de texto do SAP especificado.
  • Last updated on