ShoppingCartOrder Check Customization

Question

We have identified that products can only be checked in the shopping cart if they are standard products with AccProduct. If we want to check multi-request resources (QERReuse), such as for duplicate checks or compliance checks, we cannot use the standard libraries of One Identity because the logic is embedded deeply within the Customizer DLL. Currently, we have a script library that we can call as a customization in the shop, but we are unable to make any changes to it. Our goal is to provide an alternative item to be checked instead of objectkeyorderd, as objectkeyorderd and AccProduct are always the same. The code we have so far looks like this: #If Not SCRIPTDEBUGGER Then References NLog.Dll #End If '''

''' _CCC_ShoppingCartOrder_Check '''

''' ''' ''' Public Function _CCC_ShoppingCartOrder_Check(ByVal UID_ShoppingCartOrder As String, ByVal configJson As String) As String ' Variablen Dim counterror As Integer = 0 Dim countwarning As Integer = 0 Dim culLang As System.Globalization.CultureInfo = New System.Globalization.CultureInfo("de-DE") VI.Base.LanguageManager.SetSystemCulture(culLang) Dim log As NLog.LogSession = New NLog.LogSession(NameOf(_CCC_ShoppingCartOrder_Check),"") ' Erste Variante mit Submit Dim check = New QER.CompositionApi.ITShop.ShoppingCartSubmit(UID_ShoppingCartOrder) Dim ConfigJsonParm As String = check.GetConfigJson check.Check.Config.CheckMode = QER.CompositionApi.ITShop.CheckMode.CheckOnly Dim tCartItemCheckResult As QER.CompositionApi.ITShop.CartItemCheckResult log.Info("Shopping Cart: " & UID_ShoppingCartOrder & " will be checked...") Dim checkResult = check.CheckAsync(Session).Result log.Info("Check Config: ") log.Info(ConfigJsonParm ) ' Für alle Bestellpositionen Dim items = checkResult.Items() For Each tCartItemCheckResult In items ' Bestellpositionen Prüfungen durchführen log.Info(" > Cart Item " & tCartItemCheckResult.ToString & " check result...") Dim itemsChecks = tCartItemCheckResult.checks() ' Für alle gefundenen Prüfungsresultate For Each checks In itemsChecks ' Resulatat ausgeben log.Info(" > ID : " + checks.id + ", Status :" + checks.Status.toString + ", Title :" + checks.title) Select Case checks.Status.toString Case "Warning" countwarning += 1 Case "Error" counterror += 1 Case Else End Select Next Next Return " In " & CStr(items.count) & " Cart Items, there are " & CStr(countwarning) & " warnings and " & CStr(counterror) & " errors." End Function Any help would be appreciated!

Hanno Bunjes · Answer

Hi,

To add new checks to the IT shop, you can extend the Composition API with a plugin DLL. This process is very similar to adding an API server plugin, with some differences:

- It must be a separate DLL, it cannot be an API Server plugin.

- The DLL name must match the pattern *.CompositionApi.dll.

- Add assembly references to QER.CompositionApi.dll and QBM.CompositionApi.dll.

- You should deploy this DLL to all API servers and job servers. This is because the check results are stored as JSON and deserialized, and that fails if your custom check type cannot be found.

The basic process is also described here:
https://github.com/OneIdentity/IdentityManager.ApiSdk/blob/v93/doc/05-composition-api-plugins.md#shopping-cart-checks

However, the code on that page is for the upcoming 9.3 release, and the interfaces have slightly changed. I've made the changes for 9.2 in the code here. Obviously, there is a placeholder where the check logic should go, so you can insert any checking logic.

    public class CartCheckProvider : ICartCheckProvider, IKnownTypeProvider
    {

        public IEnumerable<Type> GetTypes()
        {
            return new[] { typeof(SampleCheck) };
        }

        public ICartCheck GetCartCheck(ICartItemCheckContext context)
        {
            return new SampleCartCheck(context);
        }
    }

    public class SampleCartCheck : ICartCheck
    {
        private readonly ICartItemCheckContext _context;
        private SampleCheck _check;

        public SampleCartCheck(ICartItemCheckContext context)
        {
            _context = context;
        }

        public IReadOnlyList<ICartItemCheck> GetItemChecks()
        {
            _check = new SampleCheck(_context);
            return new[] { _check };
        }

        public Task CheckAsync(CancellationToken ct = default)
        {
            return _check.ProcessAsync(ct);
        }
    }

    public class SampleCheck : ICartItemCheck
    {
        private readonly ICartItemCheckContext _context;

        public SampleCheck(ICartItemCheckContext context)
        {
            _context = context;
        }

        internal async Task ProcessAsync(CancellationToken ct = default)
        {
            var session = _context.Session;
            var cartitem = _context.Item;
            // Any logic required to calculate the check result should go here.
            // At the end we will have a result:
            Status = CheckStatus.Success; // ... or CheckStatus.Error
                                          // Set the description text to provide more information about the result.
            if (Status == CheckStatus.Success)
            {
                ResultText = "This check was successful";
            }
            else
            {
                ResultText = "This check failed";
            }
        }

        public string Id => "SampleCartItemCheck";
        public CheckStatus Status { get; set; } = CheckStatus.Pending;
        public string Title => "Sample customizable check";
        public string ResultText { get; set; }
        // Populate this property to append any serializable data to the result.
        public object Detail => null;
    }

ShoppingCartOrder Check Customization

Top Replies