Numéro de produit 00123, pourquoi n'en reste-t-il que 123 après exportation ?

Lorsque le numéro de produit devient « 123 » après l'exportation, ce n'est généralement pas parce que le fichier est endommagé, mais parce que le type de données et le format d'affichage ne correspondent pas. Si vous utilisez souvent des programmes pour générer des rapports Excel, les champs comportant des zéros non significatifs, tels que les nombres et les codes, sont les plus susceptibles de rencontrer ce problème. Cet article explique les raisons de la perte des zéros non significatifs, donne la méthode d'écriture de l'identifiant de texte d'openpyxl et des idées de vérification de la mémoire, et explique quels problèmes nécessitent une révision manuelle.

Ces méthodes sont également applicables au processus de traduction et de collation de documents multilingues. Les nombres, formules et relations de référence dans le tableau peuvent également être modifiés après traduction. Après lecture, vous pouvez utiliser les mêmes éléments de contrôle dans votre propre flux de documents.

Le numéro de produit perd-il ses zéros non significatifs après l'exportation ? Conclusion en une phrase

En écrivant le nombre sous forme de texte et en définissant le format de cellule sur texte en même temps, vous pouvez conserver les zéros non significatifs ; si l'amont a converti le nombre en nombre entier, les informations sur le zéro non significatif ont été perdues et le format ne peut pas être restauré.

Pourquoi la valeur et le format sont-ils séparés ?

La clé pour comprendre ce problème est de faire la distinction entre « ce qui est vu » et « ce qui est stocké ». Lorsque openpyxl exploite des fichiers xlsx, cell.value stocke les objets Python (str, int, float, datetime, etc.), tandis que cell.number_format n'est qu'une chaîne d'instructions qui indique à Excel comment restituer la valeur.

Lorsque vous exécutez ws['A1'] = '00123', openpyxl écrit la chaîne "00123" inchangée en XML. Mais si number_format n'est pas défini, Excel peut essayer d'analyser intelligemment lors de l'ouverture du fichier et de convertir la chaîne numérique pure en un affichage numérique, et les zéros non significatifs disparaîtront.

La bonne approche est la double assurance :

