Catalog- und CatalogAssignment-Tabellen

Artikel
08/24/2023

Verwenden Sie die Katalog- und CatalogAssignment-Tabellen, um eine Struktur zu erstellen, mit der Sie die in Ihrer Lösung verwendeten Aktionen als Geschäftsereignisse darstellen können. Microsoft Dataverse-Geschäftsereignisse ermöglichen viele Szenarien, um Integrationen mit anderen Anwendungen über Dataverse zu erstellen. Weitere Informationen: Microsoft Dataverse-Geschäftsereignisse

In Ihrem Katalog werden die Ereignisse beschrieben, die für Ihre Lösung relevant sind, sodass die Anwender sie nutzen können. Wenn Sie die Ereignisse, die für Ihre Lösung relevant sind, nicht katalogisieren, stehen sie den Anwendern Ihrer Lösung möglicherweise nicht zur Verfügung.

Verwenden Sie die Catalog-Tabelle, um eine zweistufige Hierarchie zu erstellen. Dadurch wird eine Gruppe Katalog und Kategorie erstellt, wobei der Katalog der zweiten Ebene die Kategorie darstellt.

Der Katalog der ersten Ebene muss Ihre Lösung repräsentieren. Verwenden Sie mehrere Kataloge der zweiten Ebene, die sich auf Ihren Katalog der ersten Ebene beziehen, um verschiedene Kategorien von Funktionen innerhalb Ihrer Lösung zu gruppieren.

Für jeden Katalog der zweiten Ebene, der die Kategorien innerhalb Ihrer Lösung darstellt, verwenden Sie die CatalogAssignment Tabelle, um alle Tabellen, Custom-API- oder Custom Process-Aktionen anzugeben, die als Ereignisse verfügbar sein sollen.

Wichtig

Benutzer mit der Sicherheitsrolle Umgebungserstellung können die Katalogdaten im Power Automate Dataverse-Konnektor Bei einer ausgeführten Aktion-Trigger aufrufen. Andere Sicherheitsrollen müssen eine Leseberechtigung auf der entsprechenden Zugriffsebene auf diese Tabellen haben: Benutzerdefinierte API, Prozess, SDK-Nachricht.

Weitere Informationen:

Beispiel: Contoso-Kundenverwaltung

Um die Idee eines Katalogs einzuführen, lassen Sie uns mit einem Beispiel beginnen.

Die Contoso-Kundenverwaltungslösung enthält viele Komponenten. Die einzigen Komponenten, die hier von Interesse sind, sind:

Tabellen
Benutzerdefinierte API
Custom Process Action (Workflow)

Tabellen

Die Contoso-Kundenverwaltung ist eine Lösung, die die folgenden Tabellen umfasst:

Schemaname	Anzeigename	Beschreibung
`Account`	Konto	Eine Dataverse-Systemtabelle
`Contact`	Kontakt	Eine Dataverse-Systemtabelle
`contoso_Membership`	Mitgliedschaft	Eine benutzerdefinierte organisationseigene Tabelle

Benutzerdefinierte API

Sie haben außerdem eine Reihe angepasster API-Aktionen erstellt, die von ihrem Point of Sale-System, ihrer Website und ihren ERP-Systemen aufgerufen werden, um Dataverse über Ereignisse zu informieren, die nicht aus Dataverse stammen:

UniqueName	Anzeigename
`contoso_CustomerEnteredStore`	Laden betreten
`contoso_CustomerVisitWebSite`	Website besuchen
`contoso_CustomerPurchasedProduct`	Gekauftes Produkt
`contoso_CustomerReturnedProduct`	Zurückgegebenes Produkt

Aufbau des Katalogs

Der Lösungskatalog für die Contoso-Kundenverwaltung sieht wie folgt aus:

Katalog	Beschreibung
Contoso-Kundenverwaltung	Stammkatalog
Tabellen	2nd Level Katalog-Kategorie
Konto	CatalogAssignment: Entität
Kontakt	CatalogAssignment: Entität
Mitgliedschaft	CatalogAssignment: Entität
Kundenereignisse	2nd Level Katalog-Kategorie
Store betreten	CatalogAssignment: CustomAPI
Website besuchen	CatalogAssignment: CustomAPI
Produkt kaufen	CatalogAssignment: CustomAPI
Produkt zurückgeben	CatalogAssignment: CustomAPI

