Klanttabellen (account, contactpersoon en klantadres)

Deze Test-IsEmptyAddressRecordCreationDisabled PowerShell-functie gebruikt de Microsoft Power Platform CLI-opdrachtpac env list-settings om een waarde in de Organization.OrgDbOrgSettings kolom te controleren.

function Test-IsEmptyAddressRecordCreationDisabled {

   $orgdborgsettings = pac env list-settings `
      --filter orgdborgsettings `
   | Where-Object { $_ -match '^orgdborgsettings\s+' } `
   | ForEach-Object { $_ -replace '^orgdborgsettings\s+', '' }

   $xml = [xml]$orgdborgsettings

   $element = $xml.SelectSingleNode("//CreateOnlyNonEmptyAddressRecordsForEligibleEntities")

   # Return true only when the element exists and has the value of 'true'
   return ($null -ne $element) -and ($element.InnerText -eq 'true')
}

Meer informatie over de Microsoft Power Platform CLI

Deze statische IsEmptyAddressRecordCreationDisabled methode maakt gebruik van de klasse WhoAmIRequest en de methode IOrganizationService.Retrieve om een waarde in de kolom Organization.OrgDbOrgSettings te controleren.

static bool IsEmptyAddressRecordCreationDisabled(IOrganizationService service)
{

   Guid orgId = ((WhoAmIResponse)service
         .Execute(new WhoAmIRequest())).OrganizationId;

   Entity organization = service
         .Retrieve("organization", orgId, new ColumnSet("orgdborgsettings"));

   XDocument orgdborgsettings = XDocument
         .Parse((string)organization["orgdborgsettings"]);

   XElement? element = orgdborgsettings
         .XPathSelectElement("//CreateOnlyNonEmptyAddressRecordsForEligibleEntities");

   // Return true only when the element exists and has the value of 'true'
   return element != null && element.Value == "true";
}

• De SDK voor .NET gebruiken
• WhoAmiRequest-klasse
• Een tabelrij ophalen met behulp van de SDK voor .NET
• Kolom Organization.OrgDbOrgSettings

Deze Test-IsEmptyAddressRecordCreationDisabled PowerShell-functie maakt gebruik van het voorbeeld Get-WhoAmI en Get-Record de functies die worden beschreven in Herbruikbare functies maken en zijn afhankelijk van globale variabelen die zijn ingesteld in de functie Verbinding maken.

function Test-IsEmptyAddressRecordCreationDisabled {

   $orgId = Get-WhoAmI | Select-Object -ExpandProperty OrganizationId

   $orgdborgsettings = Get-Record `
      -setName 'organizations' `
      -id $orgId `
      -query "?`$select=orgdborgsettings"
   | Select-Object `
      -ExpandProperty orgdborgsettings

   $xml = [xml]$orgdborgsettings

   $element = $xml.SelectSingleNode("//CreateOnlyNonEmptyAddressRecordsForEligibleEntities")

   # Return true only when the element exists and has the value of 'true'
   return ($null -ne $element) -and ($element.InnerText -eq 'true')
}

• De Web-API van Microsoft Dataverse gebruiken
• Snelstart web-API met PowerShell en Visual Studio Code
• WhoAmI-functie
• Entiteitstype van de organisatie

Deze Test-IsDeleteAddressRecordsEnabled PowerShell-functie gebruikt de Microsoft Power Platform CLI-opdrachtpac env list-settings om een EnableDeleteAddressRecords waarde in de Organization.OrgDbOrgSettings kolom te controleren.

function Test-IsDeleteAddressRecordsEnabled {

   $orgdborgsettings = pac env list-settings `
      --filter orgdborgsettings `
   | Where-Object { $_ -match '^orgdborgsettings\s+' } `
   | ForEach-Object { $_ -replace '^orgdborgsettings\s+', '' }

   $xml = [xml]$orgdborgsettings

   $element = $xml.SelectSingleNode("//EnableDeleteAddressRecords")

   # Return true only when the element exists and has the value of 'true'
   return ($null -ne $element) -and ($element.InnerText -eq 'true')
}

Meer informatie over de Microsoft Power Platform CLI

Deze statische IsDeleteAddressRecordsEnabled methode maakt gebruik van de klasse WhoAmIRequest en de IOrganizationService.Retrieve methode om een EnableDeleteAddressRecords waarde in de Organization.OrgDbOrgSettings kolom te controleren.

static bool IsDeleteAddressRecordsEnabled(IOrganizationService service)
{

   Guid orgId = ((WhoAmIResponse)service
         .Execute(new WhoAmIRequest())).OrganizationId;

   Entity organization = service
         .Retrieve("organization", orgId, new ColumnSet("orgdborgsettings"));

   XDocument orgdborgsettings = XDocument
         .Parse((string)organization["orgdborgsettings"]);

   XElement? element = orgdborgsettings
         .XPathSelectElement("//EnableDeleteAddressRecords");

   // Return true only when the element exists and has the value of 'true'
   return element != null && element.Value == "true";

}

• De SDK voor .NET gebruiken
• WhoAmiRequest-klasse
• Een tabelrij ophalen met behulp van de SDK voor .NET
• Kolom Organization.OrgDbOrgSettings

