Avhengighetssporing for løsningskomponenter

Løsninger består av løsningskomponenter. Bruk Løsninger-området i Microsoft Dataverse til å opprette eller legge til løsningskomponenter. Du kan utføre disse handlingene programmatisk ved å bruke AddSolutionComponentRequest-meldingen eller meldinger som oppretter eller oppdaterer løsningskomponenter som inneholder en SolutionUniqueName-parameter.

Løsningskomponenter er ofte avhengige av andre løsningskomponenter. Du kan ikke slette noen løsningskomponent som har avhengigheter til eller fra en annen løsningskomponent. Et tilpasset bånd krever for eksempel vanligvis bilde- eller skript-webressurser for å vise ikoner og utføre handlinger ved hjelp av skript. Så lenge det tilpassede båndet er i løsningen, kreves de spesifikke webressursene det bruker. Før du kan slette nettressursene, må du fjerne referanser til dem i det egendefinerte båndet. Du kan vise disse løsningskomponentavhengighetene i programmet ved å velge Vis avhengigheter.

Denne artikkelen beskriver typene løsningskomponenter som du kan inkludere i løsningene, og hvordan de er avhengige av hverandre.

Alle løsningskomponenter

Systemets globale valgkolonne componenttype inneholder den fullstendige listen over tilgjengelige løsningskomponenttyper. Du kan se det støttede verdiområdet for denne egenskapen ved å inkludere filen OptionSets.cs eller OptionSets.vb i prosjektet. Mange av løsningskomponenttypene som er oppført der, er imidlertid bare til intern bruk, og listen gir ikke informasjon om relasjonene mellom løsningskomponenter.

Løsningskomponentavhengigheter

Avhengigheter for løsningskomponenter sikrer at du har en pålitelig opplevelse når du arbeider med løsninger. De hindrer handlinger som du vanligvis utfører fra utilsiktet å ødelegge tilpasninger som er definert i en løsning. Det er disse avhengighetene som tillater at en administrert løsning kan installeres og avinstalleres ved ganske enkelt å importere eller slette en løsning.

Løsningsrammeverket sporer automatisk avhengigheter for løsningskomponenter. Alle operasjoner på en løsningskomponent beregner automatisk eventuelle avhengigheter til andre komponenter i systemet. Systemet bruker avhengighetsinformasjonen til å bevare sin integritet og forhindre operasjoner som kan føre til en inkonsekvent tilstand.

Som et resultat av avhengighetssporing håndheves følgende virkemåter:

Sletting av en komponent forhindres hvis en annen komponent i systemet avhenger av den.
Eksport av en løsning advarer deg hvis det er noen manglende komponenter som kan føre til at importen mislykkes i et annet miljø.

Du kan ignorere advarsler under eksporten hvis du vil at løsningen bare skal installeres i et miljø der avhengige komponenter forventes å finnes. Når du for eksempel oppretter en løsning som er utformet for å installeres over en forhåndsinstallert basisløsning.
Import av en løsning mislykkes hvis løsningen ikke inneholder alle nødvendige komponenter og målmiljøet ikke allerede har dem.
Når du importerer en administrert løsning, må alle nødvendige komponenter samsvare med løsningens pakketype. En komponent i en administrert løsning kan bare avhenge av en annen administrert komponent.

Det finnes tre typer avhengigheter for løsningskomponenter:

Intern løsning. Dataverse administrerer interne avhengigheter. Disse avhengighetene oppstår når en bestemt løsningskomponent ikke kan eksistere uten en annen løsningskomponent.
Publisert. Dataverse oppretter publiserte avhengigheter når to løsningskomponenter er knyttet til hverandre og deretter blir publisert. For å fjerne denne typen avhengighet må du fjerne tilknytningen og publisere tabellene på nytt.
Ikke publisert. Upubliserte avhengigheter gjelder for den upubliserte versjonen av en publiserbar løsningskomponent som oppdateres. Når du publiserer løsningskomponenten, blir den en publisert avhengighet.

Løsningsinterne avhengigheter er avhengigheter der handlinger knyttet til en løsningskomponent krever en handling for en annen løsningskomponent. Hvis du for eksempel sletter en tabell, forventer du at alle tabellattributtene slettes med den. Systemet sletter også alle tabellrelasjoner med andre tabeller.

