Taula birtualetarako APIaren kontuak

Taulen definizio-sistemaren bi aldaketa kategoria handi daude Microsoft Dataverse-n taula birtualak (entitate birtual izenez ere ezagunak) sartzearekin:

• Multzo berri bat gehitzea, izen-espazioak, klaseak eta beste mota batzuk taula birtual pertsonalizatuen datu-hornitzaileen garapena laguntzeko
• Oinarrizko plataformaren aldaketak, kanpoko datu-iturrien mapa onartzeko beste propietate batzuk barne, eta ezaugarri honen hasierako inplementazioaren mugak islatzen dituzten taulen eta zutabeen propietateen portaeraren aldaketak

Dynamics 365 Data SDK mihizia

Dynamics 365 Data SDK multzoa, Microsoft.Xrm.Sdk.Data.dll, taula birtualeko datu-hornitzaile pertsonalizatuak sortzen laguntzeko motak ditu. Ondorengo izen-espazioak ditu:

Izen-lekua	Deskribapenak
Microsoft.Xrm.Sdk.Data	Oinarrizko izenen espazioa, mota komun batzuk dituena, hala nola AllowedQueryOptions zerrenda
Microsoft.Xrm.Sdk.Data.CodeGen	Hausnarketa dinamikoa, tipoen kointzidentzia eta kodearen sorrera onartzen dituzten klaseak eta interfazeak ditu. Barne-hornitzailearen motorrak erabiltzen du nagusiki.
Microsoft.Xrm.Sdk.Data.Converters	XRM mota estandarrak dagozkien .NET oinarrizko motetara bihurtzeko klase multzoa.
Microsoft.Xrm.Sdk.Data.Exceptions	Salbuespen-mota multzo bat, egikaritze-denboran baloreak ebaztean gerta daitezkeen akatsak adierazten dituena. Guztiak Microsoft.Xrm.Sdk.SdkExceptionBase-tik datoz.
Microsoft.Xrm.Sdk.Data.Expressions	Onartutako kontsulta-eraldaketak inplementatzen laguntzeko klaseak, hala nola FILTER, JOIN eta ORDER.
Microsoft.Xrm.Sdk.Data.Mappings	Taula birtualen definizio motetatik kanpoko motetara mapa eraikitzen duten klaseak eta interfazeak.
Microsoft.Xrm.Sdk.Data.Visitors	RetrieveMultiple eskaeretan datu-hornitzaileari pasatako QueryExpression parametroan eragiketa espezifikoak egiteko bisitari-eredua inplementatzen duten motak. Kontsulta generikoetarako eta LINQn oinarritutako prozesamendurako bateragarritasun espezifikoa ematen du. Klase hauek Microsoft.Xrm.Sdk.Query.QueryExpressionVisitorBase-tik datoz.

Izen-espazio hauek NuGet pakete honetan sartutako muntaketan daude: Microsoft.CrmSdk.Data.

Aldaketak plataforma nagusian

Dataverse erreferentzia mota estandarren ondorengo aldaketak taula birtualak onartzen ditu.

Taula berriak

Dataverse-k taula birtualeko datu-hornitzaileak eta iturburuak erakusten ditu taula hauetan: EntityDataProvider eta EntityDataSource.

Taularen definizioaren propietate berriak

Lau propietate berri gehitu zaizkio EntityMetadata klaseari:

Propietatea	Deskribapenak
DataProviderId	Elkartutako taula birtualeko datu-hornitzailea identifikatzen duen GUID
DataSourceId	Elkartutako taula birtualeko datu-iturburua identifikatzen duen GUID
ExternalName	Mota honen izena kanpoko datu-iturburuan
ExternalCollectionName	Mota honen izen plurala, interfazean erabiltzen dena eta OData-ren sarbidea onartzeko

Bi propietate berri gehitu zaizkio AttributeMetadata klaseari:

Propietatea	Deskribapenak
ExternalName	Kanpoko datu-iturburuko motaren izena
IsDataSourceSecret	Eremuak informazio sentikorra duen ala ez adierazten du

Jabetza ExternalName ere gehitu zitzaion OptionMetadata eta klaseei OptionSetMetadata . Kanpoko izen horiek kanpoko datu-iturburuen mapatzean laguntzen dute, kanpoko datu-iturburuan lotutako motaren izena zehaztuz. Propietate hauek taula birtualetan soilik erabiltzen dira. Entitate pertsonalizatu integratu edo estandar baterako, kanpoko izen hauek honako hauek izan nullbehar dute:

Taula birtualaren sorrera

Taula birtual bat programatikoki sortzeko ikuspegia zertxobait desberdina da entitate mota pertsonalizatu estandar batetik zertxobait desberdina:

