Kundentabellen (Konto, Kontakt und Kundenadresse)

Diese Test-IsEmptyAddressRecordCreationDisabled PowerShell-Funktion verwendet den Befehl Microsoft Power Platform CLIpac env list-settings, um einen Wert in der Organization.OrgDbOrgSettings Spalte zu überprüfen.

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')
}

Erfahren Sie mehr über die Microsoft Power Platform CLI

Diese statische IsEmptyAddressRecordCreationDisabled Methode verwendet die WhoAmIRequest-Klasse und die IOrganizationService.Retrieve-Methode , um einen Wert in der Spalte "Organization.OrgDbOrgSettings" zu überprüfen.

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";
}

• Das SDK für .NET verwenden
• WhoAmIRequest-Klasse
• Abrufen einer Tabellenzeile über das SDK für .NET
• Spalte "Organization.OrgDbOrgSettings"

Diese Test-IsEmptyAddressRecordCreationDisabled PowerShell-Funktion verwendet das unter "Erstellen wiederverwendbarer Funktionen" beschriebene Beispiel Get-WhoAmI und Get-Record Funktionen und hängt von globalen Variablen ab, die in der Connect-Funktion festgelegt sind.

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')
}

• Microsoft Dataverse-Web-API verwenden
• Schnellstart-Web-API mit PowerShell und Visual Studio Code
• WhoAmI-Funktion
• Organisationsentitätstyp

Diese Test-IsDeleteAddressRecordsEnabled PowerShell-Funktion verwendet den Befehl Microsoft Power Platform CLIpac env list-settings, um einen EnableDeleteAddressRecords Wert in der Organization.OrgDbOrgSettings Spalte zu überprüfen.

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')
}

Erfahren Sie mehr über die Microsoft Power Platform CLI

Diese statische IsDeleteAddressRecordsEnabled Methode verwendet die WhoAmIRequest-Klasse und die IOrganizationService.Retrieve Methode , um einen EnableDeleteAddressRecords Wert in der Organization.OrgDbOrgSettings Spalte zu überprüfen.

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";

}

• Das SDK für .NET verwenden
• WhoAmIRequest-Klasse
• Abrufen einer Tabellenzeile über das SDK für .NET
• Spalte "Organization.OrgDbOrgSettings"

Diese Test-IsDeleteAddressRecordsEnabled PowerShell-Funktion verwendet das in "Erstellen wiederverwendbarer Funktionen" beschriebene Beispiel Get-WhoAmI und Get-Record Funktionen und hängt von globalen Variablen ab, die in der Connect-Funktion festgelegt sind.

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')
}

• Microsoft Dataverse-Web-API verwenden
• Schnellstart-Web-API mit PowerShell und Visual Studio Code
• WhoAmI-Funktion
• Organisationsentitätstyp

Die Start-BulkDeleteEmptyCustomerAddressRecords PowerShell-Funktion erstellt einen Systemauftrag zum Löschen leerer customeraddress Datensätze mithilfe des befehls Microsoft Power Platform CLIpac data bulk-delete schedule.

Diese Funktion hängt von dem beispiel Test-IsDeleteAddressRecordsEnabled und Test-IsEmptyAddressRecordCreationDisabled den Funktionen ab, die unter "Erkennen" beschrieben werden, ob das Löschen von Adressdatensätzen aktiviert ist , und erkennen Sie, ob die Erstellung leerer Adressdatensätze deaktiviert ist. Die Funktion erstellt den Auftrag nur, wenn beide Einstellungen zulassen, dass alle leeren Kundenadressdatensätze gelöscht werden, und es wird verhindert, dass neue leere Datensätze erstellt werden.

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'
}

• Erfahren Sie mehr über die Microsoft Power Platform CLI
• Befehl zum Massenlöschen von Pac-Daten
• Löschen von Datensätzen in einem Massenvorgang

Die statische BulkDeleteEmptyCustomerAddressRecords Methode erstellt einen Systemauftrag zum Löschen leerer customeradddress Datensätze mithilfe der BulkDeleteRequest-Klasse.

Diese Methode verwendet die im Abschnitt IsDeleteAddressRecordsEnabled und IsEmptyAddressRecordCreationDisabled beschriebenen Beispiel - und -statischen Methoden, um sicherzustellen, dass diese Einstellungen so konfiguriert sind, dass alle leeren Kundenadressdatensätze gelöscht werden können und keine neuen erstellt werden.

/// <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;

}

• Das SDK für .NET verwenden
• BulkDeleteRequest-Klasse
• Löschen von Datensätzen in einem Massenvorgang

Die Start-BulkDeleteEmptyCustomerAddressRecords PowerShell-Funktion erstellt einen Systemauftrag zum Löschen leerer customeradddress Datensätze mithilfe der BulkDelete-Aktion.

Diese Methode nutzt die Funktionen Test-IsDeleteAddressRecordsEnabled und Test-IsEmptyAddressRecordCreationDisabled, die in Erkennung, ob das Löschen von Adressdatensätzen aktiviert ist und Erkennung, ob die Erstellung leerer Adressdatensätze deaktiviert ist beschrieben sind. Dies erfolgt, um sicherzustellen, dass die Einstellungen so konfiguriert sind, dass alle leeren Kundenadressdatensätze gelöscht werden und keine neuen erstellt werden.

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
}

• Microsoft Dataverse-Web-API verwenden
• Schnellstart-Web-API mit PowerShell und Visual Studio Code
• BulkDelete-Aktion
• Löschen von Datensätzen in einem Massenvorgang