NSILM

GS: DashboardDefinitionSection: API: PUT /quality-api/dashboard-definitions/{dashboardDefinitionId}/elements/{elementId}

Muutja: Carolina Kask · 2024-08-13

Üldkirjeldus

Teenus muudab juhtimislaua komponendi elemendi andmeid.

Seotud andmeobjektid:

NSIL-435 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutaja poolt valitud rollil peab olema juhtimislauaga seotud valdkonna haldamise õigus.
    • AssessmentModel.domainType = Klassifikaatorid#KlassifikaatorDOMAIN, mis on seotud DASHBOARD_MANAGE_PRIVILEGE  (attributeDefinitionCode) privileegiga, mis on kasutaja poolt valitud rollile lisatud.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
dashboardDefinitionId1UUID
  • Juhtimislaud ei tohi olla kustutatud.
    • DashboardDefinition.objectStatus = CURRENT
Juhtimislaua id (UUID).
elementId1UUID
  • Element ei tohi olla kustutatud.
    • DashboardDefinitionElement.objectStatus = CURRENT
Juhtimislaua element.
previousComponent.id0..1String
  • Kui määratud, siis element ei tohi olla kustutatud.
    • Sektsioon:
      • DashboardDefinitionElement.objectStatus = CURRENT, mille DashboardDefinitionElement.id = previousComponent.id
  • Kohustuslik, kui previousComponent.type on määratud.

Juhtimislaua komponendi elemendi seadistuse objektile eelneva juhtimislaua komponendi (elemendi) id.

previousComponent.type0..1
  • Lubatud väärtused:
    • ELEMENT
  • Kohustuslik, kui previousComponent.id on määratud.

Juhtimislaua komponendi elemendi seadistuse objektile eelneva juhtimislaua komponendi (elemendi) tüüp.

name1String
  • Peab olema 3 - 250 tähemärki.

Juhtimislaua komponendi elemendi nimetus.

helpText0..1String
  • Lubatud kuni 1800 tähemärki.

Juhtimislaua elemendi selgitus.

filters0..*Array

Juhtimislaua elemendi filtrite andmed.

Kasutatakse juhtimislaua elemendi filtrite haldamiseks.

filters.key0..1String
  • Lubatud kuni 500 tähemärki.
  • Kohustuslik, kui filters.value väärtus on määratud.

Juhtimislaua elemendi filtri parameeter.

filters.value0..1String
  • Lubatud kuni 500 tähemärki.
  • Kohustuslik, kui filters.key väärtus on määratud.

Juhtimislaua elemendi filtri parameetri väärtus.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
GS: DashboardDefinitionSection: API: POST /quality-api/dashboard-definitions/{dashboardDefinitionId}/elements#V%C3%A4ljundid

Tegevused

  1. Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
    1. Kui kasutajal ei ole õigust päringut teostada, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  2. Süsteem valideerib sisendi.
    1. Kui sisend on ebakorrektne, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. Süsteem otsib juhtimislaua andmed.
    • Süsteem otsib Objektid#DashboardDefinition objekti, mille:
      • id = Sisendis esitatud dashboardDefinitionId väärtus.
      • objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem otsib juhtimislaua elemendi komponendi andmed.
    1. Süsteem otsib Objektid#DashboardDefinitionElement objekti, mille:
      • id = Sisendis esitatud elementId väärtus.
      • objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  5. Süsteem muudab leitud juhtimislaua elemendi andmeid.
    • Süsteem muudab leitud Objektid#DashboardDefinitionElement objekti andmeid:
      • helpText = Sisendis esitatud helpText väärtus.
      • filters = Sisendis esitatud filters väärtused.
      • objectStatus = CURRENT
      • audit (muutmine) = audit (muutmine)
  6. Süsteem lisab loodud elemendi juhtimislaua komponentide järjestuses õigesse asukohta.
    • Kui previousComponent väärtus ei ole määratud, siis lisatakse element vastava taseme juhtimislaua komponentide järjekorras esimeseks.
    • Kui previousComponent väärtus on määratud, siis lisatakse loodud element vastava taseme juhtimislaua komponentide järjekorras määratud juhtimislaua komponendi järele.
    • Andmed salvestatakse Objektid#DashboardDefinitionComponentOrder objekti.
  7. Süsteem tagastab muudetud andmed.