• Sortzeko unean lotutako datu-hornitzailea (eta, aukeran, datu-iturria) ezagutzen baduzu, zehaztu balio hauek.
• Mota honetako datu-hornitzailea ezagutzen ez baduzu, ezarri DataProviderId7015A531-CC0D-4537-B5F2-C882A1EB65AD eta ezarri DataSourceIdnull . Exekuzio-garaian mota honetako instantziak erabili aurretik, esleitu propietate horiei balio egokiak.

Plugin bat erregistratzen duzunean, bi taula berri sortzen dituzu: EntityDataProvider eta, aukeran EntityDataSource, . Haien IDak entitydataproviderid eta entitydatasourceid, beharrezko GUID horiek adierazten dituzte. (Bestela, garatzaileek gutxitan sartu behar dituzte mota pertsonalizatu horiek zuzenean.) Kontuan izan DataSource-k dagokion DataProvider motarekin bat etorri behar duen propietatea entitydataproviderid duela, edo exekuzio-denboraren salbuespen bat botatzen dela.

Abisua

Taula estandarrek (ez-birtualak) beren balioak izan DataProviderId behar dituzte eta DataSourceId balio lehenetsietan ezarri behar dituzte (null), bestela exekuzio-denboraren salbuespen bat botako da. Behin sortuta, ezin duzu mota ez-birtual batetik mota birtual batera bihurtu, edo alderantziz.

Taularen definizioaren propietateen portaeraren aldaketak

Ondorengo taulan EntityMetadata propietate estandarren portaera nola aldatzen den azaltzen da taula birtualei aplikatzean. Propietate batzuk ez dira baliozkoak taula birtualetarako, beste batzuk esparruan edo balioan mugatuak diren bitartean.

Metadatuak (Jabetza)	Aplikatzen al da?	Oharrak
ActivityTypeMask	Ez du balio	Beti 0
Atributuak	baliozkoa
AutoCreateAccessTeams	Ez du balio	Beti faltsua
AutoRouteToOwnerQueue	Ez du balio	Beti faltsua, ilarak ez dira onartzen.
CanBeInManyToMany	baliozkoa
CanBePrimaryEntityInRelationship	baliozkoa
CanBeRelatedEntityInRelationship	baliozkoa
CanChangeHierarchicalRelationship	Ez du balio	Beti faltsuak, hierarkiazko harremanak ez dira onartzen.
CanChangeTrackingBeEnabled	Ez du balio	Beti faltsuak, aldaketen jarraipena eta auditoretza balioak ez dira onartzen.
CanCreateAttributes	baliozkoa
CanCreateCharts	Ez du balio	Beti faltsua
CanCreateForms	baliozkoa
CanCreateViews	baliozkoa
CanEnableSyncToExternalSearchIndex	Ez du balio	Beti faltsua
CanModifyAdditionalSettings	baliozkoa
CanTriggerWorkflow	Ez du balio	Beti faltsua, lan-fluxuak ezin dira aktibatu.
ChangeTrackingEnabled	Ez du balio	Beti faltsua
CollectionSchemaName	baliozkoa
EgunakDesderegistroaALekiaModifikatua	Ez du balio	Beti baliogabea edo 0
Deskribapenak	baliozkoa
DisplayCollectionName	baliozkoa
DisplayName (Pantaila-izena)	baliozkoa
EnforceStateTransitions	Ez du balio	StateCode eta Status ez dira onartzen.
EntityColor	baliozkoa
EntityHelpUrl	baliozkoa
EntityHelpUrlEnabled	baliozkoa
EntitySetName	baliozkoa
Hedapen-datuak	Ez du balio	Erabiltzen ez den jabetza
Aldatu egin da	baliozkoa
IconLargeName	baliozkoa
IconMediumName	baliozkoa
IconSmallName	baliozkoa
Sartutako bertsioa	baliozkoa
Jarduera da	Ez du balio	Beti faltsua, jarduerak ez dira onartzen.
IsActivityParty	Ez du balio	Beti faltsua
IsAIRUpdated	Ez du balio	Ez onartua
IsAuditEnabled	Ez du balio	Beti faltsua, auditoria ez da onartzen.
IsAvailableOffline	Ez du balio	Beti faltsua, lineaz kanpoko erabilera ez da onartzen.
IsBusinessProcessEnabled	Ez du balio	Beti faltsua, negozio-prozesuak ez dira onartzen.
IsChildEntity	Ez du balio	Beti faltsua, taula birtual guztiak erakundearen jabetzakoak dira.
IsConnectionsEnabled	baliozkoa
IsCustomEntity	baliozkoa
Apersonalizagarria	baliozkoa
IsDocumentManagementEnabled	baliozkoa
IsDocumentRecommendationsEnabled	Ez du balio	Beti faltsua, ezaugarri berri hau ez da onartzen.
IsDuplicateDetectionEnabled	Ez du balio	Beti faltsutzen da, baina bikoiztutakoen detekzioa datuen jatorrian egin daiteke.
IsEnabledForCharts	mugatua	Fetch klausula onartuetarako bakarrik.
IsEnabledForTrace	baliozkoa
Garrantzitsua da	baliozkoa
IsInteractionCentricEnabled	baliozkoa
IsIntersect	baliozkoa
IsKnowledgeManagementEnabled	Ez du balio	Beti faltsua, ezagutzaren kudeaketaren integrazioa ez da onartzen.
IsMailMergeEnabled	baliozkoa
IsManaged	baliozkoa
Mapeablea da	baliozkoa
IsOfflineInMobileClient	Ez du balio	Beti faltsuak, taula birtualaren balioak ez dira cachean gordetzen lineaz kanpo erabiltzeko.
IsOneNoteIntegrationEnabled	baliozkoa
IsOptimisticConcurrencyEnabled	Ez du balio	Beti faltsutzen da, aldiberekotasuna datuen jatorrian ezarri behar da.
IsPrivate	baliozkoa
IsQuickCreateEnabled	baliozkoa
IsReadOnlyInMobileClient	baliozkoa
Izendagarria da	baliozkoa
IsSLAEnabled	Ez du balio	Beti faltsua
IsStateModelAware	Ez du balio
IsValidForAdvancedFind	baliozkoa
IsValidForQueue	baliozkoa
IsVisibleInMobile	baliozkoa
IsVisibleInMobileClient	baliozkoa
Giltzak	Ez du balio	Gako alternatiboak ez daude onartzen
LogicalCollectionName	baliozkoa
LogicalName (Izen logikoa)	baliozkoa
ManyToManyRelationships	baliozkoa
ManyToOneRelationships	baliozkoa	Ez onartzen bi taula birtualen artean.
MetadataId	baliozkoa
MobileOfflineFilters	Ez du balio	Beti faltsua, lineaz kanpoko erabilera ez da onartzen.
Objektu motaren kodea	baliozkoa
HarremanakToManyManys	baliozkoa
Jabetza mota	Ez du balio	Beti erakundearen jabetza
PrimaryIdAttribute atributua	baliozkoa
Atributu NagusiaImagen	baliozkoa
Lehen izenaren atributua	baliozkoa
Pribilegioak	Ez du balio
RecurrenceBaseEntityLogicalName	Ez du balio
ReportViewName	Ez du balio
Eskemaren izena	baliozkoa
SyncToExternalSearchIndex	Ez du balio

