Ações de automatização do SAP

O nosso grupo de ações para automatização do SAP fornece um conjunto de ferramentas para ajudar a simplificar e automatizar os seus fluxos de trabalho do SAP. Com essas ações, pode facilmente iniciar a aplicação SAP GUI, criar novas sessões, selecionar itens de 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.

Iniciar o SAP

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

Para modo de ligação:

• A opção de descrição do servidor permite que se ligue a um sistema SAP através do nome SAP ou endereço IP. Para isso, precisa das credenciais de início de sessão e das permissões de acesso necessárias. A descrição do servidor é um nome legível por humanos ou uma descrição do sistema SAP.
• A opção de cadeia de ligação do servidor permite que se ligue a um sistema SAP através de uma cadeia de ligação. A cadeia de ligação do servidor normalmente inclui 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.

Para várias opções de início de sessão:

• Encerrar esta opção de início de sessão encerra o início de sessão da ação específica.
• Continuar este início de sessão e encerrar qualquer outra opção de início de sessão substitui a instância SAP existente com o início de sessão específico.
• Continuar este início de sessão sem terminar quaisquer outros inícios de sessão na opção do sistema 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.
Connection string	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 a opção Primeiro plano ou Última ativação estiver selecionada, a instância do SAP será anexada à sessão SAP em primeiro plano. Se não houver nenhuma sessão SAP em primeiro plano, será anexada à última sessão SAP que foi iniciada e ainda não foi fechada.
Título da janela	Sim	Texto		Especifica o título da janela SAP à qual a instância está anexada. O título da janela pode ser selecionado na lista pendente de sessões SAP existentes ou inserido 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. Esta variável deve ser definida 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 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. Esta variável deve ser definida 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 de menu na barra de ferramentas a selecionar, como 'Guardar'. Insira o nome do item de menu conforme é apresentado 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

Feche a ligação SAP da instância SAP selecionada. Tenha em atenção que todas as instâncias relacionadas com a ligação específica serão terminadas.

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. Esta variável deve ser definida 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 na 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. Esta variável deve ser definida 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 pretende 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. Uma transação do SAP tem de ser iniciada primeiro para a sessão do SAP 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. Esta variável deve ser definida 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. Esta variável deve ser definida numa ação de início de sessão do SAP anterior.
Tipo de elemento	Não	Elemento básico do SAP, Caixa de verificação, Etiqueta, Lista pendente	Elemento básico do SAP	Selecione o tipo de elemento do SAP com o qual precisa de interagir. A opção "Clique no elemento do SAP" executa uma ação de clique em qualquer elemento do SAP como botões, botões de opção, separadores, campos de texto, árvores.
ID do elemento do SAP	Não	Numérico		O ID do elemento do SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Pode utilizar o botão abaixo para indicar o elemento da IU do SAP no ecrã do SAP ou inserir 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.
ID do elemento do SAP	Não	Numérico		O ID do elemento do SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Pode utilizar o botão abaixo para indicar o elemento da IU do SAP no ecrã do SAP ou inserir o valor manualmente.
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.

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. Esta variável deve ser definida 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 do SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Pode utilizar o botão abaixo para indicar o elemento da IU do SAP no ecrã do SAP ou inserir o valor manualmente.
Attribute name	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. Esta variável deve ser definida 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 do SAP. Este parâmetro determina o elemento da IU no SAP com o qual a ação interage. Pode utilizar o botão abaixo para indicar o elemento da IU do SAP no ecrã do SAP ou inserir 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