Fix an issue blocking CI during example analysis (Azure#18626)

* Generalize input MarkdownPaths

* fix exampleIssues.csv

* fix a bug

* fix a bug

* change severity

* fix a bug

* fix csv

* restore

Author: MoChilia

tools/StaticAnalysis/ExampleAnalyzer/Measure-MarkdownOrScript.ps1

@@ -50,7 +50,14 @@ if ($OutputScriptsInFile.IsPresent) {
 if ($PSCmdlet.ParameterSetName -eq "Markdown") {
     $null = New-Item -ItemType Directory -Path $OutputFolder -ErrorAction SilentlyContinue
     $null = New-Item -ItemType File  $OutputFolder\TempScript.ps1
-    $MarkdownPath = Get-Content $MarkdownPaths
+    # When the input $MarkdownPaths is the path of txt file
+    if ($MarkdownPaths -cmatch ".*\.txt") {
+        $MarkdownPath = Get-Content $MarkdownPaths
+    }
+    # When the input $MarkdownPaths is the path of a folder
+    else{
+        $MarkdownPath = $MarkdownPaths
+    }
     foreach($_ in Get-ChildItem $MarkdownPath){
         # Filter the .md of overview in "\help\"
         if ((Get-Item -Path $_.FullName).Directory.Name -eq "help" -and $_.FullName -cmatch ".*\.md" -and $_.BaseName -cmatch "^([A-Z][a-z]+)+-([A-Z][a-z0-9]*)+$") {

tools/StaticAnalysis/ExampleAnalyzer/utils.ps1

@@ -541,34 +541,44 @@ function Get-ScriptAnalyzerResult {
     }
     $results = @()
     foreach($analysisResult in $analysisResults){
-        if($analysisResult.Severity -eq "Error"){
+        if($analysisResult.Severity -eq "ParseError"){
+            $Severity = 2
+        }
+        elseif($analysisResult.Severity -eq "Error"){
             $Severity = 2
         }
         elseif($analysisResult.Severity -eq "Warning"){
             $Severity = 3
         }
+        elseif($analysisResult.Severity -eq "Information"){
+            $Severity = 4
+        }
         if($analysisResult.RuleSuppressionID -ge 5000 -and $analysisResult.RuleSuppressionID -le 5199){
             $result = [AnalysisOutput]@{
                 Module = ($analysisResult.Message -split "-")[0]
                 Cmdlet = ($analysisResult.Message -split "-")[1] + "-" + ($analysisResult.Message -split "-")[2]
                 Example = ($analysisResult.Message -split "-")[3]
                 RuleName = $analysisResult.RuleName
-                Description = ($analysisResult.Message -split "@")[1] -replace "`"","`'"
+                Description = ($analysisResult.Message -split "@")[1] -replace "`"","`'" -replace "`n"," " -replace "`r"," "
                 Severity = $Severity
-                Extent = $analysisResult.Extent -replace "`"","`'"
+                Extent = $analysisResult.Extent.ToString().Trim() -replace "`"","`'" -replace "`n"," " -replace "`r"," "
                 ProblemID = $analysisResult.RuleSuppressionID
-                Remediation = ($analysisResult.Message -split "@")[2] -replace "`"","`'"
+                Remediation = ($analysisResult.Message -split "@")[2] -replace "`"","`'" -replace "`n"," " -replace "`r"," "
             }
         }
         else{
             $result = [AnalysisOutput]@{
+                Module = ""
+                Cmdlet = ""
+                Example = 0
                 RuleName = $analysisResult.RuleName
-                Description = $analysisResult.Message
+                Description = $analysisResult.Message -replace "`"","`'" -replace "`n"," " -replace "`r"," "
                 Severity = $Severity
-                Extent = $analysisResult.Extent
-                Remediation = "Unexpected Error! Please contact the Azure Powershell Team."
+                Extent = $analysisResult.Extent.ToString().Trim() -replace "`"","`'" -replace "`n"," " -replace "`r"," "
+                ProblemID = 5200
+                Remediation = "Unexpected Error! Please check your example or contact the Azure Powershell Team."
+                }
             }
-        }
         $results += $result
     }
     #Except the suppressed records