Repository navigation
Commit 0352626
Document filter special characters and the wildcard workaround (#1906)
* Document filter special characters, wildcard searches and cieq
The filter docs only said ampersands and commas are unsupported, with no
workaround, and did not say which fields support wildcard searches or
the cieq and has operators. Document the asterisk workaround for values
containing & or , (with a client-side exact-match check), the REST API's
like operator and the fields it applies to, and add the missing
CaseInsensitiveEquals and Has operators to the operator lists.
Closes #1200
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Update the filter and sort endpoint and field list
The list named four endpoints and seven fields, far fewer than the
library supports. Describe the endpoints by what they accept and point
at RequestOptions.Field for the full set of fields.
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Record observed wildcard behaviour of Equals filters on Tableau Cloud
Checked against a Tableau Cloud site (REST API 3.30): an Equals filter
treats * as a wildcard at the start, end and middle of a workbook name,
which makes the documented workaround for values containing & or ,
work, while like, cieq and has are rejected with a 400 on workbook
names. Document this and remove the untested-workaround caveat.
Related to #1200
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Correct the filter docs: ampersands work, only commas need a workaround
Tested against Tableau Cloud: TSC percent-encodes the query string, so
an ampersand in a filter value is accepted. A comma is rejected even
when encoded or preceded by a backslash. The earlier text said both
characters failed.
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Explain that view filters use different value rules
Readers of the special-character and wildcard sections could apply them
to vf() export filters, where a comma separates alternatives, a
backslash escapes it, and asterisks are literal.
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Correct the case-sensitivity note for filter values
Equals on workbook, data source, project and user names, and on workbook
content URLs, ignores case. Equals on a group name is case-sensitive on
Tableau Server.
Refs #1200
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Use generic names in the filter examples
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Add an In operator example and note that vf encodes ampersands
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Correct the In list comma note: the value splits silently
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Qualify & encoding by REST API version and fix Value row
Values can contain &, but only from REST API 3.7 when TSC encodes the
query string. The Value row said & is not allowed.
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Scope the Equals wildcard note to what was tested
Prefix, suffix and middle * matched on workbook names (Tableau Cloud)
and project names (REST API 3.31), ignoring letter case.
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Say the wildcard behavior is not documented per version
Co-Authored-By: Claude Code <noreply@anthropic.com>
* Limit filter docs to confirmed behavior
Remove the operator and field scope claims, the case-sensitivity paragraph, the like operator table, the view filter section, the In list section and the version-specific encoding and wildcard claims. Keep the comma failure, the asterisk workaround, and the Has and CaseInsensitiveEquals operator rows.
Co-Authored-By: Claude Code <noreply@anthropic.com>
---------
Co-authored-by: Claude Code <noreply@anthropic.com>1 parent 76a0ab9 commit 0352626
2 files changed
Lines changed: 53 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3006 | 3006 | | |
3007 | 3007 | | |
3008 | 3008 | | |
3009 | | - | |
| 3009 | + | |
3010 | 3010 | | |
3011 | 3011 | | |
3012 | 3012 | | |
| |||
6163 | 6163 | | |
6164 | 6164 | | |
6165 | 6165 | | |
| 6166 | + | |
| 6167 | + | |
6166 | 6168 | | |
6167 | 6169 | | |
6168 | 6170 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
35 | 35 | | |
36 | 36 | | |
37 | 37 | | |
38 | | - | |
| 38 | + | |
39 | 39 | | |
40 | 40 | | |
41 | 41 | | |
| |||
50 | 50 | | |
51 | 51 | | |
52 | 52 | | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
53 | 57 | | |
54 | 58 | | |
55 | 59 | | |
56 | 60 | | |
57 | 61 | | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
58 | 102 | | |
59 | 103 | | |
60 | 104 | | |
| |||
219 | 263 | | |
220 | 264 | | |
221 | 265 | | |
| 266 | + | |
| 267 | + | |
| 268 | + | |
| 269 | + | |
| 270 | + | |
0 commit comments