تخطى إلى المحتوى
Home » المقالات » الدليل السهل لربط الـ Salesforce Object Fields بالـ Data Types في Apex وLWC JavaScript

الدليل السهل لربط الـ Salesforce Object Fields بالـ Data Types في Apex وLWC JavaScript

التعامل مع الـ data types جزء كبير من شغل أي Salesforce developer. هتلاقوا نفسكم كتير محتاجين تستخدموا data types مختلفة وإنتو بتكتبوا كود في Apex أو في Lightning Web Components (LWC) JavaScript. ومهم جداً إنكم تربطوا الـ fields بتاعة الـ Salesforce objects بالـ data types الصح في Apex وJavaScript، عشان تضمنوا إن الداتا مظبوطة والـ app بتاعكم شغال من غير مشاكل. وحتى لو مش دايماً محتاجين تحددوا الـ data type للـ variables في JavaScript، معرفتكم بالـ data types اللي شغالين بيها هتوفر عليكم صداع كتير وتساعدكم تكتبوا كود أحسن.

في البوست ده هنديكم جدول مفيد بيوضح إزاي تربطوا الـ data types بتاعة الـ fields في Salesforce objects بالـ data types في Apex وJavaScript. الجدول ده مثالي لو عايزين ترجعوا له بسرعة وإنتو بتكتبوا كود، وبيساعدكم تفهموا إزاي الـ data types المختلفة بتشتغل مع بعض. وهنعدي كمان على شوية أمثلة توضح ليه فكرة كويسة إنكم تعرفوا الـ data types في JavaScript، حتى لو مش دايماً لازم تحددوها.

لو إنتو جداد على Salesforce Apex أو عايزين تتعمقوا أكتر في الـ data types بتاعة Apex، أنصحكم تبصوا على بوست “Beginner’s Guide to Salesforce Apex: Primitive Data Types and Methods” (بالإنجليزي)، هيساعدكم تفهموا أساسيات الـ primitive data types في Apex والـ methods بتاعتها. ولو عايزين تعرفوا أكتر عن الشغل بالـ collections في Apex زي الـ lists والـ sets والـ maps، بصوا على بوست “Beginner’s Guide to Salesforce Apex: An Introduction to Collections – Lists, Sets, and Maps” (بالإنجليزي).

على آخر البوست ده هتبقوا محترفين في التعامل مع الـ data types بتاعة Salesforce في Apex وJavaScript، وهتقدروا تبنوا apps أكفأ وأكتر اعتمادية.

مقارنة الـ Data Types بتاعة الـ Salesforce Object Fields في Apex وLWC JavaScript

Salesforce Data TypeApex Data TypeJavaScript Data Typeملاحظات
1. Text
2. Text Area
StringString1. الـ Data Type: الـ fields اللي من نوع “Text” و”Text Area” في الـ Salesforce Object بتقابل String في Apex وString في LWC JavaScript.

2. الحد الأقصى للطول: الـ Text والـ Text Area fields في الـ Salesforce Object أقصاها 255 حرف، بينما Apex وJavaScript يقدروا يتعاملوا مع strings أطول بكتير. عشان تتجنبوا الـ errors، دايماً قصّروا النص الطويل قبل ما تحطوه في Text أو Text Area field.
Text Area (Long)StringString1. الـ Data Type: الـ fields اللي من نوع “Text Area (Long)” بتقابل String في Apex وString في LWC JavaScript.

2. الحد الأقصى للطول: الـ Long Text Area fields في الـ Salesforce Object أقصاها 131,072 حرف، بينما Apex وJavaScript يقدروا يتعاملوا مع strings أطول بكتير. عشان تتجنبوا الـ errors، دايماً قصّروا النص الطويل قبل ما تحطوه في Text Area (Long) field.
Text Area (Rich)StringString1. الـ Data Type: الـ fields اللي من نوع “Text Area (Rich)” بتقابل String في Apex وString في LWC JavaScript.

