Työkalun yleiskatsaus

CTT (Configuration Transport Tool) on työkalu, jolla Efecte Service Managementin (ESM) järjestelmänvalvojat voivat visualisoida sovelluksen kokoonpanoon tehtyjä muutoksia.

CTT tarjoaa tavan siirtää muutoksia ympäristöjen välillä. CTT:ssä on mahdollista valita muutoksia ja luoda määritystiedosto, joka voidaan sitten tuoda ESM:ään muutosten tekemiseksi automaattisesti kyseiseen määritystiedostoon.

CTT vertailee ja näyttää kahden konfiguraatiotiedoston väliset erot. Yleensä toinen tiedosto on testiympäristöstä ja toinen tuotantoympäristöstä.

Vaatimukset ja saatavuus

Työkalun käyttö edellyttää kykyä viedä konfiguraatioita sekä lähde- että kohde-ESM-ympäristöistä valitsemalla Ylläpito → Järjestelmäasetukset → Vie konfiguraatiot.

Konfiguraatioiden siirtoa ympäristöjen välillä (CTT:llä luodun konfiguraatiotiedoston tuonti) tuetaan ESM-versiosta 2023.3 alkaen. Kaikkia kohteita ei tueta, katso lisätietoja alta.

Tällä hetkellä CTT:tä tarjotaan yhden jaetun Efecte Cloud -instanssin kautta. Voit käyttää CTT-ympäristöä täällä: CTT-ympäristö

Käyttötapaus

Ylläpitäjä voi tarkastella testiympäristössä tehtyjä muutoksia, joita ei ole vielä siirretty tuotantoon. Toinen käyttötapaus on saman ympäristön muutosten vertailu säännöllisesti. Jos esimerkiksi kokoonpano tallennetaan tuotantoympäristöstä kerran kuukaudessa, voit käyttää CTT:tä nähdäksesi ympäristöön kunkin kuukauden aikana tehdyt kokoonpanomuutokset.

Tällä hetkellä CTT pystyy havaitsemaan muutoksia mallipohjan kokoonpanoissa, esimerkiksi lisättyjä luokkia ja attribuutteja tai muutoksia attribuuttien kokoonpanossa. CTT voi myös näyttää eroja kansiorakenteessa ja rooleissa. Määritysten erot korostetaan CTT:ssä.

Esimerkkejä CTT:n käyttötapauksista

Muutosten oikean siirron varmistaminen testiympäristöstä Pro

Varmistaa, että kaikki muutokset siirretään oikein testiympäristöstä tuotantoympäristöön, kun muutos ensimmäisen kerran rakennetaan ja testataan testiympäristössä.

Konfiguraatio luodaan yleensä testiympäristössä ennen kuin sama konfiguraatio otetaan käyttöön tuotantoympäristössä. Ensimmäinen käyttötapaus CTT:lle on vertailla konfiguraatiota kahden ympäristön välillä ja varmistaa, että kaikki testiympäristössä tehdyt muutokset otetaan käyttöön uudelleen tuotantoympäristössä.

Testiympäristön päivittäminen vastaamaan Pro kokoonpanoa

Testiympäristöjä on joskus päivitettävä vastaamaan tuotantoa ennen uuden kehitystyön aloittamista. Tämä voi johtua suunnitelmien muutoksista tai siitä, että joitakin suunniteltuja kehityskohteita ei ole otettu käyttöön. CTT:tä voidaan käyttää näissä tapauksissa tarkistamaan, puuttuuko testistä jotain tai onko jotain muuttunut, ja auttamaan ympäristöjen saamisessa samalle tasolle ennen seuraavan kehityskohteen aloittamista.

Konfiguraation versiointi kehityksen aikana

On hyvä käytäntö ottaa vienti konfiguraatiosta ennen uusien ominaisuuksien kehittämisen aloittamista ja myös toisinaan kehityksen aikana. CTT:tä voidaan käyttää saman ympäristön eri versioiden vertailuun edistymisen visualisoimiseksi tai auttamaan ymmärtämään, mitä kehityksessä tehdään/on tehtävä. CTT:n avulla on myös helpompi debugata muutoksia, jos ilmenee monimutkaisempia ongelmia.

Tällä hetkellä tuetut määrityskohteet

Nykyisestä versiosta lähtien CTT tukee seuraavien konfiguraatiokohteiden vertailua/siirtoa:

Ei-tuetut kohteet

Tällä hetkellä CTT ei tue poistettujen objektien , kuten mallien, luokkien tai attribuuttien, visualisointia tai siirtämistä. Näin ollen CTT:n luoman määritystiedoston tuominen ESM:ään ei poista mitään mallia, luokkaa tai attribuuttia kohdekonfiguraatiosta.

