Files

305 lines
17 KiB
Markdown
Raw Permalink Normal View History

2026-05-06 13:35:47 -03:00
---
title: Impressão de cópia controlada
source: https://tdn.totvs.com/pages/viewpage.action?pageId=152802071
path: \Plataforma Documentação técnica\Recurso de Documentos (ECM)\Impressão de cópia controlada.md
---
- [Introdução](#Impressãodecópiacontrolada-Introdução)
- [Pré-requisitos](#Impressãodecópiacontrolada-Pré-requisitos)
- [Tipos de arquivos suportados](#Impressãodecópiacontrolada-Tiposdearquivossuportados)
- [Impressão de documentos](#Impressãodecópiacontrolada-Impressãodedocumentos)
- [Acionar a impressão](#Impressãodecópiacontrolada-Acionaraimpressão)
- [Realizar a impressão](#Impressãodecópiacontrolada-Realizaraimpressão)
- [Recursos adicionais](#Impressãodecópiacontrolada-Recursosadicionais)
- [Log de cópia controlada](#Impressãodecópiacontrolada-Logdecópiacontrolada)
- [Compatibilidade de impressão com o MS Office](#Impressãodecópiacontrolada-CompatibilidadedeimpressãocomoMSOffice)
- [Variáveis de impressão e visualização](#Impressãodecópiacontrolada-Variáveisdeimpressãoevisualização)
- [Pré-requisitos](#Impressãodecópiacontrolada-Pré-requisitos.1)
- [Configuração de atualização das variáveis](#Impressãodecópiacontrolada-Configuraçãodeatualizaçãodasvariáveis)
- [Variáveis de visualização](#Impressãodecópiacontrolada-Variáveisdevisualização)
- [Variáveis de impressão](#Impressãodecópiacontrolada-Variáveisdeimpressão)
- [Eventos de documentos](#Impressãodecópiacontrolada-Eventosdedocumentos)
- [Configurar variáveis](#Impressãodecópiacontrolada-Configurarvariáveis)
- [Microsoft Word](#Impressãodecópiacontrolada-MicrosoftWord)
- [Microsoft Excel](#Impressãodecópiacontrolada-MicrosoftExcel)
# Introdução
---
O recurso de impressão de cópia controlada no TOTVS Fluig Plataforma permite identificar e rastrear as cópias emitidas dos documentos.
É um recurso importante quando ocorre atualização de normas e procedimentos, principalmente de ISO, onde é necessário recolher as cópias impressas antigas e disponibilizar as novas versões para as áreas.
Com o registro de quais áreas possuem os documentos impressos fisicamente, facilita muito essa substituição. Além de evitar não conformidades em auditorias.
# Pré-requisitos
---
São pré-requisitos para a impressão de documentos:
- A configuração de ao menos uma área. Para saber como fazer isso, acesse a documentação sobre [Áreas](http://tdn.totvs.com/x/w4D5DQ);
- A configuração de marca d'água é opcional. Para saber mais, acesse a documentação de [Marca d'água](http://tdn.totvs.com/x/BoH5DQ);
# Tipos de arquivos suportados
---
A plataforma permite a impressão de cópia controlada apenas para arquivos PDF, documentos do Word e planilhas do Excel. Em servidores Linux, arquivos com extensões .doc e .xls podem não funcionar.
A tabela abaixo exibe as extensões suportadas pelo recurso de cópia controlada:
| Extensão | Compatível? | Sistema Operacional do servidor da plataforma |
| --- | --- | --- |
| **.doc** | (aviso) | Somente em servidor Windows |
| **.docx** | (seleção) | Windows/Linux |
| **.ppt** | (erro) | |
| **.pptx** | (erro) | |
| **.xls** | (aviso) | Somente em servidor Windows |
| **.xlsx** | (seleção) | Windows/Linux |
| **.pdf** | (seleção) | Windows/Linux |
| **.txt** | (erro) | |
Atenção!
Em algumas instalações ocorre o erro: “java.lang.NoClassDefFoundError : null” ao imprimir documentos Microsoft® Office. Para mais detalhes de como solucionar a inconsistência confira a documentação [Configuração de serviços de componentes](http://tdn.totvs.com/x/eiH2Dw).
# Impressão de documentos
---
Os documentos com os tipos de arquivos suportados (listados acima) configurados para utilizar o Visualizador Interno, SEMPRE são impressos como cópia controlada.
Para os demais tipos de arquivos que não são suportados, NÃO é permitida a impressão pela Cópia controlada. É possível apenas a impressão normal do documento e deve ser realizada exclusivamente pela Visualização do Documento, no ícone da Impressora (ver segunda opção abaixo).
## Acionar a impressão
Você pode fazer a impressão de um documento através da navegação ou através da visualização.
Na navegação, selecione o arquivo e acione o botão Mais > Imprimir cópia controlada.
![](..\..\images\image2018-11-26_14-39-35.png)
Na visualização do documento há duas opções. Na primeira acione Ações do documento > Imprimir cópia controlada.
![](..\..\images\image2018-11-26_14-40-59.png)
Na segunda, acione o ícone da impressora.
![](..\..\images\image2018-11-26_14-42-24.png)
Atenção
Para os documentos com os tipos de arquivos NÃO suportados esta é a única forma de impressão pela plataforma. Não sendo registrada como uma cópia controlada.
Para os documentos com os tipos de arquivos suportados, configurados para não utilizar o Visualizador Interno, também será realizada uma impressão normal, sem registro de cópia controlada.
## Realizar a impressão
Após acionar a impressão, você será apresentado à tela de configuração. Configure cada campo conforme a sua necessidade:
1. **Documento protocolo:** escolha um documento protocolo para a impressão. Ele pode conter variáveis de impressão que serão atualizadas quando a impressão for finalizada. Para saber mais acesse o item [Variáveis de impressão](https://tdn.totvs.com/pages/viewpage.action?pageId=152802071).
2. **Renderizador de impressão de PDF:** se você não possuir uma impressora instalada e configurada no computador, a plataforma utilizará o renderizador escolhido para gerar um arquivo PDF que normalmente é aberto automaticamente pelo próprio navegador em uma nova aba. Assim você pode salvar o documento e imprimi-lo posteriormente ou apenas mantê-lo. Se a impressão parecer desconfigurada com o renderizador padrão (PDFRenderer), altere para a opção JPedal e tente novamente.
3. **Marca d'água:** Marca d'água que será incluída nas cópias impressas, se desejado. O cadastro da marca d'água é realizado no recurso [Marca d'água](https://tdn.totvs.com/pages/viewpage.action?pageId=234455302) do Painel de controle. 
Importante: A marca d'água selecionada será aplicada somente nos documentos que não possuem marca definida. Para ver a marca d'água de cada documento, verifique a seção **Documentos selecionados para imprimir cópia controlada**. Caso desejado, para alterar a marca definida, acesse as propriedades do documento.
4. **Área(s) Destino:** são as áreas para as quais a impressão será feita. Esse campo é obrigatório. Cadastre pelo menos uma área. Para saber como fazer isso, acesse a documentação sobre [Áreas](http://tdn.totvs.com/x/w4D5DQ).
5. **Documentos selecionados para imprimir cópia controlada:** Nessa lista são apresentados os documentos que serão impressos, bem como a marca d'água a ser aplicada a cada um deles.
6. **Imprimir cópia controlada:** ao acionar esse botão, a impressão será feita.
![](..\..\images\C%C3%B3pia%20com%20marca%20dagua.png)
# Recursos adicionais
---
A impressão de cópia controlada foi desenvolvida inicialmente com o recurso de *applets*, porém este recurso atualmente está disponível somente para o navegador Internet Explorer. Os navegadores Google Chrome (versão 45 ou superior) e Mozilla Firefox (versão 52 ou superior) não suportam mais a execução dos plugins NPAPI necessários.
Este recurso possibilita identificar qual impressora foi selecionada e também definir o número de cópias emitidas.
Caso você deseje utilizar essas opções é necessário atender os requisitos a seguir:
- Configurar o [Ambiente de execução do Java®](https://tdn.totvs.com/pages/viewpage.action?pageId=75271469) no computador do usuário que fará a impressão;
- Utilizar o navegador Internet Explorer. Acesse a [Matriz de Portabilidade](http://tdn.totvs.com/x/_ApbB) para saber qual é a versão homologada;
- Marcar a opção "Habilita applet" em Painel de Controle > Parâmetros. Para saber mais sobre essa tela acesse a documentação sobre [Parâmetros](http://tdn.totvs.com/x/goH5DQ).
Quando a opção "Habilita applet" está marcada no Painel de Controle > Parâmetros, você NÃO conseguirá fazer a impressão através dos navegadores Firefox ou Chrome. Ao tentar fazer isso, será apresentada a mensagem "Não foi possível carregar applet".
Nesse caso, você poderá apenas fazer a impressão através do Internet Explorer.
Se quiser fazer a impressão através dos outros navegadores, desabilite a opção. Lembrando que nesse caso, a informação de qual impressora foi selecionada, não será registrada.
Importante
Informamos que o Office 365 não encontra-se no rol de versões homologadas pelo TOTVS Fluig Plataforma.
# Log de cópia controlada
---
O log de cópia controlada é o registro das informações de cada impressão de cópia controlada. Esse registro é importante, pois oferece total controle e rastreabilidade sobre as cópias.
Para saber como consultar esse log acesse a documentação de [Log de cópia controlada](http://tdn.totvs.com/x/-YD5DQ).
# Compatibilidade de impressão com o MS Office
---
Por padrão o TOTVS Fluig Plataforma utiliza o OpenOffice como motor padrão para a impressão de documentos, ou seja, é possível que determinados documentos não sejam impressos exatamente como são visualizados no MS Office.
Para que o MS Office seja o motor padrão de impressão é necessário fazer a [Configuração dos serviços de componentes](http://tdn.totvs.com/x/eiH2Dw). Não é necessário reiniciar a plataforma após a configuração. Basta fazer uma nova impressão.
**oculto**
**Observação KCS:** Informação duplicada no artigo <https://centraldeatendimento.fluig.com/hc/pt-br/articles/360033839533>.
Caso seja feita alguma atualização, lembrar de atualizar o artigo!
# Variáveis de impressão e visualização
---
É possível configurar variáveis nos documentos que serão atualizadas durante a visualização ou durante a impressão (quando o documento for utilizado como protocolo). As variáveis podem informar a versão do documento, publicador ou a data de publicação, por exemplo.
## Pré-requisitos
---
Para que as variáveis sejam atualizadas é necessário que a opção *"*Atualiza Propriedades Cópia Controlada?" localizada na aba Informações Gerais das propriedades do documento esteja marcada.
Essa opção pode ser alterada manualmente durante ou após a publicação ou pode estar configurada nas propriedades herdadas da pasta, para que seja marcada automaticamente durante a publicação.
## Configuração de atualização das variáveis
---
Para marcar essa opção manualmente, durante a publicação de documento avançado ou na edição de propriedades após a publicação, acione a aba **Informações Gerais** e marque a opção **Atualiza Propriedades de Cópia Controlada?**.
![](..\..\images\image2018-11-26_15-26-16.png)
Para fazer a configuração automática, acione as propriedades da pasta. Acesse a aba **Propriedades Herdadas** e marque a opção **Atualiza propriedades de Cópia Controlada?**.
![](..\..\images\image2018-11-26_15-33-28.png)
## Variáveis de visualização
---
As variáveis de visualização são atualizadas sempre que o documento é aberto e visualizado dentro da plataforma. Confira a lista de informações que podem ser adicionadas ao documento:
| Variável | Descrição |
| --- | --- |
| Document.Author | Autor do documento |
| Document.Author.ID | Matricula do autor do documento |
| Document.Author.Name | Nome do autor do documento |
| Document.Active | Documento ativo |
| Document.ID | Código do documento |
| Document.Publisher | Publicador do documento |
| Document.Publisher.ID | Matricula do publicador do documento |
| Document.Publisher.Name | Nome do publicador do documento |
| Document.Version | Versão do documento |
| Document.Revision | Revisão do documento |
| Document.Description | Descrição do documento |
| Document.Comments | Comentários do documento |
| Document.VersionDescription | Descrição da Versão/Revisão |
| Document.Tag | Tags do documento |
| Document.ApprovedOn | Data que o documento foi aprovado |
| Document.CreationDate | Data de criação do documento |
| Document.ExpiresOn | Data de expiração do documento |
| Document.FirstVersionDate | Data da primeira versão |
| Document.LastUpdateDate | Data da última atualização |
| Document.Approvers1, Document.Approvers2, Document.ApproversN | Aprovador do nível 1. O N representa qual aprovador a ser retornado: o 1 retorna o primeiro aprovador, o 2 retorna o segundo e assim sucessivamente, especificamente do nível 1. |
| Document.Level2.Approver1, Document.Level2.Approver2, Document.LevelN.ApproverN | Aprovador do nível N. O N em *Level* representa qual nível deve ser retornado, e o N em *Approver* representa qual aprovador a ser retornado. Por exemplo: Document.Level2.Approver1 retorna o primeiro aprovador do nível 2. |
## Variáveis de impressão
---
As variáveis de impressão são atualizadas somente no documento protocolo quando a impressão é concluída. Essas variáveis não são atualizadas quando o documento é visualizado dentro da plataforma.
Nesse caso, se você tentar visualizar um documento que possui variáveis de impressão, ela será exibida como no exemplo abaixo.
![](..\..\images\image2018-11-26_15-40-7.png)
Confira a lista de informações que podem ser adicionadas ao documento:
| Variável | Descrição |
| --- | --- |
| Document.PrintDate | Data da impressão |
| Document.PrintRequester | Requisitante/Solicitante |
| Document.PrintedDocument.AreaResponsible | Responsável pela área |
| Document.PrintedDocument.Description | Descrição do documento |
| Document.PrintedDocument.Comments | Comentários do documento |
| Document.PrintedDocument.VersionDescription | Descrição da Versão/Revisão |
| Document.PrintedDocument.Tag | Tags do documento |
| Document.DocumentNrDocumento | Número do documento |
| Document.PrintedDocument.Version | Versão do documento |
| Document.PrintedDocument.Revision | Revisão do documento |
| Document.DestinationArea | Área |
| Document.PrintedDocument.Publisher | Publicador do documento |
| Document.PrintedDocument.VersionDescription1 | Descrição da versão do documento |
| Document.PrintedDocument.VersionDescription2 | Continuação da descrição da versão do documento |
| Document.PrintedDocument.VersionDescription3 | Continuação da descrição da versão do documento |
Atenção
É padrão do próprio MS Office limitar as propriedades dos documentos em 127 caracteres durante a visualização ou impressão.
## Eventos de documentos
---
Os eventos [onApplyDocumentPrintProperties](http://tdn.totvs.com/display/fluig/Eventos+de+Documentos#EventosdeDocumentos-onApplyDocumentPrintProperties) e [onApplyDocumentProtocolProperties](http://tdn.totvs.com/display/fluig/Eventos+de+Documentos#EventosdeDocumentos-onApplyDocumentProtocolProperties) podem ser utilizados para atualizar ou recuperar as informações das variáveis configuradas nos documentos.
Veja também o exemplo (**interacting-with-copy-controlled-properties**) disponível no repositório do TOTVS Fluig Plataforma clicando **[aqui](https://git.fluig.com/projects/SAMPLES/repos/projetos/browse/interacting-with-copy-controlled-properties)**.
## Configurar variáveis
---
### Microsoft Word
Com o documento aberto no Microsoft Word, posicione o cursor no local onde a variável deve ser incluída.
Pressione **CTRL + F9** e preencha o espaço entre as chaves (**{ }**) como no exemplo abaixo:
![](..\..\images\variaveis.gif)
### Microsoft Excel
- Com o documento aberto no Microsoft Excel, clique com o botão direito do mouse sobre **qualquer coluna** conforme a necessidade (1), em seguida acione a opção **Inserir** (2). Para demonstrar esse recurso, utilizaremos a Coluna A:
![](..\..\images\image2018-11-26_17-0-49.png)
- Preencha as células da **coluna escolhida** no passo anterior, com um nome que identificará as variáveis que você escolheu. Por exemplo, **Publicador** e **Data**.
![](..\..\images\image2018-11-26_17-4-41.png)
- Clique na célula da primeira variável (A2 usada neste exemplo abaixo) e em seguida digite o valor Document.Publisher (ou a variável escolhida) na **Caixa de Nome**;
- Pressione ***enter*** para salvar;
- Faça o mesmo nas demais células, informando na caixa de nome a variável escolhida.
![](..\..\images\image2018-11-26_17-9-34.png)
- Clique sobre a célula que deverá ser atualizada com o valor da variável;
- Digite "=" e em seguida clique sobre a célula da variável configurada no passo anterior;
- Pressione ***enter*** para salvar;
- Faça o mesmo com as demais células;
- Salve o documento.
![](..\..\images\image2018-11-26_17-12-31.png)
- Clique com o botão direito do mouse sobre a coluna de variáveis que foi criada no passo 1;
- Aciona a opção **Ocultar** para que a coluna não seja exibida;
- Salve o documento.
![](..\..\images\image2019-10-18_10-34-5.png)
Confira o passo a passo completo do exemplo que acabamos de fazer:
![](..\..\images\variaveis_excel.gif)
Atenção!
Lembrando que, a partir do pacote de atualização da release **fluig 1.7.1-220719 -****Crystal Lake****,** em arquivos da ferramenta Excel é possível inserir variáveis em **qualquer coluna ou planilha.**