Не торкайтеся бізнес-коду спадного списку під час перекладу Excel

Після перекладу багатомовного файлу Excel переклад виглядає гладко, але користувач стикається з помилкою в спадному меню або система не може розпізнати параметр після надсилання. Цей тип проблеми зазвичай виникає через процес перекладу, який плутає «формулу перевірки даних» із «вмістом відображення комірки». Ця стаття призначена для персоналу з локалізації та операцій, яким потрібно обробляти файли Excel із розкривними списками. Тут пояснюється, який вміст потрібно заблокувати, а який – перекласти. Він також надає ідеї Python і критерії прийняття вручну для отримання метаданих перевірки.

Усі приклади тут використовують синтетичні дані. Код було перевірено з прикладами в ізольованому середовищі, але це не є гарантією всіх реальних файлів або продуктивності продукту. Перед обробкою важливих документів збережіть оригінали та перегляньте їх відповідно до меж і пунктів прийняття в тексті.

Як перекласти багатомовний Excel, не руйнуючи розкривний список? Висновок одним реченням

Спочатку заблокуйте бізнес-код опції, що випадає, і перекладіть лише копію підказок і помилок; підтвердити наявність зв’язку зіставлення, а потім замінити значення перерахування.

Істотна різниця між формулою перевірки та копірайтингом інтерфейсу

Перевірка даних Excel — це, по суті, набір правил метаданих, які визначають, які вхідні дані є законними. Перш ніж перекладати, ви повинні спочатку розрізнити два типи вмісту.

Відповідно до офіційна документація openpyxl, бібліотека «не виконує та не оцінює» ці правила під час читання та запису файлів .xlsx, це просто поведінка бібліотеки Python. У клієнті Excel правила перевірки суворо дотримуються.

• Під час читання файлу: об’єкт DataValidation є лише відображенням пам’яті структури XML і не повідомляє вам, чи допустиме значення поточної клітинки.
• Під час перекладу: інструмент не буде автоматично перехоплювати ваші неправильні зміни до formula1, і саме тут криється ризик.

Валідатори для type="list" зазвичай надходять із двох джерел:

1. Вбудований список рядків: розділений комами, написаний безпосередньо formula1. Цей тип вмісту є найбільш вразливим до машинного перекладу, оскільки це вузли звичайного тексту в XML.
2. Посилання на регіон: наприклад =Sheet2!$A$1:$A$10. Відносно безпечно, але перевірка також буде невдалою після заміни або перейменування вихідної області.

Ключ до розрізнення цих двох — перевірити, чи formula1 починається зі знака рівності.

Крім того, чотири атрибути error, errorTitle, prompt і promptTitle є справжнім копірайтингом інтерфейсу, орієнтованого на користувача, і повинні бути включені в область перекладу; значення переліку в formula1 заблоковано за замовчуванням.

Ще одна суперечлива деталь: в офіційній документації openpyxl чітко зазначено, що showDropDown=True насправді означає «приховати спадну стрілку» в Excel і LibreOffice, на відміну від звичайної логічної семантики. Під час перекладу або рефакторингу конфігурації не змінюйте цей параметр автоматично.

Приклад синтезу: правильне вилучення та захист кордонів

Припустімо, що у вихідному файлі є стовпець «Статус замовлення», а формула перевірки — це вбудований список "NEW,PROCESSING,SHIPPED" із повідомленням про помилку англійською мовою. Правильний підхід полягає в тому, щоб залишити formula1 як є (замінити його, лише якщо є явна двомовна карта перерахування), перекласти error на цільову мову та переконатися, що логічні прапорці, такі як allow_blank, не були випадково змінені. Цей приклад створює дані повністю в пам’яті, не вимагає підготовки зовнішніх файлів Excel і може запускатися безпосередньо в локальному середовищі Python.

Особливої уваги потребують такі граничні умови:

• Рядок у лапках із комою: напр. ""Yes, sure"","No"". Якщо просто розділити комою, ви отримаєте три фрагменти замість двох допустимих варіантів.
• Ім’я визначення (іменований діапазон): formula1 посилається на назву, а не на прямий діапазон. Рядок не містить ! або ком, і його легко сприйняти як звичайний текст. Метод обробки полягає в тому, щоб перевірити, чи виконується специфікація іменування перед аналізом. Якщо так, переклад вмісту пропускається, і для ручної перевірки записується лише зв’язок посилання.
• Валідатор для незв’язаних діапазонів клітинок: відповідно до документації openpyxl, він ігноруватиметься під час збереження, тому його слід відфільтрувати на етапі попередньої обробки, щоб уникнути безглуздих перекладів недійсних правил.

Використовуйте openpyxl для безпечного вилучення метаданих перевірки

У наступному прикладі показано, як створити книгу з перевіркою списку в пам’яті та витягти поля, які потрібно перекласти, і поля, які потрібно заблокувати. Властивості та поведінку перевірки даних можна знайти в офіційна документація openpyxl. Рекомендовано для запуску в середовищі openpyxl>=3.1.0. Приклади не включають мережеві запити, команди оболонки, використання облікових даних або операції перезапису файлів, усі твердження базуються на очікуваному стані об’єкта пам’яті та використовуються для перевірки логіки вилучення.

from openpyxl import Workbook
from openpyxl.worksheet.datavalidation import DataValidation

