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:

VersionTargetAPI
26.7.0 and belownetstandard2.0the previous API
26.8.0 and abovenetstandard2.1the 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(...) / WebFarmOptionsPř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.jsPředchozí
builder.Services.AddDoconut(...)Aktuální
app.UseDoconutResources() plus app.UseDoconut() with no argumentsAktuální
Viewer supplied by dependency injectionAktuá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:

HostCan consume 26.8.0
.NET Core 3.0 or later (including .NET 5/6/7/8)Ano
.NET Framework, any versionNe

.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í

  1. Vytvořte větev a nasaditelnou zálohu existující aplikace.
  2. Zaznamenejte přesné verze jádra a pluginových balíčků.
  3. 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.
  4. Zachovejte aktuální soubory .lic a nasazovací tajemství mimo správu verzí.
  5. 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ů.
  6. 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.

BeforeNow
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:

bash
dotnet add package Doconut.NETStandard

Pro reprodukovatelnou migraci na verzi auditovanou tímto průvodcem předávejte verzi jako samostatnou volbu:

bash
dotnet add package Doconut.NETStandard --version 26.9.0

Udrž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í:

text
LicenseStream > LicenseContent > LicensePath > automatic discovery

Automatické 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:

csharp
// 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í:

csharp
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í. Injektujte Doconut.Viewer do svého kontroleru, nebo použijte @inject Doconut.Viewer Viewer v 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ředNyní
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í:

csharp
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:

  1. volat UseSession() před Doconut, když je zabezpečení relace povoleno;
  2. volat UseDoconutResources() před UseDoconut();
  3. udržujte ResourcesPath, generované URL zdrojů a klientské ResPath v souladu;
  4. udržujte mapovanou větev a klientské BasePath v 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:

csharp
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(...):

csharp
// 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:

csharp
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.

csharp
// 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ě:

csharp
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ě:

csharp
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ředNyní
WebFarmOptions.PathFileShareConfig.RootPath
PageWaitTimeSeconds / StartWaitFromPagezruš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 / WebfarmPathstá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 RootPath nebo UsePerTokenSubfolders liší 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:

csharp
builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());
csharp
// 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 *ConfigConverter podle rodiny (WordConfigConverter, ExcelConfigConverter, …), každá s vnořeným výčtem EnTargetFormat — odstraněno. Nyní existuje jeden výčet ConversionTarget pro každou rodinu.
  • viewer.Converter.GetConverter() — odstraněno. Injektujte Doconut.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:

csharp
// 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ředNyní
DoconutOptions.UnSafeModeUnsafeMode
DocOptions.IsWebfarmIsWebFarm
DocOptions.WebfarmPathWebFarmPath
DocOptions.ImageResolutionstá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í:

OblastAktuální typ
Cesty middleware, licencování, registrace pluginuDoconutOptions
Heslo, časový limit, zabezpečení, vodoznakDocOptions
Renderování formátu a DPIPdfConfig, WordConfig, ExcelConfig, a další typy BaseConfig
Výchozí nastavení widgetu prohlížečeViewerConfig nebo ekvivalentní možnosti JavaScriptu
Generovaný CSS a skriptyCssConfig 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:

javascript
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

javascript
ResPath: '',                      // PŘED — zdroje pocházely z kořene aplikace
ResPath: 'doconut-res/images',    // NOW    — prefix UseDoconutResources() připojuje

Pokud 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:

  1. vydat CSS Vieweru a licencované CSS Vyhledávání/Anotace pomocí ReferenceCss;
  2. vykreslit panel nástrojů Vieweru, který vlastní aplikace;
  3. vykreslit searchBarMount, annBarMount a požadovaný montáž Vieweru;
  4. vydat skripty Vieweru a licencovaných modulů pomocí ReferenceScripts;
  5. načíst pomocný skript panelu nástrojů aplikace;
  6. inicializovat jeden objViewer;
  7. inicializovat licencované pásky Vyhledávání a Anotace;
  8. volat attach(objViewer) na každé pásce;
  9. 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ě:

csharp
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:

csharp
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

  1. Potvrďte, že hostitelský rámec může konzumovat netstandard2.1. Pokud ne, zastavte.
  2. Zvyšte verzi balíčku na 26.8.0 a sestavte. Projděte kompilacní chyby — většina jsou řádky using v §1.
  3. Přesuňte startovní kód na AddDoconut() a volání middleware na jejich nové pořadí (§3, §4).
  4. Vložte Viewer tam, kde jste jej konstruovali, udělejte OpenDocument asynchronní a odstraňte InitCache() (§5, §6).
  5. Pokud používáte webovou farmu, proveďte §7 — jediná část, která je redesignem místo přejmenování.
  6. Pokud převádíte dokumenty, proveďte §8.
  7. Proveďte §11 — změny na straně klienta. Jsou to ty, které se neozvou samy.
  8. 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 202 odpově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á?