topic Re: How do to include help doc with custom widget deployed to Portal? in ArcGIS Enterprise Portal Questions

How do to include help doc with custom widget deployed to Portal?

deleted-user-997AEHHSB7nZ — Fri, 07 Dec 2018 15:43:28 GMT

We deploy custom widgets to ArcGIS Portal (following prescribed workflow - Add custom widgets—Portal for ArcGIS | ArcGIS Enterprise) but we'd like to include a help doc along with our widget (like you can in Dev Edition - Add help for your widget—Web AppBuilder for ArcGIS (Developer Edition) | ArcGIS for Developers ). Is there a supported way to do that?

Re: How do to include help doc with custom widget deployed to Portal?

DerekLaw — Sat, 08 Dec 2018 03:57:50 GMT

Hi Pete,

Please take a look at these GeoNet threads,

Activate help link on home made widget

https://community.esri.com/message/669750-help-widget

Hope these help,

Re: How do to include help doc with custom widget deployed to Portal?

RobertScheitlin__GISP — Sat, 11 Dec 2021 14:12:05 GMT

Derek's links are what the WAB dev team have provided for adding help to a custom widget. I still find this to be a bit to involved and heavy handed when try to provide a simple help link for your custom widget. Here is a hack snippet of code I use to make my widgets link to help docs on a web server.

In the widget settings.js setConfig function.

    setConfig:function(config){
      //hack the 'Learn more about this widget link'
      setTimeout(function(){
        var helpLink = dojo.query('.help-link');
        helpLink[0].href = 'https://gis.calhouncounty.org/WAB/V2.9/widgets/eSearch/help/eSearch_Help.htm';
        html.setStyle(helpLink[0],'display','block');
      },600);
...‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Or you can have the link go to a help doc in the widgets folder by using a url like this.

helpLink[0].href = this.location.href.replace('?id=','apps/') + '/widgets/eSearch/help/eSearch_Help.html';‍

Re: How do to include help doc with custom widget deployed to Portal?

deleted-user-997AEHHSB7nZ — Mon, 10 Dec 2018 20:12:47 GMT

Thanks guys - appreciate the quick answers! The snippet you provided Robert Scheitlin, GISP‌ works in our test environment just fine thank you. One question, why the setTimeout? What needs to happen in that 600 ms before you run that code? Is the help link not actually there yet? I just wonder if there's a way to get this done without some kind of race condition.

Re: How do to include help doc with custom widget deployed to Portal?

RobertScheitlin__GISP — Mon, 10 Dec 2018 20:16:13 GMT

Pete that is because the WAB core code searches for the help doc in the path that WAB expects to find the help in and when it can not it hides the link.