Estratégias de Retry
Pode ser necessário executar novamente um conjunto de passos para um determinado documento, por necessidade ou por ocorrência de uma situação de erro.
Para tanto, o controle do fluxo pode ser feito via API de comunicação. Basicamente, os cenários em que pode ser necessário aplicar uma estratégia de retry são:
Reiniciar completamente o processamento do arquivo
a. Esse procedimento atualiza todo o contexto de processamento do documento, inclusive os responsáveis pela assinatura, caso uma nova configuração de responsáveis tenha sido criada para o grupo de documentos;
Reiniciar o processo de geração
b. O documento retorna ao estado de início do processo de geração;
Reiniciar o processo de coleta de assinaturas
c. O documento retorna ao estado de pronto para coleta de assinaturas;
Reiniciar o processo de finalização das assinaturas (OBS: o reinício a partir daqui não exige a coleta novamente das assinaturas )
d. A montagem do documento final é refeita
Reiniciar o processo de registro no serviço de preservação
e. Deve ser usado nos casos em que houve falha no registro. Geralmente devido a entrada em algum código de erro no processo de registro;
Suspender um documento já processado e válido
f. Suspende temporariamente um documento. O motivo deve ser informado;
Reativar um documento suspenso
g. Reativa um documento suspenso. O motivo deve ser informado;
Iniciar o processo de revogação de um documento
h. Processo irreversível. No tocante ao Diploma Digital, para emissão de um novo diploma para a mesma pessoa, todo o processo de emissão deverá ser reiniciado com um novo id de documento e no que couber, nova documentação acadêmica.
OBSERVAÇÃO 1: Como os documentos referentes a emissão do Diploma Digital dependem um do outro recomenda-se utilizar as funções de retry sempre em um documento base e em todos os documentos que dependem dele. Por exemplo, caso se deseje reiniciar o processo de emissão do XML da Documentação Acadêmica, deve-se também, após seu processamento, reiniciar o processo de emissão do Diploma Digital e, por conseguinte, o processo de conversão da representação visual para o formato PDF/A.
OBSERVAÇÃO 2: Recomenda-se não utilizar as rotinas de retry com documentos que já se encontram com status válido, suspenso ou revogado (10,11 e 13, respectivamente).
OBSERVAÇÃO 3: Nos casos que se deseje registrar novamente documento já válido, deve-se revogá-lo e iniciar um novo processo.