2. الحد الأقصى للطول: الـ Rich Text Area fields في الـ Salesforce Object أقصاها 131,072 حرف، بينما Apex وJavaScript يقدروا يتعاملوا مع strings أطول بكتير. عشان تتجنبوا الـ errors، دايماً قصّروا النص الطويل قبل ما تحطوه في Text Area (Rich) field.

3. خلوا بالكم إن الـ Rich Text Area fields بتخزن كمان الـ HTML formatting، وده بيتحسب من الحد الأقصى للحروف.
EmailStringString1. الـ Data Type: الـ fields اللي من نوع “Email” بتقابل String في Apex وString في LWC JavaScript.

2. الحد الأقصى للطول: الـ Email fields في الـ Salesforce Object أقصاها 80 حرف، بينما Apex وJavaScript يقدروا يتعاملوا مع strings أطول بكتير. عشان تتجنبوا الـ errors، دايماً قصّروا الـ email addresses الطويلة قبل ما تحطوها في Email field.

3. التحقق من الـ Format: لو الـ format بتاع الـ email address غلط في الـ String بتاع Apex أو LWC JavaScript، هيطلع error لما تحطوه في Email field. عشان تتجنبوا ده، اتأكدوا دايماً إن الـ email addresses صح ومتظبطة قبل ما تحطوها في Email field.
1. Number
2. Currency
3. Percent
Decimal
Double
Number1. الـ Data Type: الـ fields اللي من نوع “Number” و”Currency” و”Percentage” بتقابل Decimal أو Double في Apex وNumber في LWC JavaScript.

2. الـ Precision والـ Scale:
– الـ Number والـ Currency والـ Percent fields في الـ Salesforce Object ليها حدود على الـ precision (إجمالي عدد الأرقام) والـ scale (عدد الأرقام بعد العلامة العشرية).

– الـ Decimal والـ Double في Apex والـ Number في JavaScript يقدروا يتعاملوا مع قيم أكبر وأدق.

– عشان تتجنبوا الـ errors، اتأكدوا إن الأرقام في Apex أو JavaScript ملتزمة بحدود الـ precision والـ scale المحددة للـ field قبل ما تحطوها فيه.

– اختاروا بين Decimal وDouble في Apex حسب احتياجكم ومستوى الدقة اللي محتاجينه في الحسابات.

3. ملاحظات تانية:
– الـ Percent fields في Salesforce بتعرض علامة الـ %، بينما الـ Decimal في Apex مش بيعرضها.
DateDateDate 1.الـ Data Type: الـ fields اللي من نوع “Date” بتقابل Date في Apex والـ Date object في LWC JavaScript.

2. ملاحظات تانية:
– الـ “Date” fields بتتخزن بالـ format ده “YYYY-MM-DD”، وممكن تتعرض بأشكال مختلفة باستخدام Visualforce أو Lightning components.

– في Apex وLWC JavaScript، تقدروا تستخدموا الـ Date عشان تعملوا عمليات وحسابات على التواريخ.
DateTimeDateTimeDate1. الـ Data Type: الـ fields اللي من نوع “DateTime” بتقابل DateTime في Apex والـ Date object في LWC JavaScript.

2. الـ TimeZone:
– الـ Date/Time fields في Salesforce بتخزن القيم بتوقيت UTC.

– في Apex وLWC JavaScript، قيمة الـ date-time بتتخزن بتوقيت المستخدم by default، بس ممكن تتحول لـ UTC أو لأي time zone معينة باستخدام الـ Timezone class أو الـ method اللي اسمها Intl.DateTimeFormat() على الترتيب.

3. ملاحظات تانية:
– الـ Format: الـ “DateTime” fields بتتخزن بالـ format ده “YYYY-MM-DDTHH:MM:SS.SSSZ”، وممكن تتعرض بأشكال مختلفة باستخدام Visualforce أو Lightning components.

