Ações de automatização do SAP

As ações de automação SAP fornecem um conjunto de ferramentas para ajudar a simplificar e automatizar os seus fluxos de trabalho SAP. Ao usar estas ações, pode facilmente iniciar a aplicação SAP GUI, criar novas sessões, selecionar itens do menu, iniciar e terminar transações, e muito mais.

Com as ações do grupo de automatização do SAP, pode interagir facilmente com elementos da IU do SAP clicando nos mesmos, preenchendo campos de texto e extraindo os respetivos dados. Basta introduzir o valor do atributo do ID do elemento da IU do SAP. Se não souber o valor do ID, pode utilizar o seletor de elementos da IU do Power Automate para computadores para capturar o elemento do SAP necessário e obter o respetivo valor do ID. Quando captura um elemento da IU do SAP deste modo, apenas o valor do ID do elemento é recuperado e nenhum elemento da IU é adicionado ao repositório de elementos da IU do fluxo de ambiente de trabalho.

As nossas ações de automatização do SAP também podem ser perfeitamente integradas com outras ações disponíveis no Power Automate para computadores, incluindo o grupo de ações de automatização da IU. Este grupo de ações permite-lhe capturar todos os elementos da IU do SAP GUI e adicioná-los ao repositório de elementos da IU do fluxo de ambiente de trabalho. Ao combinar as nossas ações de automatização do SAP GUI com o grupo de ações de automatização da IU, pode criar fluxos de trabalho de RPA avançados que automatizam até os processos do SAP mais complexos.

Nota

Power Automate para ambiente de trabalho suporta automatização com SAP GUI versão 750 ou posterior.

Limitações conhecidas

Interfaces Web SAP

As ações de UI, Automação Web ou SAP não funcionam em formulários SAP que abrem no navegador embutido do SAP (Web Dynpro). Uma solução para essa limitação é tentar abrir essa página diretamente num navegador autónomo e automatizá-la usando ações de Automação Web.

Iniciar o SAP

Abra a aplicação SAP GUI e ligue-se a um sistema SAP.

Tens duas opções de modo de ligação:

  • Use o nome SAP ou o endereço IP na descrição do servidor. Para usar esta opção, precisa das credenciais de login e permissões de acesso necessárias. A descrição do servidor é um nome legível por humanos ou uma descrição do sistema SAP.
  • Usa a string de cadeia de ligação do servidor. A cadeia de ligação do servidor inclui tipicamente o nome ou endereço IP do servidor, o número da instância e o ID do sistema. A cadeia de ligação do servidor é um formato específico para identificação e ligação a um sistema SAP.

Tem várias opções de login:

  • Terminar este logon: Esta opção termina o logon da ação específica.
  • Continue este login e termine quaisquer outros logons: Esta opção substitui a instância SAP existente pelo login específico.
  • Continue este login sem terminar nenhum outro logon no sistema: Esta opção cria uma nova sessão SAP.

Nota

O SAP GUI não permite mais de seis ligações ativas (sessões) a um sistema SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Modo de ligação N/A Descrição do servidor e cadeia de ligação do servidor Descrição do servidor Especificar como estabelecer ligação ao servidor da GUI do SAP.
Modo de início de sessão N/A Início de sessão manual e início de sessão único (SSO) Início de sessão manual Especifique como iniciar sessão no servidor SAP GUI. Inicie sessão no servidor manualmente através da introdução do nome de utilizador e da palavra-passe ou utilize o início de sessão único (SSO).
Descrição do servidor Sim Valor de texto Especifica o nome do sistema do SAP ou o endereço IP para ligação.
Cadeia de ligação Sim Valor de texto Especifica a cadeia de ligação para o servidor SAP GUI. A cadeia de ligação é um identificador exclusivo que especifica o nome do servidor, o número do sistema e outros detalhes da ligação.
Cliente Não Valor de texto Especifica o número do cliente SAP para ligação.
Username Não Valor de texto Especifica o ID de utilizador SAP para início de sessão.
Password Sim Valor de texto Especifica a palavra-passe de utilizador SAP para início de sessão.
Linguagem Não Valor de texto Especifica o idioma de início de sessão SAP para a interface de utilizador.
Opções de início de sessão múltiplo Não Termine este início de sessão, continue este início de sessão e termine quaisquer outros inícios de sessão, Continue este início de sessão sem terminar nenhum outro início de sessão no sistema Terminar este início de sessão Várias opções de início de sessão especificam como o sistema SAP se comporta quando o utilizador tenta iniciar sessão quando a sessão já está iniciada.

Variáveis produzidas

Argumento Tipo Descrição
SAPInstance Instância do SAP A instância SAP a utilizar com ações de automatização SAP. A instância SAP refere-se à janela SAP específica.
CurrentSAPLoginTerminated Valor booleano Indica se o início de sessão no SAP que está a ser efetuado com a ação específica foi terminado ou não.
OtherSAPLoginTerminated Valor booleano Indica se outras sessões iniciadas no SAP são terminadas ou não.

Exceções

Exceção Descrição
Falha na ação de início de sessão do SAP GUI Indica um problema no início de sessão a um sistema SAP GUI.

Attach

Anexar a aplicação SAP GUI em execução a uma instância do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Modo de anexação Não Primeiro plano ou última ativação, Título da janela Título da janela Especifica o modo para anexar a instância do SAP a uma janela. Se selecionares a opção Primeiro Plano ou última opção ativada, a instância SAP liga-se à sessão SAP no primeiro plano. Se não houver nenhuma sessão SAP em primeiro plano, liga-se à última sessão SAP que iniciaste e ainda não está encerrada.
Título da janela Sim Texto Especifica o título da janela SAP à qual a instância está anexada. Pode selecionar o título da janela na lista suspensa de sessões SAP existentes ou introduzi-lo manualmente.

