documentacao - Há previsão Melhorar a Documentação do Fluig?

Há alguma intenção de melhorar a documentação?

Digo isso devido à grande quantidade de inconsistências e nomenclaturas confusas na documentação.

Vamos pegar a DocumentDto como exemplo.

Ao usar como objeto em um Web Service a documentação ( https://tdn.totvs.com/display/public/fluig/Guia+de+propriedades+dos+objetos#GuiadePropriedadesdosObjetos-DocumentDto ) indica que ela só possui propriedades (o que é certo, afinal é um objeto que será passado ao Web Service.

Então nós temos a DocumentDto que é usada nos eventos e nessa documentação ( https://tdn.totvs.com/display/public/fluig/Desenvolvimento+de+Eventos#DesenvolvimentodeEventos-DocumentDto ) ela é listada como só tendo os métodos. E note que só temos métodos pra pegar os valores dos documentos (get) e nenhum para atribuir valores (set).

Mas ao ler a documentação do método publishWorkflowAttachment, da hAPI, diz que é obrigatório atribuir o ID da pasta destino usando o método setParentDocumentId da DocumentDto, porém pela documentação em nenhum momento há a indicação deste método.

Estou criando um arquivo de definição de tipos em TypeScript pra conseguir um autocomplete decente no VSCode e peguei por base os arquivos .js que vem no plugin do Fluig pro Eclipse Luna e lá também há muitos problemas de definições.

Olá,

Não sabia que não tinha o vínculo.

Estranho que os links que eu tinha postado era esse mesmo que você compartilhou, mostrando as propriedades, e o outro mostrando os métodos.

Por isso que achei confuso, principalmente por que na documentação não cita os métodos SET, somente os GET.

Aliás, como comentei, estou fazendo um arquivo fluig.d.ts pra ter um autocomplete no VSCode, e boa parte das funções/classes eu peguei diretamente dos arquivos .js que estão no plugin do Fluig e nesses arquivos mesmo o objeto DocumentDto não possui nenhum método SET.

— Bruno Gasparetto 10 de Mar de 2020

Estou na fase de tentar entender tudo pra conseguir fazer o arquivo de definições. Por enquanto só estou jogando tudo o que acho e guardando nesse repositório https://github.com/brunogasparetto/fluig-declaration-type

Bruno, uma outra forma de mapear todos os metodos de uma classe utilizada no Fluig é verificando os binds criados ao consultar um serviço. Já tentou?

— Alef Vinicius 10 de Mar de 2020

Certeza que lá vai ter vários gets e sets.

Você diz ir testando na mão cada consulta a um serviço jogando num log, por exemplo? Seria um serviço extremamente custoso se comparado a ter uma documentação boa, hehehe. Confesso que fiquei triste com a documentação do Fluig e saber que é uma das melhores documentações da TOTVS me fez ficar bem triste. Inclusive a capacitação "Fluig Expert" deles é um pouco fraca, já que não tem nivelamento dos alunos e acabam gastando tempo demais com coisas simples e vendo quase nada da parte Expert mesmo :(

fluig forum

Há previsão Melhorar a Documentação do Fluig?

Comentário

1 resposta

Comentário

Não é a resposta que estava procurando? Procure outras perguntas com as tags documentacao melhoria documentdto ou faça a sua própria pergunta.