En intern avhengighet kan imidlertid føre til en publisert avhengighet og fremdeles kreve manuell inngripen. Hvis du for eksempel inkluderer et oppslagsfelt i et tabellskjema og deretter sletter primærtabellen i relasjonen, kan du ikke fullføre slettingen før du fjerner oppslagskolonnen fra det relaterte tabellskjemaet og deretter publiserer skjemaet.

Når du utfører handlinger programmatisk med løsninger, bruk meldinger som er knyttet til Dependency-tabellen. Gå til Avhengighetsentitet for meldinger du kan bruke til å identifisere avhengigheter som kan eksistere før du sletter en komponent eller avinstallerer en løsning.

Felles løsningskomponenter

Disse løsningskomponentene vises i programmet. Du arbeider med dem direkte når du legger til eller fjerner løsningskomponenter via løsningssiden. Hver av de andre typene løsningskomponenter avhenger av én eller flere av disse løsningskomponentene.

Programbånd
Enhet
Rapport
Artikkelmal
Kolonnesikkerhetsprofil
Behandlingstrinn for SDK-meldingen
Tilkoblingsrolle
Mal for utskriftsfletting
Sikkerhetsrolle
Kontraktsmal
alternativsett
Tjenesteendepunkt
Dashbord eller enhetsskjema
Montering av tillegg
Nettstedskart
E-postmal
Prosess
Webressurs

Applikasjonsbånd (RibbonCustomization)

Båndtilpassinger for programmets bånd og båndmaler for tabeller. Bånd i programmer inkluderer ikke definisjoner for bånd på tabell- eller skjemanivå.

Egendefinerte bånd har ofte publiserte avhengigheter til nettressurser. Bruk webressurser til å definere ikoner for knapper på båndet og JavaScript-funksjoner som styrer når elementer på båndet vises, eller hvilke handlinger som skal utføres når en bestemt båndkontroll brukes. Avhengigheter opprettes kun når bånddefinisjonene bruker $webresource:-direktivet for å knytte nettressursen til båndet. Hvis du vil ha mer informasjon, finner du den i $webresource-direktivet.

Artikkelmal (KBArticleTemplate)

Mal som inneholder standardattributtene for en artikkel. Det er alltid en intern avhengighet mellom artikkelmalen og KbArticle-tabellen.

Tilkoblingsrolle (ConnectionRole)

Rolle som beskriver et forhold mellom to poster. Hver tilknytningsrolle definerer hvilke typer entitetsposter som kan knyttes sammen ved hjelp av tilknytningsrollen. Denne rollen oppretter en publisert avhengighet mellom tilkoblingsrolle og tabellen.

Kontraktsmal (ContractTemplate)

Mal som inneholder standardattributtene for en kontrakt. Det er alltid en intern avhengighet mellom kontraktmalen og kontrakttabellen.

Dashbord eller enhetsskjema (SystemForm)

Bruk tabelloppføringer for systemskjema til å definere dashbord og tabellskjemaer. Når du bruker SystemForm som et tabellskjema, er det en intern avhengighet av tabellen. Når du bruker et SystemForm som et dashbord, er det ingen interne avhengigheter. Både tabellskjemaer og dashbord har vanligvis publiserte avhengigheter relatert til innholdet. Et tabellskjema kan ha oppslagskolonner som avhenger av en tabellrelasjon. Både dashbord og tabellskjemaer kan inneholde diagrammer eller underrutenett som oppretter en publisert avhengighet til en visning, som deretter har en intern avhengighet til en tabell. En publisert avhengighet på nettressurser kan opprettes på grunn av innhold som vises på dashbordet eller skjemaet, eller når et skjema inneholder JavaScript-biblioteker. Tabellskjemaer har publiserte avhengigheter på alle attributter som vises som kolonner i skjemaet.

E-postmal (EmailTemplate)

Malen som inneholder standardattributtene for en e-postmelding. En e-postmal inneholder vanligvis kolonner som setter inn data fra angitte tabellattributter. Du kan koble en e-postmal til en bestemt tabell når du oppretter den, slik at det kan være en intern avhengighet av tabellen. En global mal for e-post er ikke knyttet til en bestemt tabell, men den kan ha publiserte avhengigheter på tabellattributter som brukes til å gi data. En prosess (arbeidsflyt) konfigureres ofte til å sende en e-post ved hjelp av en e-postmal, noe som oppretter en publisert avhengighet for arbeidsflyten.

