Apply Conditional Layout (ACL) Settings are Lost During Package Installation and ACL Settings Included in Package Fail to Install in Archer

[KB-Sync1]

Article Number

000036336

Applies To

Product(s): Archer
Version(s): All Versions
Primary Deployment: On Premises/AWS Hosted/AWS SaaS

---

Description

When packaging from any instance to another instance, including from and to the same instance:

• All existing apply conditional layout settings for the application are lost
• All apply conditional layout settings included in the package fail to install.

The following error is logged into the JobFramework log file during package installation:

<E2ETraceEvent xmlns="http://schemas.microsoft.com/2004/06/E2ETraceEvent">;
   <System xmlns="http://schemas.microsoft.com/2004/06/windows/eventlog/system">;
        <EventID>7</EventID>
        <Type>3</Type>
        <SubType Name="Error">0</SubType>
        <Level>LEVEL ID</Level>
        <TimeCreated SystemTime="2024-05-03T11:32:22.8991438Z" />
        <Source Name="Archer.Kernel.Packaging" />
        <Correlation ActivityID="{ed050341-4e88-4c74-849e-ee615df1f7ef}" />
        <Execution ProcessName="ArcherTech.JobFramework.Job" ProcessID="43484" ThreadID="1" />
       <AssemblyVersion>6.15.0.10392</AssemblyVersion>
        <Channel />
        <Computer>xxxxxx</Computer>
    </System>
    <ApplicationData>
        <TraceData>
            <DataItem>
                <TraceRecord Severity="Error" xmlns="http://schemas.microsoft.com/2004/10/E2ETraceEvent/TraceRecord">;
                    <TraceIdentifier>Archer.Kernel.Packaging</TraceIdentifier>
                    <UserId>XXXX</UserId>
                    <LogReferenceId>050324-113222-6424</LogReferenceId>
                    <Description>Object reference not set to an instance of an object.</Description>
                    <AppDomain>ArcherTech.JobFramework.Job.exe</AppDomain>
                    <Exception>
                        <ExceptionType>System.NullReferenceException, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</ExceptionType>
                        <Message>Object reference not set to an instance of an object.</Message>
                        <Source>ArcherTech.Kernel</Source>
                        <StackTrace>   at ArcherTech.Kernel.Brokers.Packaging.Install.Actions.LayoutInstallAction.
&lt;&gt;c__DisplayClass11_1.&lt;EnsureKeyField&gt;b__4(LevelLayoutSectionBase section)
   at ArcherTech.Utility.ExtensionMethods.CollectionExtensions.FindFirstSection(IEnumerable`1 tabs, Func`2 match)
   at ArcherTech.Kernel.Brokers.Packaging.Install.Actions.LayoutInstallAction.EnsureKeyField(InstallContext context,
 LevelLayout returnLayout, LevelLayout sourceLayout, LevelLayout existingLayout)
   at ArcherTech.Kernel.Brokers.Packaging.Install.Actions.LayoutInstallAction.PrepareOverrideLayout(InstallContext
 context, LevelLayout returnLayout, LevelLayout sourceLayout, LevelLayout existingLayout, Module sourceModule, 
Boolean updateItems)
   at ArcherTech.Kernel.Brokers.Packaging.Install.Actions.LayoutInstallAction.UpdateLayout(InstallContext context,
 LevelLayout sourceLayout, LevelLayout existingLayout, Boolean overrideLayout, Boolean updateItems, Module 
sourceModule)
   at ArcherTech.Kernel.Brokers.Packaging.Install.Actions.LayoutInstallAction.&lt;&gt;c__DisplayClass3_0.&lt;
InstallLayout&gt;b__0(InstallContext context, ExecuteActions`1 actionExecutor)</StackTrace>

                    </Exception>
                </TraceRecord>
            </DataItem>
        </TraceData>
    </ApplicationData>
</E2ETraceEvent>

Cause

The issue is a result of the following:

• The instance that generated the package has a key field off layout
• The instance that the package is being installed to has a key field off layout.

This is causing the package installation to fail without installing the apply conditional layout settings from the package.

Workaround

On the instance that created the package:

1. Drag the key field onto the layout.
2. Create an ACL to always hide this key field if it is required that the key field is not visible.
3. Create a new package of this application and install into destination instance.

Notes

There has been an idea submitted to change this behavior. You can vote on it here: Redesign packaging so it doesn't fail horribly when key fields are off layout or block users from se... - Archer Community - 663411 (archerirm.community)

Defect ID

CE-6705