Générer et lire le code QR Royal Mail en utilisant C#

Le code-barres Royal Mail Mailmark 2D est un code-barres complexe lisible par machine utilisé dans les lettres. Il fournit des informations sur le suivi du courrier et l’état de livraison. Il peut également inclure des informations supplémentaires, telles que le calendrier de livraison et les statistiques de reporting. Dans cet article, nous apprendrons comment générer et lire le code-barres Royal Mail Mailmark 2D en utilisant C#.

Les sujets suivants seront abordés dans cet article :

  1. API C# pour générer et lire les codes QR Royal Mail
  2. Qu’est-ce qu’un code-barres royal?
  3. Types de codes QR Royal Mail
  4. Générer un code QR Royal Mail
  5. Lire le code QR Royal Mail
  6. Ressources d’apprentissage gratuites

API C# pour générer et lire le code QR Royal Mail

Pour générer et lire le code QR Royal Mail, nous utiliserons l’API Aspose.BarCode for .NET. Grâce à l’API, nous pouvons générer et reconnaître un large éventail de types de codes-barres 1D et 2D.

Veuillez soit télécharger la DLL de l’API, soit l’installer à l’aide de NuGet.

PM> Install-Package Aspose.BarCode

Qu’est-ce qu’un code-barres royal ?

Le code-barres Royal Mail est un code-barres Complex Mail Data Mark (CMDM). Il a été développé par le système postal britannique pour automatiser le tri et le suivi du courrier. Il a le format spécifié d’un code ECC200 de type Data Matrix, conforme à la norme internationale. Il est également appelé Royal Mail 4-State Customer Code (RM4SCC).

Types de codes QR Royal Mail

Il existe trois types de codes-barres de marquage de données de courrier complexes 2D :

  • Tapez 7 :
    • Des lettres
    • Taille du code-barres : 24 × 24 modules
    • Taille physique : 12 × 12 mm
    • Nombre total de caractères : 51 caractères
    • Utilisation client : 6 espaces de rechange
Mailmark2DType7
  • Tapez 9 :
    • Grandes lettres, y compris les lettres en polyéthylène
    • Taille du code-barres : 32 × 32 modules
    • Taille physique : 16 × 16 mm
    • Nombre total de caractères : 90 caractères
    • Utilisation par le client : > 25 mais un maximum de 45 espaces libres
Mailmark2DType9
  • Tapez 29 :
    • Grandes lettres, y compris les lettres en polyéthylène
    • Taille du code-barres : 16 × 48 modules
    • Taille physique : 8 × 24 mm
    • Nombre total de caractères : 70 caractères
    • Nombre total de caractères : nous avons besoin de 6 à 25 caractères client.
Mailmark2DType29

Générer un tampon de code-barres Royal Mail en C#

Nous pouvons générer un tampon de code-barres Royal Mail en suivant les étapes ci-dessous :

  1. Tout d’abord, créez une instance de la classe Mailmark2DCodetext.
  2. Ensuite, définissez diverses propriétés telles que UPUCountryID, VersionID, Class, ItemID, etc.
  3. Ensuite, spécifiez le Mailmark2DType comme Type7, Type9 ou Type29.
  4. Ensuite, créez une instance de la classe ComplexBarcodeGenerator avec l’objet Mailmark2DCodetext comme argument.
  5. Après cela, définissez les dimensions du code-barres.
  6. Enfin, appelez la méthode Save pour enregistrer l’image du code-barres sur le disque local.

L’exemple de code suivant montre comment générer un code-barres Mailmark 2D de type 7 à l’aide de C#.

// Cet exemple de code montre comment générer le code-barres Mailmark 2D
// Initialiser le code 2D du mailmark
Mailmark2DCodetext mailmark2D = new Mailmark2DCodetext();
mailmark2D.UPUCountryID = "JGB ";
mailmark2D.InformationTypeID = "0";
mailmark2D.VersionID = "1";
mailmark2D.Class = "1";
mailmark2D.SupplyChainID = 123;
mailmark2D.ItemID = 1234;
mailmark2D.DestinationPostCodeAndDPS = "QWE1";
mailmark2D.RTSFlag = "0";
mailmark2D.ReturnToSenderPostCode = "QWE2";

