Dataverse

1.1.1

tests/Private/Confirm-PSDVItemDataAttributes.Tests.ps1

. (Join-Path $PSScriptRoot 'PrivateTestCommon.ps1')

Describe 'Confirm-PSDVItemDataAttributes' {
    BeforeEach {
        InModuleScope Dataverse {
            $Global:DATAVERSEAUTHCONTEXT = New-PSDVTestAuthContext
            $Global:DATAVERSEACCESSTOKEN = New-PSDVTestAccessToken
            $Global:DATAVERSEORGURL = 'https://example.crm.dynamics.com/'
        }
    }

    AfterEach {
        InModuleScope Dataverse {
            $Global:DATAVERSEAUTHCONTEXT = $null
            $Global:DATAVERSEACCESSTOKEN = $null
            $Global:DATAVERSEORGURL = $null
        }
    }

    It 'returns metadata for valid item attributes' {
        Mock -CommandName Invoke-WebRequest -ModuleName Dataverse -MockWith {
            return [PSCustomObject]@{ Content = '{"value":[{"LogicalName":"name","AttributeType":"String","SchemaName":"name","Targets":[]},{"LogicalName":"primarycontactid","AttributeType":"Lookup","SchemaName":"primarycontactid_contact","Targets":["contact"]}]}' }
        } -ParameterFilter { $Uri -match "EntityDefinitions\(LogicalName='account'\)/Attributes" }

        InModuleScope Dataverse {
            $result = Confirm-PSDVItemDataAttributes -Table 'account' -ItemData @{ name = 'Contoso'; primarycontactid = [Guid]::NewGuid() }

            $result.Table | Should -BeExactly 'account'
            $result.AttributeDetails.Keys | Should -Contain 'name'
            $result.AttributeDetails.Keys | Should -Contain 'primarycontactid'
        }
    }

    It 'returns metadata for valid lookup OData bind navigation properties' {
        Mock -CommandName Invoke-WebRequest -ModuleName Dataverse -MockWith {
            return [PSCustomObject]@{ Content = '{"value":[{"LogicalName":"name","AttributeType":"String","SchemaName":"name","Targets":[]},{"LogicalName":"primarycontactid","AttributeType":"Lookup","SchemaName":"primarycontactid_contact","Targets":["contact"]}]}' }
        } -ParameterFilter { $Uri -match "EntityDefinitions\(LogicalName='account'\)/Attributes" }

        InModuleScope Dataverse {
            $contactId = [Guid]::NewGuid()
            $result = Confirm-PSDVItemDataAttributes -Table 'account' -ItemData @{ name = 'Contoso'; 'primarycontactid_contact@odata.bind' = "/contacts($contactId)" }

            $result.Table | Should -BeExactly 'account'
            $result.AttributeDetails.Keys | Should -Contain 'name'
            $result.AttributeDetails.Keys | Should -Contain 'primarycontactid_contact@odata.bind'
            $result.AttributeDetails['primarycontactid_contact@odata.bind'].SchemaName | Should -BeExactly 'primarycontactid_contact'
        }
    }

    It 'returns metadata for valid OData bind relationship navigation properties' {
        Mock -CommandName Invoke-WebRequest -ModuleName Dataverse -MockWith {
            if ($Uri -match '/ManyToOneRelationships') {
                return [PSCustomObject]@{ Content = '{"value":[{"ReferencingAttribute":"parentcustomerid","ReferencingEntityNavigationPropertyName":"parentcustomerid_account"}]}' }
            }

            return [PSCustomObject]@{ Content = '{"value":[{"LogicalName":"fullname","AttributeType":"String","SchemaName":"FullName","Targets":[]},{"LogicalName":"parentcustomerid","AttributeType":"Lookup","SchemaName":"ParentCustomerId","Targets":["account"]}]}' }
        }

        InModuleScope Dataverse {
            $accountId = [Guid]::NewGuid()
            $result = Confirm-PSDVItemDataAttributes -Table 'contact' -ItemData @{ fullname = 'Ada'; 'parentcustomerid_account@odata.bind' = "/accounts($accountId)" }

            $result.Table | Should -BeExactly 'contact'
            $result.AttributeDetails.Keys | Should -Contain 'fullname'
            $result.AttributeDetails.Keys | Should -Contain 'parentcustomerid_account@odata.bind'
            $result.AttributeDetails['parentcustomerid_account@odata.bind'].SchemaName | Should -BeExactly 'ParentCustomerId'
        }

        Should -Invoke -CommandName Invoke-WebRequest -ModuleName Dataverse -Times 1 -Exactly -ParameterFilter { $Uri -match '/ManyToOneRelationships' }
    }

    It 'resolves logical name from entity set when table is not supplied' {
        Mock -CommandName Invoke-WebRequest -ModuleName Dataverse -MockWith {
            if ($Uri -match '/EntityDefinitions\?') {
                return [PSCustomObject]@{ Content = '{"LogicalName":"contact"}' }
            }

            return [PSCustomObject]@{ Content = '{"value":[{"LogicalName":"fullname","AttributeType":"String","SchemaName":"fullname","Targets":[]}]}' }
        }

        InModuleScope Dataverse {
            $result = Confirm-PSDVItemDataAttributes -EntitySet 'contacts' -ItemData @{ fullname = 'Ada' }

            $result.Table | Should -BeExactly 'contact'
        }

        Should -Invoke -CommandName Invoke-WebRequest -ModuleName Dataverse -Times 2 -Exactly
    }

    It 'throws when item data contains invalid attributes' {
        Mock -CommandName Invoke-WebRequest -ModuleName Dataverse -MockWith {
            return [PSCustomObject]@{ Content = '{"value":[{"LogicalName":"name","AttributeType":"String","SchemaName":"name","Targets":[]}]}' }
        }

        InModuleScope Dataverse {
            { Confirm-PSDVItemDataAttributes -Table 'account' -ItemData @{ invalidfield = 'value' } } | Should -Throw 'Invalid attributes not present in account : invalidfield'
        }
    }

    It 'throws when item data contains invalid OData bind navigation properties' {
        Mock -CommandName Invoke-WebRequest -ModuleName Dataverse -MockWith {
            return [PSCustomObject]@{ Content = '{"value":[{"LogicalName":"name","AttributeType":"String","SchemaName":"name","Targets":[]},{"LogicalName":"primarycontactid","AttributeType":"Lookup","SchemaName":"primarycontactid_contact","Targets":["contact"]}]}' }
        }

        InModuleScope Dataverse {
            { Confirm-PSDVItemDataAttributes -Table 'account' -ItemData @{ 'missing_contact@odata.bind' = '/contacts(11111111-1111-1111-1111-111111111111)' } } | Should -Throw 'Invalid attributes not present in account : missing_contact@odata.bind'
        }
    }
}