Asiakastaulukot (tili, yhteyshenkilö ja asiakastili)

Tämä Test-IsEmptyAddressRecordCreationDisabled PowerShell-funktio käyttää Microsoft Power Platform CLI -pac env list-settingskomentoa sarakkeen arvon tarkistamiseenOrganization.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')
}

Lue lisätietoja komentorivikäyttöliittymän Microsoft Power Platform

Tämä staattinen IsEmptyAddressRecordCreationDisabled menetelmä käyttää WhoAmIRequest-luokkaa ja IOrganizationService.Retrieve-menetelmääOrganization.OrgDbOrgSettings-sarakkeen arvon tarkistamiseen.

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

• SDK:n käyttäminen .NET:lle
• WhoAmIRequest-luokka
• Taulukon rivin noutaminen käyttämällä SDK:ta .NETille
• Organization.OrgDbOrgSettings-sarake

Tämä Test-IsEmptyAddressRecordCreationDisabled PowerShell-funktio käyttää esimerkkiä Get-WhoAmI ja Get-Record funktioita, jotka on kuvattu kohdassa Uudelleenkäytettäviä funktioita luominen ja riippuvat Connect-funktiossa määritetyistä yleisistä muuttujista.

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 Dataversen verkko-ohjelmointirajapinnan käyttäminen
• Verkko-ohjelmointirajapinnan pikakäynnistys PowerShellin ja Visual Studio Coden avulla
• WhoAmI-funktio
• Organisaation entiteettityyppi

Tämä Test-IsDeleteAddressRecordsEnabled PowerShell-funktio käyttää Microsoft Power Platform CLI -pac env list-settingskomentoa sarakkeen EnableDeleteAddressRecords arvon tarkistamiseenOrganization.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')
}

Lue lisätietoja komentorivikäyttöliittymän Microsoft Power Platform

Tämä staattinen IsDeleteAddressRecordsEnabled menetelmä käyttää WhoAmIRequest-luokkaa ja IOrganizationService.Retrieve -menetelmääsarakkeen arvon tarkistamiseenOrganization.OrgDbOrgSettings.EnableDeleteAddressRecords

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

}

• SDK:n käyttäminen .NET:lle
• WhoAmIRequest-luokka
• Taulukon rivin noutaminen käyttämällä SDK:ta .NETille
• Organization.OrgDbOrgSettings-sarake

Tämä Test-IsDeleteAddressRecordsEnabled PowerShell-funktio käyttää esimerkkiä Get-WhoAmI ja Get-Record funktioita, jotka on kuvattu kohdassa Uudelleenkäytettäviä funktioita luominen , ja se riippuu Connect-funktiossa määritetyistä yleisistä muuttujista.

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 Dataversen verkko-ohjelmointirajapinnan käyttäminen
• Verkko-ohjelmointirajapinnan pikakäynnistys PowerShellin ja Visual Studio Coden avulla
• WhoAmI-funktio
• Organisaation entiteettityyppi

PowerShell-funktio Start-BulkDeleteEmptyCustomerAddressRecords luo järjestelmätyön tyhjien customeraddress tietueiden poistamiseen Microsoft Power Platform CLI -pac data bulk-delete schedulekomennolla.

Tämä funktio riippuu esimerkistä Test-IsDeleteAddressRecordsEnabled ja Test-IsEmptyAddressRecordCreationDisabled funktioista, jotka on kuvattu ohjeartikkelissa Osoitetietueiden poistamisen tunnistus jaTunnista, onko tyhjä osoitetietueen luominen poistettu käytöstä. Funktio luo työn vain, kun molemmat asetukset sallivat kaikkien tyhjien asiakasosoitetietueiden poistamisen ja estävät uusien tyhjien tietueiden luomisen.

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

• Lue lisätietoja komentorivikäyttöliittymän Microsoft Power Platform
• pac-tietojen joukkopoistoaikataulukomento
• Tietojen poistaminen joukkona

Staattinen BulkDeleteEmptyCustomerAddressRecords menetelmä luo järjestelmätyön tyhjien customeradddress tietueiden poistamiseen BulkDeleteRequest-luokan avulla.

Tässä menetelmässä käytetään esimerkki IsDeleteAddressRecordsEnabled - ja IsEmptyAddressRecordCreationDisabled staattisia menetelmiä, jotka on kuvattu kohdassa Tunnista, onko osoitetietueiden poistaminen käytössä ja Tunnista, onko tyhjä osoitetietueiden luonti poistettu käytöstä . Näin varmistetaan, että nämä asetukset on määritetty niin, että kaikki tyhjät asiakasosoitetietueet voidaan poistaa ja jotta uusia ei luoda.

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

}

• SDK:n käyttäminen .NET:lle
• BulkDeleteRequest-luokka
• Tietojen poistaminen joukkona

PowerShell-funktio Start-BulkDeleteEmptyCustomerAddressRecords luo järjestelmätyön tyhjien customeradddress tietueiden poistamiseen BulkDelete-toiminnolla.

Tässä menetelmässä käytetään esimerkkiä Test-IsDeleteAddressRecordsEnabled ja Test-IsEmptyAddressRecordCreationDisabled funktioita, jotka on kuvattu kohdassa Tunnista, onko osoitetietueiden poistaminen käytössä ja Tunnista, onko tyhjä osoitetietueiden luonti poistettu käytöstä . Näin varmistetaan, että nämä asetukset on määritetty niin, että kaikki tyhjät asiakasosoitetietueet voidaan poistaa, eikä uusia luoda.

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 Dataversen verkko-ohjelmointirajapinnan käyttäminen
• Verkko-ohjelmointirajapinnan pikakäynnistys PowerShellin ja Visual Studio Coden avulla
• Bulk-poisto-toiminto
• Tietojen poistaminen joukkona