Zutabearen definizioaren propietateen portaeraren aldaketak

Ondorengo taulan azaltzen da nola aldatzen den AttributeMetadata propietate estandarren portaera taula birtualei aplikatzean. Propietate batzuk ez dira baliozkoak taula birtualetarako, beste batzuek esparrua edo balio mugatua duten bitartean.

Metadatuak (Jabetza)	Aplikatzen al da?	Oharrak
Zutabe zenbakia	Ez du balio
Bertsio zaharkitua	baliozkoa
Deskribapenak	baliozkoa
DisplayName (Pantaila-izena)	baliozkoa
EntityLogicalName	baliozkoa
Hedapen-datuak	Ez du balio
Aldatu egin da	baliozkoa
HeredaDe	baliozkoa
Sartutako bertsioa	baliozkoa
IsAuditEnabled	Ez du balio	Beti faltsua, auditoria ez da onartzen.
IsCustomAttribute	baliozkoa
Apersonalizagarria	baliozkoa
IsFilteragarria	baliozkoa
IsGlobalFilterEnabled	baliozkoa
IsLogical	baliozkoa
IsManaged	baliozkoa
IsPrimaryId	baliozkoa
IzenaPrimarioa	baliozkoa
Izendagarria da	baliozkoa
Bilatu daiteke	baliozkoa
Ziurtatuta	Ez du balio	Beti faltsua, eremu mailako segurtasuna ez da onartzen.
IsSortableEnabled	baliozkoa
IsValidForAdvancedFind	baliozkoa
IsValidForCreate	baliozkoa
IsValidForRead	baliozkoa
IsValidForUpdate	baliozkoa
LinkedAttributeId	baliozkoa
LogicalName (Izen logikoa)	baliozkoa
MetadataId	baliozkoa
RequiredLevel	baliozkoa
Eskemaren izena	baliozkoa
Iturri mota	Ez du balio	Beti 0, kalkulatutako edo rollup-eko balioak ez dira onartzen.

Ikusi ere

Erakunde birtualetarako sarrera
Taula birtualeko datu-hornitzaile pertsonalizatuak
Adibidea: taula birtualeko datu-hornitzaile generikoaren plugina