Koska CTT:n muutosten vertailu perustuu objektin koodeihin (kuten attribuuttikoodeihin), CTT ei pysty havaitsemaan tällaisten koodien muutoksia . Esimerkiksi attribuutti, jonka koodi on muuttunut, näytetään CTT:ssä uutena attribuuttina.

Tällä hetkellä CTT ei pysty havaitsemaan jaettuja attribuutteja ei-jaetuissa luokissa . Tämä tarkoittaa, että jos tällaiset attribuutit siirretään, ne luodaan uusina attribuutteina kohdejärjestelmässä.

Määritteiden osalta tuetaan useimpien käsittelijämääritysten siirtoa. Käsittelijämäärityksiä, jotka eivät ole osa määritteen metatietoja, ei tueta . Tämä sisältää esimerkiksi EntityStateMail -sähköpostimallit.

Vaiheittainen uid

1. Konfiguraatioiden vienti
   Vie konfiguraatiot lähde- ja kohde-ESM-ympäristöistä (yleensä testi- ja tuotantoympäristöistä) valitsemalla Ylläpito → Järjestelmäasetukset → Vie konfiguraatiot . Valitse kaikki soveltuvat konfiguraatiotyyppien tyypit (kohdassa Vaikutetut konfiguraatiot ).

2. CTT:n käyttö
   1. Avaa CTT-sovellus.
   2. Lataa viedyt kokoonpanot CTT:hen ja valitse "Näytä muutokset" .
      1. Latausnäytön pitäisi näkyä heti sovelluksen avaamisen jälkeen. Jos latausnäyttö ei ole auki, avaa se napsauttamalla otsikossa olevaa Lähetä tiedostoja -painiketta.

Lähteen tulisi olla muutoksia sisältävä määritystiedosto. Yleensä tämä on testiympäristön määritystiedosto. Kohde on yleensä nykyisen tuotantoympäristön määritystiedosto. Voit ladata määritystiedoston XML- tai ZIP- muodossa.
Huomautus: suurille määritystiedostoille ZIP-muoto on parempi, koska se lyhentää tiedostojen latausaikaa. Yhdistetyn tiedostokoon on oltava alle 150 Mt.

3. Mitä CTT:ssä näkyy
   1. Pohjien erot
      Kaikki muuttuneet mallit näkyvät vasemmanpuoleisessa valikossa. Jokainen uusi (vihreä) tai muuttunut (keltainen) malli, luokka ja attribuutti näkyy valikossa. Jos mallissa, luokassa tai attribuutissa ei ole tapahtunut muutoksia, sitä ei näytetä. ( Huomaa : tällä hetkellä poistettuja kohteita ei näytetä/tueta.)
      
      Määritteen valitseminen (napsauttamalla määritteen nimeä) näyttää kyseisen määritteen muutokset vertailunäkymässä:

b. Kuuntelijoiden erot
Kaikki mallit, joilla on uusia tai muuttuneita kuuntelijoita, näkyvät vasemmanpuoleisessa valikossa. Valitse kuuntelija nähdäksesi muutostiedot.

c. Kansioiden erot
Uudet kansiot (vihreä) ja muuttuneet kansiot (keltainen).

d. Roolien erot
Uudet roolit (vihreä) ja muuttuneet roolit (keltainen). Huomautus: roolin mallin, kansion tai attribuutin käyttöoikeuksien muuttamista ei vielä tueta muutoksena.

4. Muutosten valitseminen ja määritystiedoston luominen
   1. Valitse muutokset rastittamalla valintaruutu ( Huomaa : tällä hetkellä voi valita vain malleja/luokkia/attribuutteja).
   2. Valitse Käytä muutoksia.
   3. Näyttöön tulee valintaikkuna, jossa voit tarkistaa, onko luodussa määritystiedostossa ongelmia tai varoituksia. Lataa luotu määritystiedosto napsauttamalla Lataa määritystiedosto.
      

5. Luodun konfiguraation tuonti ESM:ään
   Huomautus : CTT:n luoman määritystiedoston tuonti ESM:ään on tuettu ESM 2023.3:sta alkaen. Katso vaatimukset myös alta kohdasta Järjestelmänvalvojan käytännöt .
   

Suodattimet ja haku

Vasemmalla puolella, Muutokset-puun yläpuolella, löydät toimintoja tietojen suodattamiseen ja hakemiseen. Huomaa, että suodattimet ja haku vaikuttavat vain vasemmalla puolella (muutospuussa) näkyvään tietoon. Jos olet valinnut muutoksia, jotka ovat piilossa suodattimen tai haun vuoksi, ne pysyvät silti valittuina.

