Ações de automação do SAP
Nosso grupo de ações para automação do SAP fornece um conjunto de ferramentas para ajudar a agilizar e automatizar seus fluxos de trabalho do SAP. Com essas ações, você pode iniciar facilmente o aplicativo GUI do SAP, 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.
Iniciar o SAP
Abra o aplicativo da GUI do SAP e conecte-se a um sistema SAP.
Para modo de conexão:
- A opção de descrição do servidor permite conectar-se a um sistema SAP por meio do nome SAP ou endereço IP. Para fazer isso, você precisa das credenciais de login e permissões de acesso necessárias. A descrição do servidor é um nome ou descrição legível do sistema SAP.
- A opção de cadeia de conexão do servidor permite conectar-se a um sistema SAP por meio de uma cadeia de conexão. A cadeia de conexã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 conexão do servidor é um formato específico para identificar e conectar-se a um sistema SAP.
Para várias opções de logon:
- A opção Encerrar este logon encerra o logon da ação específica.
- Continue esse logon e finalize qualquer outro logon. A opção substitui a instância SAP existente pelo logon específico.
- Continuar esse logon sem encerrar nenhum outro logon na opção do sistema 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. | |
| Connection string | 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 | Type | 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 | No | 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 a opção Primeiro plano ou a última opção ativada for selecionada, a instância SAP será vinculada à sessão SAP em primeiro plano. Se não houver nenhuma sessão SAP em primeiro plano, ela será vinculada à ú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á vinculada. O título da janela pode ser selecionado na lista suspensa de sessões SAP existentes ou inserido manualmente. |
Variáveis produzidas
| Argumento | Type | 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. Essa variável deve ser definida em uma ação de logon do SAP anterior. |
Variáveis produzidas
| Argumento | Type | 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 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. Essa variável deve ser definida em uma ação de logon do SAP anterior. | |
| Nome do item de menu | No | Valor do texto | O nome do item de menu na barra de ferramentas a ser selecionado, como 'Salvar'. Insira o nome do item de menu conforme exibido na instalação SAP da máquina. |
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 do SAP da instância SAP selecionada. Observe que todas as instâncias relacionadas à conexão específica serão encerradas.
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. Essa variável deve ser definida em uma ação de logon do SAP anterior. |
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 na 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. Essa variável deve ser definida em uma ação de logon do SAP anterior. | |
| Código da transação | No | 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. Uma transação do SAP deve ser iniciada antes para a sessão do 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. Essa variável deve ser definida em uma ação de logon do SAP anterior. |
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. Essa variável deve ser definida em uma ação de logon do SAP anterior. | |
| Tipo de elemento | No | Elemento SAP Básico, Caixa de Seleção, Rótulo, Lista Suspensa | Elemento do SAP básico | Selecione o tipo de elemento SAP com o qual você precisa interagir. A opção 'Clicar 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, árvores. |
| ID do elemento do SAP | No | 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. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do 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. |
| ID do elemento do SAP | No | 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. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente. | |
| 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. |
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. Essa variável deve ser definida em uma ação de logon do SAP anterior. | |
| ID do elemento do SAP | No | 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. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente. | |
| Nome do atributo | No | Valor do texto | Próprio texto | O atributo cujo valor é recuperado. |
Variáveis produzidas
| Argumento | Type | 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. Essa variável deve ser definida em uma ação de logon do SAP anterior. | |
| ID do elemento do SAP | No | 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. Você pode usar o botão abaixo para indicar o elemento da interface do usuário do SAP na tela do SAP ou inserir o valor manualmente. | |
| Texto para preencher | No | 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. |