Guia de automação web

Autentica em pop-ups de credenciais em navegador.

Parameters:

Name	Type	Description	Default
``usuario	str)``	String contendo usuário para digitação no campo correspondente.	required
``senha	str)``	String contendo senha para digitação no campo correspondente.	required
``caminho_janela	dict)``	dicionário contendo caminho até o título do navegador.	required
``caminho_usuario	dict)``	dicionário contendo caminho até o elemento usuário no pop-up navegador.	required
``caminho_senha	dict)``	dicionário contendo caminho até o elemento senha no pop-up navegador.	required
``caminho_botao_aprovacao	dict)``	dicionário contendo caminho até o elemento botão de confirmação no pop-up navegador.	required
``pid_aplicacao	int)``	Número inteiro contendo o PID do navegador que contém o popup de autenticação.	required
``estilo_aplicacao	str)``	String contendo o estilo de aplicação entre uia e win32.	required

Returns:

Type	Description
bool	Retorna valor booleano. True for sucesso, False para erro na operação de autenticar.

Source code in py_rpautom\web_utils.py

def autenticar_navegador(
    usuario: str,
    senha: str,
    caminho_janela: dict,
    caminho_usuario: dict,
    caminho_senha: dict,
    caminho_botao_aprovacao: dict,
    pid_aplicacao: int,
    estilo_aplicacao: str = 'uia',
) -> bool:
    """Autentica em pop-ups de credenciais em navegador.

    Args:
        ``usuario (str)``: String contendo usuário para digitação no campo correspondente.

        ``senha (str)``: String contendo senha para digitação no campo correspondente.

        ``caminho_janela (dict)``: dicionário contendo caminho até o título do navegador.

        ``caminho_usuario (dict)``: dicionário contendo caminho até o elemento usuário no pop-up navegador.

        ``caminho_senha (dict)``: dicionário contendo caminho até o elemento senha no pop-up navegador.

        ``caminho_botao_aprovacao (dict)``: dicionário contendo caminho até o elemento botão de confirmação no pop-up navegador.

        ``pid_aplicacao (int)``: Número inteiro contendo o PID do navegador que contém o popup de autenticação.

        ``estilo_aplicacao (str)``: String contendo o estilo de aplicação entre uia e win32.

    Returns:
        Retorna valor booleano. True for sucesso, False para erro na operação de autenticar.
    """
    # Validar o tipo da varivavel
    if isinstance(usuario, str) is False:
        raise ValueError('``usuario`` precisa ser do tipo str.')

    if isinstance(senha, str) is False:
        raise ValueError('``senha`` precisa ser do tipo str.')

    if isinstance(caminho_janela, dict) is False:
        raise ValueError('``caminho_janela`` precisa ser do tipo dict.')

    if isinstance(caminho_usuario, dict) is False:
        raise ValueError('``caminho_usuario`` precisa ser do tipo dict.')

    if isinstance(caminho_senha, dict) is False:
        raise ValueError('``caminho_senha`` precisa ser do tipo dict.')

    if isinstance(caminho_botao_aprovacao, dict) is False:
        raise ValueError(
            '``caminho_botao_aprovacao`` precisa ser do tipo dict.'
        )

    if isinstance(pid_aplicacao, int) is False:
        raise ValueError('``pid_aplicacao`` precisa ser do tipo int.')

    if isinstance(estilo_aplicacao, str) is False:
        raise ValueError('``estilo_aplicacao`` precisa ser do tipo str.')

    desktop_utils.conectar_app(
        pid_aplicacao,
        estilo_aplicacao=estilo_aplicacao,
        tempo_espera=1,
    )

    if (
        desktop_utils.localizar_elemento(
            caminho_campo=caminho_janela,
            estilo_aplicacao=estilo_aplicacao,
        )
        is True
    ):
        desktop_utils.ativar_foco(nome_janela=caminho_janela)

        desktop_utils.digitar(
            caminho_campo=caminho_usuario,
            valor=usuario,
        )
        desktop_utils.digitar(
            caminho_campo=caminho_senha,
            valor=senha,
        )
        desktop_utils.clicar(
            caminho_campo=caminho_botao_aprovacao,
        )

        return True

    return False