def extract_validation_metadata():
    # 合成示例：在内存中构造含列表验证的工作簿，无需外部文件
    wb = Workbook()
    ws = wb.active
    dv = DataValidation(
        type="list",
        formula1='"NEW,PROCESSING,SHIPPED"',
        allow_blank=True
    )
    dv.error = "Invalid status code"
    dv.prompt = "Select order status"
    ws.add_data_validation(dv)
    dv.add("A1:A10")

    extracted = []
    for validator in ws.data_validations.dataValidation:
        # 跳过未绑定范围的验证器，此类验证器保存时会被忽略
        if not validator.sqref:
            continue

        is_inline_list = (
            validator.type == "list" 
            and validator.formula1 
            and not validator.formula1.startswith("=")
        )

        record = {
            "sqref": str(validator.sqref),
            "formula1_locked": validator.formula1 if is_inline_list else None,
            "translatable_error": validator.error,
            "translatable_prompt": validator.prompt,
            "is_reference": validator.formula1.startswith("=") if validator.formula1 else False
        }
        extracted.append(record)

    # 预期输出校验：验证提取逻辑符合设计预期
    assert len(extracted) == 1
    assert extracted[0]["formula1_locked"] == '"NEW,PROCESSING,SHIPPED"'
    assert extracted[0]["translatable_error"] == "Invalid status code"
    assert extracted[0]["is_reference"] is False
    return extracted

# 注意：此函数需在本地环境执行，此处仅作结构展示，未实际运行

Основне рішення цього коду полягає в ідентифікації is_inline_list. Позначте formula1 як заблоковане поле, лише якщо підтверджено, що воно є вбудованим списком. Для перевірки на основі посилань прапор is_reference попереджає наступні процеси про те, що для поля може знадобитися спеціальна обробка відображення зони, а не переклад тексту.

Твердження тільки перевіряють логіку вилучення. У фактичних виробничих файлах можуть виникати складні ситуації, такі як накладання кількох валідаторів і формули, що містять символи екранування. На цій основі необхідно підвищити надійність аналізу.

📊 Базове порівняння: три методи обробки вмісту перевірки

🎯 Який спосіб вам підходить?

якщо ви...

1. Необхідно перекласти бізнес-форми, що містять вбудовані розкривні списки

Заблокуйте formula1 і перекладіть лише чотири атрибути копіювання інтерфейсу, такі як error і prompt.

2. Майте під рукою надійну двомовну таблицю відображення нумерації

Після підтвердження зв’язку зіставлення можна замінити значення переліку юридичними параметрами цільовою мовою та перевірити їх одне за одним у версії Excel цільовою мовою.

3. Джерело, що випадає, посилається на інші аркуші

Зберігайте зв’язок посилань і вручну перевіряйте, чи була змінена вихідна область після перекладу.

4. Використовуйте спеціальну перевірку типу або складні функціональні формули

Не залишайте це автоматизованим інструментам для аналізу, перейдіть безпосередньо до черги перегляду вручну.

Критерії прийняття та межі перевірки вручну

Автоматизоване вилучення може вирішити лише проблему ідентифікації структури, а якість доставки все ще потрібно контролювати через приймання. У наведеній нижче таблиці наведено типові винятки та рішення щодо обробки. Значення в таблиці є лише спеціальними пороговими значеннями для синтетичних прикладів і не є галузевими стандартами. Під час використання їх слід налаштувати відповідно до конкретного бізнесу.

Має бути зрозуміло, що наведений вище код лише завершує вилучення метаданих і не дорівнює наскрізній перевірці ефекту перекладу. Для справжнього прийняття потрібно фактично відкрити файл у версії Excel на цільовій мові, перевірити, чи нормально з’являється спадне меню, чи з’являється підказка про помилку після вибору та чи може серверна система правильно отримати надіслане значення.

Запис виконання зразка пам'яті

Наступний код виконується після наведеної вище функції та використовує лише синтетичні дані та не читає файл клієнта.

result = extract_validation_metadata()
assert result[0]["sqref"] == "A1:A10"

❓ Часті запитання (FAQ)

1. Чи openpyxl перевірить, чи введені дані у розкривному списку є законними?

не буду. Згідно з офіційною документацією openpyxl, бібліотека не виконує та не оцінює правила перевірки під час читання та запису .xlsx, але правила все одно суворо дотримуватимуться в клієнті Excel.

2. Чи можна безпосередньо перекласти параметри у спадному списку?

Не рекомендується. Вбудовані перерахування часто відповідають внутрішнім кодам статусу, і прямий переклад зруйнує бізнес-логіку; їхня відсутність взагалі може дозволити користувачам цільової мови бачити варіанти англійською. Більш безпечний підхід полягає в тому, щоб заблокувати formula1 і лише перекладати підказки та повідомлення про помилки або замінювати їх допустимими значеннями перерахування відповідною мовою після підтвердження зв’язку зіставлення.

3. Які атрибути потрібно перекласти?

Чотири атрибути error, errorTitle, prompt і promptTitle є копірайтингом орієнтованого на користувача інтерфейсу та повинні бути включені в обсяг перекладу.

4. Чи можна інвертувати параметр showDropDown для налаштування відображення?

не можу В офіційній документації openpyxl чітко зазначено, що showDropDown=True означає приховування стрілки спадного меню в Excel і LibreOffice, що суперечить традиційній логічній семантиці та вимагає спеціального підтвердження перед зміною.

📝 Підсумок

Під час перекладу Excel за допомогою розкривних списків головне — спочатку розрізнити «бізнес-кодування» та «копірайтинг інтерфейсу»: блокування кодування, переклад копірайтингу та ручну перевірку зв’язків посилань. Після перекладу вам потрібно фактично перевірити розкривний список і повідомлення про помилки у версії Excel цільовою мовою.

Спробуйте зараз: завантажте документ, щоб розпочати переклад, зберігаючи вихідний макет