Verwenden von Metadaten mit CodeWork with metadata using code

Sowohl die Web-API als auch der Organisationsservice enthalten Funktionen für CRUD-Vorgänge auf dem Entitätsschema.Both the Web API and the Organization service include capabilities to perform CRUD operations on the entity schema. Sie können diese Vorgänge mithilfe von Code ausführen. Im Allgemeinen verwenden Sie Designer, um benutzerdefinierte Schemaelemente hinzuzufügen, zu aktualisieren oder zu löschen.While you can perform these operations using code, generally you will use designers to add, update, or delete custom schema elements. Benutzer müssen Administratorberechtigungen haben, um Schemaänderungen anzuwenden, aber alle Benutzer können Metadaten lesen.Users must have administrator privileges to apply schema changes, but all users can read metadata.

Warum mit Metadaten arbeiten?Why work with metadata?

Ein allgemeinerer Einsatz für Metadatendienste ist das Abrufen von Metadaten zur Umgebung, in der die Erweiterung ausgeführt wird.A more common use for the metadata services is to retrieve metadata about the environment that your extension is running within. Da jede Umgebung anders sein kann und Schemametadaten viele Informationen darüber enthalten, wie die Umgebung konfiguriert ist, müssen Sie diese Informationen abrufen, um zu ermöglichen, dass Ihre Erweiterungen sich an andere Anpassungen anpassen, die in dieser Umgebung wirksam sind.Because every environment can be different and schema metadata contains much of the information about how the environment is configured, you may need to retrieve this information to allow for your extensions to adapt to other customizations that are in effect in that environment.

Einige Beispiele:Some examples:

  • Die Gesamtanzahl der verfügbaren Optionen in einem Optionssatz kann sich ändern.The number of options available in an optionset attribute can change. Anstelle die Wert in einer Umgebung fest zu kodieren, sollten Sie beachten, ob verschiedene Optionen vorhanden sind.Rather than hard-code the values in your environment, consider whether different options are present. Sie können das System abfragen, um zu ermitteln, ob in der Umgebung verschiedene Optionen sind.You can query the system to determine whether the current environment has different options.
  • Der Anzeigename einer Entität kann geändert werden.The display name for an entity can be changed. Der Standardanzeigename für die Firmenentität ist Firma.The default display name for the account entity is Account. Dies könnte zu Unternehmen geändert werden.This could be changed to Company. Wenn Sie einem Benutzer eine Nachricht anzeigen und auf den Namen der Entität verweisen möchten, sollten Sie nicht fest kodieren, sondern den Wert nutzen, der mit dem übereinstimmt, was der Benutzer gewohnt ist zu sehen und den Anzeigenamen verwenden, der von den Entitätsmetadaten abgerufen wurde.If you want to display a message to a user and refer to the name of an entity, you should not hard-code this but instead use the value that matches what the user is accustomed to seeing and use the display name retrieved from the entity metadata instead.

Durchsuchen der Metadaten für die OrganisationBrowse the metadata for your organization

Ein gutes Verständnis der Metadaten im System hilft dabei zu verstehen, wie die Common Data Service-Plattform funktioniert.Developing a good working understanding of the metadata in the system can help you understand how Common Data Service platform works. Die Designer, die zum Bearbeiten der Metadaten verfügbar sind, können nicht alle Details anzeigen, die in den Metadaten gefunden werden.The designers available to edit metadata cannot show all the details found in the metadata. Sie können eine modellgesteuerte App mit dem Namen Browser für Metadaten installieren, die es Ihnen ermöglicht, alle ausgeblendeten Entitäten- und Metadateneigenschaften anzuzeigen, die im System vorhanden sind.You can install a model-driven app called the Metadata Browser which will allow you to view all the hidden entities and metadata properties that are found in the system. Weitere Informationen zu Browser für Metadaten: Durchsuchen der Metadaten für Ihre OrganisationMore information about the Metadata Browser: Browse the metadata for your organization

Programmtechnisch mit Metadaten arbeitenProgrammatically work with metadata

Weitere Informationen zum programmgesteuerten Arbeiten mit Metadaten mittels:For more information about programmatically working with metadata using: