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!
The Product Idea boards have gotten an update to better integrate them within our Product team's idea cycle! However this update does have a few unique behaviors, if you have any questions about them check out our FAQ.

Alteryx Designer Desktop Ideas

Share your Designer Desktop product ideas - we're listening!
Submitting an Idea?

Be sure to review our Idea Submission Guidelines for more information!

Submission Guidelines

Adding Example Links in Macro Descriptions

As seen in This Discussion Post,  the idea here is to be able to add a link to example workflows in macro descriptions - like the ones seen in native tools.

 

Filter ToolFilter Tool

Many thanks to @jdunkerley79 for demonstrating how this can be done by manually editing the macro's XML - specifically by adding a child element to the <MetaInfo> section, like so:

 

      <Example>
        <Description>Open Example</Description>
        <File>\\aSERVER\aRootDir\path\to\Alteryx\Macros\Date Wizard\Date Wizard Examples.yxmd</File>
      </Example>

One small caveat is that it doesn't support truly relative paths.  @PaulN explained in the discussion post that a relative reference here would search in the sample folders.

 

"Alteryx default behavior is to look for examples under .\Alteryx\Samples\02 One-Tool Examples or Alteryx\Samples\02 One-Tool Examples (or .\Alteryx\Samples\en\02 One-Tool Examples)."

 

Having said that, trying to reference a macro example in the same folder (using a relative reference) will throw an error given the following situation:

 

Package Structure:

Macro Package.png

Date Wizard.yxmc XML edits:

 

      <Example>
        <Description>Open Example</Description>
        <!-- THIS WORKS -->
        <File>\\aSERVER\aRootDir\path\to\Alteryx\Macros\Date Wizard\Date Wizard Examples.yxmd</File>
        <!-- THIS DOESNT
        <File>Date Wizard Examples.yxmd</File>
        <File>.\Date Wizard Examples.yxmd</File>
        <File>./Date Wizard Examples.yxmd</File>
        -->
      </Example>

This shows a link in the Macro description but yields an error (shown below) when it is clicked.

 

Example Link ShowsExample Link ShowsErrorError

 Once again, this works fine with an absolute file path reference.  

 

Here is ultimately what I am suggesting:  Can we add an option to the Interface Designer (that updates the XML) and have it allow relative paths?  Allowing relative paths would obviously be essentially to maintaining the macro's ability to be "lift-and-shift" when packaged/moved/uploaded to servers/galleries etc.

 

I'm assuming the option could look something like this, similar to the "Help" file -only it would show link in the macro description...

Interface Designer SuggestionInterface Designer Suggestion

In conclusion, this would be very useful in providing links to example workflows for custom macros that may be complex and/or not self-explanatory.

 

Cheers,

 

Taylor Cox

6 Comments
AlexKo
Alteryx Alumni (Retired)
Status changed to: Comments Requested

Thank you for this awesome idea @Coxta45! This is something we're considering for a future release.

 

For those that have expressed interest for this idea, I'd appreciate any additional feedback you may have.

 

Is there any other functionality that you think would be useful on the tool card description (either for custom macros or native tools)?

For example, we're considering adding links in the tool description to online references that may be related, such as Tool Mastery articles.

dataprep
8 - Asteroid

The example is probably the main issue for us. 

 

 

andrewdatakim
12 - Quasar
12 - Quasar

External links would be useful. There are occasions when we download external macros and the documentation is mainly on the website and not embedded in the download zip. It would be useful to use the method described to link the original source and support information. E.g. CREW macros linked back to ChaosReignsWithin.com and the specific blog post for the initial tool release.

Accrual
7 - Meteor

Any update on this? Unbelieveable if its not supported. 

Ajjay
8 - Asteroid

Any updates on this ?

Sooriya
6 - Meteoroid

Hi all, so far no updates relating to this use-case, and since I need to overcome this situation for my application, I've come up with a automation script using "Python" which can be handy for the users who are facing this issues on sample workflows("Open Example").

 

Refer to this for enhanced solution alongside the demo files attached to it. 

https://community.alteryx.com/t5/Public-Community-Gallery/Deploying-Custom-Macros-yxi-including-Samp...