IPowerPortalsProService

Die Benutzeroberfläche IPowerPortalsProService bietet Methoden zur Durchführung von CRUD-Operationen, zur Ausführung von Abfragen, zur Verwaltung von Beziehungen und zum Abruf von Metadaten aus Dataverse. Es ist der primäre Service für serverseitigen Datenzugriff in PowerPortalsPro.

Anmerkung
In den meisten Fällen müssen Sie nicht direkt anrufenIPowerPortalsProService. Die , MainContext, und Gitterkomponenten RecordContextübernehmen die Datenoperationen automatisch. Nutzen Sie diesen Service für benutzerdefinierte Logik, die außerhalb des Standard-Komponenten-Workflows liegt.

Server- und Client-Implementierungen

IPowerPortalsProService Wird mit zwei Implementierungen ausgeliefert, die automatisch vom Framework registriert werden – Ihr Komponentencode ist gegenüber beiden identisch, und die Laufzeit injiziert jeweils diejenige, die zum aktiven Renderkontext passt:

Serverimplementierung (PowerPortalsPro.Web.Server, registriert von AddPowerPortalsProWebServer) — läuft im Prozess, kommuniziert direkt mit Dataverse über IOrganizationService, und setzt Ihre ITablePermissionHandler / ITableRecordPermissionHandler Interceptors vor jedem Lesen oder Schreiben an. Ausgewählt, wenn die Seite unter InteractiveServerRenderMode oder statischem SSR gerendert wird.
Client-Implementierung (PowerPortalsPro.Web.Client, registriert von AddPowerPortalsProWebClient) — läuft im Browser unter WebAssembly, hat überhaupt kein Dataverse SDK und serialisiert stattdessen jeden Aufruf mit JSON an den entsprechenden serverseitigen HTTP-Endpunkt (/api/table/{name}, /api/retrieveMultiple, usw.). Die Berechtigungshandler gelten weiterhin, weil die Anfrage wieder am Endpunkt des Servers landet. Siehe die Client-API-Seite für das Wire-Format und die von der Client-Implementierung aufgerufenen Routen.

Da der Vertrag identisch ist, arbeitet dieselbe Komponente in jedem Interaktivitätsmodus (Server, WebAssembly oder Auto). Code, der eine servergerenderte Seite aufruft _powerPortalsProService.RetrieveRecordAsync(...) , führt einen inprozessorientierten Dataverse-Aufruf aus; dieselbe Zeile auf einer WASM-gerenderten Seite stellt eine HTTP-Anfrage – kein Verzweiging erforderlich.

Injektion des Dienstes

Injizieren Sie IPowerPortalsProService in jede Blazor-Komponente oder -Dienstleistung über Constructor- oder Property-Injektion.

React

Blazor

Abruf eines Datensatzes

Verwenden RetrieveRecordAsync Sie, um einen einzelnen Datensatz anhand von Tabellennamen und ID abzurufen. Geben Sie optional an, welche Spalten zurückgegeben werden sollen; wenn ausgelassen, werden alle Spalten zurückgegeben.

React

Blazor

Abfrage mehrerer Datensätze

Verwenden RetrieveRecordsAsync Sie mit einer FetchXML-Abfragezeichenkette, um mehrere Datensätze mit Unterstützung für Filterung, Sortierung und verknüpfte Entitäten abzurufen.

React

Blazor

Erstellung eines Datensatzes

Verwenden CreateRecordAsync Sie, um einen neuen Datensatz in Dataverse zu erstellen. Die Antwort enthält die ID des neu erstellten Datensatzes.

React

Blazor

Aktualisierung eines Datensatzes

Verwenden Sie UpdateRecordAsync es, um einen bestehenden Datensatz zu aktualisieren. Nur die auf der Domain gesetzten TableRecord Eigenschaften werden an Dataverse gesendet.

React

Blazor

Löschen eines Datensatzes

Nutze es, DeleteRecordAsync um einen Datensatz nach Tabellennamen und ID zu löschen.

React

Blazor

Assoziierende Aufzeichnungen

Verwenden AssociateAsync Sie und DisassociateAsync verwalten Sie viele-zu-viele Beziehungen zwischen Datensätzen.

