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

เมธอดแบบคงที่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
• เอนทิตี้ประเภทองค์กร

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

}

ฟังก์ชัน 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
• เอนทิตี้ประเภทองค์กร

เมธอดแบบคงที่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
• ลบข้อมูลจํานวนมาก