Controle e revisões
Arquivos Word e PDF como Artifacts
Adicione documentos Word e PDFs a um projeto como Artifacts, revise e comente suas páginas, mantenha cada versão e libere armazenamento removendo os arquivos de versões antigas.
Nesta página
- Conceitos
- Como usá-lo
- Quando e por quê
- Adicionar arquivos Word ou PDF
- Enviar uma nova versão
- Revisar e comentar
- Comentários em versões posteriores
- Comentários e alterações controladas do Word
- Comparar duas versões
- Exemplo prático: uma revisão de projeto na demonstração CubeSat EO-1
- Dicas e boas práticas
- Erros comuns
- Como se conecta
- A seção Arquivo
- Remover arquivos de versões antigas
- Arquivos sendo adicionados
- Sem conversão
- Mensagens
- Limites
- Relacionado
Um documento do Word ou um PDF pode ficar no seu projeto como um Artifact. Os revisores o leem no Holarch, comentam as páginas dele e o aprovam como qualquer outro item. Cada novo envio do mesmo documento se torna uma nova versão, e as versões anteriores continuam legíveis.
No serviço hospedado, os arquivos do Word são convertidos em PDF quando você os adiciona, e os PDFs são compactados. O PDF é o que todos leem, baixam e comentam.
Conceitos
- Artifact de arquivo: um Artifact que contém um arquivo. A página dele tem uma seção Arquivo no topo com o visualizador, as versões e as ferramentas de arquivo.
- Versão: um envio do documento. Cada versão guarda o PDF, quem o enviou, a data e uma nota opcional. A versão mais recente é mostrada por padrão.
- Conversão: converter um arquivo do Word em PDF e compactar PDFs. Um arquivo é convertido por vez para todos; os arquivos de contas diferentes se revezam, de modo que um lote grande não atrasa os outros.
- Comentário fixado: um comentário que pertence a um ponto de uma versão: palavras selecionadas, um ponto, uma caixa ou uma página inteira (ou, na visão do Word, um parágrafo). A Discussão mostra onde ele está, por exemplo "na versão 2, página 3".
Como usá-lo
Quando e por quê
Use um Artifact de arquivo quando um entregável é escrito fora do Holarch: um pacote de revisão de projeto, o documento de controle de interface de um fornecedor, um relatório de teste. Mantê-lo no projeto o coloca ao lado dos requisitos e itens que ele cobre. Os revisores comentam em um só lugar, e as linhas de base registram qual versão foi aprovada.
Adicionar arquivos Word ou PDF
- Abra o Banco de dados de um projeto LML.
- Clique em + Novo item e depois em Artifact a partir de um arquivo do Word ou PDF… abaixo do campo Nome. Quando o Banco de dados mostra apenas Artifacts, o botão é + Novo Artifact e o botão da caixa de diálogo diz A partir de um arquivo do Word ou PDF…. A caixa de diálogo se fecha e o seletor de arquivos abre.
O mesmo botão está na caixa de diálogo Novo item em todos os lugares em que ela abre, por exemplo ⌘K / Ctrl+K → Novo item…. Você também pode arrastar arquivos .docx e .pdf para a tabela do Banco de dados, ou pressionar ⌘K / Ctrl+K e executar Artifact a partir de arquivo… em qualquer página do projeto.
- Escolha um ou mais arquivos.
Você vê Arquivos sendo adicionados acima da tabela, com o status de cada arquivo: "Em espera (2 à frente)", Convertendo…, Compactando… ou Armazenando….
- Aguarde ou continue trabalhando. Você pode fechar a aba.
Quando um arquivo fica pronto, o Holarch avisa: "Design Review.docx está pronto como Artifact." Se nenhuma aba sua do Holarch estiver aberta, a mensagem chega por e-mail.
Cada arquivo se torna um Artifact, com o nome do arquivo sem a extensão. O aviso informa o tamanho armazenado, por exemplo "Armazenado em 2,1 MB, compactado a partir de 15 MB."
Enviar uma nova versão
- Abra o Artifact.
- Na seção Arquivo, clique em Enviar nova versão… e escolha o arquivo.
- Opcionalmente, digite uma Nota para a nova versão, por exemplo "Comentários da revisão de projeto atendidos", e clique em Enviar como nova versão.
Você vê "Nova versão Design Review.docx: Convertendo…" na página até que fique pronta.
Quando você adiciona um arquivo cujo nome corresponde a um Artifact já criado a partir de um arquivo com esse nome, Arquivo já está no projeto pergunta o que fazer:
- Enviar como nova versão (o padrão): o arquivo se torna a próxima versão desse Artifact.
- Manter ambos: um Artifact separado, cujo nome recebe " (2)".
- Cancelar: nada é adicionado.
Revisar e comentar
- Abra o Artifact. Páginas mostra o PDF no visualizador de documentos: uma barra de ferramentas, as páginas e um painel Comentários ao lado delas.
- Percorra o documento com a barra de ferramentas: Página 3 de 12 (digite um número de página e pressione Enter), os botões de página anterior e seguinte, Miniaturas, zoom (Ajustar à largura, Página inteira ou um tamanho fixo) e Localizar (⌘F / Ctrl+F). Teclas: ← e → viram as páginas, Home e End vão para a primeira e a última página, + e − ampliam e reduzem.
- Comente de uma de quatro formas:
- Selecionar texto: selecione palavras na página (você também pode copiá-las) e depois clique em Comentar na seleção. As palavras ficam destacadas.
- Ponto: clique no lugar da página ao qual o comentário pertence.
- Caixa: arraste uma caixa em torno de uma área, por exemplo uma figura ou uma tabela.
- Comentar na página: um comentário sobre a página mostrada, como um todo.
Digite o comentário no painel e clique em Adicionar comentário (⌘Enter / Ctrl+Enter). Digite @ e um nome para mencionar alguém.
- O painel Comentários lista as conversas na ordem das páginas, numeradas como os marcadores delas na página. Clique em uma conversa para ir ao lugar dela; clique em um marcador ou destaque para abrir a conversa dele. Responder, Resolver e Reabrir funcionam como na Discussão; Mostrar resolvidos mostra as conversas resolvidas.
- Para ter mais espaço, clique em Modo de revisão (a versão na janela inteira) ou Desencaixar (uma janela separada, por exemplo em uma segunda tela). Ambos ficam atualizados à medida que as pessoas comentam.
Cada comentário pertence à versão em que foi feito, e a Discussão também o mostra, por exemplo "na versão 2, página 3". Comentar nunca altera o arquivo: um PDF assinado mantém a assinatura.
Comentários em versões posteriores
Quando uma nova versão é adicionada, as conversas abertas passam para ela, de modo que uma revisão continua entre as versões:
- O Holarch encontra as palavras de cada conversa na nova versão, também quando elas foram para outra página ou o texto ao redor foi refluído. A conversa aparece ali com o rótulo Da versão 1 (a versão em que foi feita).
- Quando as palavras foram editadas, a conversa também é marcada com Texto alterado desde e mostra o que a versão anterior dizia, por exemplo "A versão 1 dizia: “reject 40 W”".
- Quando as palavras sumiram, a conversa é listada em Versões anteriores no fim do painel Comentários, com as palavras citadas e Mostrar na versão 1 (a última versão que as tem).
- Um Ponto ou uma Caixa acompanha a linha de texto mais próxima. Em uma página sem texto (um desenho ou uma digitalização), fica onde estava quando a página parece igual na nova versão; caso contrário, vai para Versões anteriores.
- As conversas resolvidas permanecem nas versões em que estavam. Reabra uma para que ela passe para as versões mais novas.
- Feito em (acima das conversas, assim que há conversas de mais de uma versão) mostra apenas as conversas feitas em uma versão, ou todas elas.
- As conversas vindas do Word seguem as mesmas regras.
Isso acontece quando a nova versão é adicionada. Os projetos com comentários de antes deste recurso recebem o mesmo tratamento na primeira vez que uma versão mais nova é mostrada. Na Discussão, um comentário de uma versão mais antiga diz onde está agora, por exemplo "Na versão 1, página 2, “radiator” · transferido para a versão 3" ou "· não está na versão 3".
Os comentários mantêm as palavras citadas, de modo que continuam legíveis depois que o arquivo de uma versão antiga é removido. Um comentário editado mantém o texto anterior: Texto anterior sob o comentário lista cada redação anterior com quem a escreveu e quando.
Uma linha de base registra a versão do arquivo e as conversas de comentários dela tal como eram então. Clique no nome da linha de base em Em linhas de base para vê-las.
Comentários e alterações controladas do Word
No serviço hospedado, as próprias marcações de revisão de um arquivo do Word são trazidas quando você o adiciona:
- Os comentários dele se tornam conversas de comentários no PDF, nas palavras em que foram feitos, com as respostas. Cada um mantém o autor e a data do Word e é marcado com Do Word. Um comentário que o Word marcou como concluído chega resolvido.
- As alterações controladas dele são listadas como sugestões: "Inserção sugerida: …" ou "Exclusão sugerida: …", pela pessoa que as fez.
- O PDF mostra os comentários na margem e as alterações controladas como marcas de revisão.
O aviso após o envio diz o que foi trazido, por exemplo "Importado do Word: 3 comentários e 2 alterações controladas." Você é o dono das conversas importadas, então pode resolvê-las ou excluí-las. As pessoas que acompanham o item não são notificadas sobre cada comentário importado.
Comparar duas versões
- Abra o Artifact. Na seção Arquivo, clique em Comparar versões… (mostrado quando o Artifact tem duas versões ou mais).
- Escolha a versão Mais antiga e a Mais recente. Por padrão, a versão mostrada é comparada com a anterior a ela.
As duas versões aparecem lado a lado, página por página:
- As palavras Inseridas ficam verdes na versão mais recente.
- As palavras Excluídas ficam vermelhas na versão mais antiga.
- As frases e parágrafos Movidos ficam violeta nos dois lugares. Um bloco movido que também foi editado mostra também as alterações de palavras. A lista de alterações nomeia as duas páginas, por exemplo "Página 2 → página 5".
- As páginas sem texto (desenhos, digitalizações) são comparadas como imagens. Uma alterada fica contornada; na página mais recente, Diferenças mostra em vermelho onde só a versão mais antiga tem tinta e em verde onde só a mais recente tem.
- Selecione uma alteração na lista, ou clique em Anterior e Próximo (F7 e Shift+F7), para mostrá-la nos dois lados. Sincronizar rolagem mantém o mesmo texto lado a lado enquanto você rola.
O texto é comparado no documento inteiro, de modo que o texto que foi para outra página, ou refluiu para outras linhas, ainda é correspondido. Um arquivo do Word mantido sem conversão é comparado como texto, sem páginas. Documentos longos mostram uma barra de progresso enquanto são lidos.
A mesma comparação marca alterações de texto em outros lugares: a revisão de solicitações de mudança, o Histórico do item, as alterações de documentos e as diferenças de bibliotecas mostram as frases movidas como movidas, com um link Movido para / Movido de entre os dois lugares.
Exemplo prático: uma revisão de projeto na demonstração CubeSat EO-1
- Na demonstração CubeSat EO-1, abra o Banco de dados, clique em + Novo item e adicione "EO-1 CDR Package.docx" com Artifact a partir de um arquivo do Word ou PDF….
- Quando ele estiver pronto, abra EO-1 CDR Package e relacione-o aos requisitos que ele cobre.
- Os revisores o abrem e usam Comentar na página… para a página 12: "Thermal margin table is missing the eclipse case."
- Após as correções, envie "EO-1 CDR Package.docx" novamente e escolha Enviar como nova versão, com a nota "CDR comments addressed".
- Crie uma linha de base. A página do Artifact mostra Em linhas de base com o nome da linha de base para a versão 2.
Dicas e boas práticas
- Envie cada nova versão com o mesmo nome de arquivo. Assim, um único Artifact contém o histórico inteiro.
- Envie um PDF em vez de um arquivo do Word quando o layout precisar corresponder exatamente ao do Word: a conversão pode mover quebras de linha.
- PDFs assinados, formulários PDF, arquivos PDF/A e PDFs criptografados são mantidos exatamente como enviados. Compactá-los quebraria a assinatura, o formulário ou a conformidade.
Erros comuns
- Apareceu um segundo Artifact: você escolheu Manter ambos. Exclua-o, envie o arquivo novamente e escolha Enviar como nova versão.
- Um arquivo do Word com mais de 100 MB foi recusado: no Word, escolha Arquivo → Salvar como → PDF e depois envie o PDF.
Como se conecta
- Comentários e revisões: os comentários fixados são comentários comuns; respostas, menções e aprovações funcionam como em qualquer item. Veja Comentários e revisões.
- Linhas de base: uma linha de base registra a versão que cada Artifact de arquivo tinha. Veja Solicitações de mudança.
- Armazenamento: o PDF de cada versão conta para o armazenamento do projeto e para o seu. Veja Anexos, armazenamento e limites.
A seção Arquivo
| Controle | O que ele faz |
|---|---|
| Versão | Mostra uma versão: "Versão 3 (mais recente) · data · quem enviou". As versões cujo arquivo foi removido dizem "arquivo removido". |
| Baixar (PDF) | Salva o PDF da versão mostrada. Um arquivo do Word mostrado sem conversão oferece Baixar (.docx). |
| Restaurar como a mais recente | Torna a versão mostrada novamente a mais recente, como uma nova versão. Nada é sobrescrito. Somente editores, não na versão mais recente. |
| Enviar nova versão… | Adiciona a próxima versão. Somente editores. |
| Comparar versões… | Duas versões lado a lado com o texto inserido, excluído e movido marcado. Veja "Comparar duas versões". |
| Remover arquivos de versões antigas… | Exclui os arquivos das versões antigas escolhidas. Veja abaixo. |
| Páginas / Visualizador de PDF | O visualizador de documentos (páginas, Localizar, comentários); ou o visualizador de PDF do próprio navegador (impressão). |
| Modo de revisão / Desencaixar | O visualizador de documentos na janela inteira ou em uma janela separada. |
| Comentar na página… / Fixar um comentário | Na visão do Word (um arquivo do Word mantido sem conversão): um comentário em uma página pelo número dela, ou no parágrafo em que você clica. Clique em Parar de fixar para encerrar. Os PDFs usam as próprias ferramentas do visualizador (veja Revisar e comentar). |
Abaixo das ferramentas, os dados da versão: Enviado (quem e quando), Arquivo enviado (o nome original dele), Nota, Armazenado (o tamanho e a economia) e Em linhas de base (clique no nome de uma linha de base para ver as conversas de comentários que ela registrou).
Remover arquivos de versões antigas
Os PDFs das versões antigas ocupam armazenamento. Remova os que ninguém precisa:
- No Artifact, clique em Remover arquivos de versões antigas….
- Selecione as versões.
Você vê "Remove permanentemente os arquivos da versão 2. A versão permanece no histórico."
- Clique em Remover arquivos.
Você vê "Arquivos de 1 versão removidos (12,4 MB liberados)."
- Quem pode remover: o titular da conta em um plano pessoal (o proprietário do projeto), um administrador da organização no plano Team. Um administrador da organização não precisa de acesso de edição ao projeto; a remoção leva o nome do administrador.
- A versão mais recente não pode ser removida desta forma. Para removê-la, exclua o Artifact.
- A versão permanece na lista, marcada como "Arquivo removido por name em date". Os comentários dela permanecem na Discussão como texto.
- A remoção é registrada no log de auditoria, com as versões e o espaço liberado.
Arquivos sendo adicionados
O Banco de dados mostra Arquivos sendo adicionados enquanto os seus envios estão a caminho.
- Enviando…: o arquivo está sendo enviado. Cancelar o interrompe, e nada é adicionado.
- Em espera (n à frente) ou Em espera (próximo): o arquivo aguarda a vez dele. Cancelar o remove da fila.
- Convertendo…, Compactando…, Armazenando…: o arquivo está sendo processado.
- Um arquivo que não pôde ser adicionado permanece na lista com a mensagem dele até que você clique em Dispensar.
Se o servidor reiniciar durante uma conversão, o arquivo volta para a fila e é tentado mais uma vez.
Sem conversão
Quando o servidor não tem conversor, os arquivos são armazenados como enviados:
- Os PDFs são armazenados sem compactação.
- Os arquivos do Word são mostrados em somente leitura no navegador: "Exibido somente para leitura no navegador (sem conversão para PDF neste servidor). O layout pode diferir do Word." Fixar um comentário então fixa comentários em parágrafos.
Mensagens
| Mensagem | O que fazer |
|---|---|
| "file tem 140 MB. Arquivos do Word acima de 100 MB não podem ser convertidos. No Word, escolha Arquivo → Salvar como → PDF e envie o PDF." | Salve o documento como PDF no Word e envie o PDF. |
| "Não foi possível converter file: o arquivo está protegido por senha. Remova a senha e envie-o novamente." | Abra o arquivo no Word, remova a senha de abertura, salve e envie novamente. |
| "Não foi possível converter file: o arquivo está danificado ou não é um documento do Word." | Abra e salve o arquivo no Word, ou envie um PDF. |
| "Não foi possível converter file: levou mais de 5 minutos (muito grande ou complexo). Divida-o ou salve-o como PDF e envie o PDF." | Divida o documento, ou salve-o como PDF no Word e envie o PDF. |
| "Não foi possível converter file: ele precisa de mais memória do que o conversor tem (muitas imagens grandes). Reduza as imagens ou envie um PDF." | Compacte as imagens no Word (Formato da Imagem → Compactar Imagens), ou envie um PDF. |
| "Não foi possível armazenar file: o arquivo está danificado ou não é um PDF." | Salve o PDF novamente a partir do programa que o criou. |
| "Somente documentos do Word (.docx) e PDFs se tornam Artifacts. Não adicionados: files." | Salve outros formatos como .docx ou PDF primeiro. |
| Uma mensagem de limite por arquivo | O arquivo ultrapassa o limite por arquivo do seu plano. Um arquivo do Word também recebe a sugestão de salvá-lo como PDF. |
Quando um arquivo não pode ser adicionado, nada é mantido: nenhum Artifact, nenhuma versão, e o envio é excluído.
Limites
| Plano | Por arquivo |
|---|---|
| Free / Acadêmico | 10 MB |
| Individual | 25 MB |
| Team | 100 MB |
- Arquivos do Word acima de 100 MB não podem ser convertidos em nenhum plano.
- O limite por arquivo se aplica ao arquivo que você envia. O PDF armazenado conta para o armazenamento do projeto e para o seu.
- Os Artifacts de Word e PDF estão disponíveis em projetos LML.