React

Blazor

Ausführung von Anfragen

Verwenden ExecuteAsync Sie für eine einzelne Anfrage oder ExecuteMultipleAsync um mehrere Anfragen in einer einzigen Datenbanktransaktion auszuführen. Wenn eine Anfrage in einem transaktionalen Batch fehlschlägt, werden alle Änderungen zurückgesetzt.

React

Blazor

Abruf von Metadaten

Verwenden RetrieveTableMetadataAsync Sie und RetrieveViewMetadataAsync um Tabellen- und Ansichtsmetadaten abzurufen. Für zwischengespeicherte Zugriffe bevorzugen ITableMetadataCache Sie stattdessen und IViewMetadataCache .

React

Blazor

Arbeit mit Dateien

Verwenden GetFileInfoAsync Sie es, um Datei- oder Bildmetadaten und optional den Binärinhalt aus einer Datei- oder Bildspalte abzurufen.

React

Blazor

IPowerPortalsProService Interface

Methoden

Name	Parameter	Typ	Beschreibung
`AssociateAsync`	TableRecordReference record string relationshipName IEnumerable<TableRecordReference> relatedRecords EntityRole? role	Task<AssociateResponse>	Verknüpft einen Eintrag mit einem oder mehreren verwandten Unterlagen durch eine viele-zu-viele-Beziehung.
`ClearAllCachesAsync`		Task<IReadOnlyList<CacheClearResult>>	Löscht jede serverseitige `Services.IClearableCache` Karte (Tabelle / Ansicht / Privileg) Metadaten, Benutzerrechte, Umgebungsdatei-Einstellungen) und stellt die Lokalisierte Zeichenketten cachen atomar – die Leser sehen weiterhin das zuvor Daten geladen, bis der neue Zustand vollständig besetzt ist. Lazy Caches füllen sich auf der Nächste Anfrage, die sie braucht. Der HTTP-Endpunkt hinter diesem Aufruf wird durch [Authorize(Roles = 'SystemAdmin')]. Serverseitige direkte Anrufer sollten Gitter entsprechend an ihrer eigenen Grenze.
`ClearCacheAsync`	string name	Task<CacheClearResult>	Löscht einen benannten Cache. Rückkehrt `null` , wenn nicht registriert ist Cache-Übereinstimmungen `name` (Groß- und Kleinschreibungsunempfindlich); Fehler sind eingewickelt im Ergebnis statt weggeworfen. Dasselbe Authentor wie `IPowerPortalsProService.ClearAllCachesAsync`.
`CreateFileArchiveAsync`	CreateFileArchiveRequest request	Task<FileArchiveResult>	Erstellt ein Archiv (derzeit zip; zukünftige Formate leben hinter dem `CreateFileArchiveRequest.Format` enum) mit allen Aufzeichnungen Dateinutzlast für das benannte Tabellen-/Spaltenpaar. Verwendet dieselbe pro Platte Permission-Chain als `String,System.Boolean)` — unbefugt / fehlend Reihen werden lautlos aus dem Archiv gestrichen. Doppelte Dateinamen sind eindeutig durch das Suffix '(2)',' (3)', ... Also das Archiv Überschreibt niemals Einträge.
`CreateRecordAsync`	TableRecord record	Task<CreateResponse>	Erstellt einen neuen Datensatz in Dataverse.
`DeleteRecordAsync`	string tableLogicalName Guid id	Task<DeleteResponse>	Löscht einen Datensatz aus Dataverse nach Tabellennamen und Datensatz-ID.
`DisassociateAsync`	TableRecordReference record string relationshipName IEnumerable<TableRecordReference> relatedRecords EntityRole? role	Task<DisassociateResponse>	Entfernt eine Verbindung zwischen einem Datensatz und einem oder mehreren verwandten Datensätzen über eine viele-zu-viele-Beziehung.
`DownloadLocalizationSourceAsync`	string sourceId string culture	Task<LocalizationDownload>	Lädt die Schlüssel herunter, eine Quelle hat zu einer Kultur beigetragen, während der meisten kürzlich aufgewärmt, als JSON im gleichen Konsumenten mit verschachtelten Objekten app.{culture}.json Dateien verwenden. Für Übersetzungsübergabe vorgesehen — Gib die Datei einem Übersetzer ab, hol eine übersetzte Version zurück und wirf sie hinein einen Lokalisierungsordner, in dem die Originalquelle überschrieben wird für diese Schlüssel bereitgestellt.
`DownloadMergedLocalizationsAsync`	string culture	Task<LocalizationDownload>	Lädt die zusammengeführten Lokalisierungsschlüssel für eine Kultur herunter – die Post-Merge Gewinnwert für jeden Schlüssel, den der Cache gespeichert hat, unabhängig davon, welchen Die Quelle lieferte es ursprünglich. Nutzen Sie dies für eine vollständige Momentaufnahme Referenz (alles, was das Portal tatsächlich für diese Kultur dienen wird) und nicht die oben beschriebene Ansicht pro Quelle.
`ExecuteAsync`	OrganizationRequest request	Task<OrganizationResponse>	Führt eine einzelne Organisationsanfrage gegen Dataverse aus.
`ExecuteMultipleAsync`	IEnumerable<OrganizationRequest> requests bool returnResponses	Task<List<OrganizationResponse>>	Führt mehrere Organisationsanfragen in einer einzigen Datenbanktransaktion aus. Wenn eine Anfrage fehlschlägt, werden alle Änderungen im Batch zurückgesetzt.
`GetCacheNamesAsync`		Task<IReadOnlyList<string>>	Gibt die Namen aller serverseitigen `Services.IClearableCache`, passend zurück. für eine Admin-Benutzeroberfläche, die pro Cache Lösch-Buttons rendern will. Gleiches Authentifizierungsgate wie `IPowerPortalsProService.ClearAllCachesAsync` auf dem HTTP-Endpunkt gilt.
`GetFileInfoAsync`	string tableName Guid recordId string columnName bool includeData	Task<FileInfo>	Ruft Dateiinformationen und optional den Binärinhalt aus einer Datei- oder Bildspalte in Dataverse ab.
`GetFileInfosAsync`	string tableName IEnumerable<Guid> recordIds string columnName bool includeData	Task<IEnumerable<FileInfo>>	Batch-Abruf von Dateiinformationen für viele Datensätze derselben Tabelle / Spalte in einer einzigen Hin- und Rückfahrt. Intern fächert man die pro Platte parallel ab und gibt die kombinierte Liste zurück. Die gleiche pro-record-Permission-Handler-Kette läuft wie für der Ein-Record-Anruf; Fehlgeschlagene Nachschlage werden aus der Antwort gestrichen, anstatt Ich bin bei der ganzen Charge durchgefallen. Verwendet von FileGrids 'Download All' / 'Download Selected', damit der Client eine zip, ohne N HTTP-Anfragen abzufeuern.
`GetLocalizationOverviewAsync`		Task<LocalizationOverview>	Gibt einen administrativ orientierten Schnappschuss der String-Lokalisierungspipeline zurück: die Statische Konfiguration, die das Aufwärmen sowie die Ladeaufzeichnungen pro Quelle steuerte Produziert durch das letzte Aufwärmen. Unterstützt den LocalizationAdmin Komponente in PowerPortalsPro.Web.Blazor.FluentUI. Der HTTP-Endpunkt wird durch [Authorize(Roles = 'SystemAdmin')] gesperrt.
`GetOrganizationSettingsAsync`		Task<OrganizationSettings>	Ruft die organisationsweiten Einstellungen ab, die aus dem Dataverse stammen Organisationsbilanz : DefaultCurrency – die Basiswährung der Organisation, verwendet im Create-Mode Editoren (MoneyEdit), um das richtige Symbol auf brandneuen Datensätzen darzustellen. BlockedFileExtensions + MaxUploadFileSizeInBytes — Datei-Upload Constraints, die Clients spiegeln, um ungültige Dateien vor dem Roundtrip abzulehnen. Ersetzt die alten GetEnvironmentFileSettingsAsync – die beiden Dateifelder sind nun auf dieser kombinierten Reaktion ausgesetzt.
`GetTablePermissionsForCurrentUserAsync`	string tableLogicalName	Task<TableSecurityPermission>	Gibt die kombinierte Tabellen-Maske `Models.TableSecurityPermission` des aktuellen Benutzers zurück für `tableLogicalName` — die bitweise Vereinigung von Lesen / Erstellen / Schreiben / Löschen / Anhängen / Anhängen To markiert jede registrierte ITablePermissionHandler-Funktion, die erlaubt ist für den Nutzer auf diesem Tisch. Serverseitig delegiert dies an das zwischengespeicherte ITablePermissionCache; der WASM-Klient trifft einen HTTP-Endpunkt, der denselben Cache auf dem Server aufruft. Spiegelt die table-cache-Suche Blazors NewRecordGridButton / DeleteRecordGridButton bereits direkt über DI tun, und der neue Wert, den GridDataResponse trägt als TablePermissions — hier sichtbar, damit Konsumenten außerhalb des Grid-Pfades (benutzerdefiniert) Toolbars, bedingte Benutzeroberfläche, 'Kann der Benutzer X erstellen?'-Gatter überall auf der Seite erstellen) Erreiche dieselbe Antwort, ohne eine Raster-Anfrage zu stellen.
`GetTranslationAvailabilityAsync`		Task<TranslationAvailability>	Gibt zurück, ob die Lokalisierungs-Übersetzungsfunktion in der aktuellen Umgebung nutzbar ist: ob der Azure-Übersetzungsdienst konfiguriert ist, ob die Übersetzung verwaltet wurde Die Lösung ist installiert, und die potenziellen Zielsprachen (die vom Portal unterstützten Kulturen annotiert mit Azure-translateability). Unterstützt die Entscheidung der LocalizationTranslator-Benutzeroberfläche Um das Übersetzungspanel anzuzeigen, eine Installationsaufforderung oder gar nichts.
`RetrieveRecordAsync`	string tableLogicalName Guid id IEnumerable<string> columns	Task<TableRecord>	Ruft einen einzelnen Datensatz aus Dataverse anhand von Tabellennamen und Datensatz-ID ab.
`RetrieveRecordsAsync`	string fetchXml	Task<RetrieveRecordsResponse>	Ruft mehrere Datensätze aus Dataverse mithilfe einer FetchXML-Abfrage ab. Unterstützt Filterung, Sortierung, Auslagerung, verknüpfte Entitäten und aggregierte Abfragen.
`RetrieveTableMetadataAsync`	string tableLogicalName	Task<TableMetadata>	Enthält Tabellenmetadaten aus Dataverse, einschließlich Spaltendefinitionen, Beziehungen und Anzeigekonfiguration.
`RetrieveViewMetadataAsync`	Guid viewId	Task<ViewMetadata>	Ruft Ansichtsmetadaten aus Dataverse ab, einschließlich der FetchXML-Abfrage, Spalten und Anzeigekonfiguration der Ansicht.
`RetrieveViewsForTableAsync`	string tableLogicalName	Task<IEnumerable<ViewMetadata>>	Ruft jeden View-Metadaten-Datensatz für eine Tabelle ab. Verwendet von Grids, die es brauchen Listen Sie die verfügbaren Ansichten auf (View-Picker, Standard-Ansichtsauflösung usw.). Die serverseitige Implementierung liest aus dem sich befindlichen IViewMetadataCache; der WASM-Client trifft auf einen HTTP-Endpunkt, der dasselbe auf dem Server tut.
`TranslateLocalizationFileAsync`	TranslationRequest request	Task<TranslationResult>	Maschinell übersetzt eine hochgeladene Lokalisierungsdatei über Azure in eine oder mehrere Zielsprachen Übersetzer, Wiederverwendung des Dataverse-Übersetzungsspeichers und Meldung der Anzahl der Strings Frisch übersetzt versus wiederverwendet. Gibt pro Zielsprache eine Datei plus eine ZIP von allen zurück.
`UpdateRecordAsync`	TableRecord record	Task<UpdateResponse>	Aktualisiert einen bestehenden Datensatz in Dataverse. Nur die im Datensatz gesetzten Eigenschaften werden an Dataverse gesendet.

