Бөлісу құралы:

pac modelbuilder

Dataverse API және кестелері үшін код генераторы.

Бұл команданы Dataverse кестелері, арнайы хабарламалар және pac modelbuilder build алынған класс үшін ерте байланған .NET кластарын генерациялау үшін қолданыңыз. Ерте байланыстырылған сыныптарды жасау үшін осы пәрменді пайдалану туралы қосымша ақпарат алыңыз

Сынып мынадан алынған OrganizationServiceContext:

  • Мемлекеттік қызметшілердің құқықтарын қорғау жөніндегі уәкілетті органның құқық қорғау органдарына жүгінуі.
  • Dataverse деректерін пайдаланып LINQ сұрауларын жаза алатындай System.Linq.IQueryable интерфейсін және .NET Language-Integrated сұрау (LINQ) сұрау провайдерін жүзеге асырады.

Осы кодты құру құралы ұсынатын мүмкіндіктер туралы қосымша ақпарат алу үшін:

Ескертпе

pac modelbuilder build Пәрмен таратылған CrmSvcUtil.exe NuGet пакетімен алмастырады.

Раа

Пәрмен Сипаттама
pac modelbuilder build Dataverse API және кестелері үшін код үлгісін жасайды

pac modelbuilder build

Dataverse API және кестелері үшін код үлгісін жасайды

Ескертпе

Команданы build қолданбас бұрын, алдымен Dataverse-кеpac auth create командасы арқылы қосылуыңыз керек. Егер бірнеше қосылымыңыз болса, аутентификация таңдауынpac пайдаланып, кодты генерациялағыңыз келетін Dataverse ортасын таңдаңыз.

Мысал

Келесі мысалда бұйрықты жылдам басқару арқылы қалай қолдануға build болатындығы көрсетілген.

pac modelbuilder build ^
  --entitynamesfilter account;contact ^
  --generatesdkmessages ^
  --messagenamesfilter examp_* ^
  --emitfieldsclasses ^
  --emitVirtualAttributes ^
  --namespace MyApps.Model ^
  --outdirectory c:\src\MyApps\Model ^
  --writesettingsTemplateFile ^
  --serviceContextName OrgContext

PowerShell арқылы бірдей пәрмен:

