Role of ‘visibility’ attribute

In ZSPEC file, the following elements have the attribute named visibility

• Argument
• Contact details
• Content
• Operation
• Property
• Extend-property
• Extra-property
• Response
• Server
• Structure
• Tag
• Oauth2
• Token

The possible values of the attribute visibility are public, private, and internal.

• public : If the visibility is public, then the elements will be open to all.

• private : If visibility is private, then the elements will be considered for specific users / products / orgs. A user with visibility to private elements will have access to both private and public elements.

• internal : If visibility is internal, then the elements will be considered only for that particular product. A user with visibility to internal elements will have access to both internal, private and public elements.

Order of Visibility

Public > Private > Internal

The order of priority for the visibility attribute is from parent element to child element. i.e., the visibility of the parent element controls the visibility of the child element. For example, if the parent element’s visibility is private and the child element’s visibility is public, then the child element will be treated as private only.