Name: AssociateAsync

Parameter: TableRecordReference record
string relationshipName
IEnumerable<TableRecordReference> relatedRecords
EntityRole? role

Typ: Task<AssociateResponse>

Beschreibung: Verknüpft einen Eintrag mit einem oder mehreren verwandten Unterlagen durch eine viele-zu-viele-Beziehung.

Name: ClearAllCachesAsync

Typ: Task<IReadOnlyList<CacheClearResult>>

Beschreibung: Löscht jede serverseitige Services.IClearableCache Karte (Tabelle / Ansicht / Privileg) Metadaten, Benutzerrechte, Umgebungsdatei-Einstellungen) und stellt die Lokalisierte Zeichenketten cachen atomar – die Leser sehen weiterhin das zuvor Daten geladen, bis der neue Zustand vollständig besetzt ist. Lazy Caches füllen sich auf der Nächste Anfrage, die sie braucht. Der HTTP-Endpunkt hinter diesem Aufruf wird durch [Authorize(Roles = 'SystemAdmin')]. Serverseitige direkte Anrufer sollten Gitter entsprechend an ihrer eigenen Grenze.

Name: ClearCacheAsync

Parameter: string name

Typ: Task<CacheClearResult>

Beschreibung: Löscht einen benannten Cache. Rückkehrt null , wenn nicht registriert ist Cache-Übereinstimmungen name (Groß- und Kleinschreibungsunempfindlich); Fehler sind eingewickelt im Ergebnis statt weggeworfen. Dasselbe Authentor wie IPowerPortalsProService.ClearAllCachesAsync.

