Veelvoorkomende problemen en oplossingen

Overzicht van veelvoorkomende problemen die consultants tegenkomen bij Ultimo-implementaties en -beheer, met oplossingen en best practices.

Gerelateerd: workflows/workflow-engine, configuration/application-element-tree, configuration/process-settings

Records verwijderen met SQLbewerken

Probleembewerken

Records zijn per ongeluk aangemaakt (bijv. Jobs in een PO-model, of na een migratie/splitsing).

Oplossingbewerken

Gebruik de stored procedure dba.applsp_DeletePrimaryKey om records veilig te verwijderen inclusief alle gerelateerde records.

Stappen: 1. Selecteer de ID's die verwijderd moeten worden 2. Voeg ze in de dba.IdConversion tabel in met type 'D' 3. Zet de applicatie in maintenance mode 4. Voer de stored procedure uit

BEGIN TRY
    BEGIN TRANSACTION
    -- Selecteer te verwijderen records
    INSERT INTO dba.IdConversion (IdcOldId, IdcIdctId)
    SELECT j.JobId, N'D' 
    FROM dba.Job j 
    INNER JOIN dba.Equipment e ON j.JobEqmId = e.EqmId 
    WHERE JobRecCreateDate < DATEADD(Year, -10, SYSDATETIMEOFFSET());

    -- Maintenance mode aan
    UPDATE dba.SAPPLIC 
    SET SAPPMNTNOTICE = N'The database will be updated. Please stand by.',
        SAPPSUSEID = N'ummadmin';

    -- Verwijder records
    EXECUTE dba.applsp_DeletePrimaryKey 
        @cTableName = N'Job', 
        @cColumnName = N'JobId';

    -- Maintenance mode uit
    UPDATE dba.SAPPLIC SET SAPPMNTNOTICE = NULL, SAPPSUSEID = NULL;
    COMMIT TRANSACTION
END TRY
BEGIN CATCH
    IF @@TRANCOUNT > 0 ROLLBACK TRANSACTION;
    DECLARE @ErrMsg NVARCHAR(4000) = ERROR_MESSAGE();
    DECLARE @ErrSeverity INT = ERROR_SEVERITY();
    DECLARE @ErrState INT = ERROR_STATE();
    RAISERROR(@ErrMsg, @ErrSeverity, @ErrState);
END CATCH;

Let op: Zet ALTIJD maintenance mode aan vóór het uitvoeren van de stored procedure. Test altijd eerst in een niet-productieomgeving.

Scheduled workflows zijn gedeactiveerdbewerken

Probleembewerken

Standaard scheduled workflows zijn per ongeluk of bewust gedeactiveerd, wat leidt tot ontbrekende functionaliteit.

Oplossingbewerken

Controleer en heractiveer de volgende essentiële scheduled workflows:

Tip: Ultimo kan bij een release deze workflows automatisch heractiveren. Documenteer altijd waarom een scheduled workflow bewust is uitgeschakeld.

Pakket importeren met afwijkende Revision Basebewerken

Probleembewerken

Bij het importeren van een UCT-pakket in een omgeving met een andere Ultimo-revisie kunnen conflicten ontstaan.

Oplossingbewerken

1. Controleer de Ultimo Revision Base van het pakket vóór import
2. Als de revisie afwijkt: test eerst in een acceptatieomgeving
3. Controleer na import de Merged-status
4. Bij conflicten: los deze handmatig op in de configuration/package-manager

Screen designer: "In Development" elementenbewerken

Probleembewerken

Elementen gelinkt aan 'InDevelopment' feature toggles zijn zichtbaar in de screen designer maar kunnen niet worden geconfigureerd.

Oplossingbewerken

Dit is verwacht gedrag. Elementen gekoppeld aan 'InDevelopment' feature toggles worden read-only weergegeven met een 'under construction' icoon. Wacht tot Ultimo de feature vrijgeeft.

Data Collection templates tussen omgevingenbewerken

Probleembewerken

Templates met nieuwe syntax (Properties element, joins, filters) werken niet op oudere omgevingen.

Oplossingbewerken

• Maak templates pas aan op de test-omgeving als deze dezelfde versie heeft als productie
• Let op: het opslaan van 'oude' templates in de 'nieuwe' situatie converteert ze automatisch naar de nieuwe syntax

Jobstatus-updates bij materiaal per sitebewerken

Probleembewerken

Jobstatussen worden bijgewerkt op basis van totale voorraad in plaats van voorraad per site.

Oplossingbewerken

Activeer de process settings 'Waiting for material' en 'Material in stock'. Ultimo controleert dan of gereserveerde artikelen op dezelfde site als de job op voorraad zijn: - Goedgekeurde job → check voorraad op zelfde site - Niet op voorraad → status 'Waiting for material' - Weer op voorraad → status 'Material in stock' (op volgorde van geplande startdatum)

Negatieve voorraad bij barcode scannerbewerken

Probleembewerken

Bij voorraadmutaties via barcode scanner kan negatieve voorraad ontstaan.

Oplossingbewerken

Controleer de AET-setting Allow negative stock onder Barcode scanner. Zet deze op False als negatieve voorraad niet gewenst is. Zie configuration/application-element-tree.

Zie ookbewerken

• sql-referentie — Handige SQL-scripts voor Ultimo
• configuration/process-settings — Processpecifieke instellingen
• configuration/application-element-tree — AET-configuratie