Tilasuodattimet

Tilasuodattimia on käytettävissä kaikentyyppisille määrityskohteille – malleille, kansioille ja rooleille. Suodattimen valinnan poistaminen piilottaa kyseisen tyyppiset muutokset näkymästä. Huomaa, että muuttuneiden kohteiden kohdalla se ei piilota muuttuneita kohteita, kuten malleja tai luokkia, jos niiden alla on uusia kohteita.

Pro

Mallien kanssa voidaan käyttää erityisiä ominaisuussuodattimia. Poistamalla suodattimen valinnan se piilottaa muutokset, jotka sisältävät vain kyseisen tyyppisiä muutoksia. Esimerkiksi lokalisoinneissa, jos attribuutissa on vain lokalisoinnin muutos (lisätyt/muutetut käännökset), attribuutti piilotetaan suodatinta käytettäessä. Jos attribuutti sisältää lokalisointimuutoksia ja joitakin muita muutoksia, sitä ei piiloteta.

Tilata

Järjestys viittaa mallipohjan luokka- tai attribuuttijärjestysnumeroihin. Poistamalla tämän suodattimen valinnan muutokset piilotetaan näkymästä, jossa ainoa muutos koskee järjestysnumeroa.

Lokalisointi

Lokalisointi viittaa lisättyihin/muutettuihin mallipohjien, luokkien ja attribuuttien käännöksiin. Poistamalla tämän suodattimen valinnan nämä muutokset piilotetaan näkymästä, jossa ainoa muutos on lokalisoinnissa.

Haku

Hakua voidaan käyttää mallien kanssa, jolloin voit suodattaa näkymää. Voit käyttää nimiä tai koodeja mallien, luokkien ja attribuuttien etsimiseen. Hakua voidaan käyttää yhdessä suodattimien kanssa. Selvyyden vuoksi haku näyttää vain sellaisten muutosten tulokset, joita suodattimet eivät piilota.

Valittujen muutosten dokumentti

Voit ladata PDF-dokumentin, joka sisältää kaikki valitut muutokset malleille, luokille ja määritteille. Kun olet valinnut haluamasi muutokset, valitse Käytä muutoksia . Valitse sitten Lataa dokumentaatiotiedosto :

Ylläpitäjän käytännöt CTT:tä käytettäessä

• CTT on suunniteltu tukemaan käyttötapauksia, joissa muutoksia tehdään lähdeympäristön kautta. Kohdeympäristön muokkaaminen ilman CTT-tuontia saattaa rikkoa joitakin ominaisuuksia tuonnin yhteydessä.
• ESM:n alusta-asetuksen configuration.import.update on oltava arvossa true, jotta kokoonpanon päivittäminen kokoonpanon tuonnissa CTT:n luomalla kokoonpanotiedostolla on mahdollista.
  • CTT tuottaa myös merkin luotuun määritystiedostoon, jonka on oltava läsnä tuontia varten.
  • Ilman alusta-asetuksia ja tiedostomerkintää konfiguraation tuonti toimii kuten ennenkin – se luo vain uusia objekteja eikä päivitä mitään (hyödyllinen tuotaessa koko konfiguraatio tyhjään tietokantaan).
• Kaikilla konfiguraation objekteilla on oltava määritellyt koodit : mallit, luokat, attribuutit, staattiset arvot, kansiot, roolit jne. CTT käyttää koodeja objektien yhdistämiseen ja erojen löytämiseen konfiguraatiosta.
  • ESM-toimintoja kohdassa Ylläpito → Järjestelmäasetukset → Suorita järjestelmätarkistus voidaan käyttää attribuuttien koodien etsimiseen ja lisäämiseen.
  • Jotta rooleille voidaan lisätä koodeja, alustan asetuksen adminrole.code.editable on oltava true .
• Vaikka kuuntelijan nimen päivittäminen päivämäärän tai versionumeron lisäämiseksi on nykyinen paras käytäntö, tällä hetkellä näet muuttuneen kuuntelijan muutokset vain , jos nimi pysyy samana .
  • Sama pätee muihin objekteihin , jotka tunnistetaan vain nimellä (mallitapahtumat, kojelaudat, näkymät, ajoitetut tehtävät).
    • Huomautus: CTT ei tällä hetkellä tue edellä mainittuja objekteja. Tuki saatetaan lisätä tuleviin versioihin.
• Staattisilla arvoilla on oltava koodit, jotta ne toimivat CTT:n kanssa.