Skip to content

Commit 6d32ec6

Browse files
committed
Drop On Extract Refresh entry, soften intro and daily-schedule wording
Three fresh-eyes findings: - Remove the "Subscriptions cannot use On Extract Refresh" entry. The REST API's refreshExtractTriggered attribute does support this, and TSC support is landing in #1861 (which closes the tracker #1658). The entry is about to be factually wrong on both counts. - Soften the intro: it promised "follow the appropriate issues" for every item, but the vf_-silently-dropped entry has no tracker filed. New wording says "where filed" so the doc doesn't overpromise. - Reword the daily-schedules note to describe behavior neutrally ("currently runs daily schedules hourly instead") rather than calling it a "bug", which reads punchy on a public docs page.
1 parent f37c911 commit 6d32ec6

1 file changed

Lines changed: 2 additions & 7 deletions

File tree

docs/api-ref.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10961,7 +10961,7 @@ for wb in finance_workbooks:
1096110961

1096210962
## Known server-side limitations
1096310963

10964-
Some behaviors you may hit while using TSC are not bugs in the TSC library. They are limitations of the Tableau Server REST API itself, and cannot be fixed in TSC alone. This section lists the currently-tracked server-side gaps so you can identify them quickly and follow the appropriate issues.
10964+
Some behaviors you may hit while using TSC are not bugs in the TSC library. They are limitations of the Tableau Server REST API itself, and cannot be fixed in TSC alone. This section lists known server-side gaps so you can identify them quickly and follow the tracking issues where filed.
1096510965

1096610966
For the live, maintainer-updated view of these issues, filter open issues in this repository by the [`Server-Side Enhancement`](https://github.com/tableau/server-client-python/labels/Server-Side%20Enhancement) label.
1096710967

@@ -10980,12 +10980,7 @@ Every item in this list requires a change in Tableau Server / Tableau Cloud befo
1098010980
<br>
1098110981

1098210982
**Daily extract-refresh schedules cannot be created via the REST API on Tableau Cloud**
10983-
: Creating an extract-refresh task on a daily schedule fails through the REST API (returns a 500), and the underlying Cloud scheduler has a separate bug where daily executes hourly. Tracked in [#1508](https://github.com/tableau/server-client-python/issues/1508).
10984-
10985-
<br>
10986-
10987-
**Subscriptions cannot use an "On Extract Refresh" schedule via the REST API**
10988-
: The "When data refreshes" (a.k.a. "On Extract Refresh") subscription trigger available in the Tableau UI has no equivalent in the REST API surface, so TSC cannot expose it. Tracked in [#1658](https://github.com/tableau/server-client-python/issues/1658).
10983+
: Creating an extract-refresh task on a daily schedule fails through the REST API (returns a 500), and the underlying Cloud scheduler currently runs daily schedules hourly instead. Tracked in [#1508](https://github.com/tableau/server-client-python/issues/1508).
1098910984

1099010985
<br>
1099110986

0 commit comments

Comments
 (0)