Name: CreateFileArchiveAsync

Parameter: CreateFileArchiveRequest request

Typ: Task<FileArchiveResult>

Beschreibung: Erstellt ein Archiv (derzeit zip; zukünftige Formate leben hinter dem CreateFileArchiveRequest.Format enum) mit allen Aufzeichnungen Dateinutzlast für das benannte Tabellen-/Spaltenpaar. Verwendet dieselbe pro Platte Permission-Chain als String,System.Boolean) — unbefugt / fehlend Reihen werden lautlos aus dem Archiv gestrichen. Doppelte Dateinamen sind eindeutig durch das Suffix '(2)',' (3)', ... Also das Archiv Überschreibt niemals Einträge.

Name: CreateRecordAsync

Parameter: TableRecord record

Typ: Task<CreateResponse>

Beschreibung: Erstellt einen neuen Datensatz in Dataverse.

Name: DeleteRecordAsync

Parameter: string tableLogicalName
Guid id

Typ: Task<DeleteResponse>

Beschreibung: Löscht einen Datensatz aus Dataverse nach Tabellennamen und Datensatz-ID.

Name: DisassociateAsync

Parameter: TableRecordReference record
string relationshipName
IEnumerable<TableRecordReference> relatedRecords
EntityRole? role

Typ: Task<DisassociateResponse>

