Ne touchez pas au code métier de la liste déroulante lors de la traduction d'Excel

Une fois le fichier Excel multilingue traduit, la traduction semble fluide, mais l'utilisateur rencontre une erreur dans le menu déroulant ou le système ne peut pas reconnaître l'option après la soumission. Ce type de problème provient généralement du processus de traduction qui confond « formule de validation des données » avec « contenu d'affichage des cellules ». Cet article est destiné au personnel de localisation et d'exploitation qui doit traiter des fichiers Excel contenant des listes déroulantes. Il explique quel contenu doit être verrouillé et lequel doit être traduit. Il fournit également des idées Python et des critères d'acceptation manuels pour extraire les métadonnées de vérification.

Les exemples ici utilisent tous des données synthétiques. Le code a été vérifié avec des exemples dans un environnement isolé, mais cela ne constitue pas une garantie de tous les fichiers réels ou des performances du produit. Avant de traiter des documents importants, veuillez conserver les originaux et les examiner en fonction des limites et des éléments d'acceptation du texte.

Comment traduire Excel multilingue sans détruire la liste déroulante ? Conclusion en une phrase

Verrouillez d'abord le code commercial de l'option déroulante et traduisez uniquement la copie de l'invite et de l'erreur ; confirmez qu’il existe une relation de mappage, puis remplacez la valeur d’énumération.

La différence essentielle entre la formule de vérification et la rédaction d'interface

La validation des données d'Excel est essentiellement un ensemble de règles de métadonnées qui définissent quelles entrées sont légales. Avant de traduire, il faut d’abord distinguer les deux types de contenus.

Selon documentation officielle d'openpyxl, la bibliothèque "n'applique ni n'évalue" ces règles lors de la lecture et de l'écriture de fichiers .xlsx, il s'agit simplement du comportement de la bibliothèque Python. Dans le client Excel, les règles de validation sont toujours strictement appliquées.

• Lors de la lecture d'un fichier : L'objet DataValidation est juste un mappage mémoire de la structure XML et ne vous dira pas si la valeur de la cellule actuelle est légale.
• Lors de la traduction : L'outil n'interceptera pas automatiquement vos modifications incorrectes dans formula1, et c'est là que réside le risque.

Les validateurs pour type="list" proviennent généralement de deux sources :

1. Liste de chaînes en ligne : séparées par des virgules, écrites directement en formula1. Ce type de contenu est le plus vulnérable à la traduction automatique car il s'agit de nœuds de texte brut en XML.
2. Référence de région : telle que =Sheet2!$A$1:$A$10. Relativement sûr, mais la vérification échouera également une fois la zone source remplacée ou renommée.

La clé pour distinguer les deux est de vérifier si formula1 commence par un signe égal.

De plus, les quatre attributs error, errorTitle, prompt et promptTitle constituent la véritable rédaction de l'interface orientée utilisateur et doivent être inclus dans la portée de la traduction ; la valeur d'énumération dans formula1 est verrouillée par défaut.

Encore un détail contre-intuitif : la documentation officielle d'openpyxl indique clairement que showDropDown=True signifie en fait "masquer la flèche déroulante" dans Excel et LibreOffice, par opposition à la sémantique booléenne habituelle. Lors de la traduction ou de la refactorisation d'une configuration, ne modifiez pas ce paramètre automatiquement.

Exemple de synthèse : extraction correcte et protection des limites

Supposons que le fichier source comporte une colonne « Statut de la commande » et que la formule de validation est une liste en ligne "NEW,PROCESSING,SHIPPED" avec un message d'erreur en anglais. L'approche correcte consiste à laisser formula1 tel quel (le remplacer uniquement s'il existe une carte d'énumération bilingue explicite), à traduire error dans la langue cible et à garantir que les indicateurs booléens tels que allow_blank ne sont pas accidentellement modifiés. Cet exemple construit les données entièrement en mémoire, ne nécessite pas la préparation de fichiers Excel externes et peut être exécuté directement dans l'environnement Python local.

Les conditions aux limites suivantes nécessitent une attention particulière :

• Chaîne entre guillemets avec virgule : par ex. ""Yes, sure"","No"". Si vous divisez simplement par virgule, vous obtenez trois fragments au lieu de deux options valides.
• Nom de définition (plage nommée) : formula1 fait référence au nom plutôt qu'à la plage directe. La chaîne ne contient ni ! ni virgules, et il est facile de la considérer à tort comme du texte ordinaire. La méthode de traitement consiste à vérifier si la spécification de dénomination est respectée avant l'analyse. Si tel est le cas, la traduction du contenu est ignorée et seule la relation de référence est enregistrée pour une vérification manuelle.
• Validateur pour les plages de cellules non liées : selon la documentation openpyxl, il sera ignoré lors de l'enregistrement, il doit donc être filtré lors de l'étape de prétraitement pour éviter les traductions dénuées de sens de règles invalides.

Utilisez openpyxl pour extraire en toute sécurité les métadonnées de vérification