Verfügbare Ereignisse

Wenn Sie bei einer Tabelle eine CatalogAssignment-Aktion durchführen, werden einige systemgebundene Vorgänge für diese Tabelle als Ereignisse verfügbar.

Bei diesem Katalog werden die folgenden Ereignisse verfügbar sein:

Tabelle	Veranstaltung	Warum verfügbar
Konto	Erstellen Update Entf	Standard-Datenoperation
Konto	GrantAccess ModifyAccess RevokeAccess	Eine benutzereigene Entität kann geteilt werden.
Kontakt	Erstellen Update Entf	Standard-Datenoperation
Kontakt	GrantAccess ModifyAccess RevokeAccess	Eine benutzereigene Entität kann geteilt werden.
Mitgliedschaft	Erstellen Update Entf	Standard-Datenoperation
N/V	`contoso_CustomerEnteredStore`	Explizite Katalogzuweisung
N/V	`contoso_CustomerVisitWebSite`	Explizite Katalogzuweisung
N/V	`contoso_CustomerPurchasedProduct`	Explizite Katalogzuweisung
N/V	`contoso_CustomerReturnedProduct`	Explizite Katalogzuweisung

Die meisten Tabellen werden die Ereignisse Create, Update und Delete unterstützen. Es gibt einige Ausnahmen. Tabellen im Besitz des Benutzers machen Ereignisse für Änderungen an der Freigabe verfügbar: GrantAccess, ModifyAccess, und RevokeAccess

Hinweis

Alle angepassten Custom-APIs oder Custom Process Actions, die an die Tabelle gebunden sind, werden ebenfalls berücksichtigt.

Benutzerdefinierte Prozessaktionen, die deaktiviert sind, werden angezeigt, das Ereignis tritt jedoch erst auf, wenn sie aktiviert und verwendet werden.

Erzeugen eines Katalogs in Power Apps