pac modelbuilder build `
  --entitynamesfilter 'account;contact' `
  --generatesdkmessages `
  --messagenamesfilter 'examp_*' `
  --emitfieldsclasses `
  --emitVirtualAttributes `
  --namespace 'MyApps.Model' `
  --outdirectory 'c:\src\MyApps\Model' `
  --writesettingsTemplateFile `
  --serviceContextName 'OrgContext'

Маңызды

PowerShell бағдарламасын пайдалану кезінде кез келген жол параметрлерін жалғыз тырнақшалармен қоршап алу керек.

Бұл пәрменнің нәтижесі - келесі файлдар қалтаға c:\src\MyApps\Model жазылады.

C:\src\MyApps\Model\
|---Объектілер\
| |--account.cs
| |--contact.cs
|---OptionSets\
| |--addresstypes.cs
|---Messages\
| |--examp_myapi.cs
|---EntityOptionSetEnum.cs
|---builderSettings.json
|---OrgContext.cs

builderSettings.json сіз көрсеткен параметрлерді қамтиды. Заттар өзгерген кезде файлдарды тез қалпына келтіру үшін оны пайдалана аласыз. Келесі мысалда buildersettings.json арқылы бірінші пәрменнен жасалған файлды пайдалану көрсетілген:

pac modelbuilder build `
  --outdirectory c:\src\MyApps\Model `
  --settingsTemplateFile c:\src\MyApps\Model\builderSettings.json

Сондай-ақ, сіз файл жасауды таңдай builderSettings.json аласыз және барлық параметрлерді командаға берудің орнына оны пайдалана аласыз. Төменде жоғарыда келтірілген бірінші үлгіге тең мысал келтірілген:

{
  "suppressINotifyPattern": false,
  "suppressGeneratedCodeAttribute": false,
  "language": "CS",
  "namespace": "MyApps.Model",
  "serviceContextName": "OrgContext",
  "generateSdkMessages": true,
  "generateGlobalOptionSets": false,
  "emitFieldsClasses": true,
  "entityTypesFolder": "Entities",
  "messagesTypesFolder": "Messages",
  "optionSetsTypesFolder": "OptionSets",
  "entityNamesFilter": [
    "account",
    "contact"
  ],
  "messageNamesFilter": [
    "examp_*"
  ],
  "emitEntityETC": false,
  "emitVirtualAttributes": true
}

ПараметрлерTemplateFile параметрін пайдаланған кезде параметрлерді командаға берсеңіз, командаға берілген параметрлер файлда орнатылғандарды builderSettings.json басып шығарады.

settingsTemplateFile параметрін және writesettingsTemplateFile параметрін бір уақытта пайдалана алмайсыз.

Қажетті параметрлер modelbuilder build

--outdirectory -o

Нысан, хабар және параметрлер жиынтығы файлдары үшін каталог жазыңыз.

Қосымша параметрлер modelbuilder build

--emitentityetc -etc

Орнатылған кезде, жасалған кодқа ETC (нысан түрі коды) қосылады.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--emitfieldsclasses -efc

Кодты құру кезіндегі объект бойынша барлық өріс атауларын қамтитын тұрақты құрылымды жасаңыз.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--emitvirtualattributes -eva

Орнатылған кезде, іздеу атрибуттарының негізгі атау атрибуттарының мәндерін сүзгілеуге мүмкіндік беретін іздеу үшін қолдаушы атау атрибуттарын қамтиды.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--entitynamesfilter -enf

Сүзгілер Dataverse деректерін оқыған кезде алынған нысандар тізімі. Бөлектелген тізімде жартылай колонка ретінде өтті. entitylogicalname< пішінін >пайдалану;<EntityLogicalName>

--entitytypesfolder -etf

Нысандарды қамтитын қалта атауы. Әдепкі атауы - 'Субъектілер'.

--environment -env

Мақсатты деректерді анықтайды. Мән Guid немесе абсолютті https URL мекенжайы болуы мүмкін. Көрсетілмеген жағдайда, ағымдағы аутентификация профилі үшін таңдалған белсенді ұйым пайдаланылады.

--generateGlobalOptionSets -go

Барлық жаһандық опциялар жиынтығын шығару. Ескерту: Егер нысан жаһандық параметрлер жиынтығына сілтеме болса, ол қосқыш болмаса да шығарылады.

--generatesdkmessages -a

Орнатылған кезде, кодты генерациялау бөлігі ретінде SDK хабар кластарын шығарады.

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--language -l

Прототиптік код үшін қолданатын тіл. Бұл мән 'CS' немесе 'VB' болуы мүмкін. Әдепкі тіл - "CS."

--logLevel -ll

Журнал деңгейі. Әдепкі мән - "Өшіру."

Мына мәндердің біреуін пайдаланыңыз:

  • Off
  • Critical
  • Error
  • Warning
  • Information
  • Verbose
  • ActivityTracing
  • All

--messagenamesfilter -mnf

Dataverse деректерін оқыған кезде алынатын хабарлар тізімін сүзеді. Нүктелі үтірмен бөлінген тізім түрінде берілетін міндетті хабарлар (Жасау, Жаңарту, Жою, Алу, Алу, Алу, Қауымдастық және Ажырату) әрқашан қосылады. Жолдан басталатын немесе аяқталатын барлық хабарларға рұқсат беру үшін хабарлардың атаулары бар соңғы немесе алдыңғы жұлдызшаны (*) пайдаланыңыз. Messagename< пішінін >пайдалану;<Хабарлама атауы>.

--messagestypesfolder -mtf

Хабарларды қамтитын қалта атауы. Әдепкі атауы - "Хабарлар".

--namespace -n

Пайда болған кодтың атау кеңістігі. Әдепкі атау кеңістігі - жаһандық атау кеңістігі.

--optionsetstypesfolder -otf

Параметрлер жиынтығы бар қапшық атауы. Әдепкі атауы - 'OptionSets'.

--serviceContextName -sctx

Қалыптасқан қызмет көрсету контекстінің атауы. Егер мән берілсе, ол қызмет контексті үшін пайдаланылады. Олай болмаған жағдайда, қызмет көрсету контексті жасалмайды.

--settingsTemplateFile -stf

Dataverse үлгісін құрастырушы құрастырушысын осы іске қосу үшін пайдаланылатын параметрлерді қамтиды, пәрмен жолындағы кез келген қайталанатын параметрлерді басып шығарады. Орнату мүмкін емес, - WordSettingstemplate - Орнату мүмкін емес.

--suppressGeneratedCodeAttribute -sgca

Орнатылған кезде, бұл код генерациялау қозғалтқышымен және нұсқасымен белгіленген барлық жасалған нысандарды басады

Бұл параметр мәнді қажет етпейді. Бұл ауысу.

--suppressINotifyPattern

Қосылған кезде, қасиеттер мен сыныптар үшін INotify орамдарын жазмайды.

--writesettingsTemplateFile -wstf

Орнатылған кезде параметрлер файлын шығыс каталогына ағымдағы берілген параметрлері немесе әдепкі параметрлері бар жазады.

Ескертулер

Бұйрықты қолдану pac modelbuilder build бойынша ұсыныстар берілген.

және параметрлерін орнату entitynamesfiltermessagenamesfilter

Абайлаңыз

Жасалған файлдарды жобаңызда пайдаланылатын файлдармен шектеу үшін entitynamesfilter және messagenamesfilter параметрлерін пайдалануды ұсынамыз. Әйтпесе, құрастыру пәрмені Dataverse-тен барлық кестелер мен хабарламалар үшін код жасауға тырысады. Оны өңдеу үшін айтарлықтай уақыт кетеді.

Microsoft.Crm.Sdk.Messages және Microsoft.Xrm.Sdk.Messages атау кеңістігінде табылған хабарларға арналған сыныптар осы пәрмен арқылы жасалмайды. Тек параметрде messagenamesfilter табылмаған хабарларды, мысалы, реттелетін әрекеттерді қосу керек.

WPF бағдарламасын орнатпасаңыз орнатыңыз suppressINotifyPattern

INotify Осы пәрмен басылған орамалар WPF қосымшаларымен деректерді байланыстыру сценарийлері үшін қолданылады. Егер сіз жасалған кодпен WPF қосымшасын жасамасаңыз, олар сізге қажет емес. Оларды жою үшін suppressINotifyPattern параметрін пайдаланыңыз.

Хабар сыныптарын құру кезінде қосу serviceContextName

Егер хабар сыныптарын жасасаңыз, оны пайдаланбасаңыз да, әрқашан serviceContextName параметрін қосуыңыз OrganizationServiceContextкерек. Осы Қағидалардың 1-тармағында көзделген құжаттар осы Кодексте көзделген құжаттарды қажет етеді. Орнатпаған кезде пайда болатын қате туралы қосымша ақпарат алыңыз.

Келесіні де қараңыз:

Microsoft Power Platform CLI пәрмен топтары
Microsoft Power Platform CLI шолуына шолу

  • Last updated on