netbox icon indicating copy to clipboard operation
netbox copied to clipboard

Event Rule Action Data passed to Script

Open renatoalmeidaoliveira opened this issue 1 year ago • 6 comments

NetBox version

v3.7.0

Feature type

Change to existing functionality

Proposed functionality

Currently EventRules passes a serialized version of the model as data to the linked Script, I think it would be better if the Action Data was processed like the Body Template of Webhoocks and passed to the Script.

Use case

It would allow users to build Script to react NetBox changes with the change context, currently the user cannot get directly the changelog. And by passing a parsed data with Event Data gives the plugin developer a lot of flexibility to build automations

Database changes

None

External dependencies

None

renatoalmeidaoliveira avatar Jan 21 '24 23:01 renatoalmeidaoliveira

I don't think we have a mechanism in place within a script right now to accept this data. Could you please expand your proposal above to specify exactly how a script would receive this data, in addition to the form data it currently accepts?

jeremystretch avatar Jan 22 '24 13:01 jeremystretch

In the current implementation the EventRule passes a serialized version of the instance as data to the script., so it isn't possible to pass any input to the Script using the EventRule. For example: The user wants that for every interface change a Script runs and perform Napalm checks on the interface, to implement that the user might need the Interface, the Device and the changes performed by the end user. But in the current implementation is only receives the changed object and the way it is passed to the Script it can't even be used as Script Inputs. The feature request aims to give the user an interface to setup what data should be passed to the Script when the changes happens

renatoalmeidaoliveira avatar Jan 22 '24 13:01 renatoalmeidaoliveira

In run_script data is passed as a dict where the keys are the Script Input, but when the Job is schedules in process_event_rules it passed as built in enqueue_object, (the serialized model) and that way it ain't gonna pass the expected dict to the Script since its expecting a dict with keys as the Script Inputs. I think that the Action Data (or any other field) could be used similar as the Templete body of webhooks using something like rende_body

renatoalmeidaoliveira avatar Jan 22 '24 14:01 renatoalmeidaoliveira

I think I get what this is saying.

Basically, you can define your data template for what is passed to a script.

This is originally what I thought "action data" wass for.

DanSheps avatar Jan 24 '24 18:01 DanSheps

@DanSheps I thougt that it was the purpose of "action data" too. And when I look to the rest of the implementation it makes sense for me change the context injected to the template body in the webhook to whatever the user wants to setup inside the action data

renatoalmeidaoliveira avatar Jan 24 '24 18:01 renatoalmeidaoliveira

I've assigned this to @renatoalmeidaoliveira with the understanding that its scope is limited to passing the action_data associated with an event rule directly to the script being executed, as if it were user input.

jeremystretch avatar Feb 14 '24 13:02 jeremystretch

@renatoalmeidaoliveira are you still planning to work on this?

jeremystretch avatar May 28 '24 12:05 jeremystretch

@jeremystretch yes, I've talked with @arthanson in slack and waiting for some guidance to move on

renatoalmeidaoliveira avatar May 28 '24 12:05 renatoalmeidaoliveira

From the Script Developer point of view I think that Action Data should be passed to the Script the same way as the Input Form and REST API. That means the only sending the blob JSON isn't a good idea

renatoalmeidaoliveira avatar May 28 '24 12:05 renatoalmeidaoliveira

@renatoalmeidaoliveira I notice your PR got robo-closed. Do you anticipate having time to work on it soon, or should I let it go?

jeffgdotorg avatar Jul 22 '24 16:07 jeffgdotorg