L'exemple suivant montre comment construire un classeur avec validation de liste en mémoire et extraire les champs qui doivent être traduits et les champs qui doivent être verrouillés. Les propriétés et comportements de validation des données peuvent être trouvés dans documentation officielle d'openpyxl. Il est recommandé de l'exécuter dans l'environnement openpyxl>=3.1.0. Les exemples n'incluent pas les requêtes réseau, les commandes shell, l'utilisation des informations d'identification ou les opérations d'écrasement de fichiers. Toutes les assertions sont basées sur l'état attendu de l'objet mémoire et sont utilisées pour valider la logique d'extraction.

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

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

Le jugement central de ce code réside dans l’identification de is_inline_list. Marquez formula1 comme champ verrouillé uniquement s’il est confirmé qu’il s’agit d’une liste en ligne. Pour une validation basée sur des références, l'indicateur is_reference alerte les processus en aval que le champ peut nécessiter un traitement de mappage de zone spécial plutôt qu'une traduction de texte.

Les instructions d'assertion vérifient uniquement la logique d'extraction. Dans les fichiers de production réels, il peut y avoir des situations complexes telles que le chevauchement de plusieurs validateurs et des formules contenant des caractères d'échappement. Sur cette base, la robustesse de l’analyse doit être améliorée.

📊 Comparaison de base : trois méthodes de traitement du contenu de vérification

🎯 Quelle méthode vous convient ?

si tu……

1. Besoin de traduire des formulaires commerciaux contenant des listes déroulantes en ligne

Verrouillez formula1 et traduisez uniquement les quatre attributs de copie d'interface tels que error et prompt.

2. Avoir en main une table de cartographie de dénombrement bilingue fiable

Après avoir confirmé la relation de mappage, vous pouvez remplacer les valeurs d'énumération par des options légales dans la langue cible et les tester une par une dans la version d'Excel en langue cible.

3. La source déroulante fait référence à d'autres feuilles de calcul

Conservez la relation de référence et vérifiez manuellement si la zone source a été modifiée après la traduction.

4. Utilisez une validation de type personnalisée ou des formules de fonctions complexes

Ne laissez pas les outils automatisés analyser les données, accédez directement à la file d'attente de révision manuelle.

Critères d'acceptation et limites de révision manuelle

L'extraction automatisée ne peut résoudre que le problème de l'identification de la structure, et la qualité de la livraison doit encore être contrôlée par l'acceptation. Le tableau suivant répertorie les exceptions typiques et les décisions de traitement. Les valeurs du tableau ne sont que des seuils personnalisés pour des exemples synthétiques et ne constituent pas des normes industrielles. Ils doivent être ajustés en fonction des activités spécifiques lorsqu'ils sont utilisés.

Il doit être clair que le code ci-dessus complète uniquement l'extraction des métadonnées et n'équivaut pas à une vérification de l'effet de traduction de bout en bout. Une véritable acceptation nécessite d'ouvrir réellement le fichier dans la version en langue cible d'Excel, de tester si le menu déroulant apparaît normalement, si une invite d'erreur est déclenchée après la sélection et si le système back-end peut recevoir correctement la valeur soumise.

Entrée d'exécution d'un exemple de mémoire

Le code suivant s'exécute après la fonction ci-dessus et utilise uniquement des données synthétiques et ne lit pas le fichier client.

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

❓ Questions fréquemment posées (FAQ)

1. Openpyxl vérifiera-t-il si l'entrée dans la liste déroulante est légale ?

Ne le fera pas. Selon la documentation officielle d'openpyxl, la bibliothèque n'applique ni n'évalue les règles de validation lors de la lecture et de l'écriture de .xlsx, mais les règles seront toujours strictement appliquées dans le client Excel.

2. Les options de la liste déroulante peuvent-elles être directement traduites ?

Non recommandé. Les énumérations en ligne correspondent souvent aux codes d'état du back-end, et la traduction directe détruira la logique métier ; ne pas les traiter du tout peut permettre aux utilisateurs de la langue cible de voir les options en anglais. Une approche plus sûre consiste à verrouiller formula1 et à traduire uniquement les invites et les messages d'erreur, ou à les remplacer par des valeurs d'énumération légales dans la langue correspondante après avoir confirmé la relation de mappage.

3. Quels attributs doivent être traduits ?

Les quatre attributs error, errorTitle, prompt et promptTitle sont des rédactions d'interface orientées utilisateur et doivent être inclus dans la portée de la traduction.

4. Le paramètre showDropDown peut-il être inversé pour ajuster l'affichage ?

Ne peut pas. La documentation officielle d'openpyxl indique clairement que showDropDown=True signifie masquer la flèche déroulante dans Excel et LibreOffice, ce qui est contraire à la sémantique booléenne conventionnelle et nécessite une confirmation particulière avant modification.

📝Résumé

Lors de la traduction d'Excel avec des listes déroulantes, l'essentiel est de faire d'abord la distinction entre le « codage métier » et la « rédaction d'interface » : verrouillage du codage, traduction de rédaction et vérification manuelle des relations de référence. Après la traduction, vous devez tester la liste déroulante et le rapport d'erreurs dans la version en langue cible d'Excel.

Essayez-le maintenant : téléchargez le document pour lancer la traduction, en conservant la mise en page d'origine.