Integrar em uma aplicação web ASP.NET Core permite edição de documentos sem interrupções diretamente no seu portal web. GroupDocs.Editor Cloud SDK for .NET fornece uma API poderosa que permite carregar, editar e salvar arquivos DOCX no servidor. Este guia orienta você na configuração necessária, mostra código passo a passo e fornece um exemplo completo que pode ser executado em minutos. Ao final, você será capaz de adicionar edição de documentos a uma aplicação ASP.NET Core com confiança.

Pré-requisitos e Configuração

Antes de começar, certifique‑se de que você tem o seguinte:

  • SDK .NET 6.0 ou posterior instalado
  • Uma IDE como Visual Studio 2022 ou VS Code
  • Uma conta do GroupDocs Cloud para obter Client Id e Client Secret
  • Acesso a uma máquina de desenvolvimento Windows, Linux ou macOS

Integrar em uma aplicação web ASP.NET Core também requer uma conexão de rede confiável com os endpoints do GroupDocs Cloud, pois todo o processamento de documentos ocorre remotamente. Planeje seu ambiente de implantação de acordo.

Instale o SDK via NuGet:

dotnet add package GroupDocs.editor-Cloud

Baixe o pacote mais recente na página oficial de lançamentos: GroupDocs.Editor Cloud SDK for .NET Download.

Crie um objeto de configuração com suas credenciais (trecho do exemplo completo):

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

Com o pacote instalado e as credenciais prontas, você pode prosseguir para a implementação. As próximas seções explicam cada trecho de código em detalhes, para que você entenda como a biblioteca se encaixa na arquitetura geral de uma aplicação web ASP.NET Core.

Guia passo a passo para integrar em uma aplicação web ASP.NET Core

Esta seção detalha o processo de integração em um aplicativo web ASP.NET Core em etapas discretas e gerenciáveis. Cada etapa inclui um pequeno fragmento de código extraído diretamente da implementação de referência.

Etapa 1: Configurar credenciais da API

Primeiro, instancie o objeto Configuration com os detalhes do seu cliente e crie o cliente EditorApi.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

A classe EditorApi está documentada na referência da API. Inicializar o cliente uma vez por solicitação é suficiente para a maioria dos cenários; você também pode registrá‑lo como singleton no contêiner de injeção de dependência do ASP.NET Core para melhorar o desempenho.

Etapa 2: Definir Opções de Carregamento

Especifique o arquivo de origem e o local de saída desejado usando LoadOptions. Este objeto informa ao serviço qual documento abrir e onde armazenar o HTML renderizado.

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

LoadOptions, FileInfo e RenderOptions permitem que você controle como o documento é renderizado para edição. Por exemplo, você pode definir RenderOptions para incluir imagens, preservar estilos originais ou limitar o número de páginas renderizadas.

Etapa 3: Chamar LoadDocument

Invocar a API para carregar e converter o documento. A chamada é síncrona neste exemplo, mas você também pode usar a versão assíncrona se sua ação de controlador for assíncrona.

var loadResult = editorApi.LoadDocument(loadOptions);

O método LoadDocument retorna um objeto de resultado contendo URLs para o HTML renderizado e outros metadados. Você pode armazenar o loadResult para recuperação posterior ou passar o HTML diretamente para o front‑end.

Etapa 4: Processar Resultado de Carregamento

Depois de carregar, você pode servir o HTML para o front‑end ou armazená‑lo para uso posterior. Esta etapa conclui o integrando o editor de documentos em um aplicativo web ASP.NET Core fluxo de trabalho e prepara o documento para a interação do usuário.

Em um cenário real, você normalmente retornaria o conteúdo HTML de uma ação de controlador:

return Content(loadResult.HtmlContent, "text/html");

Você também pode querer implementar cache para evitar recarregar o mesmo documento repetidamente, o que pode melhorar os tempos de resposta ao integrating into an ASP.NET Core web application em escala.

Integrando Document Editor em uma Aplicação Web ASP.NET Core - Exemplo de Código Completo

O código a seguir demonstra todo o processo, desde a configuração até o carregamento de um arquivo DOCX.

var configuration = new Configuration
{
    ClientId = "client_id",
    ClientSecret = "client_secret"
};

var editorApi = new EditorApi(configuration);

var loadOptions = new LoadOptions
{
    FileInfo = new FileInfo { FilePath = "input.docx" },
    RenderOptions = new RenderOptions { OutputPath = "output.html" }
};

var loadResult = editorApi.LoadDocument(loadOptions);

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter ajuda.

Usando cURL para Integração de Edição de Documentos ASP.NET Core

Se você preferir uma abordagem REST direta, a mesma operação pode ser realizada com comandos cURL. Esse método é útil para prototipagem rápida ou quando você precisa integrar o editor em um serviço que não foi escrito em .NET.

1. Autenticar e Obter Token de Acesso

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

A resposta contém um access_token usado nas chamadas subsequentes.

2. Carregar o Arquivo Fonte

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/storage/upload?path=/input.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.docx"

3. Carregar o Documento para Edição

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.docx" },
           "renderOptions": { "outputPath": "output.html" }
         }'

4. Baixar o HTML renderizado

curl -X GET "https://api.groupdocs.cloud/v2.0/editor/storage/download?path=/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Esses comandos ilustram como adicionar edição de documentos a uma aplicação ASP.NET Core sem escrever nenhum código C#, útil para testes rápidos ou integração com outros serviços. Para mais detalhes, veja a documentação oficial da API.

Ao dominar tanto a biblioteca .NET quanto a API REST bruta, você ganha flexibilidade ao integrar em uma aplicação web ASP.NET Core, permitindo escolher a abordagem que melhor se adapta à sua arquitetura.

FAQs

Leitura adicional