Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Type 2] Support range filter operators (GreaterThan, LessThan, Between) in PDFRequestOptions.vf() for view filters

オープン
#1,752 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
45/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
静か
技術スタック
python
領域
api

調査の方向性

Start by reading the PDFRequestOptions.vf() entry point and the existing RequestOptions.filter.add() implementation. Determine how operators and range values should be represented for PDF view filters, then verify the expected behavior for GreaterThan, LessThan, and Between against the described continuous-filter use case.

索引モデルが issue の本文から書いたものです。

説明

enhancement Server-Side Enhancement ui-exists

Summary

Add support for range filter operators (GreaterThan, LessThan, Between) in PDF view filters using .vf() method

Request Type

Type 2: add a REST API and support it in tsc.

This is functionality that exists in Tableau dashboards (continuous range filters) but cannot be properly controlled through the PDF generation API.

Description

Current Limitation

When using PDFRequestOptions.vf() to apply view filters for PDF generation, there is no way to specify filter operators such as GreaterThan, LessThan, or Between. The current implementation only supports:

  • Single discrete values: pdf_opts.vf('Region', 'West')
  • Multiple discrete values (IN operator): pdf_opts.vf('Category', 'Furniture,Technology')
  • Ambiguous comma-separated syntax: pdf_opts.vf('Score', '10,50')
Problem

For continuous range filters configured in Tableau dashboards, the comma-separated syntax '10,50' is ambiguous and may be interpreted as:

  • IN (10, 50) - only values exactly 10 or 50
  • BETWEEN 10 AND 50 - range from 10 to 50

Currently, there is no way to explicitly specify that a filter should use BETWEEN, GreaterThan, or other range operators, even though these filters work perfectly when using the dashboard interactively.

Proposed Solution

Add operator support to .vf() similar to how RequestOptions.filter.add() works for API queries:

Current API (RequestOptions filtering):

req_option = TSC.RequestOptions()
req_option.filter.add(TSC.Filter(
    TSC.RequestOptions.Field.Score,
    TSC.RequestOptions.Operator.GreaterThanOrEqual,
    '10'
))

Proposed enhancement for PDF view filters:

pdf_opts = TSC.PDFRequestOptions()
pdf_opts.vf('SCORE', '10', operator=TSC.RequestOptions.Operator.GreaterThanOrEqual)
# OR
pdf_opts.vf('SCORE', min_value='10', max_value='50')  # For BETWEEN
Use Case & Value
  • Frequency: This is needed any time programmatic PDF generation requires filtering on continuous numeric or date fields
  • Current workaround: None - users must either accept ambiguous behavior or modify dashboard filters, which affects all users
  • Work saved: Eliminates need to create separate dashboards with hardcoded filters just for PDF generation
  • Business impact: Critical for automated reporting where PDFs need to show data for specific ranges (e.g., "Show only high-risk scores 80-100", "Show sales data > $1M")
Example Scenario

A Tableau dashboard has a continuous slider filter for SCORE (range: 0-100). When generating automated weekly PDFs:

  • Needed: Filter to show only scores BETWEEN 10 AND 50
  • Current behavior: Passing [10, 50] may show only exact values 10 and 50
  • Expected behavior: Should show all values in the range 10-50, just like moving the slider in the web UI

This feature would bring view filter capabilities in line with the existing RequestOptions.filter API and match the functionality available in the Tableau web interface.

主要言語
Python
スター
716
フォーク
446
平均マージ
8日 8時間
マージ済み PR(30日)
2

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

tableau/server-client-python のほかの issue

tableau/server-client-python の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。