Hidden property doesn't work as expected.
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 45/100
Research direction
Start with Workbook initialization and the field hidden method referenced in the issue, then run the provided reproduction against CheckBook_2021.2_sql.twb. Compare fields whose XML lacks the hidden attribute with the method's documented return values. Done means the behavior and docstring consistently communicate the intended True/False result, with coverage for fields without the attribute.
Written by the indexing model from the issue text.
Description
Hi. Release 0.10 brought ability to get status of field, either it hidden or not. But in fact Tableau workbook doesn't contain xml attribute for every field, only for hidden. So after initialisation Workbook object if you check fields you will see two values False or None.
But code and docstring inside hidden method tells that as a user I should expect only True False values. Am I right that it's a bug and None values have to be handled?
Code to reproduce:
import tableaudocumentapi
wb = tableaudocumentapi.Workbook('CheckBook_2021.2_sql.twb')
import pandas as pd
fs = []
for s in wb.datasources:
for k in s.fields:
try:
id = s.fields[k].id
except:
pass
try:
name = s.fields[k].name
except:
pass
try:
caption = s.fields[k].caption
except:
pass
try:
calculation = s.fields[k].calculation
except:
pass
try:
hidden = s.fields[k].hidden
except:
pass
fs.append({'ds': s.caption,
'id': id,
'name': name,
'caption': caption,
'calculation': calculation,
'hidden': hidden
})
df = pd.DataFrame.from_records(fs)
df
Result:

- Dominant language
- Python
- Stars
- 363
- Forks
- 183
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from tableau/document-api-python
-
Difficulty 5/5 Over a week Newbie friendliness 20/100
tableau/document-api-python#270 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 25/100
tableau/document-api-python#260 ·
-
docs
Difficulty 2/5 1-3 hours Newbie friendliness 55/100
tableau/document-api-python#258 ·
-
Difficulty 5/5 Over a week Newbie friendliness 30/100
tableau/document-api-python#251 · 2 comments ·
-
Difficulty 5/5 Over a week Newbie friendliness 20/100
tableau/document-api-python#250 · 2 comments ·
All issues in tableau/document-api-python
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
-
🐛 Bug 🔔 Pending processing
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
jumpserver/jumpserver#17584 ·