– في Apex وLWC JavaScript، تقدروا تستخدموا الـ DateTime عشان تعملوا عمليات وحسابات على قيم التاريخ والوقت.
TimeTimeString1. الـ Data Type: الـ fields اللي من نوع “Time” بتقابل Time في Apex وString في LWC JavaScript.

2. الـ Time Zone: الـ “Time” fields مش بتخزن أي معلومات عن الـ time zone، والقيمة بتتعتبر بتوقيت المستخدم by default في Apex وLWC JavaScript.

3. ملاحظات تانية:
– الـ Format: الـ “Time” fields بتخزن الوقت بالـ format ده “HH:MM:SS.SSSZ”، حيث “HH” هي الساعة (0-23)، و”MM” الدقيقة (0-59)، و”SS” الثانية (0-59)، و”SSS” الملّي ثانية (000-999). والـ “Z” في الآخر معناها توقيت جرينتش (GMT).

– في Apex تقدروا تستخدموا الـ Time عشان تعملوا عمليات وحسابات على الوقت. وفي LWC JavaScript تقدروا تستخدموا String عشان تخزنوا الوقت وتعرضوه.
CheckboxBooleanBooleanالـ Null: الـ “Checkbox” fields مينفعش تبقى قيمتها null، يا True يا False بس، بينما الـ Boolean في Apex والـ Boolean في LWC JavaScript ممكن قيمتهم تبقى null.
PicklistStringString1. الـ Data Type: الـ “Picklist” fields بتخزن قيمة واحدة بتتختار من لستة اختيارات محددة، وبتقابل String في Apex وفي LWC JavaScript.

2. الحد الأقصى للطول: الـ “Picklist” fields أقصاها 255 حرف، بينما الـ String في Apex وLWC JavaScript يقدر يشيل نصوص أطول بكتير.

3. الـ Null: الـ “Picklist” fields ممكن قيمتها تبقى null، فخلوا بالكم تتعاملوا مع الـ null في Apex وLWC.
Multi-Select PicklistString فيه “;” ممكن يتحول لـ
List<String>
String فيه “;” ممكن يتحول لـ
Array<String>
1. الـ Data Type: الـ “Multi-Select Picklist” fields بتخزن كذا قيمة بتتختار من لستة اختيارات محددة، وبتقابل List<String> في Apex وArray<String> في LWC JavaScript.

2. الحد الأقصى للطول: الـ “Multi-Select Picklist” fields أقصاها 255 حرف لكل قيمة مختارة، بينما الـ Array في Apex وLWC JavaScript يقدر يشيل نصوص أطول بكتير.

3. الـ Null: الـ “Multi-Select Picklist” fields ممكن قيمتها تبقى null، فخلوا بالكم تتعاملوا مع الـ null في Apex وLWC.
LookupIdString1. الـ Data Type: الـ “Lookup” fields بتخزن reference لـ record واحد في object تاني، وبتقابل Id في Apex وString (Id) في LWC JavaScript.

2. الـ Null: الـ “Lookup” fields ممكن قيمتها تبقى null، فخلوا بالكم تتعاملوا مع الـ null في Apex وLWC.
Master-DetailIdString1. الـ Data Type: الـ “Master-Detail” fields بتخزن reference للـ parent record، وبتقابل Id في Apex وString في LWC JavaScript.

2. الـ Null: الـ “Master-Detail” fields مينفعش قيمتها تبقى null، بينما الـ Id في Apex والـ String في LWC JavaScript ممكن يبقوا null، فخلوا بالكم تتعاملوا مع ده صح.
Formula (حسب نوع الـ output بتاع الـ formula)(مثلاً Decimal)(مثلاً Number)1. الـ Data Type: الـ “Formula” fields بتعتمد على نوع الـ output بتاع الـ formula، وممكن تقابل data types مختلفة في Apex وLWC JavaScript.

