Community Spring Cleaning week is here! Join your fellow Maveryx in digging through your old posts and marking comments on them as solved. Learn more here!

Alteryx Server Discussions

Find answers, ask questions, and share expertise about Alteryx Server.
SOLVED

Governance / Documentation Considerations

jes115
6 - Meteoroid

We are working on building out our documentation and wondering what you recommend having in place. What do you require of workflows before they can be shared on the Server (any specific sanitizing procedures? posting requirements? peer review?) What types of Collections or Districts do you recommend to keep things organized? Anything else you didn't think of right away that needed to be outlined and shared with your team?

 

Thanks!

3 REPLIES 3
Harbinger
9 - Comet

Because Alteryx is a self service tool, I like to keep the path to production relatively low-drag. That said, a poorly engineered workflow can cause issues so there are some things that I like to check. Also, for business critical workflows, I will have the equivalent of a code review and testing. 

 

Input/output errors are pretty common. To prevent these, I always suggest clients use Gallery Connections for databases-- these have oodles of other benefits beyond execution durability. For file inputs, make sure that the workflow is pointed to fully qualified network path that the server run as account has access to.

 

If the workflow references custom macros, they will need to be in a repository the server and the client has access to (see Creating Network Drive in this community article

 

I like to use a documentation template and containers to make sure the workflow is standardized. This is something that I don't force-- instead have some fun and have a competition to see what groups can have the most documented workflows and then give them company swag and cred if they win. 

Harbinger_0-1601586297569.png

Harbinger_1-1601586366200.png

 

As far as organization goes, districts will organize your publicly available workflows collections will be used to share non-public workflows.

 

For districts, I will typically just have one per department. sometimes, when there are nuances in a department, I may have more than one. For instance I may have Marketing-Experiential and Marketing-Social Media districts. 

 

regarding collections, one per department has worked well here too. This will also work for cross departmental collaboration. For instance, Data Governance + Human Resources collection for workflows they need for collaboration.  

 

Also, less organization for the end user and more for admins: USE GROUPS. this will make your life much easier! 

 

Those are my initial thoughts!

 

 

 

 

 

 

 

 

jes115
6 - Meteoroid

Hi @harbinger - super helpful insight, thank you so much for responding!

esoden
8 - Asteroid

Capitalize has built a platform to help with documentation, governance, and streamlined administration for Alteryx. You can get a ton of information, demos, and even try the documentation tool here: https://capitalizeconsulting.com/workflow-admin-manager/

 

We are constantly enhancing the product. Let us know if there's a functionality you need and we'll build it if we don't already have it (assuming we can!).