This came up in Query with cachedwithin breaks valuelist - #2 by andreas
I didn’t realise until now these were depreciated, I used these two all the time, so never visit the docs for it… as i know how to use them… and somehow missed them in the release docs (which with auto-updates even between versions are probably easy to miss these kind of changes. In CFDOCS this is not marked as depreciated.
The docs say ‘depreciated’ but don’t point to alternate functionality (because it’s not documented that i can see)… not sure the best way to do this so leaving it to the doc ninjas… but we need verbose docs on depreciated flag docs.
So these two items (valuelist/quotedvaluelist) need further docs to show what should be used, something that should be done with anything that is depreciated IMHO… should be 'this is depreciated - use {link to alternate} instead ’ or even directly put an example of replacement code (especially if no docs on how to do that)
QueryColumnData().toList(",") for instance could be used as example replacement code.
and then to replace QuotedValueList becomes :queryColumnData().toList(...).qualifyList(...) … would be great to just have a toQualifiedList() also… as now it’s becoming cumbersome and almost defeats the point of removing the other functionality as it overcomplicates a simple functionality IMHO.
This is also not documented in QueryColumnData and query.columnData which IMHO it should be especially if it is replacing something that’s been in the language for over 20 years… this would make it obvious for new devs (and old time devs that forgot this changed)
3 posts - 3 participants