Edit and Manage Metadata in Node.js Apps

Gerenciar metadados é uma parte importante da automação de documentos, especialmente para aplicações que trabalham com diferentes formatos de documentos. Neste artigo, vamos olhar como gerenciar metadados em aplicações Node.js, com foco na extração, modificação e remoção de metadados.

Neste guia, iremos explorar as seguintes seções:

What is GroupDocs.Metadata and how it helps?
Como instalar
Quick start guide
Key Features
Common Use Cases
Getting Started with a Free Trial
See Also

What is GroupDocs.Metadata and how it helps?

GroupDocs.Metadata for Node.js é uma biblioteca que ajuda os desenvolvedores a gerenciar metadados em vários formatos de documentos em aplicações Node.js.

Embora existam métodos nativos que permitem aos desenvolvedores do Node.js extrair metadados básicos, como tamanho de arquivo, tipo e atributos, esses métodos não cobrem metadados mais complexos associados a formatos de arquivo específicos.

GroupDocs.Metadata preenche essa lacuna permitindo que os usuários recuperem, atualizem e removam metadados de arquivos como PDFs, formatos do Microsoft Office, imagens, áudio, vídeo e muitos outros. Também permite o acesso a informações detalhadas, como o autor, título, propriedades específicas de formatos de arquivo, incluindo dados de localização GPS, e muitos outros. Com uma API direta, o GroupDocs.Metadata permite que você manipule metadados de forma eficaz para cobrir muitos cenários de automação de documentos e processamento de dados.

Como instalar

GroupDocs.Metadata for Node.js via Java está hospedado no NPM. Você pode facilmente referenciar nossa API em seu projeto Node.js instalando-a com o seguinte comando:

npm install @groupdocs/groupdocs.metadata

Guia de início rápido

Getting started with GroupDocs.Metadata for Node.js é rápido e direto com nosso projeto de exemplos. Aqui está um guia simples para ajudá-lo a configurar:

Clone o Repositório: Clone o repositório de exemplo para sua máquina local.

git clone https://github.com/groupdocs-metadata/GroupDocs.Metadata-for-Node.js-via-Java.git

Navegue até a Pasta de Exemplos:

cd ./GroupDocs.Metadata-for-Node.js-via-Java/

Instale Pacotes Necessários:
```
npm install   
```
Run the Examples:
```
node runExamples.js 
```

Isso irá executar uma série de scripts de exemplo demonstrando várias funcionalidades da biblioteca GroupDocs.Metadata.

Principais Recursos

GroupDocs.Metadata for Node.js está equipado com uma variedade de recursos que o tornam uma API útil para desenvolvedores que lidam com metadados de documentos. Aqui estão alguns dos principais recursos:

Conjunto Rico de Recursos de Gerenciamento de Metadados: Ler, atualizar e remover metadados de vários formatos de documento.
Manipulação de Propriedades Direcionadas: Pesquisar, atualizar e excluir propriedades de metadados específicas que atendem a certos critérios.
Gestão Unificada de Propriedades: Utilize tags para facilitar a manipulação de propriedades de metadados comuns de maneira consistente.
Support for Password-Protected Documents: Work with documents that are secured, ensuring flexibility even with sensitive data.
Insight into Document Properties: Extrair informações detalhadas sobre páginas ocultas, assinaturas digitais, comentários de usuários, revisões e mais.
Compatibilidade com Padrões Populares: Trabalhe com os principais padrões de metadados, como IPTC, XMP, EXIF e Image Resources.
Manipulação de Metadados Multimídia: Manipule as propriedades nativas de metadados em vários formatos e extraia informações técnicas de arquivos multimídia.
Cálculo de Estatísticas do Documento: Calcule estatísticas comuns do documento como contagem de palavras e contagem de caracteres para seus documentos.
Detecção de Formato de Arquivo: Identifique o formato e o tipo MIME de um arquivo com base em sua estrutura interna.
Suporte para Tags de Áudio: Gerencie várias tags de áudio, incluindo ID3, Letras e APE.

Casos de Uso Comuns

