Introducing: The Function Executioner 🪓 (A Testing Tool)

[josecgomez]

Inspired by Insights and this gem from @klincecum

Starting my Kinetic Journey (Like for real this time)

Well, can’t put it off forever, so been playing with stuff. I really want to just play with all the advanced stuff, but I guess I should do the boring stuff too. But on that note, I have been playing a lot with a few things. dashboard-timer-set → nice, you can abuse this thing file-transfer-kinetic → love it, used it before, but yay! Anything cool y’all have found?

I decided it was time to finally get off my derriere and really learn how to use Application Studio. Like actually use it. Not just click around, move a label, and feel accomplished. I’ve been lucky to have the Queen of Kinetic herself, @hmwillett, on my team, so I’ve been coasting, clutching my beloved Classic screens like a security blanket. But alas, the time has come…

“The time has come for all good men (and women) to come to the aid of their crappy quasy finished ERP Ux experiment?.”

…that ERP being Kinetic, of course. The one we know, love, and roast daily.

So, for my first real Kinetic project, I decided to truly test my patience (and my will to live) by building a Dynamic Function Tester UX in App Studio.

And thus was born:
THE FUNCTION EXECUTIONER

(No, the name has nothing to do with the existential crises triggered by the tooling and my urge / desire to get a bit stabby…erm I mean cough…. Nothing at all. )

After much weeping, gnashing of teeth, and gentle screaming into the void, I’m proud to say it works! And dare I say… works just as well as the Classic version we wrote a while back. Sure, I had to bend a few rules, maybe summon a few demons… but I made it through.

Kinetic and I aren’t friends yet. But we’re at least nodding acquaintances.

Kinetic UX Function Executioner (A Testing Tool)

It should be able to run any function in your system (published or not) and it will generate a Parameter Entry Form via a Dynamic Panel regardless of the Parameter Types.

This was written in 2025.1 but if you need it for an older-version, I might be persuaded to try and back port it to 2024 (see below for 2024.1> compatible version)

Function Library (Required)
EFXRunner.efxb (7.2 KB) >= 2025.1
EFXRunner_2024.efxb (7.2 KB) >= 2024.1

Make sure that you give your Company Acccess to the Functions (after import) and that you promote it

(App and Layer)
The App is Called: Ice.UIDbd.FunctionTester (This was named before App Studio took all my will to live away)
FunctionExecutionerAppAndLayers.zip (6.4 KB) >= 2024.1

How to Import:

Solution Workbench
If you have issues importing the Layer (After you try the above zip) try using this cab in solution workbench
FunctionExec_Customer Solution_4.3.100.0.cab (5.5 KB) >= 2024.1

If you play with it, enhance it, or have issues with it let me know!

[hmwillett (Hannah Willett)]

[Mark_Wonsil]

@josecgomez

but if you need it for an older-version, I might be persuaded to try and back port it to 2024

So…yeah.

Or, if it’s all in a single or few C# code block(s), could you share that?

[josecgomez]

The EFX is C# so that’s easy, the layers… welll that’s a different story. But… let me see if I can get it converted.

[Mark_Wonsil]

@josecgomez

The EFX is C# so that’s easy

Thanks! THIS is the part that interests me ATM, but if you do the layers, that would be cool too!!!

[josecgomez]

Here is the EFX for 2024.1>
EFXRunner_2024.efxb (7.2 KB)

The Layers Import Fine

[chaddb (Chadd Blanchard)]

@josecgomez

Here is the EFX for 2024.1

Thanks @josecgomez!

[josecgomez]

Chadd you are in 2023? or is that old? I don’t have a version that far back to back port

[chaddb (Chadd Blanchard)]

Only for a little while longer. Finishing up testing on 2024.

[mbayley (Michael Bayley)]

Well done!
Let’s hope Epicor adds something similar in the “power tools”. Directly in functions maintenance would be great

[josecgomez]

@mbayley

Directly in functions maintenance would be great

We did a Customization for that Earlier that works great

EFX Testing From the Screen

This came up in a lot of classes this last week so I have pinned this topic. PSA. It is very possible and will save a ton of time and frustration. Handles published and unpublished libraries. PM me if you want a copy of the customization it will require some altering. @josecgomez has his updated for older versions of Kinetic. It will require [image] [image] My exported customization for this. UI.EfxLibraryMaintenance.EfxMainForm_Customization_WCI_EfxLibraryMaint_v1_CustomExport.xml (34.5 K…

[klincecum (Kevin Lincecum)]

@josecgomez

We did a Customization for that Earlier that works great

I modified it a bit to be completely generic and can show you how to install it properly.
I’ll see if I can post that update today.

It’s fantastic.

EFX Testing From the Screen

Ok folks, I said I would, and here it is. I did some very minor edits to the code to make this completely generic. Basically I removed the need to add an API key, the tester will now build everything from your session. I also promised a little blurb on how to install it. Well I went a little further and added a UBAQ to do the menu portion for you. File → FunctionTester.zip (39.9 KB) Inside that zip, you will find two files. A customization file: UI.EfxLibraryMaintenance.EfxMainForm_Cust…

[klincecum (Kevin Lincecum)]

@josecgomez

(No, the name has nothing to do with the existential crises triggered by the tooling and my urge / desier to get a bit stabby…erm I mean cough…. Nothing at all. )

I could tell y’all the real reason, but then I’d have to kill you.

[josecgomez]

One Generic Comment about something I ran into which I thought was interesting.

There is no built in tooling in the Epicor Back end to run a Generic Function. You can run specific imported functions (which give you very nice typed objects).

But there is no mechanism I could find to just run any arbitrary function back there. I had to get creative and go the REST route which isn’t great but it did allow me to stretch my creative muscle regarding authentication and API keys but… it works!

[klincecum (Kevin Lincecum)]

That’s why I made one called Function Runner lol.

I’ve got one tiny bit of reflection to remove, but you can run whatever, whenever.

[klincecum (Kevin Lincecum)]

Cleaned up the mess, if you want to go down the debug rabbit hole, go here:

https://www.epiusers.help/t/function-executioner-debug-thread-lol/125957

Back to praising Jose for his awesomeness.

[Mark_Wonsil]

@klincecum

if you want to go down the debug rabbit hole, go here:

This reply has Wings.

EDIT: For the youngsters, “Paul McCartney and …”

[klincecum (Kevin Lincecum)]

@Mark_Wonsil

For the youngsters

I got it later lol

[utaylor (Utah Taylor)]

That’s awesome can’t wait to try it out!