Sie können Katalog- und Katalogzuordnungs-Datensätze in Power Apps (https://make.powerapps.com) erstellen.

Sie sollten einen Katalog immer als Teil einer Lösung erstellen. Verwenden Sie die folgenden Anweisungen, um Datensätze für Kataloge zu erstellen:

Melden Sie sich bei Power Apps an,
Wählen Sie im linken Navigationsbereich Lösungen.
Erstellen oder wählen Sie eine Lösung, die Sie verwenden möchten, und klicken Sie dann auf Neu.
Wählen Sie Katalog aus dem Menü und ein neues Fenster wird geöffnet.

Füllen Sie die folgenden Felder aus:

Feld	Beschreibung
Übergeordneter Katalog	Legen Sie keinen übergeordneten Katalog für den Lösungsstammkatalog fest. Legen Sie andernfalls den Lösungsstammkatalog fest.
Eindeutiger Name	Der eindeutige Name muss ein Anpassungspräfix haben und darf keine Leerzeichen enthalten. Dieses Präfix sollte mit dem Anpassungspräfix des Lösungsherausgebers übereinstimmen.
Name	Geben Sie einen Namen für den Katalog ein. Dieser stimmt normalerweise mit Eindeutiger Name überein, jedoch ohne das Anpassungspräfix und mit Leerzeichen.
Anzeigename	Normalerweise stimmt er mit Name überein.
Beschreibung	Geben Sie eine aussagekräftige Beschreibung des Katalogs ein.

Speichert und schließt das Formular.

Erstellen Sie eine Katalogzuweisung in Power Apps

Verwenden Sie dieselbe Lösung, die den Katalog in Power Apps enthält

Klicken Sie auf Neu.
Wählen Sie Katalogzuordnung aus dem Menü aus und ein neues Fenster wird geöffnet.
Geben Sie den Namen ein. Dieser Wert muss mit einem Anpassungspräfix beginnen und darf keine Leerzeichen enthalten. Sie solllten dasselbe Anpassungspräfix verwenden, das für Ihren Lösungsherausgeber festgelegt wurde.
Legen Sie das Katalogzuweisungsobjekt fest. Diese Suche ermöglicht das Festlegen von drei verschiedenen Arten von Datensätzen:
- Benutzerdefinierte APIs
- Entitäten
- Prozesse
Sie sollten in der Lage sein, den gesuchten Typ zu finden, indem Sie den Namen eingeben.
Katalog auswählen

Hinweis

Der ausgewählte Katalog muss ein Katalog der zweiten Ebene sein, der eine Kategorie darstellt.
Formular speichern und schließen

Anpassung von Katalogelementen in Ihrer verwalteten Lösung blockieren

Sofern Sie nicht möchten, dass Personen, die Ihre verwaltete Lösung installieren, den Katalog und die Katalogzuweisungen anpassen können, sollten Sie sicherstellen, dass die IsCustomizable-Eigenschaft auf false gestellt ist, weil sie angepasst werden kannn, wenn der Standardwert eingestellt ist.

So legen Sie dies in der Power Apps-Benutzeroberfläche fest:

Wählen Sie jeden Katalog oder jede Katalogzuordnung innerhalb Ihrer Lösung aus
Klicken Sie im Menü auf die Auslassungspunkte (...) und wählen Sie Verwaltete Eigenschaften aus.
Heben Sie im sich öffnenden Fenster die Auswahl für Anpassungen zulassen auf.
Klicken Sie auf Fertig.

Tabellendiagramm

Das folgende Diagramm zeigt die Beziehung zwischen Catalog- und CatalogAssignment-Tabellen

Catalog- und CatalogAssignment-Tabellendiagramme

Die selbstreferenzielle Beziehung mit ParentCatalogId ermöglicht das Erstellen der zweistufigen Hierarchie zwischen einem Lösungskatalog und mehreren Katalogen, die Kategorien mithilfe von Katalogdatensätzen darstellen.

Katalogtabellenspalten

Alle verfügbaren Spalten und Beziehungen sind in Katalogtabelle/Entität Referenz verfügbar.

Die folgende Tabelle enthält ausgewählte Spalten/Attribute einer Katalogtabelle/Entität, die Sie festlegen können.

Anzeigename `SchemaName` `LogicalName`	Art	Beschreibung
Katalog `CatalogId` `catalogid`	Uniqueidentifier	Eindeutiger Bezeichner für Kataloginstanzen.
Beschreibung `Description` `description`	String	Lokalisierte Beschreibung für Kataloginstanzen. Erforderlich
Anzeigename `DisplayName` `displayname`	String	Lokalisierter Anzeigename für Kataloginstanzen. Erforderlich
Ist anpassbar `IsCustomizable` `iscustomizable`	ManagedProperty	Steuert, ob der Katalog angepasst oder gelöscht werden kann. Der Standardwert ist true. Mehr Informationen: Anpassung von Katalogelementen in Ihrer verwalteten Lösung blockieren Erforderlich
Name `Name` `name`	String	Der primäre Name des Katalogs. Erforderlich
Übergeordneter Katalog `ParentCatalogId` `parentcatalogid`	Suche	Eindeutiger Bezeichner des übergeordneten Katalogs. Kann nach dem Speichern nicht geändert werden.
Eindeutiger Name `UniqueName` `uniquename`	String	Eindeutiger Name für den Katalog. Erforderlich Muss mit einem Anpassungspräfix beginnen.

Hinweis

Wenn Sie eine Katalogzuweisung mit einem Katalog verknüpfen, können Sie den Katalog erst löschen, wenn Sie die Katalogzuweisung entfernen.

CatalogAssignment-Tabellenspalten

Alle verfügbaren Spalten und Beziehungen sind in CatalogAssignment Tabelle/Entität Referenz verfügbar.

Die folgende Tabelle enthält ausgewählte Spalten/Attribute einer CatalogAssignment-Tabelle/Entität, die Sie festlegen können.

Anzeigename `SchemaName` `LogicalName`	Art	Beschreibung
Katalogzuweisung `CatalogAssignmentId` `catalogassignmentid`	Uniqueidentifier	Eindeutiger Bezeichner für Katalogzuordnungsinstanzen.
Katalog `CatalogId` `catalogid`	Suche	Eindeutiger Bezeichner für den Katalog, der mit der Katalogzuordnung verbunden ist. Erforderlich
Ist anpassbar `IsCustomizable` `iscustomizable`	ManagedProperty	Steuert, ob die CatalogAssignment angepasst oder gelöscht werden kann. Der Standardwert ist true. Mehr Informationen: Anpassung von Katalogelementen in Ihrer verwalteten Lösung blockieren Erforderlich
Name `Name` `name`	String	Der primäre Name der Katalogzuordnung.
Katalogzuweisungsobjekt `Object` `object`	Suche	Eindeutiger Bezeichner für das mit der Katalogzuordnung verknüpfte Objekt. Erforderlich Kann nach dem Speichern nicht geändert werden. Dieser polymorphe Lookup kann mit den folgenden Tabellen verknüpft werden: customapi Entität Workflow Wenn Sie die Web-API verwenden, um diese polymorphe Beziehung zu verknüpfen, müssen Sie die Namen der einwertigen Navigationseigenschaften für jede Beziehung verwenden. Diese Namen sind: `CustomAPIId` `EntityId` `WorkflowId` Wenn Sie mit einer Tabelle, Custom-API oder Custom Process Action verknüpfen, müssen Sie den jeweiligen Id-Wert abrufen. Weitere Informationen finden Sie unter Abrufen der Id für CatalogAssignment-Elemente.

Abrufen der Id für CatalogAssignment-Elemente

Sie müssen die Id von Entitäten, Custom-APIs und Custom Process Actions abrufen, wenn Sie diese mit einer CatalogAssignment verknüpfen.

Abrufen der Id einer Tabelle

Die Entitätstabelle enthält eine Zeile für jede Tabelle. Sie können die Id einer bestimmten Tabelle, z. B. der Tabelle „Account“, mit einer der folgenden Abfragen über die Web-API abrufen:

GET [Organization URI]/api/data/v9.2/EntityDefinitions(LogicalName='account')?$select=MetadataId

GET [Organization URI]/api/data/v9.2/entities?$select=entityid&$filter=name eq 'Account'

Abrufen der Id einer Custom-API

Dies ist am einfachsten über die Web-API möglich. Das folgende Beispiel gibt die customapiid einer angepassten API mit der uniquename von your_CustomAPIName zurück.

GET [Organization URI]/api/data/v9.2/customapis?$select=customapiid&$filter=uniquename eq 'your_CustomAPIName'

Abrufen der Id einer Custom Process Action

Dies ist am einfachsten über die Web-API möglich. Das folgende Beispiel gibt die workflowid einer angepassten Custom Process Action mit der uniquename von ExampleCustomProcessAction zurück.

GET [Organization URI]/api/data/v9.2/workflows?$select=workflowid,uniquename&$filter=category eq 3 and type eq 1 and endswith(uniquename,'ExampleCustomProcessAction')

Hinweis

Die uniquename des Workflows enthält nicht das Anpassungspräfix, das dem Namen der Custom Process Action in der Web-API vorangestellt ist. Wenn die Aktion, die Sie über die Web-API aufrufen, new_ExampleCustomProcessAction heißt, lautet der eindeutige Name des Workflows ExampleCustomProcessAction.

Stellen Sie sicher, dass Sie auf die Zeile zugreifen, in der Typ 1 ist. Dies ist die Workflowdefinition.

Custom Process Action Workflows haben den Kategorie-Wert 3.

Vorhandene Katalogzuweisungen abrufen

Sie können die folgende OData-Abfrage verwenden, um Informationen über Katalogzuweisungen, den Zuweisungstyp, den Katalog, dem sie zugeordnet sind, und den übergeordneten Katalog abzurufen.

GET [Organization URI]/api/data/v9.2/catalogassignments?$select=name
    &$expand=CatalogId($select=uniquename;$expand=ParentCatalogId($select=uniquename)),
    EntityId($select=entityid),
    CustomAPIId($select=uniquename),
    WorkflowId($select=uniquename)
    &$filter=name ne null

Kataloge und CatalogAssignments mit Code erstellen

Sie können Kataloge und Katalogzuordnungs-Datensätze entweder über die Web-API oder SDK für .NET erstellen.

Verwenden der Web-API

Hinweis

Zur Zeit ist es nicht möglich, Datensätze für Kataloge und Katalogzuordnungen mit 'deep-insert' zu erstellen.

Sie können mit „deep-Insert“ eine Hierarchie von Katalogdatensätzen erstellen, müssen die Katalogzuordnungen jedoch einzeln erstellen.

Die folgende Reihe von Web-API-Vorgängen erstellt eine Kataloghierarchie und ein CatalogAssignment in einer Lösung mit dem UniqueName: ContosoCustomerManagement. Beachten Sie die Verwendung des Anfrage-Headers MSCRM.SolutionUniqueName, um die Zuordnung zur Lösung festzulegen, wenn der Datensatz erstellt wird.

Siehe Tabelle die Abschnitte Erstellen eines Datensatzes mit der Web-API: Grundlegendes Erstellen und Zuordnen von Tabellenzeilen beim Erstellen für weitere Informationen.

Erstellen Sie den Stammkatalog

Anforderung:

POST [Organization URI]/api/data/v9.2/catalogs HTTP/1.1
MSCRM.SolutionUniqueName: ContosoCustomerManagement
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json
{
    "name": "Contoso Customer Management",
    "uniquename": "contoso_CustomerManagement",
    "displayname": "Contoso Customer Management",
    "description": "The root catalog for the Contoso Customer Management solution",
    "iscustomizable": {
        "Value": false
    }
}

Antwort:

HTTP/1.1 204 No Content
OData-EntityId: [Organization URI]/api/data/v9.2/catalogs(00000000-0000-0000-0000-000000000001)

Erzeugen Sie den Unterkatalog für die Tabelle Ereignisse

Anforderung:

POST [Organization URI]/api/data/v9.2/catalogs HTTP/1.1
MSCRM.SolutionUniqueName: ContosoCustomerManagement
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json
{
    "name": "Contoso Customer Management Table Events",
    "uniquename": "contoso_TableEvents",
    "displayname": "Tables",
    "description": "Groups Table events for the Contoso Customer Management Solution",
    "iscustomizable": {
        "Value": false
    },
    "ParentCatalogId@odata.bind": "catalogs(00000000-0000-0000-0000-000000000001)"
}

Antwort:

HTTP/1.1 204 No Content
OData-EntityId: [Organization URI]/api/data/v9.2/catalogassignments(00000000-0000-0000-0000-000000000002)

Erzeugen Sie die Zuordnung des Kontokatalogs zum Tabellenkatalog

Informationen über die Id einer Tabelle finden Sie unter Abfragen der Id einer Tabelle.

Anforderung:

POST [Organization URI]/api/data/v9.2/catalogassignments HTTP/1.1
MSCRM.SolutionUniqueName: ContosoCustomerManagement
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json
{
    "name": "Account",
    "EntityId@odata.bind": "entities(70816501-edb9-4740-a16c-6a5efbc05d84)",
    "iscustomizable": {
        "Value": false
    },
    "CatalogId@odata.bind": "catalogs(00000000-0000-0000-0000-000000000002)"
}

Antwort:

HTTP/1.1 204 No Content
OData-EntityId: [Organization URI]/api/data/v9.2/catalogassignments(00000000-0000-0000-0000-000000000003)

Verwenden des SDK für .NET

Der folgende Code zeigt das Erstellen einer Kataloghierarchie und einer Katalogzuordnung in einer Lösung mit dem UniqueName: ContosoCustomerManagement.

Hinweis

Verwenden Sie den optionalen Parameter SolutionUniqueName mit der CreateRequest-Klasse, um die Datensätze im Kontext dieser Lösung zu erstellen. Weitere Informationen: Übergabe optionaler Parameter mit einer Anfrage

string conn = $@"
Url = {url};
AuthType = OAuth;
UserName = {userName};
Password = {password};
AppId = 51f81489-12ee-4a9e-aaae-a2591f45987d;
RedirectUri = app://58145B91-0C36-4500-8554-080854F2AC97;
LoginPrompt=Auto;
RequireNewInstance = True";

var service = new CrmServiceClient(conn);
// var service = new ServiceClient(conn);

var solutionUniqueName = " ContosoCustomerManagement ";

//Create the root catalog
Catalog rootCatalog = new Catalog
{
    Name = "Contoso Customer Management",
    UniqueName = "contoso_CustomerManagement",
    DisplayName = "Contoso Customer Management",
    Description = "The root catalog for the Contoso Customer Management solution",
    IsCustomizable = new BooleanManagedProperty(false)
};

CreateRequest rootCatalogReq = new CreateRequest {
    Target = rootCatalog
};
rootCatalogReq["SolutionUniqueName"] = solutionUniqueName;

Guid rootCatalogId = ((CreateResponse)service.Execute(rootCatalogReq)).id;

//Create the Table Events Sub-catalog
Catalog tableEvents = new Catalog
{
    Name = "Contoso Customer Management Table Events",
    UniqueName = "contoso_TableEvents",
    DisplayName = "Tables",
    Description = "Groups Table events for the Contoso Customer Management Solution",
    IsCustomizable = new BooleanManagedProperty(false),
    ParentCatalogId = new EntityReference("catalog", rootCatalogId)
};

CreateRequest tableEventsReq = new CreateRequest
{
    Target = tableEvents
};
tableEventsReq["SolutionUniqueName"] = solutionUniqueName;

Guid tableEventsId = ((CreateResponse)service.Execute(tableEventsReq)).id;

//Create the Account Catalog Assignment on the Tables catalog
CatalogAssignment accountAssignment = new CatalogAssignment
{
    Name = "Account",
    IsCustomizable = new BooleanManagedProperty(false),
    Object = new EntityReference("entity",new Guid("70816501-edb9-4740-a16c-6a5efbc05d84")),
    CatalogId = new EntityReference("catalog", tableEventsId)

};

CreateRequest accountAssignmentReq = new CreateRequest
{
    Target = accountAssignment
};
accountAssignmentReq["SolutionUniqueName"] = solutionUniqueName;

Guid accountAssignmentId = ((CreateResponse)service.Execute(accountAssignmentReq)).id;

Erstellen von Katalogen und Katalog-Zuordnungen durch Bearbeiten von Lösungsdateien

Innerhalb einer Lösungsdatei können Sie die Dateien bearbeiten, um Kataloge und Katalogzuordnungen zu erstellen.

Verwenden Sie das SolutionPackager Tool, um eine Projektmappe in Dateien zu extrahieren, die in der Versionsverwaltung verwaltet werden können. Anschließend können Sie die Dateien bearbeiten. Anschließend können Sie den SolutionPackager verwenden, um die extrahierten Dateien wieder in eine Projektmappe zu packen. Weitere Informationen: Steuerelemente mit Lösungsdateien

Tipp

Erstellen Sie einige Kataloge und Katalogzuweisungen in einer Lösung, und exportieren und extrahieren Sie dann die Lösung, um einige Beispiele anzuzeigen.

Stellen Sie sicher, dass Sie die neueste Version des Microsoft.CrmSdk.CoreTools NuGet Pakets verwenden

Erzeugen eines Katalogs mit Lösungsdateien

Innerhalb einer Projektmappe werden alle Kataloge in einem catalogs-Ordner liegen. Sie können Kataloge erstellen, ändern oder entfernen, indem Sie die Ordner und Dateien in diesem Ordner bearbeiten und die Lösung importieren, nachdem sie mit Solution Packager gepackt wurde.

Jeder Katalog wird in einem Ordner enthalten sein, der dem uniquename des Katalogs entspricht, wie z. B. contoso_CustomerManagement.

Innerhalb des Ordners ist eine catalog.xml-Datei mit der Definition des Katalogs enthalten.

Beispiel: ''

<catalog uniquename="contoso_CustomerManagement">
    <description default="The root catalog for the Contoso Customer Management solution">
        <label description="The root catalog for the Contoso Customer Management solution" languagecode="1033" />
    </description>
    <displayname default="Contoso Customer Management">
        <label description="Contoso Customer Management" languagecode="1033" />
    </displayname>
    <iscustomizable>0</iscustomizable>
    <name>Contoso Customer Management</name>
</catalog>

Das uniquename-Attribut des catalog-Elements muss mit dem Namen des Ordners übereinstimmen, der die Datei enthält.

Das catalog-Element enthält diese Elemente:

Element	Beschreibung
`description`	Hat ein `default`-Attribut mit dem Wert der Standardbeschreibung. Enthält einen oder mehrere `label`-Elemente mit Attributen für `description` und `languagecode`, wenn mehrere Sprachen definiert sind.
`displayname`	Hat ein `default`-Attribut mit dem Wert des Standardanzeigenamens. Enthält einen oder mehrere `label`-Elemente mit Attributen für `description` und `languagecode`, wenn mehrere Sprachen definiert sind.
`iscustomizable`	Ob der Katalog anpassbar ist. 0 = `false`, 1 = `true`.
`name`	Der Name des Katalogs.

Wenn der Katalog eine Kategorie darstellt, wird die Beziehung zum übergeordneten Katalog mithilfe eines parentcatalogid-Elements aufgenommen, das ein uniquename-Element enthält, das wiederum den eindeutigen Namen des übergeordneten Katalogs enthält.

Beispiel: ''

<catalog uniquename="contoso_TableEvents">
    <description default="Groups Table events for the Contoso Customer Management Solution">
        <label description="Groups Table events for the Contoso Customer Management Solution" languagecode="1033" />
    </description>
    <displayname default="Tables">
        <label description="Tables" languagecode="1033" />
    </displayname>
    <iscustomizable>0</iscustomizable>
    <name>Contoso Customer Management Table Events</name>
    <parentcatalogid>
        <uniquename>contoso_CustomerManagement</uniquename>
    </parentcatalogid>
</catalog>

Erstellen eines CatalogAssignments mit Lösungsdateien

Innerhalb einer Projektmappe, im Ordner Assets, finden Sie eine Datei catalogassignments.xml. Alle Katalogzuordnungen sind in der Datei enthalten. Sie können Katalogzuweisungen erstellen oder ändern, indem Sie diese Datei bearbeiten und die Lösung importieren, nachdem sie mit Solution Packager gepackt wurde.

Beispiel: ''

<catalogassignments>
    <catalogassignment object.logicalname="account" catalogid.uniquename="contoso_TableEvents" objectidtype="entity">
        <iscustomizable>0</iscustomizable>
        <name>Account</name>
    </catalogassignment>
    <catalogassignment catalogid.uniquename="contoso_CustomerEvents" object.uniquename="contoso_CustomerEnteredStore" objectidtype="customapi">
        <iscustomizable>0</iscustomizable>
        <name>Customer Entered Store</name>
  </catalogassignment>
</catalogassignments>

Jedes catalogassignment-Element hat diese Attribute:

Attribut	Beschreibung
`catalogid.uniquename`	Eindeutiger Name des Unterkatalogs, für den die Katalogzuweisung gedacht ist.
`objecttypeid`	Der Typ des Objekts. Gültige Werte sind: `entity` `customapi` `workflow`

Abhängig von der objectypeid muss jedes catalogassignment-Element eines dieser entsprechenden Attribute haben:

Attribut	Beschreibung
`object.uniquename`	Der eindeutige Name der benutzerdefinierten API.
`object.logicalname`	Der logische Name der Entität.
`object.workflowid`	Der eindeutige ID-Wert der benutzerdefinierten Prozessaktion.

Das catalogassignment-Element enthält diese Elemente:

Element	Beschreibung
`iscustomizable`	Ob die Katalogzuweisung anpassbar ist. 0 = `false`, 1 = `true`.
`name`	Der Name der Katalogzuweisung

Siehe auch

Microsoft Dataverse Geschäftsereignisse
Abrufen eines Entitätsdatensatzes mit der Web-API
Abrufen eines Entitätsdatensatzes mit der Web-API
Erstellen von Entitäten mit dem SDK für .NET
Abrufen einer Entität mithilfe des SDK für .NET

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).

