SFDX

SFDX прадстаўляе сучасны падыход да распрацоўкі Salesforce, які робіць акцэнт на распрацоўцы, арыентаванай на зыходныя коды, пастаяннай інтэграцыі і кантролі версій. Гэты гласарый тлумачыць ключавую тэрміналогію і паняцці, якія складаюць аснову SFDX.

Асноўныя паняцці

Scratch Org

Скрэтч-арганізацыя функцыянуе як часовае наладжвальнае асяроддзе Salesforce, якое працуе да 30 дзён. Успрымайце гэта як аднаразовае асяроддзе распрацоўкі, дзе вы можаце эксперыментаваць з новымі функцыямі, тэставаць канфігурацыі і распрацоўваць код, не закранаючы арганізацыю вытворчасці. Калі вы ствараеце нулявую арганізацыю, вы, па сутнасці, атрымліваеце свежы, пусты асобнік Salesforce, які вы можаце наладзіць у адпаведнасці са сваімі патрэбамі.

Прыклад каманды для стварэння нулявой арганізацыі:

sfdx force:org:create -f config/project-scratch-def.json -a DevOrg1 -d 30

Dev Hub

Dev Hub служыць цэнтральнай кропкай кіравання для стварэння і кіравання нулявымі арганізацыямі. Гэта як камандны цэнтр, які адсочвае ўсе вашы асяроддзя распрацоўкі. Калі вы ўключаеце Dev Hub у вытворчай або бізнес-арганізацыі, ён атрымлівае магчымасць ствараць і кантраляваць нулявыя арганізацыі. Успрымайце гэта як мацярынскую арганізацыю, якая можа ствараць асяроддзе развіцця дзіцяці і кіраваць ім.

Зыходны фармат

Зыходны фармат адносіцца да раскладзенай структуры метададзеных Salesforce пры працы з SFDX. У адрозненне ад традыцыйнага фармату метададзеных, дзе кампаненты аб'ядноўваюцца разам, зыходны фармат разбівае метададзеныя на больш дробныя файлы, больш зручныя для кіравання. Такі падыход робіць кантроль версій больш эфектыўным і дапамагае прадухіліць канфлікты, калі некалькі распрацоўшчыкаў працуюць над аднымі і тымі ж кампанентамі.

Прыклад структуры зыходнага фармату:

force-app/
    main/
        default/
            classes/
                AccountService.cls
                AccountService.cls-meta.xml
            objects/
                Account/
                    fields/
                        CustomField__c.field-meta.xml

Мадэль распрацоўкі пакета

Мадэль распрацоўкі пакетаў прадстаўляе модульны падыход да стварэння прыкладанняў Salesforce. Замест распрацоўкі непасрэдна ў арганізацыі вы ствараеце пакеты, якія змяшчаюць пэўныя функцыі. Гэтыя пакеты могуць быць устаноўлены ў розных арганізацыях, што робіць вашу распрацоўку больш партатыўнай і шматразовай. Успрымайце пакеты як аўтаномныя адзінкі функцыянальнасці, якія можна распаўсюджваць і ўсталёўваць незалежна.

Канфігурацыя праекта

Праекты SFDX выкарыстоўваюць пэўныя файлы канфігурацыі для падтрымання ўзгодненасці ў розных асяроддзях распрацоўкі:

sfdx-project.json: Асноўны канфігурацыйны файл праекта, які вызначае:

{
    "packageDirectories": [
        {
            "path": "force-app",
            "default": true,
            "package": "MyPackage",
            "versionName": "Version 1.0",
            "versionNumber": "1.0.0.NEXT"
        }
    ],
    "namespace": "",
    "sfdcLoginUrl": "https://login.salesforce.com",
    "sourceApiVersion": "57.0"
}

project-scratch-def.json: вызначае форму скрэтч-арганізацый:

{
    "orgName": "Development Org",
    "edition": "Developer",
    "features": ["EnableSetPasswordInApi"],
    "settings": {
        "lightningExperienceSettings": {
            "enableS1DesktopEnabled": true
        }
    }
}

Агульныя каманды і іх прызначэнне

Каманды аўтэнтыфікацыі

Гэтыя каманды дапамогуць вам падключыцца да вашых арганізацый Salesforce:

• force:auth:web:login: Адкрывае вэб-браўзер для інтэрактыўнага ўваходу. Гэтая каманда ініцыюе паток OAuth, дазваляючы вам бяспечна прайсці аўтэнтыфікацыю ў вашай арганізацыі Salesforce.