Variáveis produzidas

Argumento Tipo Descrição
SAPInstance Instância do SAP A instância SAP a utilizar com ações de automatização SAP. A instância SAP refere-se à janela SAP específica.

Exceções

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

Criar nova sessão do SAP

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

Nota

O SAP GUI não permite mais de seis ligações ativas (sessões) a um sistema SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.

Variáveis produzidas

Argumento Tipo Descrição
SAPInstance Instância do SAP A instância SAP a utilizar com ações de automatização SAP. A instância SAP refere-se à janela SAP específica.

Exceções

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

Selecionar item de navegação do SAP

Selecionar um item de menu do SAP na barra de ferramentas da aplicação da janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.
Nome do item de navegação Não Valor de texto O nome do item na barra de ferramentas de navegação a selecionar, tal como "Sistema". Também pode especificar uma opção num submenu usando o símbolo '>' para indicar a relação principal-subordinado. Por exemplo, 'Programar > Executar' significa que a opção 'Executar', que faz parte do submenu em 'Programa', está selecionada.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
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 do SAP na barra de ferramentas da janela. Introduza o nome do item no respetivo parâmetro de entrada manualmente, no mesmo idioma em que o ecrã SAP GUI está a ser apresentado.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.
Nome do item de menu Não Valor de texto O nome do item do menu na barra de ferramentas a selecionar, como 'Guardar'. Insira o nome do item do menu tal como aparece na instalação SAP da máquina.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha na ação de Selecionar item de menu SAP Indica um problema ao selecionar um item de menu.

Fechar ligação SAP

Fecha a ligação SAP para a instância SAP selecionada. Quando fecha a ligação, termina todas as instâncias relacionadas com essa ligação específica.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha na ação Fechar sessão SAP Indica um problema ao fechar uma sessão do SAP.

Iniciar transação do SAP

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.
Código da transação Não Valor de texto O código da transação que queres executar.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha na ação Iniciar transação SAP Indica um problema ao iniciar uma transação do SAP.

Terminar transação do SAP

Fecha a transação do SAP numa instância SAP específica e volta ao menu acesso fácil do SAP. Deve iniciar uma transação SAP antes da sessão específica do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha na ação Terminar transação SAP Indica um problema ao terminar uma transação do SAP.

Clicar em Elemento da IU do SAP

Interage através da ação de clique em qualquer elemento da IU de uma janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.
Tipo de elemento Não Elemento básico do SAP, Caixa de seleção, Etiqueta, Lista pendente, Elemento de grelha Elemento básico do SAP Selecione o tipo de elemento do SAP com o qual pretende interagir. A opção 'Clicar no elemento SAP' executa uma ação de clique em qualquer elemento SAP, como botões, botões de interação, separadores, campos de texto ou árvores.
ID do elemento do SAP Não Numérico O ID do elemento SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Utilize o seguinte botão para indicar o elemento da interface SAP no ecrã do SAP ou insira o valor manualmente.
ID do elemento do SAP Não Numérico O ID do elemento SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Utilize o seguinte botão para indicar o elemento da interface SAP no ecrã do SAP ou insira o valor manualmente.
Definir condição de caixa de verificação do SAP como Sim Marcado, Desmarcado Selecionada Especifique se a caixa de verificação será marcada ou desmarcada.
Operação de etiqueta do SAP Sim Expandir, Fechar, Escolher Expandir Especifique se a etiqueta do SAP deve ser expandida ou fechada.
Valor da opção de lista pendente Sim Valor de texto Especifique que a opção pendente está selecionada.
Elemento da grelha 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 de grelha do SAP com o qual pretende interagir.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Clique em Erro de Elemento da GUI do SAP Indica que o clique falhou.

Obter detalhes de elemento da IU do SAP

Obtém o valor do atributo de um elemento da IU do SAP numa janela do SAP.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.
ID do elemento do SAP Não Numérico O ID do elemento SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Utilize o seguinte botão para indicar o elemento da interface SAP no ecrã do SAP ou insira o valor manualmente.
Nome do atributo Não Valor de texto Texto próprio O atributo cujo valor é obtido.

Variáveis produzidas

Argumento Tipo Descrição
AttributeValue Valor de texto O valor do atributo do elemento da IU do SAP.

Exceções

Exceção Descrição
Obter erro de detalhe de elemento do SAP Indica um problema ao obter o atributo do elemento da IU.

Povoar o campo de texto do SAP no elemento

Preenche uma caixa de texto numa janela do SAP com o texto especificado.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
SAPInstance Não Instância do SAP Selecione a variável que contém a instância SAP com a qual pretende trabalhar. Defina essa variável numa ação de início de sessão do SAP anterior.
ID do elemento do SAP Não Numérico O ID do elemento SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Utilize o seguinte botão para indicar o elemento da interface SAP no ecrã do SAP ou insira o valor manualmente.
Texto a preencher Não Entrada direta encriptada ou Valor de texto O texto para preencher o campo de texto do SAP
Se o campo não estiver vazio Sim Substituir texto, Anexar texto Substituir texto Especificar se deve substituir conteúdo existente ou anexar a este.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Erro de Povoar Valor de Campo de Texto do SAP Indica um problema ao povoar o campo de texto especificado
  • Last updated on