רישוי
יכולות, רמות רישיון, ושירות הרישיון
דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של Doconut: מה כל מצב רישיון מאפשר, איך ניתנות היכולות, ואיך לבדוק את כל זה מהקוד. (לטעינת רישיון, ראה הגדרת רישיון.)
מצבי רישיון ומה הם עושים
| מצב | פותח מסמכים? | סימן מים | יכולות |
|---|---|---|---|
| רישיון מלא (בתשלום) (הגרסה הזו שוחררה לפני תאריך המנוי שלה) | כן | אין | הדגלים שנרכשו (Has*) |
| רישיון זמני (מפתח/לא למכירה — רישיון הערכה, לפני תאריך הפקיעה) | כן | אין על הצופה הבסיסי; פלט תוספים מסומן במים | הכל — מתן רישיון כולל (משפך ההערכה) |
רישיון זמני שפג (אחרי תאריך LicenseExpiry שלו) | כן | סימן מים של הערכה | אין שום רישיון |
| אין קובץ רישיון כלל | כן | סימן מים של הערכה | אין שום רישיון |
| נמצא אך נדחה (חתימה לא תקפה, שונה, ברשימה שחורה, או גרסה שפורסמה אחרי תאריך המנוי של הרישיון) | לא — LicenseException בכל פתיחה | — | — |
רישיון בתשלום שהתאריך המנוי שלו עבר ממשיך לפעול — נקי, עם היכולות שלו — על כל גרסה שפורסמה לפני תאריך זה. רק גרסה שפורסמה אחרי תאריך המנוי נדחית.
שתי תוצאות שכדאי להטמיע:
- חוסר רישיון אינו רישיון זמני. ללא קובץ רישיון, הדפים מוצגים עם סימן מים ואין שום יכולת (חיפוש, הערה, תוספים) פעילה. החוויה המלאה ללא סימן מים דורשת רישיון זמני (קבל אחד).
- רק רישיון שנדחה חוסם פתיחה. רישיון זמני שפג משאיר את האפליקציה פועלת עם סימן מים של הערכה, ורישיון בתשלום אחרי תאריך המנוי שלו משאיר את ההצגה נקייה על הגרסאות שהוא מכסה; אך פריסת גרסה שפורסמה אחרי תאריך המנוי של הרישיון נדחית ונכשלת מיידית עם
LicenseException, כך שאתה תופס זאת בפריסה — ולא על ידי שליחת פלט מסומן במים בשקט. החריגה (מOpenDocumentAsync) נושאת את הסיבה מLicense.RejectionMessage.
יכולות
Doconut מגביל פונקציונליות אופציונלית באמצעות יכולת. זה כולל את תכונות החיפוש והההערה המובנות ותוספי Converter, Dicom ו-Signer שניתן לבחור, שכל אחד מהם מוענק על ידי הרישיון שלך. הצופה הבסיסי אינו יכולת — הוא דרישה מוקדמת, מוצג כIsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // רישיון non-TRIAL קיים ומכסה את גרסת הבנייה הזוהשער היחיד שהצינור כולו משתמש בו הוא IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);ההיגיון שלו, במילה במילה מהיישום: רישיון זמני פעיל (לא פג) מעניק כל היכולת — כולל יכולות שאין להן עדיין דגל רכישה ייעודי; רישיון שנרכש במלואו מעניק בדיוק את דגלי Has* שלו והוא דיפולט-דחייה לכל דבר שלא ממופה. (קובץ מסוג TRIAL מדור קודם אינו זכות — הוא מתייחס כלא מורשה: מסומן במים, אין שום רישיון.)
רישיונות זמניים
רישיונות זמניים (מפתח/לא למכירה) מסומנים בתג ExpiryNote ונושאים תאריך פקיעה קפדני:
| חבר | משמעות |
|---|---|
IsTemporary | תג ExpiryNote קיים (הזיהוי מתבצע על ידי נוכחות התג — לעולם לא תואם לטקסט ההערה, הוא דינמי) |
ExpiryNote | טקסט מידע משובץ ברישיון |
LicenseExpiry | תאריך פקיעה קפדני (DateTime?) |
המשמעות של פקיעה שונה לפי רמה: רישיון זמני פג בתאריך LicenseExpiry בלבד (חלון המנוי שלו מתעלמים ממנו; רישיון זמני ללא תאריך מתייחס כפקוע, בטוח). כל רישיון אחר פוג בתאריך חלון המנוי/עדכון שלו; עבור רישיון בתשלום, IsExpired מדווח רק שהתאריך עבר — גרסאות שפורסמו לפניו נשארות נקיות ושומרות על היכולות שלהן.
IDoconutLicenseService רפרנס
פתור את IDoconutLicenseService (מרחב שמות Doconut.Core.Interfaces) מDoconutHost.Services. זהו singleton — הרישיון מפוענח פעם אחת, בDoconutHost.Initialize:
| חבר | משמעות |
|---|---|
License | צילום מצב מלא של DoconutLicenseInfo (להלן) |
IsTrial | קובץ מסוג TRIAL מדור קודם (מתייחס כלא מורשה — אינו זכות) |
IsTemporary / ExpiryNote / LicenseExpiry | סימני רישיון זמניים |
IsExpired | פג תוקף לפי כללי השכבה למעלה |
IsVersionValid | בנייה זו נמצאת במסגרת חלון התמיכה של הרישיון |
IsViewerLicensed | קובץ שאינו TRIAL נמצא ו גרסה מכוסה — דרישה בסיסית |
IsCapabilityGranted(cap) | שער יכולת יחיד |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | דגל אחד לכל יכולת: נרכש ברישיון המכסה בנייה זו, או ניתן על‑ידי רישיון זמני פעיל. IsCapabilityGranted עונה על אותה שאלה לפי יכולת |
IsValidForDomain(host) | כיסוי מארח; רישיונות V4 משתמשים בתו הכללי *.* |
LicenseRejectionReason | לא‑ריק ⇒ פתיחה נחסמת עם הודעה זו |
DoconutLicenseInfo חושף את צילום המצב הידידותי לממשק ניהול: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, דגלי Has*, שדות הרישיון הזמניים, ו‑RejectionMessage.
// GET /Features - feature-flag הממשק שלך מאותו מקור אמת שה‑SDK משתמש בו
public ActionResult Index()
{
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}, JsonRequestBehavior.AllowGet);
}בדיקת בריאות
Doconut רושמת בדיקת בריאות מסוג "doconut" המדווחת על מצב הרישיון. ל‑Classic ASP.NET אין נקודת קצה לבריאות משלה, ולכן יש לחשוף אותה מבקר:
// GET /Health - Doconut רושמת "doconut" בדיקת בריאות המדווחת על מצב הרישיון:
// Healthy (תקף), Degraded (נסיון או ללא קובץ רישיון), Unhealthy (נדחה או פג תוקף).
public async Task<ActionResult> Index()
{
var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
HealthReport report = await health.CheckHealthAsync();
Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
return Content(report.Status.ToString(), "text/plain");
}חבר זאת למערכת המעקב שלך והסיום של מנוי מתקרב הופך להתראה במקום לקריאת תמיכה. הבדיקה מדווחת Unhealthy כאשר הרישיון נדחה או כאשר IsExpired הוא אמת; עבור רישיון בתשלום, משמעות הדבר היא שתאריך המנוי עבר וחבילה שהוצאה לאחריו תידחה — הבנייה הנוכחית ממשיכה לרנדר בצורה נקייה. ראה את DoconutHost לערכי המצב.
שדרוגי גרסה
רישיון מכסה חלון גרסה. עדכון חבילת ה‑NuGet לבנייה חדשה יותר מהחלון הופך את הרישיון ללא תקף עבור בנייה זו: IsVersionValid הופך ל‑false ופתיחה נחסמת עם LicenseException (הסיבה נמצאת ב‑License.RejectionMessage) — כשלון מהיר בכוונה, כך שבנייה ישנה או לא מורשית נתפסת בזמן הפריסה ולא משאירה סימן מים שקט בפלט הייצור. חידש את המנוי, החלף את .lic בwwwroot, והפעל מחדש את מאגר האפליקציות כדי שDoconutHost.Initialize יטען את הרישיון החדש.
האם דף זה היה מועיל?