sfdx force:auth:web:login -a ProductionOrg

Каманды распрацоўкі

Каманды, якія выкарыстоўваюцца ў працэсе распрацоўкі:

• сіла: крыніца: штуршок: Загружае лакальную крыніцу ў скрэтч-арганізацыю. Успрымайце гэта як сінхранізацыю лакальных змяненняў з асяроддзем распрацоўкі.

sfdx force:source:push -u DevOrg1

• сіла:крыніца:цягнуць: Загрузка змяненняў з нуля org. Гэта здабывае любыя змены, унесеныя непасрэдна ў скрэтч-арганізацыю, падтрымліваючы актуальную лакальную крыніцу.

sfdx force:source:pull -u DevOrg1

Тэставанне каманд

Каманды для выканання і кіравання тэстамі:

• сіла:вяршыня:тэст:запуск: Выконвае тэсты Apex. Гэтая каманда запускае вашыя тэсты Apex і дае падрабязныя вынікі аб ахопе тэстаў і няўдачах.

sfdx force:apex:test:run -l RunLocalTests -c -r human

Кіраванне навакольным асяроддзем

Пясочніцы супраць Scratch Orgs

Пры распрацоўцы на платформе Salesforce выбар правільнага тыпу невытворчай асяроддзя мае вырашальнае значэнне для паспяховай распрацоўкі і тэсціравання. Salesforce прапануе два асноўныя варыянты: Sandboxes і Scratch Orgs, кожны з якіх служыць розным мэтам у жыццёвым цыкле распрацоўкі. Пясочніцы функцыянуюць як копіі вашай вытворчай арганізацыі, захоўваючы ўсе вашы налады і, неабавязкова, вашы даныя, што робіць іх ідэальнымі для тэставання змяненняў у асяроддзі, якое дакладна адлюстроўвае вытворчасць.

Scratch Orgs, наадварот, - гэта пустыя часовыя асяроддзя, якія вы ствараеце з нуля ў адпаведнасці з вызначанымі спецыфікацыямі. Гэта робіць іх ідэальнымі для распрацоўкі новых функцый і аўтаматызаванага тэсціравання. Разуменне моцных бакоў кожнага тыпу асяроддзя і адпаведных варыянтаў выкарыстання дапамагае распрацоўшчыкам выбраць правільны інструмент для іх канкрэтных патрэб і стварыць больш эфектыўныя працоўныя працэсы распрацоўкі.

Інтэграцыя кантролю версій

Праекты SFDX распрацаваны для бесперашкоднай працы з сістэмамі кантролю версій, такімі як Git. Зыходны фармат палягчае:

• Адсочвайце змены на дэталёвым узроўні
• Кіруйце канфліктамі паміж распрацоўшчыкамі
• Вядзеце гісторыю змяненняў
• Падтрымка канвеераў бесперапыннай інтэграцыі/бесперапыннага разгортвання (CI/CD).

Best Practices

Структура праекта

Арганізуйце свой праект SFDX з выразнай структурай:

my-project/
    force-app/                  # Main source directory
        main/
            default/            # Default package directory
    config/                     # Configuration files
    scripts/                    # Build and automation scripts
    .forceignore               # Files to ignore in deployment
    sfdx-project.json          # Project configuration
    project-scratch-def.json   # Scratch org definition

Рабочы працэс распрацоўкі

1. Стварыце функцыю галіны з вашай галоўнай галіны
2. Стварыце скрэтч-арганізацыю для распрацоўкі функцый
3. Распрацоўка і тэставанне ў scratch org
4. Выцягнуць змены ў ваш лакальны праект
5. Зафіксуйце змены ў кантролі версій
6. Стварыце запыт на прагляд кода
7. Пасля зацвярджэння аб'яднацца ў асноўную галіну

SFDX уяўляе сабой значную эвалюцыю ў распрацоўцы і разгортванні прыкладанняў Salesforce. Разумеючы гэтыя паняцці і тэрміны, распрацоўшчыкі могуць лепш выкарыстоўваць інструменты і метады, якія робяць сучасную распрацоўку Salesforce больш эфектыўнай і надзейнай. Памятайце, што SFDX пастаянна развіваецца, і для паспяховай распрацоўкі неабходна пастаянна абнаўляць найноўшыя функцыі і лепшыя практыкі.