Package Manager
De Package Manager is het versiebeheer- en distributiemechanisme voor alle UCT-aanpassingen. Pakketten worden gebruikt om configuratiewijzigingen te transporteren tussen Ultimo-omgevingen in een OTAP-straat (Ontwikkeling, Test, Acceptatie, Productie).
Gerelateerd: uct-overzicht, screens, workflows/workflow-engine
Locatie in UCTbewerken
UCT > Package Manager
Schermindelingbewerken
Navigatieboom (links)bewerken
Categorieën: Entities, Workflows, Business Rules, System Configuration, Agenda Integration, Development.
Pakkettenlijst (midden)bewerken
| Kolom | Beschrijving |
|---|---|
| Name | Bestandsnaam (vaak met datumprefix) |
| Valid | Of het pakket geldig/gevalideerd is |
| Title | Korte beschrijving van het pakketdoel |
| Description | Uitgebreidere beschrijving |
| Revision | Revisienummer |
| Merged | Of het pakket is samengevoegd met de omgeving |
| Custom code | Of het pakket aangepaste code bevat |
| Date | Aanmaak-/uploaddatum |
Detailpaneel (rechts)bewerken
- General tab — Name, Description, Ultimo Revision Base, Custom code, notities
- Info tab — Technische bestandsgegevens
Werkwijzebewerken
Pakket aanmakenbewerken
- Maak configuratiewijzigingen in de UCT (O-omgeving)
- Exporteer de wijzigingen als pakket via Package Manager
- Geef het pakket een beschrijvende naam en titel
Pakket importerenbewerken
- Upload het pakket naar de doelomgeving (T/A/P)
- Controleer de Ultimo Revision Base — deze moet overeenkomen met de doelomgeving
- Importeer en controleer de Merged-status
Praktische tipsbewerken
- Naamgeving: Gebruik altijd een beschrijvende naam (bijv.
2026-03-15_JobScreenAanpassing_KlantX) - Revision Base: Als de revisie van de doelomgeving afwijkt van de pakketbasis, kunnen er conflicten ontstaan
- Controleer na import: Verifieer altijd de Merged-status
- Custom code: Pakketten met custom code vereisen extra aandacht bij upgrades
- Documenteer: Leg vast welke pakketten naar welke omgevingen zijn gepromoveerd
Valkuil: Importeer nooit een pakket rechtstreeks naar productie zonder eerst te testen in acceptatie. De OTAP-straat bestaat niet voor niets.
Stap-voor-stap: Pakket aanmaken en opnemenbewerken
1. Nieuw pakket aanmakenbewerken
- Open Package Manager via het UCT-hoofdmenu
- Klik Add (Ctrl+Alt+N) in de toolbar boven de pakkettenlijst
- Klik Edit (Ctrl+Alt+E) in het detailpaneel
- Vul de velden in:
- Title — Beschrijvende naam (bijv. "JobScreenAanpassing_KlantX")
- Customer reference — Referentie van de klant
- Ultimo reference — Referentie van Ultimo
- Remarks — Aanvullende opmerkingen
- Klik Save (Ctrl+Alt+S)
2. Opname starten (recording)bewerken
- Selecteer het pakket in de lijst
- Klik Start recording — het rode opname-icoon verschijnt rechtsboven in de navigatiebalk
- De pakketregel krijgt een rode balk aan de linkerzijde en vetgedrukte tekst
- Voer nu configuratiewijzigingen uit in de UCT
Acties die automatisch worden opgenomen: - Gebruikers aanmaken/wijzigen (scherm Users) - Groepen aanmaken/wijzigen (scherm Groups) - Wijzigingen aan de Application Element Tree - Menuwijzigingen (Menu Designer) - Schermregistraties toevoegen/wijzigen (Screens) - Explorers en Explorer Links wijzigen - Master Data Setup kopieeracties - Text Templates wijzigen - Workflow Scheduler wijzigingen
Bestanden die handmatig worden toegevoegd: - Screen files — bij het publiceren van een scherm in de Screen Designer - Workflow files — bij het publiceren van een workflow in de Workflow Designer
Let op: Nieuwe workflows of wijzigingen aan bestaande workflows worden NIET automatisch opgenomen. Je moet de workflow-bestanden apart overdragen of ze publiceren naar het pakket.
3. Opname pauzeren/hervattenbewerken
- Klik Pause recording om tijdelijk te stoppen (icoon verandert)
- Klik Resume recording om door te gaan
- Je kunt ook via het rode icoon rechtsboven in de navigatiebalk pauzeren/hervatten
4. Opname stoppenbewerken
- Open de Package Manager
- Selecteer het opnamepakket
- Klik Stop recording
- Als bestanden out-of-sync zijn verschijnt een dialoog; klik Synchronise om bij te werken
5. Bestanden in het pakket controlerenbewerken
- Ga naar het tabblad Files in het detailpaneel
- Klik Validate files om te controleren of bestanden in het pakket overeenkomen met de omgeving
- Bij een afwijking verschijnt het icoon "Out of sync" — klik Synchronise om bij te werken
Stap-voor-stap: Pakket transporterenbewerken
Downloadenbewerken
- Selecteer het pakket in de Package Manager
- Klik Download (Ctrl+Alt+D) — het .up-bestand wordt gedownload
- Bewaar het bestand op een veilige locatie
Let op: Wijzig nooit de extensie (.up) van het pakketbestand.
Uploadenbewerken
- Open de Package Manager in de doelomgeving
- Klik Upload (Ctrl+Alt+U)
- Klik Select en kies het .up-bestand
- Klik OK — het pakket verschijnt in de lijst
Stap-voor-stap: Pakket validerenbewerken
- Selecteer het pakket (moet een opname bevatten en Revertible zijn)
- Klik Validate in het detailpaneel
- Bij succes: melding "validation succeeded without conflicts"
- Bij conflicten: waarschuwing met de specifieke issues
Tip: Valideer altijd voor het toepassen. Conflicten kunnen optreden bij afwijkende databasestructuren of ontbrekende afhankelijkheden.
Stap-voor-stap: Pakket toepassen (Apply)bewerken
- Selecteer het pakket
- Klik Apply in het detailpaneel
- Bij succes: bevestigingsdialoog
- Bij fouten: foutmelding met details
- Na toepassen wordt de knop Revert beschikbaar
Stap-voor-stap: Pakket terugdraaien (Revert)bewerken
- Selecteer het toegepaste pakket
- Klik Revert in het detailpaneel
- Alle acties worden ongedaan gemaakt
Waarschuwing: Als het pakket de bestanden
applicationelement.appelenapplicationstructure.appstrubevat, wordt de AET naar de factory default teruggezet!
Pakketten samenvoegen (Merge)bewerken
- Selecteer meerdere pakketten (Ctrl+klik)
- Klik Merge selected packages
- Controleer de volgorde (de selectievolgorde bepaalt de mergevolgorde)
- Klik OK
Het samengevoegde pakket bevat de acties van alle bronpakketten in de opgegeven volgorde.
Pakketbestandenbewerken
Elk pakket bestaat uit twee bestanden in de map FileServiceData/Packages:
| Extensie | Beschrijving |
|---|---|
| .up | Pakketinhoud die kan worden toegepast |
| .rup | Rollback-bestand voor het terugdraaien |
Het .rup-bestand wordt aangemaakt bij opname of bij het toepassen van een geupload pakket.
Pakketindicatorenbewerken
| Kolom | Beschrijving |
|---|---|
| Auto | Automatisch aangemaakt (geen actieve opname) of handmatig opgenomen |
| Revertible | Kan worden teruggedraaid (vinkje) |
| State | Recording-status: Started, Paused, Stopped |
| Current user | Gebruiker die momenteel opneemt |
- Rode balk links = jouw actieve opname
- Oranje balk links = opname door andere gebruiker
Tip: Je kunt een opname van een andere gebruiker overnemen door Start recording te klikken op hun pakket en "Yes" te bevestigen.
Zie ookbewerken
- uct-overzicht — Overzicht van alle UCT-onderdelen
- workflows/workflow-engine — Workflows in pakketten
- screens — Schermpublicaties in pakketten