Suporte Okai

Aplica-se a: Use este artigo para gerar documentos padronizados, testar modelos de artefatos, exportar relatórios ou preparar evidências a partir de dados revisados do workspace.

O arquivo final começa antes da exportação

Modelos, documentos e exportações existem para transformar dados do workspace em uma saída compreensível, repetível e pronta para revisão. O ponto mais importante é simples: a exportação não melhora a qualidade do dado de origem. Ela apenas materializa o que já está registrado, filtrado, classificado e disponível para aquele contexto.

Quando o arquivo será enviado para auditoria, diretoria, cliente, regulador ou outra área interna, trate a geração como a última etapa de um fluxo de trabalho. Antes dela vêm a escolha do modelo, a conferência dos campos, a revisão dos registros envolvidos e a decisão sobre qual versão deve circular.

Na Okai, documentos e artefatos costumam carregar contexto: tarefa, projeto, evidência, responsável, prazo, status, origem regulatória, comentários, anexos ou campos personalizados. Se esse contexto se perde na saída, o arquivo pode até parecer bem formatado, mas deixa de cumprir sua função de rastreabilidade.

Regra de decisão: Use a exportação para distribuir uma versão revisada do que está na Okai. Não use a exportação como lugar principal para completar campo, trocar classificação, ajustar responsável ou esconder dado ausente.

Modelo, documento e exportação não são a mesma coisa

Um modelo define a estrutura esperada: seções, campos variáveis, ordem das informações e padrão de leitura. Um documento é o conteúdo gerado ou mantido a partir dessa estrutura. Uma exportação é a saída em arquivo, planilha, relatório ou formato compartilhável.

• Revise o modelo quando a estrutura não representa mais o processo, quando uma seção ficou ambígua ou quando cada equipe precisa editar o layout depois de gerar.
• Revise os dados de origem quando campos saem vazios, responsáveis parecem incorretos, datas não batem ou registros esperados não entram no documento.
• Revise filtros e escopo quando a exportação trouxe itens a mais, deixou itens de fora ou misturou workspaces, projetos, períodos ou status diferentes.
• Revise permissões quando uma pessoa não consegue gerar o mesmo arquivo que outra, não enxerga anexos ou recebe uma saída com menos informações do que o esperado.
• Revise o formato de saída quando o conteúdo está correto na prévia, mas o arquivo final perde quebra, tabela, acentuação, página, coluna ou legibilidade.

Quando não usar modelo: Se a entrega é única, exploratória ou ainda está mudando toda semana, talvez seja melhor registrar o conteúdo em comentário, tarefa, anexo ou documento livre até estabilizar a estrutura. Um modelo criado cedo demais costuma virar exceção permanente.

Escolha o modelo pelo objetivo do documento

Comece pela pergunta que o documento precisa responder. Um relatório executivo pede síntese, decisão e impacto. Uma evidência de execução pede vínculo com tarefa, responsável, data e comprovação. Um material de revisão pede campos suficientes para comparação. Um artefato final pede linguagem estável e versão aprovada.

1. Defina a finalidade: Determine se o arquivo servirá para leitura interna, aprovação, auditoria, compartilhamento externo, prestação de contas ou arquivo histórico. Essa finalidade orienta o nível de detalhe e o formato mais adequado.
2. Confirme o tipo de conteúdo: Verifique se o modelo foi criado para tarefa, projeto, documento, evidência, relatório ou outro registro compatível. Um modelo visualmente parecido pode puxar campos diferentes e gerar uma saída incompleta.
3. Revise campos obrigatórios e variáveis: Identifique quais campos alimentam título, datas, responsáveis, status, seções, tabelas, anexos e observações. Campo obrigatório sem origem clara é sinal de que o processo ou o modelo precisa de ajuste.
4. Cheque escopo e filtros: Confirme workspace, projeto, período, status, responsável, tipo de documento e demais filtros antes de gerar. A exportação deve refletir a seleção que você quer defender depois.

Cuidado com modelos parecidos: Não escolha modelo apenas pelo nome ou pela aparência da prévia. Dois modelos podem ter layout semelhante e fontes de dados diferentes. Se a finalidade mudou, valide o contrato do modelo antes de reutilizar.

Teste antes de publicar ou distribuir