2. الـ Null: الـ output بتاع الـ formula ممكن يبقى null لو الـ formula نفسها طلعت null، أو لو أي field من الـ inputs بتاعتها null، فخلوا بالكم تتعاملوا مع الـ null في Apex وLWC.
Roll-Up SummaryDecimal
Double
Integer
Numberالـ Data Type: الـ “Roll-Up Summary” fields بتقابل Decimal أو Double أو Integer في Apex حسب نوع الـ roll-up، وNumber في LWC JavaScript.
Auto NumberStringStringالـ Auto Number fields بيعملها Salesforce لوحده، ومينفعش تعدلوا قيمتها.
GeolocationLocationObjectالـ Data Type: الـ “Geolocation” fields بتقابل Location في Apex وObject في LWC JavaScript.
PhoneStringString1. الـ Data Type: الـ “Phone” fields بتقابل String في Apex وString في LWC JavaScript.

2. الحد الأقصى للطول: الـ “Phone” fields أقصاها 40 حرف. في Apex وLWC JavaScript مفيش حد معين لطول الـ String، بس مهم تتأكدوا إن رقم التليفون متظبط وجوه الحد المسموح عشان تتجنبوا الـ errors.
الجدول ده بيخليكم تقارنوا بسرعة وتفهموا العلاقة بين الـ data types بتاعة الـ Salesforce object fields والـ data types في Apex وفي LWC JavaScript. مفيد جداً للـ developers اللي شغالين على أكتر من platform ولغة في الـ Salesforce ecosystem.

ليه مهم تفهموا إزاي الـ Salesforce object fields بتقابل الـ data types في JavaScript وإنتو بتعملوا LWC Development؟

أكيد بتسألوا نفسكم: ليه نهتم إزاي الـ Salesforce Object fields بتقابل الـ data types في JavaScript، طالما في JavaScript مش بنحدد الـ data type بتاع الـ variables أصلاً؟

عندكم حق. في JavaScript، ومنها Lightning Web Components (LWC)، مش بتحددوا الـ data type بتاع الـ variable وإنتو بتعرّفوه. الـ JavaScript لغة dynamically-typed، يعني الـ data types بتتحدد أوتوماتيك وقت الـ runtime.

الجدول اللي فوق هدفه يساعدكم تفهموا الـ data types بتاعة الـ Salesforce object fields بتقابل إيه في JavaScript لما تستخدموها في كود الـ LWC. ورغم إنكم مش بتحددوا الـ data types صراحةً في الكود، مهم جداً تبقوا عارفين الـ data types المناسبة وإنتو بتتعاملوا مع الداتا جوه الـ LWC بتاعكم.

مثلاً، لما تشتغلوا على Date field في LWC، عادةً هتستخدموا الـ Date object اللي جاي built-in في JavaScript عشان تعملوا العمليات اللي ليها علاقة بالتاريخ. معرفتكم بالـ data types بتساعدكم تشتغلوا مع الداتا صح، وتتجنبوا المشاكل اللي بتحصل من استخدام data types غلط أو تحويلات غلط.

مثال: ربط DateTime field من Salesforce بالـ Date object في LWC JavaScript

تعالوا ناخد مثال على Account object في Salesforce، ونعرض الـ Name (Text) والـ CreatedDate (DateTime) بتوعه في Lightning Web Component. هنركز على الـ CreatedDate field، وإزاي نستخدم كذا JavaScript method عشان نتعامل مع الـ DateTime field بطرق مختلفة.

accountDetails.html

<!-- accountDetails.html -->
<template>
    <lightning-card title="Account Details">
        <div class="slds-box">
            <p><b>Name:</b> {accountName}</p>
            <p><b>Created Date as is: </b>{createdDate}</p>
            <p><b>Created Date Formated Date:</b> {formattedCreatedDate}</p>
            <p><b>Created Date Formatted Date String: </b>{formattedCreateDateString}</p>
            <p><b>Full Year Value:</b> {fullYearValue}</p>
            <p><b>Day Value [Sunday - Saturday : 0 - 6] : </b>{dayValue}</p>
            <p><b>Today Date: </b>{todayDate}</p>
            <p><b>Account was Created </b>{daysDifference}<b> days ago!!</b></p>
        </div>
    </lightning-card>