Beschreibung: Entfernt eine Verbindung zwischen einem Datensatz und einem oder mehreren verwandten Datensätzen über eine viele-zu-viele-Beziehung.

Name: DownloadLocalizationSourceAsync

Parameter: string sourceId
string culture

Typ: Task<LocalizationDownload>

Beschreibung: Lädt die Schlüssel herunter, eine Quelle hat zu einer Kultur beigetragen, während der meisten kürzlich aufgewärmt, als JSON im gleichen Konsumenten mit verschachtelten Objekten app.{culture}.json Dateien verwenden. Für Übersetzungsübergabe vorgesehen — Gib die Datei einem Übersetzer ab, hol eine übersetzte Version zurück und wirf sie hinein einen Lokalisierungsordner, in dem die Originalquelle überschrieben wird für diese Schlüssel bereitgestellt.

Name: DownloadMergedLocalizationsAsync

Parameter: string culture

Typ: Task<LocalizationDownload>

Beschreibung: Lädt die zusammengeführten Lokalisierungsschlüssel für eine Kultur herunter – die Post-Merge Gewinnwert für jeden Schlüssel, den der Cache gespeichert hat, unabhängig davon, welchen Die Quelle lieferte es ursprünglich. Nutzen Sie dies für eine vollständige Momentaufnahme Referenz (alles, was das Portal tatsächlich für diese Kultur dienen wird) und nicht die oben beschriebene Ansicht pro Quelle.

