기존 입력값 수정하기

문법

text

block.set_value(field_key: str, value: bool | int | float | str | decimal.Decimal, *, unit: str) -> '_ReportValue'

예제

python

from pipelinexlab import px

with px.Client(workspace="dev", project="section_properties") as client:
    with client.open_report("section_calculation_note") as report:
        width = report.block("width").set_value("width", 250.0, unit="mm")
        client.save(report)
        print(report.document().freshness)

기존 field_key에만 적용합니다. 일반 텍스트의 새 입력 연결은 selection.as_value(...)를 사용합니다. 단위를 명시하고 유한한 scalar를 전달해야 하며, 저장 시 정밀도를 잃는 정수는 거부합니다. 서식과 연결 주소는 유지합니다.

본문과 입력 저장소는 기존 UpsertReportValue operation으로 함께 갱신됩니다. 메서드 자체는 저장하거나 실행하지 않습니다. 반환 handle은 같은 Report의 connection.bind source로 사용할 수 있습니다. 이전에 얻은 handle의 value는 그때의 값이며, 새 값을 읽으려면 이번에 반환된 handle을 사용합니다.

잘못된 값·없는 필드·닫힌 Report는 초안을 바꾸지 않고 거부합니다. 입력 편집 전에 얻은 본문 선택 범위는 다시 선택해야 합니다. 저장 후 최신성 판단은 Runtime이 제공하며, 이전 결과 값은 자동으로 지우지 않습니다.

기존 입력값 수정하기 ​

문법 ​

예제 ​

기존 입력값 수정하기

문법

예제