이전 통합

이 섹션은 기존 .NET Standard 애플리케이션이 여전히 Viewer 를 수동으로 구성하고, 미들웨어에 옵션을 전달하며, 공유 폴더를 통해 웹 팜을 조정하거나 뷰어 스크립트를 애플리케이션에 복사할 때 사용합니다. 해당 아키텍처는 아직 마이그레이션하지 않은 고객을 위해 문서화되어 있습니다.

패키지 버전은 세대를 식별합니다

패키지 ID만으로는 충분하지 않습니다. 두 세대 모두 Doconut.NETStandard 로 게시됩니다:

프로젝트 파일, 잠금 파일, 또는 캐시된 .nupkg 에서 버전을 확인한 후 매뉴얼을 선택하십시오. 단순히 Doconut.NETStandard 라고만 적힌 패키지 참조는 코드가 어떤 API를 대상으로 작성되었는지 알려주지 않습니다.

이전 통합 식별

애플리케이션이 이전 통합을 사용하고 있는 경우, 다음 서명 중 하나 이상을 포함하고 있습니다:

var viewer = new Viewer(_cache, _accessor);
var viewer = new Viewer(_cache, _accessor, licenseFilePath);

var token = viewer.OpenDocument(path, config, documentOptions);
viewer.InitCache();

appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

appBranch.UseDoconutWebFarm(new WebFarmOptions { Path = sharedFolder });

Viewer.DoconutLicense(licenseStream);
Viewer.SetLicensePlugin(pluginLicenseStream);

var converter = viewer.Converter.GetConverter();

using 블록은 또 다른 신뢰할 수 있는 신호입니다 — 구성 타입이 여러 네임스페이스에 걸쳐 분산되어 있었습니다:

using Doconut.Configs;
using Doconut.Configs.View;
using Doconut.Configs.Cloud;
using Doconut.Models;

이전 페이지에서는 일반적으로 애플리케이션 관리 복사본을 로드하기도 합니다:

docViewer.js
documentLinks.js
docViewer.UI.js

그리고 컨테이너 ID를 이름으로 하는 전역 변수로 뷰어 콜백을 선언합니다, 예를 들어 ctlDoc_OnViewerReady().

현재 통합은 대신 AddDoconut(), UseDoconutResources(), 인수가 없는 UseDoconut(), 주입된 Viewer, OpenDocumentAsync(), 그리고 평탄화된 Doconut 네임스페이스로 식별됩니다.

보존된 매뉴얼 열기

번역된 과거 매뉴얼은 레거시 .NET Standard 설정 에 남아 있습니다. 해당 URL은 리디렉션되거나 교체되지 않았으며, 이는 기존 애플리케이션이 여전히 사용하는 실제 통합 세대를 설명하기 때문입니다.

그 매뉴얼의 스니펫을 현재 AddDoconut() 문서와 결합하지 마십시오. 뷰어 구성, 미들웨어 라우팅, 라이선스, 리소스, 변환, 웹 팜 조정, 그리고 세션 소유권은 모두 다릅니다.

마이그레이션 계획

수동 구성 및 동기식 문서 열기에서 DI, 현재 미들웨어, 비동기 세션, 생성된 리소스, 분산 퍼블리싱, 그리고 기능 기반 플러그인으로의 검증된 매핑을 위해 .NET Standard 2.1 로 마이그레이션 를 사용하십시오.

시작하기 전에 주의해야 할 두 가지가 있습니다:

• 호스트 프레임워크. netstandard2.1 은 .NET Core 3.0 이상이 필요합니다. .NET Framework 호스트는 현재 패키지를 전혀 사용할 수 없습니다.
• 클라이언트 측 변경 사항. 그 중 두 가지는 조용히 실패합니다 — 서버는 계속 작동하고 브라우저 콘솔은 비어 있습니다. 이는 마이그레이션 가이드에 포함되어 있습니다.

현재 애플리케이션이 문서, 라이선스, 검색, 주석, 변환기, DICOM, 보안 및 롤백 테스트를 통과할 때까지 이전 배포를 그대로 유지하십시오.