Přeskočit na hlavní obsah

DŮLEŽITÉ: Kroky po aktualizaci

Varování

Při přechodu ze starší než bezprostředně předcházející verze Alvao, nejprve proveďte kroky po upgradu pro všechny verze, které byly přeskočeny v chronologickém pořadí.

Po upgradu na verzi 25.1​

SQL skripty​

Ukládání hodnot vlastnosti objektu a jejich dědičnosti se změnila. Tabulka tblProperty již v databázi neexistuje, ani neprovádí vProperty a vPropertyInherited.

Místo toho jsou k dispozici následující tabulky:

  • NodeCust - uložení vlastních a děděných hodnot vlastností. Sloupce tabulky mají stejný typ jako definice vlastnosti.
  • ClassKind - vlastnosti definované pro každý typ objektu.
  • NodeColumnInheritance - děditelné (InheritedFromNodeId = NULL) a děděné (InheritedFromNodeId != NULL) vlastnosti objektů.

Existuje také užitečný pohled vNodeProperty a uložená procedura spNodeProperty. Musíte aktualizovat své dotazy podle nového schématu databáze.

Příklad 1​

Vyberte název hostitele (nezděděný) konkrétního objektu.

ALVAO 11.2:

select pk.txtValue [Hostname] from vPropertyKind pk where pk.lintNodeId = 10 and pk.intKindCode = 3 --HostName

ALVAO 25.1:

select nc.HostName from vNodeProperty np join NodeCust nc on nc.NodeId = np.NodeId where np.NodeId = 10 and np.InheritedFromNodeId is null and np.KindCode = 3 --HostName

Příklad 2​

Vyberte název organizace konkrétního objektu. Vlastnost může být zděděna

ALVAO 11.2:

select pk.txtValue [Název organizace] from vPropertyKindInherited pk where pk.lintNodeId = 20 and pk.txtKind = N'Název organizace'

ALVAO 25.1:

select nc.OrganizationName from NodeCust nc where nc.NodeId = 20

Příklad 3​

Vyberte všechny vlastnosti (včetně dědičné) s hodnotami konkrétního objektu.

ALVAO 11.2:

select pk.txtKind [Název vlastnosti], pk.txtValue [Hodnota vlastnosti] from vPropertyKindInherited pk where pk.lintNodeId = 30

ALVAO 25.1:

declare @nodes Node insert into @nodes select 30

declare @props NodeProperty insert into @props exec [dbo].[spNodeProperty] @nodes

select k.txtName [Název vlastnosti], p.TextValue [Hodnota vlastnosti] from @props p join tblKind k on k.intKindId = p.KindId where p.NodeId = 30

Vlastní aplikace​