• Assurez-vous que la valeur écrite est de type chaîne ;
• Définissez number_format sur '@' (le code de formatage du texte d'Excel).

Cela équivaut à dire à l'application que quel que soit le contenu, traitez-le comme du texte non calculable, évitant ainsi la conversion de type automatique côté client.

Exemple synthétique : écriture correcte et tests de limites

Pour vérifier ce mécanisme, un ensemble synthétique de données contenant une numérotation normale et des limites sujettes aux erreurs peut être construit :

• Cas normal : "00123", le résultat attendu est le texte "00123", aligné à gauche ;
• Cas limite 1 : "00000", la sortie attendue est le texte "00000", pas la valeur 0 ;
• Edge Case 2 : None ou chaîne vide, la sortie attendue est une cellule vide et aucune erreur n'est signalée ;
• Cas d'erreur : 123 (type entier). Si elles sont écrites directement, les informations du zéro non significatif ont été perdues en amont et ne peuvent pas être récupérées par le format.

Lors du traitement des données en amont, vous devez supposer que l'entrée peut être sale. Le code ne peut pas deviner à partir de rien que l'entier 123 a à l'origine plusieurs zéros non significatifs, l'objectif de la vérification est donc de s'assurer que les paramètres entrants sont des chaînes déjà complètes. Si un type entier est détecté, un avertissement doit être enregistré ou l'écriture doit être refusée, plutôt que d'être convertie silencieusement en texte sans zéros.

Implémentation de l'écriture de l'identifiant de texte openpyxl

L'exemple Python suivant montre comment créer un fragment Excel conforme en mémoire. Le code est une démonstration pédagogique et doit être exécuté dans un environnement avec openpyxl >= 3.1.0 installé.

from openpyxl import Workbook
from openpyxl.styles import numbers

def write_product_ids(ws, start_row, ids):
    """
    将产品编号以严格文本格式写入工作表。
    ids: 字符串列表，必须已包含前导零。
    """
    for i, pid in enumerate(ids):
        cell = ws.cell(row=start_row + i, column=1)

        # 边界处理：跳过空值，避免将None转为字符串"None"
        if pid is None or (isinstance(pid, str) and not pid.strip()):
            continue

        # 类型防御：整数输入意味着前导零已在上游丢失
        # 此处抛出异常是为了阻断错误数据流入Excel
        if isinstance(pid, int):
            raise ValueError(f"ID at index {i} is int ({pid}), leading zeros lost upstream.")

        cell.value = str(pid)
        # '@' 是Excel内置的文本格式代码，使用常量避免拼写错误
        cell.number_format = numbers.FORMAT_TEXT

# --- 合成示例执行区（无需外部文件） ---
wb = Workbook()
ws = wb.active

# 准备合成测试数据
test_ids = ["00123", "00000", "A-009", None, ""]

try:
    write_product_ids(ws, 1, test_ids)
except ValueError as e:
    print(f"捕获到上游数据问题: {e}")

# 验收断言（仅针对内存中的Workbook对象）
assert ws['A1'].value == "00123"
assert ws['A1'].number_format == '@'
assert ws['A2'].value == "00000"  # 全零编号保留
assert ws['A3'].value == "A-009"  # 混合字符不受影响
assert ws['A4'].value is None     # 空值未被污染

print("内存对象校验完成，请保存文件后用Excel人工复核显示效果。")

Ce code ne s'appuie sur aucun fichier externe, toutes les assertions sont faites sur l'objet Workbook en mémoire. Il convient de noter que l'affirmation montre uniquement que la structure de données interne d'openpyxl est correcte et ne garantit pas qu'Excel s'affichera correctement à son ouverture. Ce dernier est également affecté par l'environnement client tel que les paramètres régionaux d'Excel et les options de correction automatique.

Astuce : Les exemples sont des échantillons synthétiques et le code a été vérifié dans un environnement isolé, mais cela ne représente pas une garantie de tous les fichiers réels ou effets 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 ci-dessous.

Références : Documentation sur les styles openpyxl

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

La vérification automatisée ne peut couvrir que le niveau de la structure des données, et l'acceptation réelle doit être combinée à une inspection visuelle. Le tableau suivant répertorie les manifestations d’exceptions courantes et les décisions de traitement pour aider à distinguer celles qui constituent des problèmes de code et celles qui constituent des limitations environnementales.

Non applicable : Cette solution s'applique uniquement aux champs tels que les identifiants et les encodages qui ne doivent pas être impliqués dans les opérations mathématiques. Pour les valeurs qui doivent être calculées, telles que les montants et les quantités, le format texte ne doit pas être utilisé. Au lieu de cela, un format numérique personnalisé (tel que "00000") doit être utilisé pour un affichage sans zéro tout en conservant l'essence de la valeur. De plus, si l'option « Convertir automatiquement le texte en nombres » d'Excel est activée, même si le code est écrit correctement, les utilisateurs peuvent toujours être invités à effectuer la conversion lorsqu'ils l'ouvrent. Il s'agit du comportement du client et il convient de le rappeler au destinataire dans les instructions de livraison.

Utilisez cette liste de contrôle pour la traduction de documents

Décidez d’abord lesquels sont du texte, lesquels sont des formules et des codes commerciaux, puis effectuez la traduction du tableau. Le contrôle post-traduction vérifie non seulement si le chinois est devenu la langue cible, mais confirme également si les formules, les identifiants et les relations de référence ont été modifiés.

OmniDoc fournit un portail de traduction de documents multiformat et le site officiel présente des fonctions d'OCR, de glossaire et de comparaison bilingue. Pour les équipes qui souhaitent travailler directement à partir des fichiers, il s’agit d’une voie qui mérite d’être évaluée avec des échantillons réels. Veuillez utiliser les fichiers désensibilisés que vous êtes autorisé à télécharger et utilisez les éléments de vérification de cet article pour examiner les résultats. Rien ne prétend ici qu'OmniDoc utilise les bibliothèques open source ou les algorithmes internes de cet article, et l'exemple ne remplace pas non plus les tests de performances du produit.

📊 Comparaison de base

🎯 Quelle méthode vous convient ?

Si vous souhaitez exporter des identifiants tels que des numéros de produits, des numéros de commande, etc.

Écrivez sous forme de texte et définissez number_format='@', faites les deux.

Si vos données en amont sont déjà un nombre entier

La priorité est donnée à la transformation de la chaîne en amont en une chaîne ; lorsqu'elle ne peut pas être complétée, l'écriture est rejetée et un avertissement est enregistré. Ne vous convertissez pas en silence.

Si vous souhaitez exporter le montant ou la quantité

Utilisez un format numérique personnalisé pour l'affichage sans zéro, ne passez pas au format texte.

Si vous souhaitez donner le fichier à quelqu'un d'autre pour qu'il l'utilise

Dans vos instructions de livraison, rappelez au destinataire l'option « Convertir automatiquement le texte en chiffres » d'Excel et demandez-lui d'échantillonner quelques lignes de données.

❓ Questions fréquemment posées (FAQ)

1. Pourquoi n'en reste-t-il que 123 après l'exportation ?

Les valeurs sont traitées comme des valeurs numériques lorsqu'elles sont écrites, et les zéros non significatifs sont supprimés en tant qu'espaces réservés mathématiques dénués de sens. Si le texte n'est pas formaté, Excel peut également déduire automatiquement le type en fonction du contenu lors de l'ouverture du fichier.

2. Est-il suffisant de simplement définir number_format sur '@' ?

Il est recommandé d'utiliser une double assurance : non seulement s'assurer que la valeur écrite est de type chaîne, mais également définir number_format sur '@'. Effectuez une seule de ces opérations et des problèmes peuvent encore survenir.

3. Si l'assertion de code réussit, cela signifie-t-il que l'affichage Excel doit être correct ?

incertain. En affirmant qu'en indiquant uniquement que les structures de données internes d'openpyxl sont correctes, l'environnement client tel que les paramètres régionaux d'Excel, les options de correction automatique, etc. affectera également l'affichage final.

4. Le montant peut-il être enregistré au format texte ?

Cela ne devrait pas être le cas. Le montant et la quantité doivent être impliqués dans le calcul et doivent être affichés en utilisant un format numérique personnalisé (tel que "00000") avec un remplissage nul tout en conservant l'essence de la valeur.

📝Résumé

Le numéro de produit perd des zéros car le type de valeur et le format d'affichage ne sont pas alignés. Écrivez l'identifiant sous forme de texte, définissez le format du texte, puis confirmez les résultats par une inspection aléatoire et un examen manuel.

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