Functions/Public/Projects/Set-GitHubBetaProjectItemField.ps1
|
$betaProjectItemFragment = Get-Content -Raw "$PSScriptRoot/BetaProjectItemFragment.graphql" function Set-GitHubBetaProjectItemField { <# .SYNOPSIS EXPERIMENTAL: Adds an item to a GitHub project (Beta). #> [CmdletBinding()] param( [Parameter(Mandatory)] [string] $ProjectNodeId, [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [Alias('node_id')] [Alias('id')] [string] $ItemNodeId, # The name of the field to set [Parameter(Mandatory)] [Alias('FieldName')] [string] $Name, # The value to set the field to [Parameter(Mandatory)] [Alias('FieldValue')] $Value, # Optional base URL of the GitHub API, for example "https://ghe.mycompany.com/api/v3/" (including the trailing slash). # Defaults to "https://api.github.com" [Uri] $BaseUri = [Uri]::new('https://api.github.com'), [Security.SecureString] $Token ) begin { # Find the ID of the field by name $fields = Invoke-GitHubGraphQlApi ` -Headers @{ 'GraphQL-Features' = 'projects_next_graphql' } ` -Query 'query($projectId: ID!) { node(id: $projectId) { ... on ProjectNext { fields(first: 20) { nodes { id name settings } } } } }' ` -Variables @{ projectId = $ProjectNodeId } ` -BaseUri $BaseUri ` -Token $Token | ForEach-Object { $_.node.fields.nodes } # Parse JSON field foreach ($field in $fields) { $field.settings = $field.settings | ConvertFrom-Json } $field = $fields | Where-Object { $_.name -eq $Name } if (!$field) { throw "Field name does not exist: `"$Name`". Existing fields are: $($fields | ForEach-Object { '"' + $_.name + '"' })" } } process { $input = @{ projectId = $ProjectNodeId itemId = $ItemNodeId fieldId = $field.id value = $Value } # If the field is a select, we need to get the option ID for the provided value. if ($field.settings -and $field.settings.PSObject.Properties['options']) { $option = $field.settings.options | Where-Object { $_.name -eq $Value } if (!$option) { Write-Error "Invalid option value provided for field `"$Name`": `"$Value`". Available options are: $($field.settings.options | ForEach-Object { '"' + $_.name + '"' })" } $input.value = $option.id } Invoke-GitHubGraphQlApi ` -Headers @{ 'GraphQL-Features' = 'projects_next_graphql' } ` -Query ('mutation($input: UpdateProjectNextItemFieldInput!) { updateProjectNextItemField(input: $input) { projectNextItem { ...BetaProjectItemFragment } } } ' + $betaProjectItemFragment) ` -Variables @{ input = $input } ` -BaseUri $BaseUri ` -Token $Token | ForEach-Object { $_.updateProjectNextItemField.projectNextItem } } } |