Question

Sharing RunBooks/Templates/Data Transformation scripts for custom integrations?

  • 21 October 2020
  • 16 replies
  • 143 views

Userlevel 1
Badge +1

Loving the new Community platform, congratulations on the launch.

Is there a mechanism/place for sharing RunBooks/Templates/Data Transformation scripts for custom integrations through the community?


16 replies

Userlevel 5
Badge +2

Not at the moment! But we definitely have plans for this. For now, everyone can certainly share their workflows in the #workflows channel or the Workflows section of the community. Be on the look out for easier ways to share and import Workflows in the future 👍



Sent via Slack Thread
Userlevel 1
Badge +1

Sounds great. It was more specifically sharing of Data Transformation Scripts / Pre-Request Scripts for custom integrations. I’d like to share and gain insight from others.



Sent via Slack Thread
Userlevel 5
Badge +2

Ohhh I see. Yea for the custom scripting this channel is likely your best bet. You'll also be able to see community built & created custom integrations within the app



Sent via Slack Thread
Userlevel 5
Badge +2

Ohhh I see. Yea for the custom scripting this channel is likely your best bet. You'll also be able to see community built & created custom integrations within the app



Sent via Slack Thread
Userlevel 2
Badge +2

What do you think about a GitHub repo @simon ?

Userlevel 1
Badge +1

Yes, seems a great idea to me. I checked out this one, but not much in there that was relatable.

This was my first guiding star… 🙏🌟 .

I can’t see community built apps in Integration center for some reason, only BetterCloud built. My specific use case was for Showpad, from which the logo already existed when building the custom integration, which suggests someone, somewhere has already done part of the work.

The biggest contribution from me (or I should say you @jb.lovell is some of the custom actions we built around apps that transfer files when de-provisioning.



Sent via Slack Thread
Userlevel 2
Badge +4

@simon this is a fantastic topic and hits home. It sounds like it would be good to not only share but also see what others have created/built, and then have a repository of that or even a “Getting Started with Custom Integrations” use case examples with examples around scripts and steps taken to achieve automation.

Let me know if I am in the right swim lane! I am also actively working on the integration Github repo, specifically around Powershell extensible use cases.

Happy to hear your feedback and ideas!

Userlevel 1
Badge +1

Yes, that sounds great!

• A developers forum/guide for (non-developer) SaaS Ops Admins.
• A custom integration treasure trove. Demonstrating some of the most common use cases, which in my experience is generally data transformation. Creating the webhook and headers isn’t usually the challenge. Documentation on vendors sites are generally good for this. However most vendors don’t support email address in the webhook call which of course is what we want to use from BetterCloud as a dynamic attribute.
I guess the dream is a ‘virtual’ bar where Developers and SaaS Ops admins drink beer and cocktails and reminisce about the countless hours previously spent finding the missing { in their pre-request script (that they googled and copied from a random forum) for a custom integration, to find they had no idea what payload to use or what to adjust the url to in the webhook.🧐 😂.

Happy to suggest/contribute to some use cases to get started if and when needed.



Sent via Slack Thread
Userlevel 2
Badge +4

The dreaded { has been my arch nemesis for a long time :sweat_smile:. Looks like we have the same common enemy! As it pertains to sipping on your favorite adult beverage at the poolside clubhouse, let me whip up an example of that automation celebration!

I can tell you, one nerd to another, that the most common issues typically revolve around placement of code and how to pass a payload in a respectable coding manner - this is something I have spent countless nights researching and documenting, understanding the caveats, gotchas, and the AHA! moments to keep it as flexible but simple as possible for those who just need to plug and play that old casette tape API. 

@simon - once I have this all mocked up, we should discuss this with @jb.lovell and setup that coding cocktail meeting. What say you!?

Userlevel 2
Badge +4

:one:Lesson 1:  Show Me The Code 101

  • CTRL C + CTRL V
  • How it works
  • What you need
  • Resources

:two:Lesson 2: Common Coding Mistakes: 

  • To many things happening in one function
  • Wait..that shouldn’t be there
  • What’s a variable?
  • Comments save lives
  • Take a break, don’t make this mistake
  • Do you even copy paste?

:three:Lesson 3: I don’t Node What You Are Talking About

  • What’s a Node?
  • How Node works
  • Node script example
  • Global Object
  • Create/load module
  • Wrapper Function
  • Events Module

:four:Lesson 4: Your first custom app! :100:

@simon let me know your thoughts. Of course this is just a high level example but this is where I want to get your feedback. How can we represent a format that adds repeatable value and conveys technical topics to a larger audience of no-code or low code IT admins?

Userlevel 1
Badge +1

Brilliant. Totally on mark! I think you’ll have a tonne of customers, newbies and admins tapping in to this resource and adding more bang for their buck on your platform! Absolutely up for it coding cocktail meeting!

I’d potentially add (if not already covered);
Lesson 2: interpreting errors (Good luck on this 🤯)

Lesson 4: Get hooked and and transform your data
• How your script relates to a webhook
• Changes to your api webhook/payload when using Data Transformation Script
• examples (Queue @jb.lovell Youtube video part 2)
Lesson 5: Your first custom app!

I think this could potentially work in a Wiki format, referencing examples hosted in GitHub. Personally, I’d like to see a source of truth, BetterCloud driven, something I know I can trust and isn’t editable by the public (and isn’t syphoning all my data off to the dark web for a tidy sum (when I do copy/paste an example 💵 😂). Then build community script repositories and forums for contributing, sharing, caring and helping others around it. I think a Resource library for self help would be useful. There is a tonne of stuff on the net, but were does one start looking.

House rules, organised and searchable, will also be key for adoption.
A repeatable process outlined for sharing templates could be useful.

I think this is a great starting point, and could be something pretty special for your platform and custom integration adoption.



Sent via Slack Thread
Userlevel 2
Badge +4

Radical! @simon thank you for all this feedback! Stoked to partner with you on this. I am synching internally with our team and going to reach out to directly. Stay tuned.

Also, cheers are in order, to the weekend!:tropical_drink::beers:

Userlevel 2
Badge +4

@jb.lovell @mike-bc - we should add this to the live stream session and have @simon as our guest of honor!

Userlevel 5
Badge +2

for sure, @simon would you be interested?



Sent via Slack Thread
Userlevel 2
Badge +4

@simon @jb @mike-bc 

Chiming back in on this - when can we schedule a time for this session? We can even do a brainstorm :nerd: cocktail session and then determine how we incorporate other sessions in the new year.

Excited to sync up soon!

Userlevel 1
Badge +1

Hi Chris. I hope you are doing well. Apologies for the silence. Happy to contribute where I can.



Open Thread in Slack

Reply