Deze Test-IsDeleteAddressRecordsEnabled PowerShell-functie maakt gebruik van het voorbeeld Get-WhoAmI en Get-Record de functies die worden beschreven in Herbruikbare functies maken en zijn afhankelijk van globale variabelen die zijn ingesteld in de functie Verbinding maken.

function Test-IsDeleteAddressRecordsEnabled {

   $orgId = Get-WhoAmI | Select-Object -ExpandProperty OrganizationId

   $orgdborgsettings = Get-Record `
      -setName 'organizations' `
      -id $orgId `
      -query "?`$select=orgdborgsettings"
   | Select-Object `
      -ExpandProperty orgdborgsettings

   $xml = [xml]$orgdborgsettings

   $element = $xml.SelectSingleNode("//EnableDeleteAddressRecords")

   # Return true only when the element exists and has the value of 'true'
   return ($null -ne $element) -and ($element.InnerText -eq 'true')
}

• De Web-API van Microsoft Dataverse gebruiken
• Snelstart web-API met PowerShell en Visual Studio Code
• WhoAmI-functie
• Entiteitstype van de organisatie

Met Start-BulkDeleteEmptyCustomerAddressRecords de PowerShell-functie maakt u een systeemtaak om lege customeraddress records te verwijderen met behulp van de Microsoft Power Platform CLI-opdrachtpac data bulk-delete schedule.

Deze functie is afhankelijk van het voorbeeld Test-IsDeleteAddressRecordsEnabled en Test-IsEmptyAddressRecordCreationDisabled de functies die worden beschreven in Detect of het verwijderen van adresrecords is ingeschakeld en Detecteren of het maken van lege adresrecords respectievelijk is uitgeschakeld. De functie maakt de taak alleen wanneer beide instellingen toestaan dat alle lege klantadresrecords worden verwijderd en voorkomen dat nieuwe lege records worden gemaakt.

function Start-BulkDeleteEmptyCustomerAddressRecords {

   if (!(Test-IsDeleteAddressRecordsEnabled)) {
      Write-Host 'Enable deletion of address records before running this function.'
      return
   }

   if (!(Test-IsEmptyAddressRecordCreationDisabled)) {
      Write-Host 'Disable empty address record creation before running this function.'
      return
   }

   $fetchXml = @(
      '<fetch>'
      "<entity name='customeraddress'>"
      "<attribute name='customeraddressid' />"
      "<filter type='and'>"
      "<condition attribute='city' operator='null' />"
      "<condition attribute='country' operator='null' />"
      "<condition attribute='county' operator='null' />"
      "<condition attribute='fax' operator='null' />"
      "<condition attribute='freighttermscode' operator='null' />"
      "<condition attribute='latitude' operator='null' />"
      "<condition attribute='line1' operator='null' />"
      "<condition attribute='line2' operator='null' />"
      "<condition attribute='line3' operator='null' />"
      "<condition attribute='longitude' operator='null' />"
      "<condition attribute='postalcode' operator='null' />"
      "<condition attribute='postofficebox' operator='null' />"
      "<condition attribute='primarycontactname' operator='null' />"
      "<condition attribute='shippingmethodcode' operator='null' />"
      "<condition attribute='stateorprovince' operator='null' />"
      "<condition attribute='telephone1' operator='null' />"
      "<condition attribute='telephone2' operator='null' />"
      "<condition attribute='telephone3' operator='null' />"
      "<condition attribute='upszone' operator='null' />"
      "<condition attribute='utcoffset' operator='null' />"
      '</filter>'
      '</entity>'
      '</fetch>'
   ) -join ''

   pac data bulk-delete schedule `
      --entity customeraddress `
      --fetchxml $fetchXml `
      --job-name 'Delete Empty Customer Address Records'
}

• Meer informatie over de Microsoft Power Platform CLI
• opdracht schema voor bulksgewijs verwijderen van pac-gegevens
• Gegevens bulksgewijs verwijderen

Met de statische BulkDeleteEmptyCustomerAddressRecords methode maakt u een systeemtaak om lege customeradddress records te verwijderen met behulp van de klasse BulkDeleteRequest.

Deze methode maakt gebruik van de voorbeeld IsDeleteAddressRecordsEnabled - en IsEmptyAddressRecordCreationDisabled statische methoden die worden beschreven in Detect of het verwijderen van adresrecords is ingeschakeld en Detecteren of het maken van lege adresrecords respectievelijk is uitgeschakeld om ervoor te zorgen dat deze instellingen zijn geconfigureerd om het verwijderen van alle lege klantadresrecords toe te staan en ervoor te zorgen dat er geen nieuwe records worden gemaakt.

