ตารางลูกค้า (บัญชี ผู้ติดต่อ และที่อยู่ลูกค้า)

ฟังก์ชัน PowerShell นี้Test-IsEmptyAddressRecordCreationDisabledใช้คําสั่ง Microsoft Power Platform CLIpac env list-settings เพื่อตรวจสอบค่าในOrganization.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')
}

เรียนรู้เพิ่มเติมเกี่ยวกับ Microsoft Power Platform CLI

เมธอดแบบคงที่IsEmptyAddressRecordCreationDisabledนี้ใช้คลาส WhoAmIRequest และเมธอด IOrganizationService.Retrieve เพื่อตรวจสอบค่าในคอลัมน์ 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";
}

• ใช้ SDK สําหรับ .NET
• คลาส WhoAmIRequest
• ดึงข้อมูลแถวตารางโดยใช้ SDK สําหรับ .NET
• คอลัมน์ Organization.OrgDbOrgSettings

ฟังก์ชัน PowerShell นี้Test-IsEmptyAddressRecordCreationDisabledใช้ตัวอย่างGet-WhoAmIและGet-Recordฟังก์ชันที่อธิบายไว้ใน สร้างฟังก์ชันที่สามารถนํามาใช้ใหม่ได้ และขึ้นอยู่กับตัวแปรส่วนกลางที่ตั้งค่าในฟังก์ชัน 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')
}

• ใช้ MICROSOFT Dataverse Web API
• API เว็บเริ่มต้นใช้งานด่วนพร้อม PowerShell และ Visual Studio Code
• ฟังก์ชัน WhoAmI
• เอนทิตี้ประเภทองค์กร

ฟังก์ชัน PowerShell นี้Test-IsDeleteAddressRecordsEnabledใช้คําสั่ง Microsoft Power Platform CLIpac env list-settings เพื่อตรวจสอบEnableDeleteAddressRecordsค่าในOrganization.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')
}

เรียนรู้เพิ่มเติมเกี่ยวกับ Microsoft Power Platform CLI

เมธอดแบบคงที่IsDeleteAddressRecordsEnabledนี้ใช้คลาส WhoAmIRequest และIOrganizationService.Retrieveเมธอด เพื่อตรวจสอบEnableDeleteAddressRecordsค่าในOrganization.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";

}

• ใช้ SDK สําหรับ .NET
• คลาส WhoAmIRequest
• ดึงข้อมูลแถวตารางโดยใช้ SDK สําหรับ .NET
• คอลัมน์ Organization.OrgDbOrgSettings

ฟังก์ชัน PowerShell นี้Test-IsDeleteAddressRecordsEnabledใช้ตัวอย่างGet-WhoAmIและGet-Recordฟังก์ชันที่อธิบายไว้ใน สร้างฟังก์ชันที่สามารถนํามาใช้ใหม่ได้ และขึ้นอยู่กับตัวแปรส่วนกลางที่ตั้งค่าไว้ในฟังก์ชัน 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')
}

• ใช้ MICROSOFT Dataverse Web API
• API เว็บเริ่มต้นใช้งานด่วนพร้อม PowerShell และ Visual Studio Code
• ฟังก์ชัน WhoAmI
• เอนทิตี้ประเภทองค์กร

ฟังก์ชัน Start-BulkDeleteEmptyCustomerAddressRecords PowerShell สร้างงานระบบเพื่อลบเรกคอร์ดที่ว่างเปล่าcustomeraddressโดยใช้คําสั่ง Microsoft Power Platform CLIpac data bulk-delete schedule

ฟังก์ชันนี้ขึ้นอยู่กับตัวอย่าง Test-IsDeleteAddressRecordsEnabled และ Test-IsEmptyAddressRecordCreationDisabled ฟังก์ชันที่อธิบายไว้ใน ตรวจหาว่ามีการเปิดใช้งานการลบเรกคอร์ดที่อยู่ หรือไม่ และ ตรวจสอบว่าการสร้างเรกคอร์ดที่อยู่ว่างเปล่าถูกปิดใช้งานหรือไม่ ตามลําดับ ฟังก์ชันจะสร้างงานเฉพาะเมื่อการตั้งค่าทั้งสองอนุญาตให้มีการลบเรกคอร์ดที่อยู่ลูกค้าที่ว่างเปล่าทั้งหมดและป้องกันไม่ให้มีการสร้างเรกคอร์ดที่ว่างเปล่าใหม่

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

• เรียนรู้เพิ่มเติมเกี่ยวกับ Microsoft Power Platform CLI
• คําสั่งกําหนดการลบข้อมูลจํานวนมาก
• ลบข้อมูลจํานวนมาก

เมธอดแบบคงที่BulkDeleteEmptyCustomerAddressRecordsสร้างงานระบบเพื่อลบเรกคอร์ดที่ว่างเปล่าcustomeradddressโดยใช้คลาส BulkDeleteRequest

วิธีนี้ใช้ตัวอย่าง IsDeleteAddressRecordsEnabled และ IsEmptyAddressRecordCreationDisabled เมธอดแบบคงที่ที่อธิบายไว้ใน ตรวจหาว่ามีการเปิดใช้งานการลบเรกคอร์ดที่อยู่ หรือไม่ และ ตรวจสอบว่าการสร้างเรกคอร์ดที่อยู่ว่างเปล่าถูกปิดใช้งาน ตามลําดับเพื่อให้แน่ใจว่าการตั้งค่าเหล่านี้ได้รับการกําหนดค่าเพื่ออนุญาตให้ลบเรกคอร์ดที่อยู่ลูกค้าที่ว่างเปล่าทั้งหมดและตรวจสอบให้แน่ใจว่าไม่มีการสร้างใหม่

/// <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 สําหรับ .NET
• คลาส BulkDeleteRequest
• ลบข้อมูลจํานวนมาก

ฟังก์ชัน Start-BulkDeleteEmptyCustomerAddressRecords PowerShell สร้างงานระบบเพื่อลบเรกคอร์ดที่ว่างเปล่าcustomeradddressโดยใช้การดําเนินการ BulkDelete

วิธีนี้ใช้ตัวอย่าง Test-IsDeleteAddressRecordsEnabled และ Test-IsEmptyAddressRecordCreationDisabled ฟังก์ชันที่อธิบายไว้ใน ตรวจสอบว่ามีการเปิดใช้งานการลบเรกคอร์ดที่อยู่ หรือไม่ และ ตรวจสอบว่าการสร้างเรกคอร์ดที่อยู่ว่างเปล่าถูกปิดใช้งาน ตามลําดับเพื่อให้แน่ใจว่าการตั้งค่าเหล่านี้ได้รับการกําหนดค่าเพื่ออนุญาตให้ลบเรกคอร์ดที่อยู่ลูกค้าที่ว่างเปล่าทั้งหมดและตรวจสอบให้แน่ใจว่าไม่มีการสร้างใหม่

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
• API เว็บเริ่มต้นใช้งานด่วนพร้อม PowerShell และ Visual Studio Code
• การดําเนินการ BulkDelete
• ลบข้อมูลจํานวนมาก