MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.29k stars 21.48k forks source link

What role does CreateStringClaim play in looking up content from a RestrictionEnumeration? #48705

Closed John-Garland closed 4 years ago

John-Garland commented 4 years ago

The description for the Paragraph UserInput Type reads:

To display one of the Enumeration values in a responseMsg claim, use GetMappedValueFromLocalizedCollection or CreateStringClaim claims transformation. For more information, see String Claims Transformations.

While the GetMappedValueFromLocalizedCollection description does in fact include a description of how to look up content from the Enumerations, CreateStringClaim has no such description - it isn't clear if that is involved in any way at all.

At the risk of conflating what may be 2 separate issues, why is the discussion of Enumeration Restriction values placed within the Paragraph user type, when it seems like the transformation (and hence display) works with any display type and/or if the claim doesn't even have any User Input Type at all? Is it meant to be "in case you'd like to do something interesting with Paragraph, you can do this? Or is there some intent that this should only be done when specifying a Paragraph UserInputType?


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

BharathNimmala-MSFT commented 4 years ago

@dotnetgator Thank you for your query, we will further look into it and get back to you at the earliest.

yoelhor commented 4 years ago

Thanks for your feedback. The doc will be updated Monday morning (PST). Please see the section Enumeration