Name: ExecuteAsync

Parameter: OrganizationRequest request

Typ: Task<OrganizationResponse>

Beschreibung: Führt eine einzelne Organisationsanfrage gegen Dataverse aus.

Name: ExecuteMultipleAsync

Parameter: IEnumerable<OrganizationRequest> requests
bool returnResponses

Typ: Task<List<OrganizationResponse>>

Beschreibung: Führt mehrere Organisationsanfragen in einer einzigen Datenbanktransaktion aus. Wenn eine Anfrage fehlschlägt, werden alle Änderungen im Batch zurückgesetzt.

Name: GetCacheNamesAsync

Typ: Task<IReadOnlyList<string>>

Beschreibung: Gibt die Namen aller serverseitigen Services.IClearableCache, passend zurück. für eine Admin-Benutzeroberfläche, die pro Cache Lösch-Buttons rendern will. Gleiches Authentifizierungsgate wie IPowerPortalsProService.ClearAllCachesAsync auf dem HTTP-Endpunkt gilt.

Name: GetFileInfoAsync

Parameter: string tableName
Guid recordId
string columnName
bool includeData

Typ: Task<FileInfo>

Beschreibung: Ruft Dateiinformationen und optional den Binärinhalt aus einer Datei- oder Bildspalte in Dataverse ab.

Name: GetFileInfosAsync

Parameter: string tableName
IEnumerable<Guid> recordIds
string columnName
bool includeData

Typ: Task<IEnumerable<FileInfo>>

Beschreibung: Batch-Abruf von Dateiinformationen für viele Datensätze derselben Tabelle / Spalte in einer einzigen Hin- und Rückfahrt. Intern fächert man die pro Platte parallel ab und gibt die kombinierte Liste zurück. Die gleiche pro-record-Permission-Handler-Kette läuft wie für der Ein-Record-Anruf; Fehlgeschlagene Nachschlage werden aus der Antwort gestrichen, anstatt Ich bin bei der ganzen Charge durchgefallen. Verwendet von FileGrids 'Download All' / 'Download Selected', damit der Client eine zip, ohne N HTTP-Anfragen abzufeuern.

Name: GetLocalizationOverviewAsync

Typ: Task<LocalizationOverview>

Beschreibung: Gibt einen administrativ orientierten Schnappschuss der String-Lokalisierungspipeline zurück: die Statische Konfiguration, die das Aufwärmen sowie die Ladeaufzeichnungen pro Quelle steuerte Produziert durch das letzte Aufwärmen. Unterstützt den LocalizationAdmin Komponente in PowerPortalsPro.Web.Blazor.FluentUI. Der HTTP-Endpunkt wird durch [Authorize(Roles = 'SystemAdmin')] gesperrt.

Name: GetOrganizationSettingsAsync

Typ: Task<OrganizationSettings>

Beschreibung: Ruft die organisationsweiten Einstellungen ab, die aus dem Dataverse stammen Organisationsbilanz : DefaultCurrency – die Basiswährung der Organisation, verwendet im Create-Mode Editoren (MoneyEdit), um das richtige Symbol auf brandneuen Datensätzen darzustellen. BlockedFileExtensions + MaxUploadFileSizeInBytes — Datei-Upload Constraints, die Clients spiegeln, um ungültige Dateien vor dem Roundtrip abzulehnen. Ersetzt die alten GetEnvironmentFileSettingsAsync – die beiden Dateifelder sind nun auf dieser kombinierten Reaktion ausgesetzt.

Name: GetTablePermissionsForCurrentUserAsync

Parameter: string tableLogicalName

Typ: Task<TableSecurityPermission>