Entitet (Entity)

Tabeller, tidligere kjent som enheter, er den primære strukturen som brukes til å modellere og administrere data i Dataverse. På grunn av de interne avhengighetene mellom dem, sletter du også diagrammer, skjemaer, tabellrelasjoner, visninger og attributter som er knyttet til tabellen når du sletter en tabell. Tabeller har ofte publiserte avhengigheter til prosesser, dashbord og e-postmaler.

Kolonnesikkerhetsprofil (FieldSecurityProfile)

Profil som definerer tilgangsnivået for sikrede attributter.

Mal for utskriftsfletting (MailMergeTemplate)

Mal som inneholder standardattributtene for et e-postflettingsdokument. En mal for utskriftsfletting har et publisert avhengighetsforhold til tabellen den er knyttet til.

Alternativsett (OptionSet)

En valgkolonne, tidligere kalt et alternativsett, definerer et sett med alternativer. Et valglistattributt bruker et alternativ for å definere alternativene som er angitt. Flere plukklisteattributter kan bruke et globalt valg, slik at alternativene de gir, alltid er de samme, og de kan vedlikeholdes på ett sted. En publisert avhengighet skjer når et valglisteattributt refererer til et globalt alternativ. Du kan ikke slette et globalt valg som blir brukt av et plukklisteattributt.

Plugin-assembly (PluginAssembly)

Samling som inneholder én eller flere plugin-typer. Plugin-moduler registreres i hendelser som vanligvis er knyttet til en tabell. Denne registreringen oppretter en publisert avhengighet.

Prosess (arbeidsflyt)

Sett med logiske regler som definerer trinnene som er nødvendige for å automatisere en bestemt forretningsprosess, oppgave eller et sett med handlinger som skal utføres. Prosesser tilbyr et bredt utvalg handlinger som oppretter publiserte avhengigheter til enhver annen løsningskomponent som prosessen refererer til. Hver prosess har også et publisert avhengighetsforhold til tabellen den er knyttet til.

Rapport (Rapport)

datasammendrag i et leservennlig oppsett. En rapport har publisert avhengigheter for eventuelle tabell- eller attributtdata som er inkludert i rapporten. Hver rapport må også knyttes til en rapportkategori, noe som oppretter en intern avhengighet av en løsningskomponent kalt Report Related Category (ReportCategory). Du kan konfigurere rapporter til å være delrapporter, og opprette en publiseringsavhengighet med den overordnede rapporten.

Behandlingstrinn for SDK-melding (SDKMessageProcessingStep)

Fase i utføringspipelinen der en plugin-modul skal kjøres.

Sikkerhetsrolle (rolle)

Gruppering av sikkerhetsrettigheter. Tilordne sikkerhetsroller til brukere for å autorisere tilgang til Dataverse-systemet. Knytt tabellskjemaer til bestemte sikkerhetsroller for å kontrollere hvem som kan vise skjemaet. Denne tilknytningen oppretter en publisert avhengighet mellom sikkerhetsrollen og skjemaet.

Merk

Du kan bare legge til sikkerhetsroller fra forretningsenheten for miljøet i en løsning. Bare en bruker med lesetilgang til disse sikkerhetsrollene kan legge dem til i en løsning.

Tjenesteendepunkt (ServiceEndpoint)

Tjenesteendepunkt som du kan kontakte.

Nettstedskart (SiteMap)

XML-data som brukes til å kontrollere programnavigasjonsruten. Du kan koble områdediagrammet til å vise en HTML-nettressurs, eller et ikon i områdediagrammet kan bruke en nettressurs for bilder. Når du bruker direktivet $webresource: til å etablere disse tilknytningene, oppretter du en publisert avhengighet. Hvis du vil ha mer informasjon, se $webresource-direktivet.

Nettressurs (WebResource)

Data som tilsvarer filer som brukes til å utvide en modelldrevet app eller i webutvikling. Webressurser tilbyr komponenter på klientsiden som brukes til å lage tilpassede elementer i brukergrensesnittet. Nettressurser kan ha publiserte avhengighetsforhold med tabellskjemaer, båndet og nettstedskartet. Når du bruker direktivet $webresource: til å opprette tilknytninger på båndet eller områdekartet, oppretter du en publisert avhengighet. Hvis du vil ha mer informasjon, finner du den i $webresource-direktivet.