O BPEL Designer tem um recurso que permite criar comentários (documentação) anexos aos elementos do processo BPEL. Esta documentação será incluída no código-fonte do processo BPEL e posteriormente pode ser extraída e incluída em um relatório.
Para criar a documentação:
Para ler a documentação:
Um pequeno ícone de livro próximo ao elemento que não está selecionado indica que o elemento tem documentação. Se você aponta para este ícone com o cursor, aparecerá um tooltip com o texto escrito para o elemento. Você também pode ver a documentação do elemento no campo Documentação da janela Propriedades.
Para obter toda a documentação do processo como um arquivo separado você pode gerar um relatório.
O recurso geração de relatório do BPEL Designer permite a geração de um documento .pdf que descreve o processo BPEL.
Para gerar uma relatório:
Na barra de ferramentas do diagrama BPEL pressione o botão Gerar relatório.
Na janela Projetos entre os arquivos Processos do módulo BPEL aparecerá um arquivo pdf. O relatório e formato pdf contém o nome do processo, o diagrama, as informações sobre documentos importados, as informações sobre links de parceiros, uma lista de todas as variáveis definidas no processo e as informações sobre os elementos do processo. Se os elementos têm documentação gravada neles, ela será incluída no relatório.Você pode personalizar o relatório usando o botão Personalizar relatório na barra de ferramentas do diagrama. Este botão fornece duas opções: