~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>


====== Enviar Agradecimento ======

Esse é um dos casos de uso centrais do submódulo de Intercâmbio, o Envio de Agradecimento permite ao usuário registrar no sistema a ocorrência de uma nova Doação ou Intercâmbio com a instituição parceira de recebimento de materiais, ao mesmo tempo em que monta a correspondência que será enviada para a instituição de destino.

A correspondência contém informações sobre os materiais recebidos, e a instituição parceira.

===== Descrição do Caso de Uso =====

Esse caso de uso é acessado pela opção //Sigaa -> Biblioteca -> Aba Doação e Intercâmbio -> Doação e Intercâmbio -> Enviar Agradecimento//

Ao entrar no caso de uso o usuário é apresentado a uma tela contendo 3 formulários com as seguintes informações:

  * **Tipo do Texto:** Tipo - Texto. Com a opção ''Doação''e ''Intercâmbio''. De acordo com [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:cadastros:textos_predefinidos|Texto predefinidos]] cadastrados.
  * **Meio de Envio** Tipo - Texto. Com a opção ''Carta'' e ''E-mail''([[#Principais Regras de Negócio|RN05]]).
  * **Idioma**:  Tipo - Texto. De acordo com [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:cadastros:textos_predefinidos|Texto predefinidos]] cadastrados ([[#Principais Regras de Negócio|RN05]]).
  * **Dados de envio** ([[#Principais Regras de Negócio|RN05]])
    * **De***: Tipo - Texto.
    * **Para***: Tipo - Texto. Permite [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:cadastro_de_doadores_e_instituicoes_parceiras:buscar|Buscar Instituição parceira]] cadastrada. 
    * **E-mail***: Tipo - Texto ([[#Principais Regras de Negócio|RN01]]), ([[#Principais Regras de Negócio|RN02]]). 
    * **Cópia**: Tipo - Texto([[#Principais Regras de Negócio|RN01]]), ([[#Principais Regras de Negócio|RN02]]). 
    * **Assunto***: Tipo - Texto([[#Principais Regras de Negócio|RN01]]). 
  * **Materiais do Intercâmbio** ([[#Principais Regras de Negócio|RN05]])
    * **Título Intercambiado**: Tipo- Texto. Permite buscar os [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:cadastro_de_titulos:novo_titulo_avulso|títulos cadastrados]].
    * **Tipo de Material**: Tipo - TEXTO.
    * **Quantidade de Materiais:** Tipo - NUMÉRICO.
  * **Texto**: Exibe o texto cadastrado em [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:cadastros:textos_predefinidos|Texto predefinidos]].
 

Cada alteração de dados nos 1º e 2º formulários atualiza o conteúdo da correspondência. O usuário pode ver a aparência final aproximada da correspondência clicando em **Pré-visualizar**.

Caso o meio de envio seja Email, o usuário clica em **Realizar Intercâmbio**, o sistema então registra o novo intercâmbio e envia a correspondência para o email da instituição parceira, além dos outros emails inseridos no campo Cópia. E o caso de uso é finalizado.

Caso o meio de envio seja Carta, o usuário clica em **Realizar Intercâmbio**, o sistema então registra o novo intercâmbio e cria um arquivo pdf com a correspondência no modelo padrão de intercâmbio da biblioteca. 

O caso de uso também pode ser extendido, ao finalizar a inserção das informações, o usuário pode clicar em [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:doacao_e_intercambio:enviar_material| 2-Enviar Material]]. ou [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:doacao_e_intercambio:doacao_e_intercambio:indicar_interesse| 3-Indicar Interesse]]. O sistema reaproveita as informações do Envio de Agradecimento e mescla com o caso de uso seguinte, permitindo o usuário realizar dois ou 3 intercâmbios diferentes na mesma correspondência.

E o caso de uso é finalizado.

===== Principais Regras de Negócio =====

  * **RN01** - Para realizar o Envio de Agradecimento é preciso registrar pelo menos um material que foi recebido da instituição parceira.
  * **RN02** - A instituição parceira deve possuir email válido.
  * **RN03** - Opção exibida quando o tipo do envio for E-mail.
  * **RN04** - Só é possível Pré-visualizar quando a edição do texto está habilitada.
  * **RN05** - Só é possível alterar a opção quando a edição do texto estiver desabilitada.


==== Resoluções/Legislações Associadas ====

Não se Aplica


<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe                                                             ^ Tabela                                  ^
|      br.ufrn.sigaa.biblioteca.intercambio.dominio.Intercambio      |      sigaa.biblioteca.intercambio       |
|  br.ufrn.sigaa.biblioteca.intercambio.dominio.InstituicaoParceira  |  sigaa.biblioteca.instituicao_parceira  |
|  br.ufrn.sigaa.biblioteca.intercambio.dominio.TituloIntercambiado  |  sigaa.biblioteca.titulo_intercambiado  |
|  br.ufrn.sigaa.biblioteca.intercambio.dominio.MaterialIntercambio  |  sigaa.biblioteca.material_intercambio  |

===== Plano de Teste =====

Sistema: SIGAA

Módulo: Biblioteca

Link(s): Sigaa -> Biblioteca -> Aba Doação e Intercâmbio -> Doação e Intercâmbio -> Enviar Agradecimento.

Usuário:  jadsonjs 

Papel que usuário deve ter: 
SigaaPapeis.BIBLIOTECA_SETOR_INTERCAMBIO_BIBLIOTECARIO.




===== Cenários de Teste =====

Realizar um intercâmbio enviando por email, inserindo os dados obrigatórios.
\\
Verificar se o email com o intercâmbio chega no destinatário com as informações certas.
\\
Realizar um intercâmbio enviando por carta, inserindo os dados obrigatórios.
\\
Verificar se a carta impressa contém os dados informados.

===== Dados para o Teste =====

<code sql> 

-- Permite visualizar os ultimos 300 intercâmbios

select * from biblioteca.intercambio order by data_intercambio desc limit 300

</code>

</ifauth>