SwaggerWcfTag hidefromspec seem to don't work about swaggerwcf

[abelsilva]

Hi

The parameter hideFromSpec on SwaggerWcfTag is used to hide the tag itself, not the function.
You can see it in the description:

Thanks

[JFDionne]

Ah, but if you don't want to see tag why you put the tag? :)

Can I change this Issue for make a suggestion to add a param for hide the tag and the function, like if we set the visible = false on the config file?

The point is to have all the tag visible false by default and enable only the tag I want into this endpoint.

[abelsilva]

the idea is when you use the tag to hide the functions, e.g., 'functionToHide'
You probably don't want that tag to show up in the spec, it is only for internal management

but if you want to hide a function you can use

[SwaggerWcfHidden]

[JFDionne]

okay, if I add [SwaggerWcfHidden] it will but the "visible" = false?
Do it will appear if I put tag name="Function_Tag" visible="true" into the web.config ?

[abelsilva]

I didn't get the question

the

[SwaggerWcfHidden]

will hide the function

if with the tag you ask to be visible, one of the actions will override the other

[JFDionne]

Sorry i'm not clear :)

I have 4 endpoint on the same projet, since we can't "choose" which projet I want to show up on the api-docs I use the
[tag name="Test_1_Tag" visible="true"]
[tag name="Test_2_Tag" visible="false"]
[tag name="Test_3_Tag" visible="false"]
[tag name="Test_4_Tag" visible="false"]
into the web.config.

and I put
<SwaggerWcfTag("Test_1_Tag")> on my code for each fonction of the endpoint, I'll use _2 _3 and _4 on the other.

My point here is, do we have a way for having the visible false by default so I can put only visible=true on the endpoint I want to see on the api-docs?

right now if I add another endpoint, I'll need to go on each web,config and add the visible=false for this projet.

[abelsilva]

Yes, you would need, by default it should true (like it is now)

I guess it would be ok to add a new parameter to the SwaggerWcfHidden to help on the cases you mentioned, to change the value of visible

[JFDionne]

it will be wonderful!

[abelsilva]

The idea is that you mark your methods with

SwaggerWcfHidden

and one SwaggerTag, e.g.:

SwaggerWcfTag("show")

If then, when you want to show them, just add to web.config:

<tag name="show" visible="true"/>

The web.config configuration will override the SwaggerWcfHidden tag

[abelsilva]

please let me know if it works for you, thanks!

[JFDionne]

Working, thank you ! :)

[JFDionne]

oups, I talked too fast, not working for me with version 18.

I put the tag on my Interface:

    <SwaggerWcfHidden>
    <SwaggerWcfTag("Service_TA_REST")>
    <SwaggerWcfPath("Info Véhicule", "Récupere l'information d'un véhicule" & vbCrLf & "
    Basic Authentification")>
    <WebInvoke(Method:="GET", RequestFormat:=WebMessageFormat.Json, ResponseFormat:=WebMessageFormat.Json, UriTemplate:="/v1/vehicule/{id}")>
    <OperationContract>
    Function Recupere_Vehicule_V1(id As String) As clsInfo_Vehicule_REST

and on my web.config:

but the tag doesn't appear, do I miss something?

[abelsilva]

As I said, one of the actions will override the other, and as we can see now, SwaggerWcfHidden will have more priority

If you want control from the web.config you don't need to use SwaggerWcfHidden

[abelsilva]

Sorry, it should work yes, let me check

[JFDionne]

Oh, but the use of SwaggerWcfHidden was not to be able to "force" to show it from the web.config?

[Sorry, I didn't see your last comment before I post this one]

[abelsilva]

Should work like I last described, something is probably wrong

The idea is that you mark your methods with

SwaggerWcfHidden

and one SwaggerTag, e.g.:

SwaggerWcfTag("show")

If then, when you want to show them, just add to web.config:

<tag name="show" visible="true"/>

The web.config configuration will override the SwaggerWcfHidden tag