</template>
accountDetails.js

// accountDetails.js
import { LightningElement, wire, track } from 'lwc';
import { getRecord } from 'lightning/uiRecordApi';

const ACCOUNT_FIELDS = ['Account.Name', 'Account.CreatedDate'];
const ACCOUNT_ID = '001XXXXXXXXXXXXXXX'; // Replace with a valid Account Id in Your Org

export default class AccountDetails extends LightningElement {
    @track accountName;
    @track createdDate;

    @wire(getRecord, { recordId: ACCOUNT_ID, fields: ACCOUNT_FIELDS })
    wiredAccount({ error, data }) {
        if (data) {
            this.accountName = data.fields.Name.value;
            
            //Javascript constructor for Date object
            this.createdDate = new Date(data.fields.CreatedDate.value);
        } else if (error) {console.error('Error fetching account data:', error);}
    }

    get formattedCreatedDate() {
      //Javascript method toLocaleDateString used to get the Date Only String 
      //in user Locale
      return this.createdDate ? this.createdDate.toLocaleDateString() : '';
    }
    
    get formattedCreateDateString(){
        //Javascript method toLocaleString used to get the Date and time String 
        //in user Locale
        return this.createdDate? this.createdDate.toLocaleString():'';
    }
    
    get fullYearValue(){
       //Javascript method getFullYear used to get the year value
       return this.createdDate?this.createdDate.getFullYear():'';
    }
    
    get dayValue(){
       //Javascript method getDay used to get the day index of the week
       return this.createdDate?this.createdDate.getDay():'';
    }
    
    get todayDate(){
       return new Date().toLocaleDateString();
    }

    //Used to get the number of days difference between today's date and the created
    //date value of the account
    get daysDifference(){
        if(this.createdDate){
            const today = new Date();
            const diffTime = Math.abs(today - this.createdDate);
            const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
            return diffDays;
        }
        return '';        
    }
}
accountDetails.js-meta.xml

<?xml version="1.0" encoding="UTF-8"?>
<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
    <apiVersion>57.0</apiVersion>
    <isExposed>true</isExposed>
    <targets>
        <target>lightning__RecordPage</target>
    </targets>
</LightningComponentBundle>

لما تضيفوا الـ component ده على الـ Account Lightning record page، الـ output هيبقى شكله كده:

صورة لـ LWC component على الـ Account record page بيعرض DateTime field بأكتر من JavaScript method
  • Created Date as is: ده بيستخدم الـ merge field “{createdDate}”. وده الطريقة اللي بنحط بيها قيمة createdDate باستخدام الـ JavaScript constructor بتاع new Date()، وبنبعتله الـ CreatedDate field من Salesforce. لو بعتوا field غلط للـ method، هيطلع exception.
@wire(getRecord, { recordId: ACCOUNT_ID, fields: ACCOUNT_FIELDS })
    wiredAccount({ error, data }) {
        if (data) {
            this.accountName = data.fields.Name.value;
            this.createdDate = new Date(data.fields.CreatedDate.value);
        } else if (error) {console.error('Error fetching account data:', error);}
    }
  • Created Date Formatted: ده بيستخدم الـ merge field “{formattedCreatedDate}”. الكود اللي تحت بيوضح إزاي استخدمنا الـ JavaScript method اللي اسمها “toLocaleDateString()” عشان نجيب التاريخ كـ String بالـ format المحلي بتاع المستخدم.
 get formattedCreatedDate() {
        return this.createdDate ? this.createdDate.toLocaleDateString() : '';
  }

أمثلة تانية بتوضح فايدة إنكم تعرفوا الـ data types في LWC

مثال على Number (Currency)