/// <summary>
/// Create a Bulk Delete job to delete empty customer address records
/// </summary>
/// <param name="service">The authenticated IOrganizationService instance.</param>
/// <returns>The Id of the system job</returns>
/// <exception cref="Exception"></exception>
static Guid BulkDeleteEmptyCustomerAddressRecords(IOrganizationService service)
{
    if (!IsDeleteAddressRecordsEnabled(service))
    {

        throw new Exception("Enable deletion of address records" +
            " before running this method.");
    }

    if (!IsEmptyAddressRecordCreationDisabled(service))
    {

        throw new Exception("Disable empty address record creation" +
            " before running this method.");
    }

    var query = new QueryExpression("customeraddress")
    {

        ColumnSet = new ColumnSet("customeraddressid"),
        Criteria =
        {
            Conditions =
            {
                new ConditionExpression("city", ConditionOperator.Null),
                new ConditionExpression("country", ConditionOperator.Null),
                new ConditionExpression("county", ConditionOperator.Null),
                new ConditionExpression("fax", ConditionOperator.Null),
                new ConditionExpression("freighttermscode", ConditionOperator.Null),
                new ConditionExpression("latitude", ConditionOperator.Null),
                new ConditionExpression("line1", ConditionOperator.Null),
                new ConditionExpression("line2", ConditionOperator.Null),
                new ConditionExpression("line3", ConditionOperator.Null),
                new ConditionExpression("longitude", ConditionOperator.Null),
                new ConditionExpression("postalcode", ConditionOperator.Null),
                new ConditionExpression("postofficebox", ConditionOperator.Null),
                new ConditionExpression("primarycontactname", ConditionOperator.Null),
                new ConditionExpression("shippingmethodcode", ConditionOperator.Null),
                new ConditionExpression("stateorprovince", ConditionOperator.Null),
                new ConditionExpression("telephone1", ConditionOperator.Null),
                new ConditionExpression("telephone2", ConditionOperator.Null),
                new ConditionExpression("telephone3", ConditionOperator.Null),
                new ConditionExpression("upszone", ConditionOperator.Null),
                new ConditionExpression("utcoffset", ConditionOperator.Null)
            }
        }
    };

    BulkDeleteRequest request = new()
    {
        QuerySet = new QueryExpression[] { query },
        StartDateTime = DateTime.UtcNow,
        RecurrencePattern = string.Empty,
        SendEmailNotification = false,
        JobName = "Delete empty customer address records",
        ToRecipients = new List<Guid>().ToArray(),
        CCRecipients = new List<Guid>().ToArray()

    };

    var response = (BulkDeleteResponse)service.Execute(request);
    return response.JobId;

}

• De SDK voor .NET gebruiken
• BulkDeleteRequest-klasse
• Gegevens bulksgewijs verwijderen

Met Start-BulkDeleteEmptyCustomerAddressRecords de PowerShell-functie wordt een systeemtaak gemaakt om lege customeradddress records te verwijderen met behulp van de actie BulkDelete.

Deze methode gebruikt het voorbeeld Test-IsDeleteAddressRecordsEnabled en Test-IsEmptyAddressRecordCreationDisabled de functies die worden beschreven in Detect of het verwijderen van adresrecords is ingeschakeld en Detecteren of het maken van lege adresrecords respectievelijk is uitgeschakeld om ervoor te zorgen dat deze instellingen zijn geconfigureerd om het verwijderen van alle lege klantadresrecords toe te staan en ervoor te zorgen dat er geen nieuwe records worden gemaakt.

function Start-BulkDeleteEmptyCustomerAddressRecords {

   if (!(Test-IsDeleteAddressRecordsEnabled)) {
      Write-Host 'Enable deletion of address records before running this function.'
      return
   }

   if (!(Test-IsEmptyAddressRecordCreationDisabled)) {
      Write-Host 'Disable empty address record creation before running this function'
      return
   }

   $query = [ordered]@{
      EntityName    = 'customeraddress'
      ColumnSet     = @{
         Columns = @('customeraddressid')
      }
      Criteria      = @{
         Conditions = @(
            @{
               AttributeName = 'city'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'country'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'county'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'fax'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'freighttermscode'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'latitude'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'line1'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'line2'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'line3'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'longitude'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'postalcode'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'postofficebox'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'primarycontactname'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'shippingmethodcode'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'stateorprovince'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'telephone1'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'telephone2'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'telephone3'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'upszone'
               Operator      = 'Null'
            },
            @{
               AttributeName = 'utcoffset'
               Operator      = 'Null'
            }
         )
      }
   }

   $body = [ordered]@{
      QuerySet              = @($query)
      StartDateTime         = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
      RecurrencePattern     = ''
      SendEmailNotification = $false
      JobName               = 'Delete Empty Customer Address Records'
      ToRecipients          = @()
      CCRecipients          = @()
   }

   $postHeaders = $baseHeaders.Clone()
   $postHeaders.Add('Content-Type', 'application/json')

   $BulkDeleteRequest = @{
      Uri     = $baseURI + 'BulkDelete'
      Method  = 'Post'
      Headers = $postHeaders
      Body    = ConvertTo-Json $body -Depth 5 
   }

   Invoke-RestMethod @BulkDeleteRequest | Select-Object -ExpandProperty JobId
}

• De Web-API van Microsoft Dataverse gebruiken
• Snelstart web-API met PowerShell en Visual Studio Code
• Actie BulkDelete
• Gegevens bulksgewijs verwijderen