ASP.NET Core 웹 애플리케이션에 통합하면 웹 포털 내에서 원활한 문서 편집이 가능해집니다. GroupDocs.Editor Cloud SDK for .NET은 서버에서 DOCX 파일을 로드, 편집 및 저장할 수 있는 강력한 API를 제공합니다. 이 가이드는 필요한 설정 과정을 단계별 코드와 함께 안내하고, 몇 분 안에 실행할 수 있는 완전한 예제를 제공합니다. 끝까지 읽으면 ASP.NET Core 애플리케이션에 자신 있게 문서 편집 기능을 추가할 수 있습니다.

필수 조건 및 설정

시작하기 전에 다음 항목을 확인하십시오:

  • .NET 6.0 SDK 또는 이후 버전이 설치됨
  • Visual Studio 2022 또는 VS Code와 같은 IDE
  • GroupDocs Cloud 계정(Client Id 및 Client Secret을 얻기 위해)
  • Windows, Linux 또는 macOS 개발 머신에 대한 액세스

ASP.NET Core 웹 애플리케이션에 통합하려면 모든 문서 처리가 원격으로 수행되므로 GroupDocs Cloud 엔드포인트에 대한 안정적인 네트워크 연결이 필요합니다. 배포 환경을 적절히 계획하십시오.

NuGet을 통해 SDK를 설치합니다:

dotnet add package GroupDocs.editor-Cloud

공식 릴리스 페이지에서 최신 패키지를 다운로드하세요: GroupDocs.Editor Cloud SDK for .NET 다운로드.

자격 증명을 사용하여 구성 객체를 생성합니다 (전체 예제에서 발췌):

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

패키지를 설치하고 자격 증명을 준비했으면 구현 단계로 넘어갈 수 있습니다. 다음 섹션에서는 코드의 각 부분을 자세히 설명하므로 라이브러리가 ASP.NET Core 웹 애플리케이션의 전체 아키텍처에 어떻게 맞춰지는지 이해할 수 있습니다.

ASP.NET Core 웹 애플리케이션에 통합하기 위한 단계별 가이드

이 섹션에서는 ASP.NET Core 웹 애플리케이션에 통합하는 과정을 개별적이고 관리 가능한 단계로 나눕니다. 각 단계에는 참조 구현에서 직접 가져온 짧은 코드 조각이 포함됩니다.

1단계: API 자격 증명 구성

먼저, 클라이언트 세부 정보를 사용하여 Configuration 객체를 인스턴스화하고 EditorApi 클라이언트를 생성합니다.

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

var editorApi = new EditorApi(configuration);

EditorApi 클래스는 API reference에 문서화되어 있습니다. 대부분의 시나리오에서는 요청당 클라이언트를 한 번 초기화하면 충분합니다; 더 나은 성능을 위해 ASP.NET Core 의존성 주입 컨테이너에 싱글톤으로 등록할 수도 있습니다.

2단계: 로드 옵션 정의

LoadOptions를 사용하여 원본 파일과 원하는 출력 위치를 지정합니다. 이 객체는 서비스에 어떤 문서를 열고 렌더링된 HTML을 어디에 저장할지 알려줍니다.

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

LoadOptions, FileInfo, 및 RenderOptions를 사용하면 문서가 편집을 위해 렌더링되는 방식을 제어할 수 있습니다. 예를 들어, RenderOptions를 설정하여 이미지를 포함하고, 원본 스타일을 보존하거나, 렌더링되는 페이지 수를 제한할 수 있습니다.

3단계: LoadDocument 호출

API를 호출하여 문서를 로드하고 변환합니다. 이 예제에서는 호출이 동기식이지만, 컨트롤러 액션이 비동기인 경우 비동기 버전을 사용할 수도 있습니다.

var loadResult = editorApi.LoadDocument(loadOptions);

LoadDocument 메서드는 렌더링된 HTML 및 기타 메타데이터에 대한 URL을 포함하는 결과 객체를 반환합니다. loadResult를 저장하여 나중에 검색하거나 HTML을 직접 프런트‑엔드에 전달할 수 있습니다.

4단계: 로드 결과 처리

로드한 후, HTML을 프런트‑엔드에 제공하거나 나중에 사용할 수 있도록 저장할 수 있습니다. 이 단계는 ASP.NET Core 웹 앱에 문서 편집기 통합 워크플로를 완료하고 문서를 사용자 상호 작용을 위해 준비합니다.

실제 시나리오에서는 일반적으로 컨트롤러 액션에서 HTML 콘텐츠를 반환합니다:

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

또한 동일한 문서를 반복적으로 다시 로드하는 것을 방지하기 위해 캐싱을 구현하는 것이 좋으며, 이는 대규모로 integrating into an ASP.NET Core web application 할 때 응답 시간을 개선할 수 있습니다.

ASP.NET Core 웹 애플리케이션에 문서 편집기 통합 - 전체 코드 예제

다음 코드는 구성 단계부터 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);

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

ASP.NET Core 문서 편집 통합을 위한 cURL 사용

직접 REST 방식을 선호한다면, 동일한 작업을 cURL 명령으로 수행할 수 있습니다. 이 방법은 빠른 프로토타이핑이나 .NET으로 작성되지 않은 서비스에 편집기를 통합해야 할 때 유용합니다.

1. 인증 및 액세스 토큰 가져오기

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"}'

응답에는 이후 호출에서 사용되는 access_token이 포함됩니다.

2. 소스 파일 업로드

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. 문서를 편집하기 위해 로드

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. 렌더링된 HTML 다운로드

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

이 명령은 ASP.NET Core 애플리케이션에 문서 편집을 추가하는 방법을 보여주며, C# 코드를 작성하지 않고도 빠른 테스트나 다른 서비스와의 통합에 유용합니다. 자세한 내용은 공식 API 문서를 참조하십시오.

.NET 라이브러리와 순수 REST API를 모두 마스터하면, ASP.NET Core 웹 애플리케이션에 통합할 때 유연성을 얻을 수 있으며, 아키텍처에 가장 적합한 접근 방식을 선택할 수 있습니다.

자주 묻는 질문

추가 읽을거리