Abaixo estão alguns casos de uso comuns para GroupDocs.Metadata em aplicações Node.js, juntamente com trechos de código correspondentes.

Use Case 1: Recuperar metadados de uma imagem

Neste exemplo, vamos buscar propriedades de metadados de um arquivo de imagem (por exemplo, image.png) com base em critérios específicos.

Initialize o Objeto de Metadados: Crie uma nova instância da classe Metadata com seu arquivo.
Defina Critérios de Busca: Utilize uma especificação de busca para encontrar propriedades específicas, como “Largura” ou “Altura.”
Buscar e Exibir Metadados: Recupere as propriedades correspondentes e registre seus nomes e valores.

const groupdocsMetadata = require('@groupdocs/groupdocs.metadata');

try {
    // Initialize the Metadata object with the image file
    const metadata = new groupdocsMetadata.Metadata("image.png");

    // Fetch properties based on name criteria: Width or Height
    var searchSpecification = new groupdocsMetadata.WithNameSpecification("Width")
        .or(new groupdocsMetadata.WithNameSpecification("Height"));
    var metadataProperties = metadata.findProperties(searchSpecification);

    console.log(`Total found properties#: ${metadataProperties.getCount()}`);    

    // Iterate and log all found properties
   for (var i = 0; i < metadataProperties.getCount(); i++) {
        console.log(`Property name: ${metadataProperties.get_Item(i).getName()}, 
        Property value: ${metadataProperties.get_Item(i).getValue()}`);
    }
} catch (error) {
    console.error('An error:', error);
}

Use Case 2: Limpar os metadados de um documento

Aqui vamos limpar metadados indesejados de um documento PDF.

Carregue o PDF: Crie um objeto Metadata para o arquivo PDF.
Sanitizar Metadados: Remover pacotes de metadados detectados.
Salvar o Documento Limpo: Salvar o documento sanitizado em um novo arquivo.

try {
    // Load the PDF file
    const metadata = new groupdocsMetadata.Metadata("input.pdf");

    // Remove detected metadata packages and log the properties removed
    var affected = metadata.sanitize();
    console.log(`Properties removed: ${affected}`);

    // Save the cleaned PDF
    metadata.save("cleaned_output.pdf");
} catch (error) {
    console.error('An error occurred during the sanitization:', error);
}

Use Case 3: Atualizar metadados do documento

Este exemplo mostrará como atualizar as datas de criação e modificação de um documento.

Carregue o Documento: Inicialize um objeto Metadata para o arquivo do documento.
Defina Novas Propriedades: Atualize as datas de criação e modificação do documento.
Salvar o Documento Atualizado: Salve as alterações no arquivo.

try {
    // Load the VSDX file
    const metadata = new groupdocsMetadata.Metadata("input.vsdx");

    // Set the current date for creation and modification properties
    var affected = metadata.setProperties(
        new groupdocsMetadata.ContainsTagSpecification(
                groupdocsMetadata.Tags.getTime().getCreated())
            .or(new groupdocsMetadata.ContainsTagSpecification(
                groupdocsMetadata.Tags.getTime().getModified())),
        new groupdocsMetadata.PropertyValue(new Date())
    );

    console.log(`Properties set: ${affected}`);

    // Save the updated VSDX
    metadata.save("updated_output.vsdx");
} catch (error) {
    console.error('An error occurred:', error);
}

Começando com um Teste Gratuito

Por padrão, a biblioteca opera no modo de teste sem uma licença, permitindo que você explore suas características e funcionalidades básicas da biblioteca. Você pode baixar o GroupDocs.Metadata for Node.js via Java na página de Lançamentos do GroupDocs.

Além disso, você pode adquirir uma licença temporária neste link.A licença temporária permite que você use a biblioteca sem nenhuma restrição e explore totalmente suas capacidades.

What is GroupDocs.Metadata and how it helps?#

Como instalar#

Guia de início rápido#

Principais Recursos#

Casos de Uso Comuns#

Use Case 1: Recuperar metadados de uma imagem#

Use Case 2: Limpar os metadados de um documento#

Use Case 3: Atualizar metadados do documento#

Começando com um Teste Gratuito#

See Also#