Migrujte na .NET Standard 2.1
Přesuňte existující aplikaci Doconut.NETStandard z verze 26.7.0 na 26.8.0
Doconut má dvě odlišné integrace .NET Standard. Používají stejný Doconut.NETStandard název balíčku, takže určete generaci podle verze a API v aplikaci, než změníte balíčky, spuštění, licence nebo zdroje prohlížeče.
Verze je rozcestí
Obě generace publikují pod stejným ID balíčku. Pouze verze je odlišuje:
| Version | Target | API |
|---|---|---|
| 26.7.0 and below | netstandard2.0 | the previous API |
| 26.8.0 and above | netstandard2.1 | the current API |
Zvýšení čísla verze je aktualizace. Neexistuje samostatný balíček k instalaci a žádný kompatibilní shim — 26.8.0 má odlišnou API plochu. Očekávejte chyby při kompilaci po zvýšení; zbytek tohoto průvodce je jejich seznam.
Kterou integraci používáte?
| If the project contains… | Generation |
|---|---|
new Viewer(_cache, _accessor, ...) | Předchozí |
viewer.OpenDocument(...) (synchronous) | Předchozí |
viewer.InitCache() | Předchozí |
UseDoconut(new DoconutOptions { ... }) | Předchozí |
UseDoconutWebFarm(...) / WebFarmOptions | Předchozí |
Viewer.DoconutLicense(...) or Viewer.SetLicensePlugin(...) | Předchozí |
viewer.Converter.GetConverter() | Předchozí |
using Doconut.Configs; / using Doconut.Models; | Předchozí |
Manually copied docViewer.js, documentLinks.js, or docViewer.UI.js | Předchozí |
builder.Services.AddDoconut(...) | Aktuální |
app.UseDoconutResources() plus app.UseDoconut() with no arguments | Aktuální |
Viewer supplied by dependency injection | Aktuální |
await viewer.OpenDocumentAsync(...) | Aktuální |
Pokud se v jedné aplikaci objeví oba sloupce, považujte migraci za neúplnou. Neposílejte jeden dokumentový token přes zdroje nebo middleware z druhé generace.
Nejprve zkontrolujte hostitelský framework
Jedná se o pevnou bránu, ne o preferenci. Aktuální balíček cílí na netstandard2.1:
| Host | Can consume 26.8.0 |
|---|---|
| .NET Core 3.0 or later (including .NET 5/6/7/8) | Ano |
| .NET Framework, any version | Ne |
.NET Framework nemůže odkazovat na knihovnu netstandard2.1. Pokud aplikace běží na .NET Framework, zastavte se zde a místo toho použijte balíček Doconut.NETFramework; od verze 26.9.0 vyžaduje .NET Framework 4.7.2. Obě referenční aplikace pro toto vydání cílí na net8.0.
Před migrací
- Vytvořte větev a nasaditelnou zálohu existující aplikace.
- Zaznamenejte přesné verze jádra a pluginových balíčků.
- Inventarizujte každý volání
new Viewer(...), voláníInitCache(), volání načítání licence, mapováníUseDoconutWebFarm, řadič konverze, zkopírovaný skript Doconut, vlastní akci panelu nástrojů, zpětné volání vieweru a koncový bod pro otevření dokumentu. - Zachovejte aktuální soubory
.lica nasazovací tajemství mimo správu verzí. - Zaznamenejte reprezentativní sadu PDF, Office, obrázkových, CAD, e-mailových, DICOM, prohledávatelných, chráněných heslem a anotovaných dokumentů.
- Zaznamenejte existující časový limit relace, chování zabezpečení, fonty a nastavení platformy.
Migrujte jedno prostředí před změnou produkce. Aktuální integrace mění životnost služby, směrování požadavků, vlastnictví relace, doručování klientských zdrojů a — pokud provozujete farmu — jak stránky vůbec dosáhnou prohlížeče.
1. Jmenné prostory: téměř vše přesunuto do kořene
Konfigurační typy byly rozprostřeny ve čtyřech jmenných prostorech. Nyní jsou všechny v Doconut.
| Before | Now |
|---|---|
using Doconut.Configs.View; | using Doconut; |
using Doconut.Models; | using Doconut; |
using Doconut.Configs; | using Doconut; |
using Doconut.Configs.Cloud; | using Doconut.Clouds; |
using Doconut.Configs.Conversion; | unchanged |
using Doconut.Middleware; | unchanged |
Názvy typů se nezměnily: WordConfig, PdfConfig, ExcelConfig, CssConfig, ScriptConfig, CloudUploadConfig, AzureConfig, CDNConfig, FileShareConfig a zbytek je stále přítomen. Ve většině souborů je celé úpravy smazání dvou řádků using.
Doconut.Configs.Editor (BaseConfigEditor, PdfConfigEditor) byl odstraněn a nemá náhradu v tomto balíčku. Pokud vaše aplikace odkazovala na tyto typy, naplánujte tuto část samostatně a nepovažujte ji za součást této migrace.
2. Kompatibilita balíčků a licencí
Záměrně nahraďte nebo aktualizujte hlavní balíček; nespoléhejte se na identické ID balíčku při výběru nového API. Výchozí příkaz nainstaluje nejnovější stabilní verzi:
dotnet add package Doconut.NETStandardPro reprodukovatelnou migraci na verzi auditovanou tímto průvodcem předávejte verzi jako samostatnou volbu:
dotnet add package Doconut.NETStandard --version 26.9.0Udržujte všechny pluginy Doconut ve stejné verzi jako hlavní balíček — Doconut.NETStandard.Converter a Doconut.NETStandard.Dicom. Současná integrace načítá licence jednou během AddDoconut() s tímto předností:
LicenseStream > LicenseContent > LicensePath > automatic discoveryAutomatické vyhledávání hledá Doconut.Viewer.lic a doprovodné soubory Doconut.Viewer.<Capability>.lic. Předchozí statické volání Viewer.DoconutLicense(...) a Viewer.SetLicensePlugin(...) již nejsou aktuálním spouštěcím mechanismem a také není List<string> licenčních cest, které starý konstruktor Viewer akceptoval. Přesuňte licenci na DoconutOptions, udržujte doprovodné soubory pohromadě při použití automatického vyhledávání, po změně licence restartujte a ověřte schopnosti prostřednictvím IDoconutLicenseService.
Nepředpokládejte, že přítomnost staré licence pluginu dokazuje oprávnění pro aktuální sestavení pluginu. Testujte Viewer, Search, Annotation, Converter a DICOM samostatně s schválenými artefakty vydání.
3. Spuštění a injekce závislostí
Dříve byl Viewer vytvářen pro každý požadavek a možnosti byly předávány middleware:
// Předchozí integrace — pouze kontrast; nekompilujte to proti aktuálnímu SDK.
var viewer = new Viewer(_cache, _accessor);
// …
appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });Současná integrace zaregistruje Doconut jednou a získá Viewer z injekce závislostí:
builder.Services.AddDoconut(options =>
{
options.UnsafeMode = false; // všimněte si změny pravopisu: UnSafeMode → UnsafeMode
options.ShowDoconutInfo = false;
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // stav relace potřebuje mezipaměť (MVC/Razor Pages již přidávají jednu)
builder.Services.AddSession();
app.UseSession();
app.UseDoconutResources();
app.UseDoconut();Viewer je přechodná služba. Správce relací dokumentu a jeho cache vlastní dlouhodobější stav dokumentu, nikoli konkrétní injektovanou instanci Viewer.
Tři věci, které je třeba zachovat:
new Viewer(cache, accessor)již není. InjektujteDoconut.Viewerdo svého kontroleru, nebo použijte@inject Doconut.Viewer Viewerv Razor view.UseDoconutResources()nahrazuje ruční propojeníapp.UseMiddleware<EmbeddedResourceMiddleware>()a musí běžet před větví dokumentu.UnSafeMode→UnsafeMode. Přejmenování o jeden znak, které zachytí kompilátor.
Když je UnsafeMode false, SDK ověřuje token relace vůči původnímu požadavku, takže AddSession() / UseSession() musí být stále v pipeline, UseSession() před větví.
Metody, které již neexistují
| Před | Nyní |
|---|---|
viewer.OpenDocument(path, config, options) | await viewer.OpenDocumentAsync(path, config, options) |
viewer.InitCache() | odstraněno — neexistuje nic, co by se mělo ručně zahřívat; odstraňte volání a jakýkoli příznak „už jsem inicializoval?“ kolem něj |
viewer.ExportToPng(sharedPath) | viz §7 |
viewer.ExportToCloud(cloudConfig) | viz §7 |
using var v = new Viewer(...); v.CloseDocument(t) | viewer.CloseDocument(token) na injektované instanci |
4. Middleware a směrování zdrojů
UseDoconut() nyní nepřijímá žádné argumenty. Tvar větve MapWhen se sám nemusí měnit — pouze middleware uvnitř ní:
app.UseDoconutResources(); // PŘED větví
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());V aktuální pipeline:
- volat
UseSession()před Doconut, když je zabezpečení relace povoleno; - volat
UseDoconutResources()předUseDoconut(); - udržujte
ResourcesPath, generované URL zdrojů a klientskéResPathv souladu; - udržujte mapovanou větev a klientské
BasePathv souladu.
MiddlewarePath je validovaná konfigurace; sama nevytváří větev ASP.NET Core.
5. Konstrukce a životnost prohlížeče
Odstraňte vyrovnávací paměti vlastněné aplikací pro objekty Viewer.
V Viewer už nezůstane nic, co by stálo za zachování: nepřenáší žádný stav dokumentu a vyrovnávací paměť relace vlastní vše, co přežije požadavek.
Vložte jej do koncového bodu, Razor stránky, kontroleru nebo scoped služby aplikace:
app.MapPost("/api/open", async (Viewer viewer) =>
{
var token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
return Results.Ok(new { token });
});Vrácený token identifikuje serverovou relaci dokumentu. Považujte jej za nositelský pověření: neukládejte jej do logů, neukládejte jej trvale ani jej nezasílejte do analytiky.
6. Otevírání a zavírání dokumentů
Nahraďte synchronní OpenDocument(...) pomocí OpenDocumentAsync(...):
// Aktuální integrace: Viewer pochází z DI a otevírání dokumentu je asynchronní.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });Aktuální přetížení přijímají cestu k souboru nebo stream, volitelnou konfiguraci formátu, volitelný DocOptions a token pro zrušení. Uzavřete serverovou relaci explicitně, když ji prohlížeč již nepotřebuje:
viewer.CloseDocument(token);Odstraňte jakékoli volání InitCache() a příslušný příznak — není co ručně zahřívat. Nepoužívejte znovu token vytvořený předchozí knihovnou po přechodu: otevřete každý dokument znovu pomocí aktuálního API.
7. Webová farma → distribuovaná: největší změna
UseDoconutWebFarm a WebFarmOptions již neexistují.
Pokud je vaše aplikace volá, tato sekce je vaše aktualizace; pokud ne, přejděte k §8.
Dříve jedno middleware dělalo vše: poskytovalo předrenderované obrázky ze sdílené složky a dotazovalo, zatímco další uzel je stále zapisoval.
// Předchozí integrace — jedno volání, implicitní koordinace přes souborový systém.
appBranch.UseDoconutWebFarm(new WebFarmOptions
{
Path = Path.Combine(env.WebRootPath, "webfarm"),
PageWaitTimeSeconds = 180,
StartWaitFromPage = 5,
});Stejný úkol je nyní rozdělen na dvě explicitní poloviny. Strana zápisu — uzel, který otevírá dokument, zveřejní celý soubor artefaktů (stránky, informace o dokumentu, vyhledávací index, metadata) do sdíleného úložiště:
var result = await _publisher.PublishAsync( // DistributedDocumentPublisher, injektováno z DI
pathToFile,
new FileShareConfig
{
Location = CloudLocation.FileShare,
RootPath = @"\\fileserver\doconut", // stejná složka, kterou používáte dnes
UsePerTokenSubfolders = true,
},
config,
documentOptions,
new DistributedDocumentPublishOptions
{
CleanUpStagingDirectory = true,
FirstPagePriority = true,
});
return Content(result.Token);Strana čtení — kterýkoli uzel poskytuje ze sdíleného úložiště:
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconutCloud<FileShareCloudHandler>(options =>
{
options.Location = CloudLocation.FileShare;
options.CloudUploadConfig = /* stejný FileShareConfig jako výše */;
}, "/"));| Před | Nyní |
|---|---|
WebFarmOptions.Path | FileShareConfig.RootPath |
PageWaitTimeSeconds / StartWaitFromPage | zrušeno — nahrazeno FirstPagePriority na straně zápisu plus FileShareConfig.ReadReadyPollMs na straně čtení |
viewer.OpenDocument(...) pak viewer.ExportToPng(share) | jedno volání PublishAsync(...) |
DocOptions.IsWebfarm / WebfarmPath | stále tam, psáno IsWebFarm / WebFarmPath — ale není potřeba na cestě publikování |
Vaše topologie se nemění.
Ukazujte RootPath na stejný UNC sdílený adresář a každý uzel bude fungovat stejně jako dnes. Změna spočívá v tom, že publikování je operace, kterou zavoláte, místo vedlejšího efektu renderování.
Obě poloviny se musí shodovat. Pokud se
RootPathneboUsePerTokenSubfoldersliší mezi publikátorem a obslužným programem, druhý uzel odpoví 404. Vytvořte konfiguraci v jednom pomocníku a zavolejte ji z obou stran.
PageWaitTimeSeconds = 180 znamenalo „blokovat až tři minuty v naději, že se stránka objeví“. Náhrada je explicitní: s FirstPagePriority = true je stránka 1 okamžitě servírována a pozdější stránky odpovídají HTTP 202 Accepted, dokud nejsou zapsány. Vložený prohlížeč automaticky opakuje, když je nastaveno retryOn409. Klient, který neopakujete, zobrazí poškozené dlaždice pro stránky, které se stále renderují.
Celé uspořádání, včetně publikování na pozadí a přístupových lístků, je popsáno v Distribuovaná nasazení.
8. Převod je plugin a je mnohem menší
Zaregistrujte plugin, pak injektujte fasádu DocumentConverter:
builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());// Předchozí integrace
var converter = viewer.Converter.GetConverter();
var config = new WordConfigConverter { TargetFormat = WordConfigConverter.EnTargetFormat.PDF };
var result = converter.Convert(stream, SourceFormatConverter.DOCX, config);
// Aktuální integrace
var result = await _converter.ConvertAsync(stream, ".docx", ConversionTarget.Pdf, null, ct);Co to nahrazuje:
SourceFormatConverter— odstraněno. Předávejte příponu souboru jako řetězec, včetně tečky.- Typy
*ConfigConverterpodle rodiny (WordConfigConverter,ExcelConfigConverter, …), každá s vnořeným výčtemEnTargetFormat— odstraněno. Nyní existuje jeden výčetConversionTargetpro každou rodinu. viewer.Converter.GetConverter()— odstraněno. InjektujteDoconut.DocumentConverter.
ConvertAsync vrací seekovatelný stream, takže return File(result, mime, name) funguje přímo — kopie starého kódu MemoryStream není potřeba. V dodaném příkladu to odstranilo 68‑případový přepínač rozšíření a deset téměř identických řadičů.
Viz Plugin převodníku pro kompletní přehled.
9. Cloudoví poskytovatelé
UseDoconutCloud se stal obecný. Poskytovatel je typový argument místo hodnoty Location, která se přepínala uvnitř middleware:
// Předchozí integrace
appBranch.UseDoconutCloud(new CloudOptions { Location = CloudLocation.CDN, ... });
// Aktuální integrace
branch.UseDoconutCloud<CDNCloudHandler>(options =>
{
options.Location = CloudLocation.CDN;
options.CloudUploadConfig = new CDNConfig { DoconutCdnUrl = "..." };
}, "/");Třídy konfigurace jsou nezměněny kromě jmenného prostoru (Doconut.Configs.Cloud → Doconut.Clouds): AzureConfig, AmazonConfig, GoogleCloudConfig, DropBoxConfig, RedisConfig, CDNConfig, FTPConfig, plus nový FileShareConfig. Handlery jsou pojmenovány jako <Provider>CloudHandler.
Handler CDN je pouze pro čtení — slouží tomu, co je již na CDN; neprovádí nahrávání.
10. Konfigurační objekty, které změnily název
| Před | Nyní |
|---|---|
DoconutOptions.UnSafeMode | UnsafeMode |
DocOptions.IsWebfarm | IsWebFarm |
DocOptions.WebfarmPath | WebFarmPath |
DocOptions.ImageResolution | stále přítomen, ale zastaralý — nastavte rozlišení v konfiguraci formátu místo toho |
DocOptions také získává IsSecured.
Aktuální API také odděluje záležitosti přísněji než předchozí, takže zkontrolujte, že každé nastavení je na objektu, který jej nyní vlastní:
| Oblast | Aktuální typ |
|---|---|
| Cesty middleware, licencování, registrace pluginu | DoconutOptions |
| Heslo, časový limit, zabezpečení, vodoznak | DocOptions |
| Renderování formátu a DPI | PdfConfig, WordConfig, ExcelConfig, a další typy BaseConfig |
| Výchozí nastavení widgetu prohlížeče | ViewerConfig nebo ekvivalentní možnosti JavaScriptu |
| Generovaný CSS a skripty | CssConfig a ScriptConfig |
| Sdílené úložiště a cloudoví poskytovatelé | FileShareConfig a ostatní konfigurace Doconut.Clouds |
Nepořádejte DocOptions.ImageResolution dál jako řídící prvek renderování. Je zastaralý; nastavte BaseConfig.ImageResolution v konfiguraci specifické pro formát. Přezkoumejte všechna výchozí nastavení místo předpokladu, že předchozí konfigurace má stejné chování.
11. Klientský prohlížeč — dva změny, které selžou TICHÝM
Obě tyto změny neovlivní server, který funguje perfektně. Váš dokument se vykreslí, stránka vypadá správně a v konzoli prohlížeče se nic neobjeví. Přečtěte si tuto sekci i když se váš C# úspěšně zkompiluje na první pokus.
Callbacky prohlížeče jsou nyní volby, ne globální funkce
Předchozí prohlížeč volal vaše handlery podle jména, odvozujíc globální název funkce z ID kontejneru. Deklarace function ctlDoc_OnViewerReady() na stránce s <div id="div_ctlDoc"> stačila. Současný prohlížeč přijímá explicitní callbacky v objektu možností a již nehledá tyto globály:
objctlDoc = $("#div_ctlDoc").docViewer({
// ... vaše existující možnosti ...
onViewerBusy: ctlDoc_OnViewerBusy, // byl nalezen podle jména
onViewerReady: ctlDoc_OnViewerReady, // byl nalezen podle jména
onCopy: ctlDoc_Copy, // byl ctlDoc_Copy(text)
onAutoLoadStatus: ctlDoc_AutoLoadStatus // byl ctlDoc_AutoLoadStatus(page)
});Proč je to nepříjemné: staré volání bylo zabalené do prázdného catch, který pohltil vše. Nyní vaše funkce prostě nikdy neběží a nic nehlásí chybu. Běžným symptomem je neustále se točící spinner, který se nikdy nezastaví — protože funkce, která jej skryla, byla ctlDoc_OnViewerReady. Dokument za ním je v pořádku.
Úplný seznam možností je onPageLoading, onPageLoaded, onThumbnailClicked, onPageClicked, onDoubleClick, onViewerBusy, onViewerReady, onViewerError, onCopy, onAnnSaved, onAnnSaveError, onAnnLoaded, onAnnClosed, onAutoLoadStatus, onThumbsShown a onError. Neexistuje callback pro kliknutí na odkaz: zpracování hyperodkazů je vestavěné, řízené pomocí showHyperlinks.
ResPath musí ukazovat na předponu zdroje
ResPath: '', // PŘED — zdroje pocházely z kořene aplikace
ResPath: 'doconut-res/images', // NOW — prefix UseDoconutResources() připojujePokud jste změnili předponu pomocí DoconutOptions.ResourcesPath, použijte tuto hodnotu místo toho.
12. Panel nástrojů Vieweru, Vyhledávání a Anotace
Nesmíte migrovat staré skripty jeden po druhém. Současné referenční aplikace vytvářejí jeden kompletní balíček stránky:
- vydat CSS Vieweru a licencované CSS Vyhledávání/Anotace pomocí
ReferenceCss; - vykreslit panel nástrojů Vieweru, který vlastní aplikace;
- vykreslit
searchBarMount,annBarMounta požadovaný montáž Vieweru; - vydat skripty Vieweru a licencovaných modulů pomocí
ReferenceScripts; - načíst pomocný skript panelu nástrojů aplikace;
- inicializovat jeden
objViewer; - inicializovat licencované pásky Vyhledávání a Anotace;
- volat
attach(objViewer)na každé pásce; - otevřít dokument a volat
objViewer.View(token).
Vyhledávání a Anotace jsou moduly připojené ke stejnému Vieweru, ne nezávislé panely nástrojů. Hlavní panel nástrojů patří hostitelské aplikaci; pásky Vyhledávání a Anotace jsou vložené, na schopnosti omezené zdroje.
Odstraňte ručně zkopírované soubory jako documentLinks.js a docViewer.UI.js až poté, co aktuální stránka funguje se zdroji vydanými pomocí ReferenceCss a ReferenceScripts.
13. Registrace pluginů
Statické metody plugin‑licencí nezaregistrují aktuální pluginy. Nainstalujte a zaregistrujte každý vydaný balíček explicitně:
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});AddDoconut() ověřuje registrované schopnosti pluginů při spuštění. Converter a DICOM jsou vydané .NET Standard pluginy. Normální Vyhledávání a Anotace jsou vestavěné licencované funkce, ne AddPlugin<TPlugin>() balíčky.
14. Bezpečnost relace a dokumentu
Současná integrace váže dokumenty k neprůhledným tokenům a ke kešovaným relacím. S výchozím UnsafeMode = false, UseDoconut() přidává zabezpečení přístupu k dokumentu a hostitel musí nakonfigurovat ASP.NET relaci:
builder.Services.AddDistributedMemoryCache(); // stav relace potřebuje mezipaměť (MVC/Razor Pages již přidává jednu)
builder.Services.AddSession();
app.UseSession();Uchovávejte DocOptions.IsSecured = true, pokud revizní návrh nevyžaduje jinak. Nikdy nepoužívejte UnsafeMode = true jako migrační zkratku na jediném uzlu. Testujte požadavky bez tokenu, s poškozeným tokenem, s prošlým tokenem a s tokenem z jiné relace prohlížeče.
V farmě může požadavek na stránku dopadnout na uzel, který nikdy neviděl úvodní požadavek, takže kontrola na úrovni relace by ho odmítla. To je jediný případ, kdy je UnsafeMode = true správné — a musí být spárováno s podepsanými přístupovými lístky přes AddDoconutDistributedDocumentSecurity, nikoli distribuováno samostatně. Viz Distribuovaná nasazení.
Poznámka k pojmenování
Ve všech rámcích je třída Viewer. Pokud najdete DocumentViewer ve starých úryvcích nebo článcích třetích stran, tento typ v SDK nikdy neexistoval.
15. Navrhovaný pořadí práce
- Potvrďte, že hostitelský rámec může konzumovat netstandard2.1. Pokud ne, zastavte.
- Zvyšte verzi balíčku na 26.8.0 a sestavte. Projděte kompilacní chyby — většina jsou řádky
usingv §1. - Přesuňte startovní kód na
AddDoconut()a volání middleware na jejich nové pořadí (§3, §4). - Vložte
Viewertam, kde jste jej konstruovali, udělejteOpenDocumentasynchronní a odstraňteInitCache()(§5, §6). - Pokud používáte webovou farmu, proveďte §7 — jediná část, která je redesignem místo přejmenování.
- Pokud převádíte dokumenty, proveďte §8.
- Proveďte §11 — změny na straně klienta. Jsou to ty, které se neozvou samy.
- Otevřete skutečný dokument v prohlížeči a sledujte zaneprázdněný spinner. Zelená sestava zde nic neprokazuje: licencování, registrace pluginů, cesta ke zdroji a callbacky vieweru selžou až za běhu. Pro farmu ověřte, že dokument publikovaný na jednom uzlu je podáván z jiného.
Testování migrace
Minimálně ověřte:
- spuštění aplikace s produkční licencí a všemi registrovanými pluginy;
- CSS/skripty Vieweru a všechny požadavky na stránku‑obrázek pod zvolenými cestami;
- otevření dokumentu, navigace, přiblížení, miniatury, tisk a explicitní uzavření;
- vyhledávání v textovém dokumentu a nevyhledávatelný stav souboru jen s obrázkem;
- načítání anotací, ukládání, export a řízení schopností;
- zjišťování cíle konvertoru, výstup, stažení a stav vodoznaku;
- DICOM stránky, snímky a animace; technická metadata nejsou v tomto balíčku k dispozici;
- dokumenty chráněné heslem, vlastní fonty, ne‑latinský text a nastavené časové limity;
- odmítnutí tokenu napříč relacemi a chování při vypršení relace;
- pro farmu: publikovat na jednom uzlu, požádat o pozdější stránku z jiného a potvrdit, že
viewer znovu požaduje
202odpovědi místo zobrazení poškozených dlaždic; - mobilní zařízení, tmavý režim a cesta produkčního reverzního proxy.
Plán návratu
Uchovejte předchozí artefakt nasazení, odpovídající balíčky, licenční soubory a zkopírované prohlížečské
zdroje společně. Bezpečný návrat přepne celou generaci aplikace; neprovádí
směšování serveru předchozí generace s aktuálními skripty ani aktuálního serveru s
new Viewer(...) místy volání.
Před přepnutím dokumentujte:
- slot nasazení nebo artefakt použitý pro návrat;
- dopad sdíleného úložiště, pokud existuje — artefakty publikované verzí 26.8.0 nejsou spotřebovány předchozím middlewarem web‑farmy;
- jak budou neplatné aktivní relace dokumentů;
- kontrolu zdraví a testovací dokument použitý k rozhodnutí o návratu;
- kdo může obnovit předchozí sadu balíčků a konfiguraci.
Historická dokumentace
Přeložený předchozí manuál zůstává dostupný na Staré nastavení .NET Standard. Předchozí integrační brána vysvětluje stejné identifikační signály a odkazuje zpět na tuto migrační příručku.
Uchovávejte historické URL v záložkách a podporných ticketech, dokud instalace netstandard2.0 stále existují. Dokumentuje jinou generaci a není přesměrováno na aktuální API.
Byla tato stránka užitečná?