Merge pull request #134769 from dominicbetts/pr/rido-min/134742

Model parser update

Author: PMEds28

articles/iot-pnp/concepts-model-parser.md

@@ -1,14 +1,14 @@
 ---
 title: Understand the Digital Twins model parser | Microsoft Docs
-description: As a developer, learn how to use the DTDL parser to validate models
+description: As a developer, learn how to use the DTDL parser to validate models.
 author: rido-min
 ms.author: rmpablos
-ms.date: 04/29/2020
+ms.date: 10/21/2020
 ms.topic: conceptual
 ms.custom: mvc
 ms.service: iot-pnp
 services: iot-pnp
-manager: peterpr
+
 ---
 
 # Understand the digital twins model parser
@@ -23,9 +23,12 @@ The parser is available in NuGet.org with the ID: [Microsoft.Azure.DigitalTwins.
 dotnet add package Microsoft.Azure.DigitalTwins.Parser
 ```
 
+> [!NOTE]
+> At the time of writing, the parser version is `3.12.5`.
+
 ## Use the parser to validate a model
 
-The model you want to validate might be composed of one or more interfaces described in JSON files. You can use the parser to load all the files in a given folder and use the parser to validate all the files as a whole, including any references between the files:
+A model can be composed of one or more interfaces described in JSON files. You can use the parser to load all the files in a given folder and use the parser to validate all the files as a whole, including any references between the files:
 
 1. Create an `IEnumerable<string>` with a list of all model contents:
 
@@ -52,38 +55,31 @@ The model you want to validate might be composed of one or more interfaces descr
     IReadOnlyDictionary<Dtmi, DTEntityInfo> parseResult = await modelParser.ParseAsync(modelJson);
     ```
 
-1. Check for validation errors. If the parser finds any errors, it throws an `AggregateException` with a list of detailed error messages:
+1. Check for validation errors. If the parser finds any errors, it throws an `ParsingException` with a list of errors:
 
     ```csharp
     try
     {
         IReadOnlyDictionary<Dtmi, DTEntityInfo> parseResult = await modelParser.ParseAsync(modelJson);
     }
-    catch (AggregateException ae)
+    catch (ParsingException pex)
     {
-        foreach (var e in ae.InnerExceptions)
+        Console.WriteLine(pex.Message);
+        foreach (var err in pex.Errors)
         {
-            Console.WriteLine(e.Message);
+            Console.WriteLine(err.PrimaryID);
+            Console.WriteLine(err.Message);
         }
     }
     ```
 
 1. Inspect the `Model`. If the validation succeeds, you can use the model parser API to inspect the model. The following code snippet shows how to iterate over all the models parsed and displays the existing properties:
 
     ```csharp
-    foreach (var m in parseResult)
+    foreach (var item in parseResult)
     {
-        Console.WriteLine(m.Key);
-        foreach (var item in m.Value.AsEnumerable<DTEntityInfo>())
-        {
-            var p = item as DTInterfaceInfo;
-            if (p!=null)
-            {
-                Console.WriteLine($"\t{p.Id}");
-                Console.WriteLine($"\t{p.Description.FirstOrDefault()}");
-            }
-            Console.WriteLine("--------------");
-        }
+        Console.WriteLine($"\t{item.Key}");
+        Console.WriteLine($"\t{item.Value.DisplayName?.Values.FirstOrDefault()}");
     }
     ```