// Encoder le code Mailmark 2D de type 7
mailmark2D.DataMatrixType = Mailmark2DType.Type_7;
mailmark2D.CustomerContent = "CUSTOM";

// Initialiser le générateur de codes-barres
var generator = new ComplexBarcodeGenerator(mailmark2D);
generator.Parameters.Barcode.XDimension.Pixels = 4;

// Sauvegarder
generator.Sauvegarder(@"D:\Files\BarCode\Mailmark2DType7.png");

Lire le code QR Royal Mail en utilisant C#

Nous pouvons lire le code QR Royal Mail en suivant les étapes ci-dessous :

  1. Tout d’abord, créez une instance de la classe BarCodeReader.
  2. Ensuite, fournissez le chemin de l’image du code-barres d’entrée et le DecodeType.
  3. Ensuite, récupérez le BarCodeResult en appelant la méthode ReadBarCodes().
  4. Après cela, décodez le code-barres à l’aide de la méthode TryDecodeMailmark2D().
  5. Enfin, lisez les propriétés décodées de l’objet Mailmark2DCodetext.

L’exemple de code suivant montre comment lire un code QR Mailmark à l’aide de C#.

// Cet exemple de code montre comment lire le code-barres Mailmark 2D
// Reconnaître le code 2D de Mailmark
BarCodeReader reader = new BarCodeReader(@"D:\Files\BarCode\Mailmark2DType7.png", DecodeType.DataMatrix);
foreach (BarCodeResult result in reader.ReadBarCodes())
{
    // Décoder le mailmark 2D 
    Mailmark2DCodetext mailmarkResult = ComplexCodetextReader.TryDecodeMailmark2D(result.CodeText);
    
    // Lire les propriétés
    Console.WriteLine($"UPUCountryID:{mailmarkResult.UPUCountryID}");
    Console.WriteLine($"InformationTypeID:{mailmarkResult.InformationTypeID}");
    Console.WriteLine($"VersionID:{mailmarkResult.VersionID}");
    Console.WriteLine($"Class:{mailmarkResult.Class}");
    Console.WriteLine($"SupplyChainID:{mailmarkResult.SupplyChainID}");
    Console.WriteLine($"ItemID:{mailmarkResult.ItemID}");
    Console.WriteLine($"DestinationPostCodeAndDPS:{mailmarkResult.DestinationPostCodeAndDPS}");
    Console.WriteLine($"RTSFlag:{mailmarkResult.RTSFlag}");
    Console.WriteLine($"ReturnToSenderPostCode:{mailmarkResult.ReturnToSenderPostCode}");
    Console.WriteLine($"CustomerContent:{mailmarkResult.CustomerContent}");
}
UPUCountryID:JGB
InformationTypeID:0
VersionID:1
Class:1
SupplyChainID:123
ItemID:1234
DestinationPostCodeAndDPS:QWE1
RTSFlag:0
ReturnToSenderPostCode:QWE2
CustomerContent:CUSTOM DATA

Obtenez une licence gratuite

Vous pouvez obtenir une licence temporaire gratuite pour essayer la bibliothèque sans limitations d’évaluation.

Bibliothèque de codes-barres Mailmark 2D - Ressources d’apprentissage

En plus de générer et de lire des codes QR Royal Mail, vous pouvez en savoir plus sur diverses autres fonctionnalités d’Aspose.BarCode en utilisant les ressources ci-dessous :

Conclusion

Dans cet article, nous avons appris comment générer un code QR Royal Mail et enregistrer des images de codes-barres sur le disque. Nous avons également vu comment lire par programme le code-barres Mailmark 2D généré. En outre, vous pouvez en savoir plus sur l’API Aspose.BarCode for .NET à l’aide de la documentation. En cas d’ambiguïté, n’hésitez pas à nous contacter sur notre forum d’assistance gratuit.

Voir également