Método save_result_file()

Salva um arquivo de resultados gerado por um script Python/HCL durante uma execução da tarefa.

Sintaxe

hcl.save_result_file(name = "nome_do_arquivo_de_resultados")

Parâmetros

Nome Descrição
name = nome_do_arquivo_de_resultado

O nome do arquivo de resultados. O nome deve estar entre aspas.

Você precisa replicar exatamente o nome do arquivo que já foi gerado pelo script Python/HCL, incluindo a extensão do arquivo.

nome_do_arquivo_de_resultado diferencia maiúsculas e minúsculas. O uso de maiúsculas e minúsculas deve seguir o nome de arquivo gerado pelo script Python/HCL.

Retorna

Para uma execução bem-sucedida, o código de retorno é 202. Em caso de falha, uma mensagem de erro.

Exemplos

Salvar um arquivo de resultados de uma execução da tarefa

Você quer salvar um arquivo de resultados com duplicidades de registros de faturas do T1 de 2022. Os registros estão contidos em um arquivo com o nome Duplicate_Invoices_Q1_2022.csv, gerado anteriormente por um método do Python em um script. Para salvar permanentemente o arquivo na guia Execuções de tarefas no robô, você precisa usar o método do HCL save_result_file() separado.

hcl.save_result_file(name = "Duplicate_Invoices_Q1_2022.csv")

Observações

Comportamento ao salvar arquivos

Se você salvar o mesmo arquivo de resultados mais de uma vez no mesmo script, a cópia salva anteriormente será substituída automaticamente.

Visualizar o arquivo de resultados

Se você testar o método save_result_file() executando um script interativamente no editor de scripts do Robôs, o arquivo de resultados será salvo no local de armazenamento de dados do Diligent One na nuvem. No entanto, o arquivo de resultados salvo não é visualizado separadamente da cópia temporária do arquivo visualizado no painel Arquivos da sessão no editor de scripts. Um código de retorno 202 informa que o arquivo de resultados foi salvo com sucesso.

Se você quiser visualizar o arquivo salvo separadamente, crie uma tarefa e execute o script usando a tarefa. O arquivo de resultados salvo aparece no painel Detalhes da execução da tarefa associado à execução da tarefa específica na guia Execuções de tarefas.

Mensagem de erro do script

Qualquer uma dessas situações causa a mensagem de erro de script abaixo:

  • o arquivo especificado não foi gerado anteriormente pelo script

  • o nome do arquivo está incorreto

  • o uso de maiúsculas e minúsculas não segue exatamente o nome de arquivo

  • a extensão do arquivo não foi informada

Mensagem de erro do script:

FileNotFoundError: Arquivo nome_do_arquivo_de_resultado não existe no diretório de trabalho