APIs, modelos e automações documentais
Exemplos REST, modelo XML de aspecto e desenho de regras para classificação documental.
Referência técnica; exemplos sujeitos à compatibilidade da versão.
Tipos definem a estrutura de um nó. Aspectos acrescentam propriedades e comportamentos reutilizáveis. Use APIs documentadas para integrar aplicações e evite escrita direta nas tabelas internas.
REST oferece recursos próprios do Alfresco; CMIS é uma interface padronizada entre repositórios. Use contas técnicas com permissões proporcionais e mantenha credenciais no servidor de integração.
# URL e usuário ilustrativos. O curl pedirá a senha.
curl --fail --show-error --user usuario_integracao \
'https://ged.exemplo.com.br/alfresco/api/-default-/public/alfresco/versions/1/nodes/-shared-/children?maxItems=25'# Substituir o UUID e o arquivo. Operação de escrita no destino informado.
curl --fail --show-error --user usuario_integracao \
-F 'filedata=@documento.pdf;type=application/pdf' \
-F 'name=documento.pdf' \
-F 'nodeType=cm:content' \
'https://ged.exemplo.com.br/alfresco/api/-default-/public/alfresco/versions/1/nodes/UUID_DA_PASTA/children'Exemplos de contrato para adaptar e testar. Não incluem política de repetição ou deduplicação; repetir upload pode criar duplicatas ou conflito.
Modelo documental e automações possíveis
| Necessidade | Desenho de implementação | Validação |
|---|---|---|
| Título = Tipo Documental | Propriedade de classificação + comportamento ou ação que atualiza cm:title | Definir o rótulo desejado e executar ao criar e ao alterar o tipo; evitar recursão. |
| Dossiê por colaborador | Modelo com matrícula/identificador; pasta e permissões criadas por serviço | Usar chave estável, tratar homônimos e mudança de nome; evitar duplicação. |
| Ativo/inativo e demissão | Aspecto com estado e data; regras de acesso e pesquisa | Definir transições e quem pode alterar os campos. |
| Temporalidade | Classe, evento inicial, prazo e destinação em modelo + serviço de cálculo | Validar tabela aplicável e eventos; expurgo deve ter processo de autorização. |
| OCR e PDF pesquisável | Pipeline de captura/qualidade antes de publicar ou serviço assíncrono | Preservar relação com original e medir precisão; OCR não é assinatura. |
| Assinatura em lote | Serviço de assinatura controlado e retorno de arquivo/evidências | Controlar identidade, segredo e uso do certificado; validar a assinatura resultante. |
| ERP / CRM / portal | Adaptador REST/CMIS e fila de integração | Idempotência, auditoria, isolamento por cliente e recuperação de falhas. |
| Activiti / Camunda | Integração de processos por APIs/eventos conforme desenho | São componentes com ciclos próprios; não basta instalar um AMP para trocar motor. |
As soluções da tabela são propostas de engenharia, não funções já instaladas neste portal ou em seu servidor. A auditoria do Alfresco deve ser configurada para os eventos necessários; não presuma que toda leitura/alteração já esteja registrada.
Fontes: API Explorer ↗ · CMIS API ↗
Exemplo de aspecto documental
Modelo XML didático para empacotar em uma extensão compatível. O namespace identifica este exemplo da Arquindex; não depende de existir uma página web nesse endereço.
<?xml version="1.0" encoding="UTF-8"?>
<model name="arq:documental" xmlns="http://www.alfresco.org/model/dictionary/1.0">
<description>Exemplo didático de classificação documental</description>
<author>Arquindex</author><version>1.0</version>
<imports>
<import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d"/>
<import uri="http://www.alfresco.org/model/content/1.0" prefix="cm"/>
</imports>
<namespaces><namespace uri="https://arquindex.com.br/model/documental/1.0" prefix="arq"/></namespaces>
<aspects>
<aspect name="arq:classificacao">
<title>Classificação documental</title>
<properties><property name="arq:tipoDocumental">
<title>Tipo documental</title><type>d:text</type>
</property></properties>
</aspect>
</aspects>
</model>O XML precisa de registro/bootstrap no módulo, build e teste de implantação. Depois de carregar o modelo, pode-se aplicar o aspecto aos documentos. O modelo sozinho não cria telas de edição nem sincroniza o título.
Baixar exemplo: modelo-documental.xml · Trecho didático para adaptar; não é um instalador completo.