Při upgradu z ALVAO 11.2 musíte upravit své existující vlastní rozšíření, viz ALVAO Asset Management Custom Apps nebo ALVAO Service Desk Custom Apps. Upravit zdrojové soubory a skripty popsané na této stránce. Pokud přecházíte z verze ALVAO 11.1 nebo starší, nejprve převeďte vlastní rozšíření na verzi ALVAO 11.2.

  1. Alvao.API – Common.Database.ReadColumn – hodnoty Bit – vrací "0"/"1" místo lokalizovaného "Ano"/"Ne". Vrátili jsme se k jeho předchozímu stavu z SD WS. Pokud chcete vrátit lokalizovanou hodnotu namísto logické hodnoty (0/1), použijte Common.CustomColumn.GetValue a volitelný parametr returnBitAsNumber nastavený jako false. (T155790ALVAO).
  2. IObjectPropertyAutoAction skripty – Metoda OnObjectPropertyModifying nyní vrací objekt ObjectPropertyModifyResult místo Tuple. Je třeba změnit definici této metody na veřejnou ObjectPropertyModifyVýsledek OnObjectPropertyModifying(ObjectPropertyEventArgs e). Potom musíte vrátit objekt tohoto typu z popsané metody (ObjectPropertyModifyResult má parametry bool a řetězec, podobně jako v předchozí verzi.
  3. IObjectPropertyAutoAction skripty - Metody OnObjectPropertyModifying a OnObjectPropertyAutified nyní jako parametr přijímají objekt typu ObjectPropertyEventArgs. Definici těchto metod je třeba změnit na public ObjectPropertyModifyResult OnObjectPropertyModifying(ObjectPropertyEventArgs e) a public void OnObjectPropertyModified(ObjectPropertyEventArgs e). Tento objekt obsahuje všechny parametry z předchozí verze, takže namísto parametru personId, nyní použijete e.PersonId.
Varování

String.GetHashCode byste neměli používat k identifikaci vlastních aplikací, protože metoda není stabilní a může vracet různé hash kódy v různých . ET verze a implementace.

Vlastní ikony​

Způsob určení ikon příkazů byl změněn. Sledujte pokyny pro metodu IEntityCommand.Show - člen Icon.

Vlastní formuláře​

Při upgradu z ALVAO 11.2 musíte upravit své existující vlastní formuláře, viz Vlastní formulář pro odeslání nové žádosti nebo Vlastní formulář pro schválení žádosti. Upravte .cs a .cshtml soubory popsané na této stránce. Pokud přejdete z ALVAO 11.1 nebo dříve, nejprve konvertujte vlastní rozšíření na ALVAO 11.2.

Musíte přepsat alespoň následující části kódu:

  • Vyměňte usings Alvao.ServiceDesk.ServiceDeskWebApp... za Alvao.WebApp... ve všech zdrojových souborech.

ALVAO 11.2:

pomocí společnosti Alvao.ServiceDesk.ServiceDeskWebApp.Infrastructure.Custom;

ALVAO 25.1:

pomocí společnosti Alvao.WebApp.Infrastructure.Custom;
  • Nahraďte pomocí System.Web.Mvc s Microsoft.AspNetCore.Mvc.

ALVAO 11.2:

používání System.Web.Mvc;

ALVAO 25.1:

pomocí Microsoft.AspNetCore.Mvc;
  • Pokud používáte CustomPageController jako základní třídu pro vaši třídu ovladačů, přidejte konstruktor, který má parametry IHttpContextAccessor:

ALVAO 11.2:

public class MyCustomController : CustomPageController
{
    ...
}

ALVAO 25.1:

using Microsoft.AspNetCore.Http;
...
public class MyCustomController : CustomPageController
{
    ...
    public MyCustomController(IHttpContextAccessor httpContextAccessor)
        : base(httpContextAccessor)
    {
    }
    ...
}
  • Přidejte použití ke standardním prostředkům, pokud je používáte, a přistupujte k nim pouze prostřednictvím třídy Localization.

ALVAO 11.2:

hodit novou CustomHttpException(
    HttpStatusCode.Forbidden, Resources.Localization.AccessDenied);

ALVAO 25.1:

using Alvao.WebApp.Resources;
...
throw new CustomHttpException(
    HttpStatusCode.Forbidden, Localization.AccessDenied);
  • Změňte své jmenné prostory z Alvao.ServiceDesk.ServiceDeskWebApp.Custom... na Alvao.WebApp.Custom... ve všech svých třídách.

ALVAO 11.2:

name espace Alvao.ServiceDesk.ServiceDeskWebApp.Custom.MyFormController

ALVAO 25.1:

jmenný prostor Alvao.WebApp.Custom.MyFormController
  • Odstraňte parametr ControllerContext z konstruktorů a metod ve třídách dědících třídu SelectCallbackResponse.

ALVAO 11.2:

veřejná MyGridSelectse(MyGridGrid mřížka, ControllerContext ctx)
    : base(grid, ctx)

ALVAO 25.1:

veřejná MyGridSelectse(MyGridGrid mřížka)
    : base(mřížka)
  • Namísto vytvoření nové instance UrlHelper, volejte její statické metody přímo.

ALVAO 11.2:

UrlHelper helper = new UrlHelper(ctx.RequestContext); Dictionary<string, object> result = new Dictionary<string, object>(); result.Add("link", helper.DefaultAction(
    "Index", "Ticket", new { Id = rowData["iHdTicketId"] }));

ALVAO 25.1:

Dictionary<string, object> result = new Dictionary<string, object>(); result.Add("link", UrlHelper.DefaultAction(
    "Index", "Ticket", new { Id = rowData["iHdTicketId"] }));
  • Změňte způsob čtení parametrů dotazu.

ALVAO 11.2:

Request.Params["TicketId"]

ALVAO 25.1:

  • V řadiči:
HttpContext.GetParam ("TicketId")
  • Zobrazení:
    ViewContext.HttpContext.GetParam("ReturnUrl")
  • Získejte IP adresu volající z připojení.

ALVAO 11.2:

IPAddress HostIp = IPAddress.Parse(Request.UserHostAddress);

ALVAO 25.1:

var HostIp = HttpContext.Connection.RemoteIpAdresa
  • Změňte typ vhozených HTTP výjimek.

ALVAO 11.2:

hodit novou HttpException();

ALVAO 25.1:

hodí novou CustomHttpException(HttpStatusCode.InternalServerError);
  • Změňte způsob práce s relací.

ALVAO 11.2:

UserContactsModel ContactDetails =
    Session["UserContactDetails"] as UserContactsModel;

ALVAO 25.1:

var userContactDetails =
    HttpContext.Session.GetString("UserContactDetails");
UserContactsModel ContactDetails =
    string.IsNullOrEmpty(userContactDetails) ?
    null :
    JsonConvert.DeserializeObject<UserContactsModel>(userContactDetails);

ALVAO 25.2:

Relace byla odstraněna z této verze. Můžete místo toho použít CacheUtil.

CacheUtil.UpdateOrCreateItem($\"UserContactDetails_{currentPersonId}\", contactDetails, 120);\nbool isInCache =\n    CacheUtil.TryGetFromCache($\"UserContactDetails_{currentPersonId}\", out UserContactsModel contactDetails);
  • Přístup k hlavičkám odpovědi jinak.

ALVAO 11.2:

Response.AddHeader("Content-Disposition", ...);

ALVAO 25.1:

Response.Headers.Append("Content-Disposition", ...);
  • Použít statickou metodu StatusCode pro vrácení určitého stavu z řídící metody.

ALVAO 11.2:

vrátit nový HttpStatusCodeResult(
    System.Net.HttpStatusCode.NoContent);

ALVAO 25.1:

statusCode(StatusCodes.Status204NoContent);
  • Přidejte rozložení do .cshtml pokud není přítomen:
@{
    Rozložení = "~/Views/Shared/_Layout.cshtml";
}
  • Používáte-li helpery v souborech cshtml, přepište je na funkce.

ALVAO 11.2:

  • Prohlášení o funkci:
@helper HelperTest(<T> model)
{
<h1>@Model.Text</h1>
}
  • Volání funkcí:
@HelperTest(Model)

ALVAO 25.1:

  • Deklarace funkce:
@functions
{
    public void HelperTest(<T> model)
    {
        <h1>@Model.Text</h1>
    }
}
  • Volání funkcí:
@{
    HelperTest(Model);
}
  • Ke generování adres URL použijte statické metody UrlHelper.

ALVAO 11.2:

string editTicketUrl =
    VirtualPathUtility.ToAbsolute("~/Ticket/Edit/" + Model.TicketId);

ALVAO 25.1:

string editTicketUrl =
    UrlHelper.Content("~/Ticket/Edit/" + Model.TicketId);

Užitečné metody nástroje UrlHelper:

public static string Action(string action, string controller) public static string Action(string action, string controller,
    RouteValueDictionary routeValues)
public static string Content(string contentPath) public static string Content(string contentPath,
    RouteValueDictionary routeValues)
  • Pro kódování textů použijte místo HttpUtility nástroj WebUtility.

ALVAO 11.2:

HttpUtility.UrlEncode(Model.RelatedAccountName)

ALVAO 25.1:

WebUtility.UrlEncode(Model.RelatedAccountName)

Chcete-li použít WebUtility, musíte na začátek souboru přidat následující řádek:

@použití System.Net;
  • Změňte cestu k systémovým prostředkům.

ALVAO 11.2:

<img src="~/Content/img/favicon.ico" />

ALVAO 25.1:

<img src="~/wwwroot/img/favicon.ico" />

Po upgradu na verzi 25.2​

Po upgradu nejsou vyžadovány žádné manuální kroky.