نفترض إنكم عايزين تعرضوا الـ revenue بتاع opportunity كـ string متظبط بشكل عملة. لما تبقوا عارفين إن الـ ‘Amount’ field في الـ Opportunity object نوعه Currency، وده بيقابل Number في JavaScript، هتقدروا تستخدموا الـ Intl.NumberFormat object عشان تظبطوا القيمة صح.

// Assuming you have fetched the 'Amount' value from Salesforce and stored it in a variable
const opportunityAmount = 12345.67;

// Format the opportunityAmount as a currency string
const formattedAmount = new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' }).format(opportunityAmount);

console.log(formattedAmount); // Output: $12,345.67

مثال على Multi-Select Picklist

نفترض إن عندكم custom object فيه Multi-Select Picklist field اسمه ‘Interests__c’. لما تبقوا عارفين إن الـ field ده بيقابل Array of Strings في JavaScript، هتقدروا تتعاملوا مع القيم بتاعته في الـ LWC بسهولة.

// Assuming you have fetched the 'Interests__c' value from Salesforce and stored it in a variable
const interestsString = 'Reading;Cooking;Hiking;Coding';

// Convert the Multi-Select Picklist string value to an array of strings
const interestsArray = interestsString.split(';');

// Process the interestsArray in your LWC, e.g., displaying the values as a list
//interestsArray ==> ['Reading', 'Cooking', 'Hiking', 'Coding']

مثال على Picklist

نفترض إن عندكم custom object فيه Picklist field اسمه ‘Priority__c’. لما تبقوا عارفين إن الـ field ده بيقابل String في JavaScript، هتقدروا تقارنوا القيم وتتعاملوا معاها في الـ LWC بسهولة.

// Assuming you have fetched the 'Priority__c' value from Salesforce and stored it in a variable
const priority = 'High';

// Perform a comparison to take action based on the priority value
if (priority === 'High') {
    // Execute code for high priority cases
} else if (priority === 'Medium') {
    // Execute code for medium priority cases
} else {
    // Execute code for low priority cases
}

مثال على Checkbox

نفترض إن عندكم custom object فيه Checkbox field اسمه ‘IsActive__c’. لما تبقوا عارفين إن الـ field ده بيقابل Boolean في JavaScript، هتقدروا تستخدموه بسهولة في الـ conditional statements في الـ LWC.

// Assuming you have fetched the 'IsActive__c' value from Salesforce and stored it in a variable
const isActive = true;

// Use the value in a conditional statement
if (isActive) {
    // Execute code when the record is Active
} else {
    // Execute code when the record is not Active
}

الخلاصة

التعامل الصح مع الـ data types حاجة أساسية لأي Salesforce developer شغال بـ Apex أو Lightning Web Components (LWC) JavaScript. في البوست ده قدمنالكم جدول مفيد بيربط الـ data types بتاعة الـ Salesforce object fields باللي بيقابلها في Apex وJavaScript. الجدول ده مرجع سريع بيضمن إنكم تشتغلوا مع الـ data types المختلفة بثقة ودقة على الناحيتين.

وكمان شفنا أمثلة بتوضح أهمية إنكم تفهموا الـ data types اللي ورا الكود في JavaScript، حتى لو مش بتحددوها صراحةً. لو مشيتوا على الكلام اللي في البوست ده، هتبقوا جاهزين أكتر تبنوا Salesforce applications كفء ويُعتمد عليها.

وبالأساس ده، تقدروا تكملوا تطوروا مهاراتكم في الـ Salesforce development وتبنوا applications أقوى وأكفأ. Happy coding!

مصادر مفيدة (Resources)

  1. Custom Fields: Quick Look
  2. Customize a Salesforce Object
  3. Custom Field Types
  4. Data Modeling
  5. Build Lightning Web Components
  6. Javascript : Intl.NumberFormat
  7. Javascript: Date Object and Methods
  8. Rounding and truncating numbers in JavaScript

Join the conversation

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *