Kundetabeller (konto, kontakt og kundeadresse)

Denne Test-IsEmptyAddressRecordCreationDisabled PowerShell-funktion bruger kommandoen Microsoft Power Platform kommandolinjegrænsefladepac env list-settings til at kontrollere en værdi i kolonnenOrganization.OrgDbOrgSettings.

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

Få mere at vide om den Microsoft Power Platform kommandolinjegrænseflade

Denne statiske IsEmptyAddressRecordCreationDisabled metode bruger klassen WhoAmIRequest og metoden IOrganizationService.Retrieve til at kontrollere en værdi i kolonnen Organization.OrgDbOrgSettings.

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

• Brug SDK'et til .NET
• WhoAmIRequest-klasse
• Hent en tabelrække ved hjælp af SDK'et til .NET
• Kolonnen Organization.OrgDbOrgSettings

Denne Test-IsEmptyAddressRecordCreationDisabled PowerShell-funktion bruger det eksempel Get-WhoAmI og Get-Record de funktioner, der er beskrevet i Opret funktioner, der kan genbruges , og afhænger af globale variabler, der er angivet i funktionen Connect.

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

• Bruge Microsoft Dataverse Web-API
• Hurtig start: Web-API med PowerShell og Visual Studio Code
• Funktionen WhoAmI
• Organisationsenhedstype

Denne Test-IsDeleteAddressRecordsEnabled PowerShell-funktion bruger kommandoen Microsoft Power Platform kommandolinjegrænsefladepac env list-settings til at kontrollere en EnableDeleteAddressRecords værdi i kolonnenOrganization.OrgDbOrgSettings.

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

Få mere at vide om den Microsoft Power Platform kommandolinjegrænseflade

Denne statiske IsDeleteAddressRecordsEnabled metode bruger klassen WhoAmIRequest og IOrganizationService.Retrieve metoden til at kontrollere en EnableDeleteAddressRecords værdi i kolonnenOrganization.OrgDbOrgSettings.

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

}

• Brug SDK'et til .NET
• WhoAmIRequest-klasse
• Hent en tabelrække ved hjælp af SDK'et til .NET
• Kolonnen Organization.OrgDbOrgSettings

Denne Test-IsDeleteAddressRecordsEnabled PowerShell-funktion bruger det eksempel Get-WhoAmI og Get-Record de funktioner, der er beskrevet i Opret funktioner, der kan genbruges , og afhænger af globale variabler, der er angivet i funktionen Connect.

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

• Bruge Microsoft Dataverse Web-API
• Hurtig start: Web-API med PowerShell og Visual Studio Code
• Funktionen WhoAmI
• Organisationsenhedstype

Funktionen Start-BulkDeleteEmptyCustomerAddressRecords PowerShell opretter et systemjob til sletning af tomme customeraddress poster ved hjælp af kommandoen Microsoft Power Platform kommandolinjegrænsefladepac data bulk-delete schedule.

Denne funktion afhænger af det eksempel Test-IsDeleteAddressRecordsEnabled og Test-IsEmptyAddressRecordCreationDisabled de funktioner, der er beskrevet i Registrer, om sletning af adresseposter er aktiveret , og Registrer, om oprettelse af tomme adresseposter er deaktiveret. Funktionen opretter kun jobbet, når begge indstillinger gør det muligt at slette alle tomme kundeadresseposter og forhindre, at der oprettes nye tomme poster.

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

• Få mere at vide om den Microsoft Power Platform kommandolinjegrænseflade
• kommandoen plan for massesletning af pac-data
• Massesletning af data

Den statiske BulkDeleteEmptyCustomerAddressRecords metode opretter et systemjob til sletning af tomme customeradddress poster ved hjælp af klassen BulkDeleteRequest.

Denne metode bruger det eksempel IsDeleteAddressRecordsEnabled og IsEmptyAddressRecordCreationDisabled de statiske metoder, der er beskrevet i Registrer, om sletning af adresseposter er aktiveret , og Registrer, om oprettelse af tom adressepost er deaktiveret for at sikre, at disse indstillinger er konfigureret til at tillade sletning af alle tomme kundeadresseposter og sikre, at der ikke oprettes nye.

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

}

• Brug SDK'et til .NET
• BulkDeleteRequest-klasse
• Massesletning af data

Funktionen Start-BulkDeleteEmptyCustomerAddressRecords PowerShell opretter et systemjob til sletning af tomme customeradddress poster ved hjælp af handlingen Massesletning.

Denne metode bruger det eksempel Test-IsDeleteAddressRecordsEnabled og Test-IsEmptyAddressRecordCreationDisabled de funktioner, der er beskrevet i Registrer, om sletning af adresseposter er aktiveret , og Registrer, om oprettelse af tom adressepost er deaktiveret for at sikre, at disse indstillinger er konfigureret til at tillade sletning af alle tomme kundeadresseposter og sikre, at der ikke oprettes nye.

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
}

• Bruge Microsoft Dataverse Web-API
• Hurtig start: Web-API med PowerShell og Visual Studio Code
• Handlingen BulkDelete
• Massesletning af data