Beschreibung: Gibt die kombinierte Tabellen-Maske Models.TableSecurityPermission des aktuellen Benutzers zurück für tableLogicalName — die bitweise Vereinigung von Lesen / Erstellen / Schreiben / Löschen / Anhängen / Anhängen To markiert jede registrierte ITablePermissionHandler-Funktion, die erlaubt ist für den Nutzer auf diesem Tisch. Serverseitig delegiert dies an das zwischengespeicherte ITablePermissionCache; der WASM-Klient trifft einen HTTP-Endpunkt, der denselben Cache auf dem Server aufruft. Spiegelt die table-cache-Suche Blazors NewRecordGridButton / DeleteRecordGridButton bereits direkt über DI tun, und der neue Wert, den GridDataResponse trägt als TablePermissions — hier sichtbar, damit Konsumenten außerhalb des Grid-Pfades (benutzerdefiniert) Toolbars, bedingte Benutzeroberfläche, 'Kann der Benutzer X erstellen?'-Gatter überall auf der Seite erstellen) Erreiche dieselbe Antwort, ohne eine Raster-Anfrage zu stellen.

Name: GetTranslationAvailabilityAsync

Typ: Task<TranslationAvailability>

Beschreibung: Gibt zurück, ob die Lokalisierungs-Übersetzungsfunktion in der aktuellen Umgebung nutzbar ist: ob der Azure-Übersetzungsdienst konfiguriert ist, ob die Übersetzung verwaltet wurde Die Lösung ist installiert, und die potenziellen Zielsprachen (die vom Portal unterstützten Kulturen annotiert mit Azure-translateability). Unterstützt die Entscheidung der LocalizationTranslator-Benutzeroberfläche Um das Übersetzungspanel anzuzeigen, eine Installationsaufforderung oder gar nichts.

Name: RetrieveRecordAsync

Parameter: string tableLogicalName
Guid id
IEnumerable<string> columns

Typ: Task<TableRecord>

Beschreibung: Ruft einen einzelnen Datensatz aus Dataverse anhand von Tabellennamen und Datensatz-ID ab.

Name: RetrieveRecordsAsync

Parameter: string fetchXml

Typ: Task<RetrieveRecordsResponse>

Beschreibung: Ruft mehrere Datensätze aus Dataverse mithilfe einer FetchXML-Abfrage ab. Unterstützt Filterung, Sortierung, Auslagerung, verknüpfte Entitäten und aggregierte Abfragen.

Name: RetrieveTableMetadataAsync

Parameter: string tableLogicalName

Typ: Task<TableMetadata>

Beschreibung: Enthält Tabellenmetadaten aus Dataverse, einschließlich Spaltendefinitionen, Beziehungen und Anzeigekonfiguration.

Name: RetrieveViewMetadataAsync

Parameter: Guid viewId

Typ: Task<ViewMetadata>

Beschreibung: Ruft Ansichtsmetadaten aus Dataverse ab, einschließlich der FetchXML-Abfrage, Spalten und Anzeigekonfiguration der Ansicht.

Name: RetrieveViewsForTableAsync

Parameter: string tableLogicalName

Typ: Task<IEnumerable<ViewMetadata>>

Beschreibung: Ruft jeden View-Metadaten-Datensatz für eine Tabelle ab. Verwendet von Grids, die es brauchen Listen Sie die verfügbaren Ansichten auf (View-Picker, Standard-Ansichtsauflösung usw.). Die serverseitige Implementierung liest aus dem sich befindlichen IViewMetadataCache; der WASM-Client trifft auf einen HTTP-Endpunkt, der dasselbe auf dem Server tut.

Name: TranslateLocalizationFileAsync

Parameter: TranslationRequest request

Typ: Task<TranslationResult>

Beschreibung: Maschinell übersetzt eine hochgeladene Lokalisierungsdatei über Azure in eine oder mehrere Zielsprachen Übersetzer, Wiederverwendung des Dataverse-Übersetzungsspeichers und Meldung der Anzahl der Strings Frisch übersetzt versus wiederverwendet. Gibt pro Zielsprache eine Datei plus eine ZIP von allen zurück.

Name: UpdateRecordAsync

Parameter: TableRecord record

Typ: Task<UpdateResponse>

Beschreibung: Aktualisiert einen bestehenden Datensatz in Dataverse. Nur die im Datensatz gesetzten Eigenschaften werden an Dataverse gesendet.