Todo modelo que será usado por mais de uma pessoa ou por uma rotina recorrente merece teste com dados reais. O teste precisa cobrir o caminho feliz e também casos que costumam quebrar documentos: campo vazio, anexo ausente, texto longo, caracteres acentuados, múltiplos responsáveis e período com muitos itens.

• Gere uma prévia com um exemplo simples e outro complexo, preferencialmente de projetos ou tarefas já revisados.
• Confira se textos longos não cortam informação essencial e se listas extensas continuam legíveis.
• Valide se anexos e evidências aparecem apenas quando devem aparecer e se o arquivo preserva o contexto do registro original.
• Peça revisão de alguém que conheça o processo, não apenas de quem configurou o modelo.

O teste precisa deixar rastro: Registre qual modelo foi testado, em qual contexto, com qual exemplo e qual versão foi aprovada. Isso evita discutir, meses depois, se um comportamento era esperado ou se apareceu após uma alteração.

Gere a saída com controle de versão

Depois que a origem está revisada e o modelo foi escolhido, gere a prévia ou exportação no formato adequado para o destino. Use um nome de arquivo claro, com tema, período, área ou data quando isso ajudar a diferenciar versões.

1. Gere a prévia: Leia a prévia como quem vai receber o documento: título, objetivo, seções, tabelas, datas, responsáveis e anexos precisam fazer sentido fora da tela da Okai.
2. Ajuste a origem, não o sintoma: Se a prévia mostrou dado errado ou ausente, volte ao registro, campo, filtro ou modelo. Ajustar manualmente o arquivo final cria uma versão bonita, mas desconectada da trilha de trabalho.
3. Exporte no formato correto: Escolha o formato que melhor preserva a finalidade. Planilha ajuda análise e filtro; PDF ajuda distribuição estável; documento editável ajuda revisão textual, desde que a versão final volte a ser controlada.
4. Identifique a versão aprovada: Quando houver revisão formal, mantenha claro qual arquivo foi aprovado, por quem e em qual data.

Edição fora da Okai: Editar um arquivo exportado pode ser necessário para comentário, marcação ou ajuste editorial. Mas se a edição muda dado operacional, classificação, status, evidência ou conclusão, a correção deve voltar para a Okai antes de nova distribuição.

Valide como quem vai precisar confiar no arquivo

A validação não é só abrir o arquivo e confirmar que ele baixou. Um documento exportado precisa preservar conteúdo, contexto e legibilidade. Revise no mesmo formato em que ele será usado, porque alguns problemas só aparecem depois da conversão.

• O título, período, workspace, projeto ou recorte deixam claro de onde o documento veio.
• Campos variáveis foram preenchidos com informação real, não com espaço em branco, rótulo técnico ou valor provisório.
• Datas, responsáveis, status e classificações batem com os registros revisados na Okai.
• Tabelas, quebras de página, acentuação, anexos e links internos continuam legíveis no arquivo final.
• A saída inclui somente o escopo pretendido e não expõe informação de outro workspace, área ou período.

Não distribua sem revisão: Exportação que abre sem erro técnico ainda pode estar errada em conteúdo. Antes de enviar, valide finalidade, escopo e dados principais. O risco maior costuma ser circular uma versão incompleta com aparência oficial.

Quando algo sai errado

Problemas em documentos gerados raramente se resolvem no arquivo final. O caminho mais confiável é localizar em qual camada a divergência surgiu: origem, modelo, filtro, permissão, formato ou versão.

• Campos vazios: confira se o registro de origem tem valor, se o campo correto foi usado no modelo e se o preenchimento é obrigatório no processo.
• Itens faltando: revise filtros, período, status, workspace, projeto e permissões. Compare a lista exibida na Okai com o escopo usado para exportar.
• Informação antiga: verifique se a página estava atualizada, se houve alteração após a geração e se a equipe está olhando a versão mais recente.
• Layout quebrado: teste com texto longo, muitos itens e o formato de destino. Se o conteúdo está certo e a saída perde legibilidade, o modelo precisa ser ajustado.
• Diferença entre pessoas: compare permissões, workspace ativo, filtros salvos e acesso aos documentos relacionados.

Boa pergunta para o suporte: Ao abrir chamado, informe qual modelo foi usado, qual registro ou filtro alimentou a geração, horário aproximado, formato exportado, o que apareceu na prévia e o que ficou diferente no arquivo final.