Catalog- und CatalogAssignment-Tabellen

Beispiel: Contoso-Kundenverwaltung

Tabellen

Benutzerdefinierte API

Aufbau des Katalogs

Verfügbare Ereignisse

Erzeugen eines Katalogs in Power Apps

Erstellen Sie eine Katalogzuweisung in Power Apps

Anpassung von Katalogelementen in Ihrer verwalteten Lösung blockieren

Tabellendiagramm

Katalogtabellenspalten

CatalogAssignment-Tabellenspalten

Abrufen der Id für CatalogAssignment-Elemente

Abrufen der Id einer Tabelle

Abrufen der Id einer Custom-API

Abrufen der Id einer Custom Process Action

Vorhandene Katalogzuweisungen abrufen

Kataloge und CatalogAssignments mit Code erstellen

Verwenden der Web-API

Erstellen Sie den Stammkatalog

Erzeugen Sie den Unterkatalog für die Tabelle Ereignisse

Erzeugen Sie die Zuordnung des Kontokatalogs zum Tabellenkatalog

Verwenden des SDK für .NET

Erstellen von Katalogen und Katalog-Zuordnungen durch Bearbeiten von Lösungsdateien

Erzeugen eines Katalogs mit Lösungsdateien

Erstellen eines CatalogAssignments mit Lösungsdateien

Siehe auch

Feedback

Zusätzliche Ressourcen