Extensions/ConvertFrom-ExistingSubmission.ps1
|
# Copyright (C) Microsoft Corporation. All rights reserved. <# .SYNOPSIS Script for converting an existing submission in the Store to the March 2016 PDP schema. .DESCRIPTION Script for converting an existing submission in the Store to the March 2016 PDP schema. The Git-repo for the StoreBroker module can be found here: http://aka.ms/StoreBroker .PARAMETER AppId The ID of the application that the PDP's will be getting created for. The most recent submission for this application will be used unless a SubmissionId is explicitly specified. .PARAMETER SubmissionId The ID of the application submission that the PDP's will be getting created for. The most recent submission for AppId will be used unless a value for this parameter is provided. .PARAMETER SubmissionId The submission object that you want to convert, which was previously retrieved. .PARAMETER Release The release to use. This value will be placed in each new PDP and used in conjunction with '-OutPath'. Some examples could be "1601" for a January 2016 release, "March 2016", or even just "1". .PARAMETER PdpFileName The name of the PDP file that will be generated for each region. .PARAMETER OutPath The output directory. This script will create two subfolders of OutPath: <OutPath>\PDPs\<Release>\ <OutPath>\Images\<Release>\ Each of these sub-folders will have region-specific subfolders for their file content. .EXAMPLE .\ConvertFrom-ExistingSubmission -AppId 0ABCDEF12345 -Release "March Release" -OutPath "C:\NewPDPs" Converts the data from the last published submission for AppId 0ABCDEF12345. The generated files will use the default name of "PDP.xml" and be located in lang-code specific sub-directories within c:\NewPDPs. .EXAMPLE .\ConvertFrom-ExistingSubmission -AppId 0ABCDEF12345 -SubmissionId 1234567890123456789 -Release "March Release" -PdpFileName "ProductDescription.xml" -OutPath "C:\NewPDPs" Converts the data from submission 1234567890123456789 for AppId 0ABCDEF12345 (which might be a published or pending submission). The generated files will be named "ProductDescription.xml" and will be located in lang-code specific sub-directories within c:\NewPDPs. .EXAMPLE .\ConvertFrom-ExistingSubmission -Submission $sub -Release "March Release" -OutPath "C:\NewPDPs" Converts the data from a submission object that was captured earlier in your PowerShell session. It might have come from Get-ApplicationSubmission, or it might have been generated some other way. This method of running the script was created more for debugging purposes, but others may find it useful. The generated files will use the default name of "PDP.xml" and be located in lang-code specific sub-directories within c:\NewPDPs. #> [CmdletBinding( SupportsShouldProcess, DefaultParametersetName = "UseApi")] param( [Parameter( Mandatory, ParameterSetName = "UseApi", Position = 0)] [string] $AppId, [Parameter( ParameterSetName = "UseApi", Position = 1)] [string] $SubmissionId = $null, [Parameter( Mandatory, ParameterSetName = "ProvideSubmission", Position = 0)] [PSCustomObject] $Submission = $null, [Parameter(Mandatory)] [string] $Release, [string] $PdpFileName = "PDP.xml", [Parameter(Mandatory)] [string] $OutPath ) # Import Write-Log $rootDir = Split-Path -Path $PSScriptRoot -Parent $helpers = "$rootDir\StoreBroker\Helpers.ps1" if (-not (Test-Path -Path $helpers -PathType Leaf)) { throw "Script execution requires Helpers.ps1 which is part of the git repo. Please execute this script from within your cloned repo." } . $helpers #region Comment Constants $script:LocIdAttribute = "_locID" $script:LocIdFormat = "App_{0}" $script:CommentFormat = " _locComment_text=`"{{MaxLength={0}}} {1}`" " $script:CommentLockedFormat = " _locComment_text=`"{{Locked}} {0}`" " # Used by child nodes, will be formatted, appended with "{0}`"", and then formatted again. # Because of formatting twice, need to quadruple normal curly-braces. $script:CommentFormatN = " _locComment_text=`"{{{{MaxLength={0}}}}} {1} " $script:CommentFormatNClose = "{0}`" " # Used by parant nodes to describe the type/quantity of children. $script:SectionCommentFormat = " Valid length: {0} character limit, up to {1} elements " #endregion Comment Constants $script:ScreenshotAttributeMap = @{ "Screenshot" = "DesktopImage" "MobileScreenshot" = "MobileImage" "XboxScreenshot" = "XboxImage" "SurfaceHubScreenshot" = "SurfaceHubImage" "HoloLensScreenshot" = "HoloLensImage"} $script:AdditionalAssetNames = @( 'StoreLogo9x16', 'StoreLogoSquare', 'Icon', 'PromotionalArt16x9', 'PromotionalArtwork2400X1200', 'XboxBrandedKeyArt', 'XboxTitledHeroArt', 'XboxFeaturedPromotionalArt', 'SquareIcon358X358', 'BackgroundImage1000X800', 'PromotionalArtwork414X180') function Add-ToElement { <# .SYNOPSIS Adds an arbitrary number of comments and attributes to an XmlElement. .PARAMETER Element The XmlElement to be modified. .PARAMETER Comment An array of comments to add to the element. .PARAMETER Attribute A hashtable where the keys are the attribute names and the values are the attribute values. .NOTES If a provided attribute already exists on the Element, the Element will NOT be modified. It will ONLY be modified if the Element does not have that attribute. .EXAMPLE PS C:\>$xml = [xml] (Get-Content $filePath) PS C:\>$root = $xml.DocumentElement PS C:\>Add-ToElement -Element $root -Comment "Comment1", "Comment2" -Attribute @{ "Attrib1"="Val1"; "Attrib2"="Val2" } Adds two comments and two attributes to the root element of the XML document. #> param( [Parameter(Mandatory)] [System.Xml.XmlElement] $Element, [string[]] $Comment, [hashtable] $Attribute ) if ($Comment.Count -gt 1) { # Reverse 'Comment' array in order to preserve order because of nature of 'Prepend' # Input array is modified in place, no need to capture result [Array]::Reverse($Comment) } foreach ($text in $Comment) { if (-not [String]::IsNullOrWhiteSpace($text)) { $elem = $Element.OwnerDocument.CreateComment($text) $Element.PrependChild($elem) | Out-Null } } foreach ($key in $Attribute.Keys) { if ($null -eq $Element.$key) { $Element.SetAttribute($key, $Attribute[$key]) } else { $out = "For element $($Element.LocalName), did not create attribute '$key' with value '$($Attribute[$key])' because the attribute already exists." Write-Log -Message $out -Level Warning } } } function Add-ToChildren { <# .SYNOPSIS Adds comments and attributes to every child of the Parent element. .DESCRIPTION Adds comments and attributes to every child of the Parent element. Each comment and attribute is applied to each child. Comments and attribute values may use a format item, eg "{0}", but only the "0" index is valid. In other words, any number of "{0}" is fine but "{1}", "{2}", etc., is not. When, the comment/attribute is applied, it will be formatted with the index of the child, starting from one (this can be changed by the 'CountFrom' parameter). .PARAMETER Parent The Parent XmlElement. .PARAMETER Comment An array of comments to add to each child. A comment may have any number of "{0}" format items but cannot have "{1}", "{2}", etc. .PARAMETER Attribute A hashtable where the keys are the attribute names and the values are the attribute values. A attribute value may have any number of "{0}" format items but cannot have "{1}", "{2}", etc. .PARAMETER ChildNodeType Only children of the input type will be modified. Default is [System.Xml.XmlNodeType]::Element. .PARAMETER CountFrom The number to start enumerating from when labeling child nodes with an index. Default is one (1). .EXAMPLE PS C:\>$xml = [xml] (Get-Content $filePath) PS C:\>$root = $xml.DocumentElement PS C:\>Add-ToChildren -Parent $root -Comment "Static comment", "Child number {0}" -Attribute @{ "ID"="{0}" } For every child of $root, adds the input comments and attributes. After the function returns, the first child would have the new comment "Static comment", the new comment "Child number 1" and the new attribute "ID"="1". #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="More accurately reflects the likely outcome.")] param( [Parameter(Mandatory)] [System.Xml.XmlElement] $Parent, [string[]] $Comment, [hashtable] $Attribute, [System.Xml.XmlNodeType] $ChildNodeType = [System.Xml.XmlNodeType]::Element, [Int32] $CountFrom = 1 ) $Parent.ChildNodes | Where-Object NodeType -eq $ChildNodeType | ForEach-Object { $elem = $_ $comments = @() foreach ($text in ($Comment | Where-Object { -not [String]::IsNullOrWhiteSpace($_) })) { $comments += ($text -f $CountFrom) } $attribs = @{} foreach ($keyval in ($Attribute.GetEnumerator() | Where-Object { -not [String]::IsNullOrWhiteSpace($_.Value) })) { $attribs[$keyval.Key] = ($keyval.Value -f $CountFrom) } $params = @{ "Element" = $elem } if ($comments.Count -gt 0) { $params["Comment"] = $comments } if ($attribs.Keys.Count -gt 0) { $params["Attribute"] = $attribs } Add-ToElement @params $CountFrom++ } } function Ensure-RootChild { <# .SYNOPSIS Creates the specified element as a child of the XML root node, only if that element does not exist already. .PARAMETER Xml The XmlDocument to (potentially) modify. .PARAMETER Element The name of the element to existence check. .OUTPUTS XmlElement. Returns a reference to the (possibly newly created) element requested. .EXAMPLE PS C:\>$xml = [xml] (Get-Content $filePath) PS C:\>Ensure-RootChild -Xml $xml -Element "SomeElement" $xml.DocumentElement.SomeElement now exists and is an XmlElement object. #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseApprovedVerbs", "", Justification="Best description for purpose")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [string] $Element ) # ProductDescription node $root = $Xml.DocumentElement if ($root.GetElementsByTagName($Element).Count -eq 0) { $elem = $Xml.CreateElement($Element, $Xml.DocumentElement.NamespaceURI) $root.AppendChild($elem) | Out-Null } return $root.GetElementsByTagName($Element)[0] } function Add-AppStoreName { <# .SYNOPSIS Creates the AppStoreName node. .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "AppStoreName" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName # These comments get added in reverse order. $comment = $elementNode.OwnerDocument.CreateComment(" $($Listing.title) ") $elementNode.PrependChild($comment) | Out-Null # Add loc comment to parent (we need loc comments to be directly before the content) $maxChars = 200 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = @( ' This is optional. AppStoreName is typically extracted from your package''s AppxManifest DisplayName property. ', ' Uncomment (and localize) this Store name if your application package does not contain a localization for the DisplayName in this language. ', ' Leaving this uncommented for a language that your application package DOES contain a DisplayName for will result in a submission failure with the API. ', ($script:CommentFormat -f $maxChars, "App $elementName")); } Add-ToElement @paramSet } function Add-Keywords { <# .SYNOPSIS Creates the keyword nodes .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "Keywords" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName foreach ($keyword in $Listing.keywords) { $child = $Xml.CreateElement("Keyword", $xml.productDescription.NamespaceURI) $child.InnerText = $keyword $elementNode.AppendChild($child) | Out-Null } # Add comment to parent $maxChars = 30 $maxChildren = 7 $paramSet = @{ "Element" = $elementNode; "Comment" = ($script:SectionCommentFormat -f $maxChars, $maxChildren); } Add-ToElement @paramSet # Add comment to children $maxChars = 30 $paramSet = @{ "Parent" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "keyword") + "{0}" }; "Comment" = ($script:CommentFormatN -f $maxChars, "App keyword") + $script:CommentFormatNClose; } Add-ToChildren @paramSet } function Add-Description { <# .SYNOPSIS Creates the description node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "Description" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.description # Add comment to parent $maxChars = 10000 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = ($script:CommentFormat -f $maxChars, "App $elementName"); } Add-ToElement @paramSet } function Add-ShortDescription { <# .SYNOPSIS Creates the ShortDescription node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "ShortDescription" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.shortDescription # Add comment to parent $maxChars = 500 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = @( ' Only used for games. This description appears in the Information section of the Game Hub on Xbox One, and helps customers understand more about your game. ', ($script:CommentFormat -f $maxChars, "App $elementName")); } Add-ToElement @paramSet } function Add-ShortTitle { <# .SYNOPSIS Creates the ShortTitle node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "ShortTitle" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.shortTitle # Add comment to parent $maxChars = 50 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = @( ' A shorter version of your product''s name. If provided, this shorter name may appear in various places on Xbox One (during installation, in Achievements, etc.) in place of the full title of your product. ', ($script:CommentFormat -f $maxChars, "App $elementName")); } Add-ToElement @paramSet } function Add-SortTitle { <# .SYNOPSIS Creates the SortTitle node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "SortTitle" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.sortTitle # Add comment to parent $maxChars = 255 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = @( ' If your product could be alphabetized in different ways, you can enter another version here. This may help customers find the product more quickly when searching. ', ($script:CommentFormat -f $maxChars, "App $elementName")); } Add-ToElement @paramSet } function Add-VoiceTitle { <# .SYNOPSIS Creates the VoiceTitle node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "VoiceTitle" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.voiceTitle # Add comment to parent $maxChars = 255 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = @( ' An alternate name for your product that, if provided, may be used in the audio experience on Xbox One when using Kinect or a headset. ', ($script:CommentFormat -f $maxChars, "App $elementName")); } Add-ToElement @paramSet } function Add-DevStudio { <# .SYNOPSIS Creates the DevStudio node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "DevStudio" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.devStudio # Add comment to parent $maxChars = 255 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = @( ' Specify this value if you want to include a "Developed by" field in the listing. (The "Published by" field will list the publisher display name associated with your account, whether or not you provide a devStudio value.) ', ($script:CommentFormat -f $maxChars, "App $elementName")); } Add-ToElement @paramSet } function Add-ReleaseNotes { <# .SYNOPSIS Creates the release notes node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "ReleaseNotes" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.releaseNotes # Add comment to parent $maxChars = 1500 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = ($script:CommentFormat -f $maxChars, "App Release Note"); } Add-ToElement @paramSet } function Add-ScreenshotCaptions { <# .SYNOPSIS Creates the caption nodes and associates the related images as attributes to those captions. .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. .OUTPUTS [String[]] Array of image names that the captions reference #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $imageNames = @() # Group the images together by captions (so that we only have one caption element for the # same caption text) $captionImageMap = [ordered]@{} $noCaptionImages = @() $Listing.images | ForEach-Object { $imageType = $_.imageType $fileName = Split-Path -Path ($_.fileName) -Leaf $description = $_.description if (-not $script:ScreenshotAttributeMap.Contains($imageType)) { if (-not $script:AdditionalAssetNames.Contains($imageType)) { Write-Warning "Image [$fileName] of type [$imageType] defined for [$Lang] listing, but is not supported by PDP converter. Skipping adding of the image to PDP." } return # acts like a "continue" in a ForEach-Object } if ([String]::IsNullOrEmpty($description)) { $noCaptionImages += @{ $imageType = $fileName } return } if ($null -eq $captionImageMap[$description]) { # Note: PSScriptAnalyzer falsely flags this next line as PSUseDeclaredVarsMoreThanAssignment due to: # https://github.com/PowerShell/PSScriptAnalyzer/issues/699 $captionImageMap[$description] = @{} } ($captionImageMap[$description])[$imageType] = $fileName } # Create ScreenshotCaptions node if it does not exist $elementName = "ScreenshotCaptions" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName # Now, we'll create a new caption node for each known unique caption, setting an attribute # for any imagetype that has a screenshot using that caption foreach ($caption in $captionImageMap.Keys) { $child = $Xml.CreateElement("Caption", $xml.productDescription.NamespaceURI) $child.InnerText = $caption foreach ($screenshotType in $captionImageMap.$caption.Keys) { $imageName = $captionImageMap.$caption[$screenshotType] $child.SetAttribute($script:ScreenshotAttributeMap[$screenshotType], $imageName) $imageNames += $imageName } $elementNode.AppendChild($child) | Out-Null } # Now we'll create new caption nodes for images that had no captions foreach ($image in $noCaptionImages) { $child = $Xml.CreateElement("Caption", $xml.productDescription.NamespaceURI) $imageName = $image.Values[0] $child.SetAttribute($script:ScreenshotAttributeMap[$image.Keys[0]], $imageName) $elementNode.AppendChild($child) | Out-Null $imageNames += $imageName } # Add comments to parent $paramSets = @() $paramSets += @{ "Element" = $elementNode; "Comment" = " Valid attributes: any of DesktopImage, MobileImage, XboxImage, SurfaceHubImage, and HoloLensImage " } $maxChars = 200 $maxChildren = 9 $paramSets += @{ "Element" = $elementNode; "Comment" = ("${script:SectionCommentFormat}per platform " -f $maxChars, $maxChildren); } foreach ($paramSet in $paramSets) { Add-ToElement @paramSet } # Add comment to children $maxChars = 200 $paramSet = @{ "Parent" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "caption") + "{0}" }; "Comment" = ($script:CommentFormatN -f $maxChars, "Screenshot caption") + $script:CommentFormatNClose; } Add-ToChildren @paramSet return $imageNames } function Add-AdditionalAssets { <# .SYNOPSIS Creates the additional asset nodes and associates the related images as attributes to those elements. .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. .OUTPUTS [String[]] Array of image names that the elements reference #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification = "This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $imageNames = @() # Create AdditionalAssets node if it does not exist $elementName = "AdditionalAssets" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $Listing.images | ForEach-Object { $imageType = $_.imageType $imageName = Split-Path -Path ($_.fileName) -Leaf # We intentionally don't bother capturing the description for these since it's not relevant. if (-not $script:AdditionalAssetNames.Contains($imageType)) { # No need to spit out a warning here...it would have already happened # during Add-ScreenshotCaptions. return # acts like a "continue" in a ForEach-Object } $imageNames += $imageName $child = $Xml.CreateElement($imageType, $xml.productDescription.NamespaceURI) $child.SetAttribute('FileName', $imageName) $elementNode.AppendChild($child) | Out-Null } # Add comments to parent $paramSets = @() $paramSets += @{ "Element" = $elementNode; "Comment" = " Valid elements: StoreLogo9x16, StoreLogoSquare, Icon (use this value for the 1:1 300x300 pixels logo), " } $paramSets += @{ "Element" = $elementNode; "Comment" = " PromotionalArt16x9, PromotionalArtwork2400X1200, XboxBrandedKeyArt, XboxTitledHeroArt, XboxFeaturedPromotionalArt, " } $paramSets += @{ "Element" = $elementNode; "Comment" = " SquareIcon358X358, BackgroundImage1000X800, PromotionalArtwork414X180 " } $paramSets += @{ "Element" = $elementNode; "Comment" = " There is no content for any of these elements, just a single attribute called FileName. " } [array]::Reverse($paramSets) # Reverse the array to ensure that they appear in this order foreach ($paramSet in $paramSets) { Add-ToElement @paramSet } return $imageNames } function Add-Trailers { <# .SYNOPSIS Creates the trailers node and associates the related trailers, titles and screenshots. .PARAMETER Xml The XmlDocument to modify. .PARAMETER Submission Ths submission object that was used to generate the set of PDP files. .PARAMETER Lang The language / region code for the PDP (e.g. "en-us") .OUTPUTS [String[]] Array of asset names (trailers and screenshots) that are referenced #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification = "This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Submission, [Parameter(Mandatory)] [string] $Lang ) $assetFileNames = @() # Create ScreenshotCaptions node if it does not exist $elementName = "Trailers" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $maxChildren = 15 $paramSet = @{ "Element" = $elementNode; "Comment" = (" Maximum number of trailers permitted: {0} " -f $maxChildren); } Add-ToElement @paramSet $trailerCount = 0 foreach ($trailer in $Submission.trailers) { foreach ($language in ($trailer.trailerAssets | Get-Member -Type NoteProperty)) { $langCode = $language.Name if ($langCode -ne $Lang) { continue } $trailerCount++ # There's an entry for this trailer, for this language, so add it to the PDP $trailerFileName = Split-Path -Path ($trailer.videoFileName) -Leaf $assetFileNames += $trailerFileName $title = $trailer.trailerAssets.$langCode.title $screenshotDescription = $trailer.trailerAssets.$langCode.imageList[0].description $screenshotFileName = Split-Path -Path ($trailer.trailerAssets.$langCode.imageList[0].fileName) -Leaf if (-not [String]::IsNullOrWhiteSpace($screenshotFileName)) { # The API doesn't seem to always return the screenshot filename. # We'll guard against that by only adding the value to our asset array # if there's a value. $assetFileNames += $screenshotFileName } $trailerElement = $Xml.CreateElement("Trailer", $xml.productDescription.NamespaceURI) $trailerElement.SetAttribute('FileName', $trailerFileName) $elementNode.AppendChild($trailerElement) | Out-Null $titleElement = $Xml.CreateElement("Title", $xml.productDescription.NamespaceURI) $titleElement.InnerText = $title $trailerElement.AppendChild($titleElement) | Out-Null $maxChars = 255 $paramSet = @{ "Element" = $titleElement; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "trailerTitle") + $trailerCount }; "Comment" = ($script:CommentFormat -f $maxChars, "Trailer title $trailerCount"); } Add-ToElement @paramSet $imagesElement = $Xml.CreateElement("Images", $xml.productDescription.NamespaceURI) $trailerElement.AppendChild($imagesElement) | Out-Null $paramSet = @{ "Element" = $imagesElement; "Comment" = ' Current maximum of 1 image per trailer permitted. '; } Add-ToElement @paramSet $imageElement = $Xml.CreateElement("Image", $xml.productDescription.NamespaceURI) $imageElement.SetAttribute('FileName', $screenshotFileName) $imageElement.InnerText = $screenshotDescription $imagesElement.AppendChild($imageElement) | Out-Null $paramSet = @{ "Element" = $imageElement; "Comment" = ($script:CommentLockedFormat -f "Trailer screenshot $trailerCount description"); } Add-ToElement @paramSet } } return $assetFileNames } function Add-AppFeatures { <# .SYNOPSIS Creates the app features nodes .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "AppFeatures" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName foreach ($feature in $Listing.features) { $child = $Xml.CreateElement("AppFeature", $xml.productDescription.NamespaceURI) $child.InnerText = $feature $elementNode.AppendChild($child) | Out-Null } # Add comment to parent $maxChars = 200 $maxChildren = 20 $paramSet = @{ "Element" = $elementNode; "Comment" = ($script:SectionCommentFormat -f $maxChars, $maxChildren); } Add-ToElement @paramSet # Add comment to children $maxChars = 200 $paramSet = @{ "Parent" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "feature") + "{0}" }; "Comment" = ($script:CommentFormatN -f $maxChars, "App Feature") + $script:CommentFormatNClose; } Add-ToChildren @paramSet } function Add-RecommendedHardware { <# .SYNOPSIS Creates the recommended hardware nodes .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "RecommendedHardware" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName foreach ($recommendation in $Listing.recommendedHardware) { $child = $Xml.CreateElement("Recommendation", $xml.productDescription.NamespaceURI) $child.InnerText = $recommendation $elementNode.AppendChild($child) | Out-Null } # Add comment to parent $maxChars = 200 $maxChildren = 11 $paramSet = @{ "Element" = $elementNode; "Comment" = $script:SectionCommentFormat -f $maxChars, $maxChildren; } Add-ToElement @paramSet # Add comment to children $maxChars = 200 $paramSet = @{ "Parent" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "RecommendedHW") + "{0}" }; "Comment" = ($script:CommentFormatN -f $maxChars, "App Recommended Hardware") + $script:CommentFormatNClose; } Add-ToChildren @paramSet } function Add-MinimumHardware { <# .SYNOPSIS Creates the minimum hardware nodes .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "MinimumHardware" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName foreach ($minimumRequirement in $Listing.minimumHardware) { $child = $Xml.CreateElement("MinimumRequirement", $xml.productDescription.NamespaceURI) $child.InnerText = $minimumRequirement $elementNode.AppendChild($child) | Out-Null } # Add comment to parent $maxChars = 200 $maxChildren = 11 $paramSet = @{ "Element" = $elementNode; "Comment" = $script:SectionCommentFormat -f $maxChars, $maxChildren; } Add-ToElement @paramSet # Add comment to children $maxChars = 200 $paramSet = @{ "Parent" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "MinimumRequirementHW") + "{0}" }; "Comment" = ($script:CommentFormatN -f $maxChars, "App Minimum Required Hardware") + $script:CommentFormatNClose; } Add-ToChildren @paramSet } function Add-CopyrightAndTrademark { <# .SYNOPSIS Creates the CopyrightAndTrademark node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "CopyrightAndTrademark" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.copyrightAndTrademarkInfo # Add comment to parent $maxChars = 200 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "CopyrightandTrademark") }; "Comment" = ($script:CommentFormat -f $maxChars, "Copyright and Trademark"); } Add-ToElement @paramSet } function Add-AdditionalLicenseTerms { <# .SYNOPSIS Creates the AdditionalLicenseTerms node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="This is the existing name of the section within the PDP.")] param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "AdditionalLicenseTerms" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.licenseTerms # Add comment to parent $maxChars = 10000 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = ($script:CommentFormat -f $maxChars, "Additional License Terms"); } Add-ToElement @paramSet } function Add-WebsiteUrl { <# .SYNOPSIS Creates the WebsiteURL node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "WebsiteURL" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.websiteUrl # Add comment to parent $maxChars = 2048 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = ($script:CommentFormat -f $maxChars, $elementName); } Add-ToElement @paramSet } function Add-SupportContact { <# .SYNOPSIS Creates the SupportContact node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "SupportContactInfo" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.supportContact # Add comment to parent $maxChars = 2048 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f $elementName) }; "Comment" = ($script:CommentFormat -f $maxChars, "Support Contact Info"); } Add-ToElement @paramSet } function Add-PrivacyPolicy { <# .SYNOPSIS Creates the PrivacyPolicy node .PARAMETER Xml The XmlDocument to modify. .PARAMETER Listing The base listing from the submission for a specific Lang. #> param( [Parameter(Mandatory)] [System.Xml.XmlDocument] $Xml, [Parameter(Mandatory)] [PSCustomObject] $Listing ) $elementName = "PrivacyPolicyURL" $elementNode = Ensure-RootChild -Xml $Xml -Element $elementName $elementNode.InnerText = $Listing.privacyPolicy # Add comment to parent $maxChars = 2048 $paramSet = @{ "Element" = $elementNode; "Attribute" = @{ $script:LocIdAttribute = ($script:LocIdFormat -f "PrivacyURL") }; "Comment" = ($script:CommentFormat -f $maxChars, "Privacy Policy URL"); } Add-ToElement @paramSet } function ConvertFrom-Listing { <# .SYNOPSIS Converts a base listing for an existing submission into a PDP file that conforms with the March 2016 PDP schema. .PARAMETER Submission The submission object that was used to generate the set of PDP files. .PARAMETER Listing The base listing from the submission for the indicated Lang. .PARAMETER Lang The language / region code for the PDP (e.g. "en-us") .PARAMETER Release The release to use. This value will be placed in each new PDP. Some examples could be "1601" for a January 2016 release, "March 2016", or even just "1". .PARAMETER PdpRootPath The root / base path that all of the language sub-folders will go for the PDP files. .PARAMETER FileName The name of the PDP file that will be generated. .OUTPUTS [String[]] Array of media asset file names that are referenced .EXAMPLE ConvertFrom-Listing -Submission $sub -Listing ($sub.listings."en-us".baseListing) -Lang "en-us" -Release "1701" -PdpRootPath "C:\PDPs\" -FileName "PDP.xml" Converts the given "en-us" base listing to the current PDP schema, and saves it to "c:\PDPs\en-us\PDP.xml" #> [CmdletBinding()] param( [Parameter(Mandatory)] [PSCustomObject] $Submission, [Parameter(Mandatory)] [PSCustomObject] $Listing, [Parameter(Mandatory)] [string] $Lang, [Parameter(Mandatory)] [string] $Release, [Parameter(Mandatory)] [string] $PdpRootPath, [Parameter(Mandatory)] [string] $FileName ) $xml = [xml]([String]::Format('<?xml version="1.0" encoding="utf-8"?> <ProductDescription language="en-us" xmlns="http://schemas.microsoft.com/appx/2012/ProductDescription" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xml:lang="{0}" Release="{1}"/>', $Lang, $Release)) Add-AppStoreName -Xml $Xml -Listing $Listing Add-Keywords -Xml $Xml -Listing $Listing Add-Description -Xml $Xml -Listing $Listing Add-ShortDescription -Xml $Xml -Listing $Listing Add-ShortTitle -Xml $Xml -Listing $Listing Add-SortTitle -Xml $Xml -Listing $Listing Add-VoiceTitle -Xml $Xml -Listing $Listing Add-DevStudio -Xml $Xml -Listing $Listing Add-ReleaseNotes -Xml $Xml -Listing $Listing $screenshotFileNames = Add-ScreenshotCaptions -Xml $xml -Listing $Listing $additionalAssetFileNames = Add-AdditionalAssets -Xml $xml -Listing $Listing $trailerFileNames = Add-Trailers -Xml $xml -Submission $Submission -Lang $Lang Add-AppFeatures -Xml $Xml -Listing $Listing Add-RecommendedHardware -Xml $Xml -Listing $Listing Add-MinimumHardware -Xml $Xml -Listing $Listing Add-CopyrightAndTrademark -Xml $Xml -Listing $Listing Add-AdditionalLicenseTerms -Xml $Xml -Listing $Listing Add-WebsiteUrl -Xml $Xml -Listing $Listing Add-SupportContact -Xml $Xml -Listing $Listing Add-PrivacyPolicy -Xml $Xml -Listing $Listing # Save XML object to file $filePath = Ensure-PdpFilePath -PdpRootPath $PdpRootPath -Lang $Lang -FileName $FileName $xml.Save($filePath) # Post-process the file to ensure CRLF (sometimes is only LF). $content = Get-Content -Encoding UTF8 -Path $filePath $content -join [Environment]::NewLine | Out-File -Force -Encoding utf8 -FilePath $filePath # PowerShell likes to convert arrays of single items back to individual items. # We need to ensure that we're definitely concatenting arrays together, and don't have # any single items in there. Therefore, we wrap each variable in an array to force it # to be an array for merging purposes. $mediaFileNames = @($screenshotFileNames) + @($additionalAssetFileNames) + @($trailerFileNames) return $mediaFileNames } function Ensure-PdpFilePath { <# .SYNOPSIS Ensures that the containing folder for a PDP file that will be generated exists so that it can successfully be written. .DESCRIPTION Ensures that the containing folder for a PDP file that will be generated exists so that it can successfully be written. .PARAMETER PdpRootPath The root / base path that all of the language sub-folders will go for the PDP files. .PARAMETER Lang The language / region code for the PDP (e.g. "en-us") .PARAMETER FileName The name of the PDP file that will be generated. .EXAMPLE Ensure-PdpFilePath -PdpRootPath "C:\PDPs\" -Lang "en-us" -FileName "PDP.xml" Ensures that the path c:\PDPs\en-us\ exists, creating any sub-folder along the way as necessary, and then returns the path "c:\PDPs\en-us\PDP.xml" .OUTPUTS [String] containing the full path to the PDP file. #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseApprovedVerbs", "", Justification="Best description for purpose")] param( [Parameter(Mandatory)] [string] $PdpRootPath, [string] $Lang, [string] $FileName ) $dropFolder = Join-Path -Path $PdpRootPath -ChildPath $Lang if (-not (Test-Path -PathType Container -Path $dropFolder)) { New-Item -Force -ItemType Directory -Path $dropFolder | Out-Null } return (Join-Path -Path $dropFolder -ChildPath $FileName) } function Show-AssetFileNames { <# .SYNOPSIS Informs the user what the asset filenames are that they need to make available to StoreBroker. .DESCRIPTION Informs the user what the asset filenames are that they need to make available to StoreBroker. .PARAMETER LangAssetNames A hashtable, indexed by langcode, containing an array of asset names that the listing for that langcode references. .PARAMETER Release The release name that was added to the PDP files. .PARAMETER Submission Ths submission object that was used to generate the set of PDP files. .EXAMPLE Show-AssetFileNames -LangAssetNames $langAssetNames -Release "1701" -Submission $sub #> [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="The most common scenario is that there will be multiple assets, not a singular asset.")] param( [Parameter(Mandatory)] [hashtable] $LangAssetNames, [Parameter(Mandatory)] [string] $Release, [Parameter(Mandatory)] [PSCustomObject] $Submission ) # If there are no assets, nothing to do here if ($LangAssetNames.Count -eq 0) { return } Write-Log -Message @( "You now need to find all of your assets and place them here: <ImagesRootPath>\$Release\<langcode>\...", " where <ImagesRootPath> is the path defined in your config file,", " and <langcode> is the same langcode for the directory of the PDP file referencing those assets.") # Quick analysis to help teams out if they need to do anything special with their PDP's $langs = $LangAssetNames.Keys | ConvertTo-Array $seenAssets = $LangAssetNames[$langs[0]] $assetsDiffer = $false for ($i = 1; ($i -lt $langs.Count) -and (-not $assetsDiffer); $i++) { if (($LangAssetNames[$langs[$i]].Count -ne $seenAssets.Count)) { $assetsDiffer = $true break } foreach ($asset in $LangAssetNames[$langs[$i]]) { if ($seenAssets -notcontains $asset) { $assetsDiffer = $true break } } } # Now show the user the asset filenames if ($assetsDiffer) { Write-Log -Level Warning -Message @( "It appears that you don't have consistent assets across all languages.", "While StoreBroker supports this scenario, some localization systems may", "not support this without additional work. Please refer to the FAQ in", "the documentation for more info on how to best handle this scenario.") $output = @() $output += "The currently referenced asset filenames, per langcode, are as follows:" foreach ($langCode in ($LangAssetNames.Keys.GetEnumerator() | Sort-Object)) { $output += " * [$langCode]: " + ($LangAssetNames.$langCode -join ", ") } Write-Log -Message $output } else { Write-Log -Message @( "Every language that has a PDP references the following assets:", "`t$($seenAssets -join `"`n`t`")") } if ($Submission.trailers.Count -gt 0) { Write-Log -Level Warning -Message @( "Your generated PDP files are missing the trailer screenshot filenames due to API limitations.", "You will need to manually update the PDP with those filenames before the PDP's can be used.", "", "Additionally, you should review the generated PDP files and add the appropriate", "`"FallbackLanguage`" attributes (review Documentation/PDP.md for more info)", "so that trailers (and possibly trailer screenshots) can be easily shared across languages." ) } } # function Main is invoked at the bottom of the file function Main { [CmdletBinding()] param() if ($null -eq (Get-Module StoreBroker)) { $message = "The StoreBroker module is not available in this PowerShell session. Please import the module, authenticate correctly using Set-StoreBrokerAuthentication, and try again." throw $message } $sub = $Submission if ($null -eq $sub) { if ([String]::IsNullOrEmpty($SubmissionId)) { $app = Get-Application -AppId $AppId $SubmissionId = $app.lastPublishedApplicationSubmission.id } $sub = Get-ApplicationSubmission -AppId $AppId -SubmissionId $SubmissionId } $langAssetNames = @{} $langs = ($sub.listings | Get-Member -type NoteProperty) $pdpsGenerated = 0 $langs | ForEach-Object { $lang = $_.Name Write-Log -Message "Creating PDP for $lang" -Level Verbose Write-Progress -Activity "Generating PDP" -Status $lang -PercentComplete $(($pdpsGenerated / $langs.Count) * 100) try { $assetFileNames = ConvertFrom-Listing -Submission $sub -Listing ($sub.listings.$lang.baseListing) -Lang $lang -Release $Release -PdpRootPath $OutPath -FileName $PdpFileName $langAssetNames[$lang] = $assetFileNames $pdpsGenerated++ } catch { Write-Log -Message "Error creating [$lang] PDP:" -Exception $_ -Level Error throw } } Write-Log -Message "PDP's have been created here: $OutPath" Show-AssetFileNames -LangAssetNames $langAssetNames -Release $Release -Submission $sub } # Script body $OutPath = Resolve-UnverifiedPath -Path $OutPath # function Main invocation Main # SIG # Begin signature block # MIIjkgYJKoZIhvcNAQcCoIIjgzCCI38CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDimQmqBUjYsTCw # N9ga8TUZdIwGTtvV2Y9ggvC0/e3vxqCCDYEwggX/MIID56ADAgECAhMzAAABh3IX # chVZQMcJAAAAAAGHMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ3WhcNMjEwMzAzMTgzOTQ3WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOt8kLc7P3T7MKIhouYHewMFmnq8Ayu7FOhZCQabVwBp2VS4WyB2Qe4TQBT8aB # znANDEPjHKNdPT8Xz5cNali6XHefS8i/WXtF0vSsP8NEv6mBHuA2p1fw2wB/F0dH # sJ3GfZ5c0sPJjklsiYqPw59xJ54kM91IOgiO2OUzjNAljPibjCWfH7UzQ1TPHc4d # weils8GEIrbBRb7IWwiObL12jWT4Yh71NQgvJ9Fn6+UhD9x2uk3dLj84vwt1NuFQ # itKJxIV0fVsRNR3abQVOLqpDugbr0SzNL6o8xzOHL5OXiGGwg6ekiXA1/2XXY7yV # Fc39tledDtZjSjNbex1zzwSXAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhov4ZyO96axkJdMjpzu2zVXOJcsw # UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1 # ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU4Mzg1MB8GA1UdIwQYMBaAFEhu # ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu # bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w # Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx # MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAixmy # S6E6vprWD9KFNIB9G5zyMuIjZAOuUJ1EK/Vlg6Fb3ZHXjjUwATKIcXbFuFC6Wr4K # NrU4DY/sBVqmab5AC/je3bpUpjtxpEyqUqtPc30wEg/rO9vmKmqKoLPT37svc2NV # BmGNl+85qO4fV/w7Cx7J0Bbqk19KcRNdjt6eKoTnTPHBHlVHQIHZpMxacbFOAkJr # qAVkYZdz7ikNXTxV+GRb36tC4ByMNxE2DF7vFdvaiZP0CVZ5ByJ2gAhXMdK9+usx # zVk913qKde1OAuWdv+rndqkAIm8fUlRnr4saSCg7cIbUwCCf116wUJ7EuJDg0vHe # yhnCeHnBbyH3RZkHEi2ofmfgnFISJZDdMAeVZGVOh20Jp50XBzqokpPzeZ6zc1/g # yILNyiVgE+RPkjnUQshd1f1PMgn3tns2Cz7bJiVUaqEO3n9qRFgy5JuLae6UweGf # AeOo3dgLZxikKzYs3hDMaEtJq8IP71cX7QXe6lnMmXU/Hdfz2p897Zd+kU+vZvKI # 3cwLfuVQgK2RZ2z+Kc3K3dRPz2rXycK5XCuRZmvGab/WbrZiC7wJQapgBodltMI5 # GMdFrBg9IeF7/rP4EqVQXeKtevTlZXjpuNhhjuR+2DMt/dWufjXpiW91bo3aH6Ea # jOALXmoxgltCp1K7hrS6gmsvj94cLRf50QQ4U8Qwggd6MIIFYqADAgECAgphDpDS # AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK # V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0 # IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0 # ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla # MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT # H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG # OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S # 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz # y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7 # 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u # M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33 # X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl # XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP # 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB # l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF # RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM # CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ # BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud # DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO # 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0 # LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y # Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p # Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y # Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB # FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw # cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA # XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY # 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj # 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd # d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ # Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf # wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ # aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j # NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B # xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96 # eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7 # r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I # RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVZzCCFWMCAQEwgZUwfjELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z # b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAYdyF3IVWUDHCQAAAAABhzAN # BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor # BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgNPXD4W1Z # lXp+S70KTw1wdd0wA6kQnMdTfkXTXgYZNfwwQgYKKwYBBAGCNwIBDDE0MDKgFIAS # AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN # BgkqhkiG9w0BAQEFAASCAQCkEvKOHbApFgV8n474HMMJL39BtQ3U3uo94jaegPvk # XFIxYrlX5HKXXw5cEUu0Q+ocCwkKbxl8Y1fAD8UyaQ3XzOXhD08DfxSqN/xHO/h7 # XTN1dVLE6n2JrjqlD7jj05WaaBz6agPdOgTSjxE63E2ebdC1UPPcBfZB/yaInxc4 # PXtUepQCsifKL8BkcQ5tmkvySaHOyMlNWMJoR3AuJvwwNuSIKwYWBIdGPpGp+zEz # frM8c4TI9BzoHzFMsIU4bJmHJPiDkHTSq3HJZQVcRZz79pT2Sbb34NvL3u3qOFVv # 2k5qk1j3bfumbDZ/1YCtWemceZi0aGRq3izBKDT3iPTmoYIS8TCCEu0GCisGAQQB # gjcDAwExghLdMIIS2QYJKoZIhvcNAQcCoIISyjCCEsYCAQMxDzANBglghkgBZQME # AgEFADCCAVUGCyqGSIb3DQEJEAEEoIIBRASCAUAwggE8AgEBBgorBgEEAYRZCgMB # MDEwDQYJYIZIAWUDBAIBBQAEIKDmD84WvyMGLceaqx280R0aktZuyewSLyxv5f6L # A+doAgZfu81R0hoYEzIwMjAxMjAxMjAwNzExLjY2MVowBIACAfSggdSkgdEwgc4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1p # Y3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjowQTU2LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZaCCDkQwggT1MIID3aADAgECAhMzAAABJy9uo++RqBmoAAAA # AAEnMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MB4XDTE5MTIxOTAxMTQ1OVoXDTIxMDMxNzAxMTQ1OVowgc4xCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVy # YXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjowQTU2 # LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vydmlj # ZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAPgB3nERnk6fS40vvWeD # 3HCgM9Ep4xTIQiPnJXE9E+HkZVtTsPemoOyhfNAyF95E/rUvXOVTUcJFL7Xb16jT # KPXONsCWY8DCixSDIiid6xa30TiEWVcIZRwiDlcx29D467OTav5rA1G6TwAEY5rQ # jhUHLrOoJgfJfakZq6IHjd+slI0/qlys7QIGakFk2OB6mh/ln/nS8G4kNRK6Do4g # xDtnBSFLNfhsSZlRSMDJwFvrZ2FCkaoexd7rKlUNOAAScY411IEqQeI1PwfRm3aW # bS8IvAfJPC2Ah2LrtP8sKn5faaU8epexje7vZfcZif/cbxgUKStJzqbdvTBNc93n # /Z8CAwEAAaOCARswggEXMB0GA1UdDgQWBBTl9JZVgF85MSRbYlOJXbhY022V8jAf # BgNVHSMEGDAWgBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEugSaBH # hkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNU # aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUF # BzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1RpbVN0 # YVBDQV8yMDEwLTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsG # AQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IBAQAKyo180VXHBqVnjZwQy7NlzXbo2+W5 # qfHxR7ANV5RBkRkdGamkwUcDNL+DpHObFPJHa0oTeYKE0Zbl1MvvfS8RtGGdhGYG # CJf+BPd/gBCs4+dkZdjvOzNyuVuDPGlqQ5f7HS7iuQ/cCyGHcHYJ0nXVewF2Lk+J # lrWykHpTlLwPXmCpNR+gieItPi/UMF2RYTGwojW+yIVwNyMYnjFGUxEX5/DtJjRZ # mg7PBHMrENN2DgO6wBelp4ptyH2KK2EsWT+8jFCuoKv+eJby0QD55LN5f8SrUPRn # K86fh7aVOfCglQofo5ABZIGiDIrg4JsV4k6p0oBSIFOAcqRAhiH+1spCMIIGcTCC # BFmgAwIBAgIKYQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJv # b3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1WhcN # MjUwNzAxMjE0NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv # bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0 # aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCASIw # DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9plGt0 # VBDVpQoAgoX77XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEwWbEw # RA/xYIiEVEMM1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeGMoQe # dGFnkV+BVLHPk0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJUGKx # Xf13Hz3wV3WsvYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw2k4G # kbaICDXoeByw6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0CAwEA # AaOCAeYwggHiMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ80N7 # fEYbxTNoWoVtVTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYDVR0g # AQH/BIGVMIGSMIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6Ly93 # d3cubWljcm9zb2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYIKwYB # BQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0AGUA # bQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9naOh # IW+z66bM9TG+zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtRgkQS # +7lTjMz0YBKKdsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzymXlK # kVIArzgPF/UveYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCfMkon # /VWvL/625Y4zu2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3DnKOi # PPp/fZZqkHimbdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs9/S/ # fmNZJQ96LjlXdqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110mCII # YdqwUB5vvfHhAN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL2IK0 # cs0d9LiFAR6A+xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffIrE7a # KLixqduWsqdCosnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxEPJdQ # cdeh0sVV42neV8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc1bN+ # NR4Iuto229Nfj950iEkSoYIC0jCCAjsCAQEwgfyhgdSkgdEwgc4xCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBP # cGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjow # QTU2LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy # dmljZaIjCgEBMAcGBSsOAwIaAxUAs5W4TmyDHMRM7iz6mgGojqvXHzOggYMwgYCk # fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD # Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF # AONw14MwIhgPMjAyMDEyMDExODUzNTVaGA8yMDIwMTIwMjE4NTM1NVowdzA9Bgor # BgEEAYRZCgQBMS8wLTAKAgUA43DXgwIBADAKAgEAAgIhGQIB/zAHAgEAAgIR9zAK # AgUA43IpAwIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB # AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAHGkc5/8i6v5zHOd # cCzIMHr0+Ix5n2HME+a7z6hlxOW+Nn3eH68CIokabT6x1Ntk+tpIv6SqedfwPHVP # RqUjg2yIsto0b7rgydDo9pRx4FMl43wV82KwN6je1Za24fzwoerRKdc+RRP0L4VQ # aIVqfOT06U+k9rdaErPYdCE7JQzBMYIDDTCCAwkCAQEwgZMwfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTACEzMAAAEnL26j75GoGagAAAAAAScwDQYJYIZIAWUD # BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B # CQQxIgQgbRR99+hmKVMymjL2TjRUbaKXc0l27uDvyiYz3XOzm2cwgfoGCyqGSIb3 # DQEJEAIvMYHqMIHnMIHkMIG9BCAbkuhLEoYdahb/BUyVszO2VDi6kB3MSaof/+8u # 7SM+IjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB # Jy9uo++RqBmoAAAAAAEnMCIEINsqknCbARnmSJKrg+K6Lcv8FavWdtfrCTE76H9E # whRUMA0GCSqGSIb3DQEBCwUABIIBAOeAlVsSgFtpAjvXXmCKqbP9lpNni7mNf7qB # wlkSbIHvwOXz2UXqpT3TaCWspJnTTDBjaQONXLNciltTqeYu0Kv9EUFzNEOqywB2 # QGMVQcemeMIT9MNuYSzk+niAZgNuWfvBQnMOqdVPNKSh3eZjc9lqrytP4Y5cPxl/ # SuAfUlFrPhv25ohdk0Jl3cSNvihDI6TEvswpGvyP78SjDNvt9crZMJ6M0Im0VMZr # sbdBE9+wLYTy3xLmZ1QzX2ausj7nbCmSUSrRrU8EhBA/1knijCLseqEb9fBAdmyx # JnK3oHCHyGSOCo+ZVCdSJ5k/MJ7a43xVgN1orE+BpeV2qPyPD/c= # SIG # End signature block |