# Referenzdokument Darstellungsfelder Eine Liste der verfügbaren Darstellungsfelder für Stripe-Apps und wie sie Ihren Endnutzer/innen erscheinen. Ein Darstellungsfeld gibt die Seite im Dashboard an, auf der Ihre Ansicht erscheinen kann. Ein Darstellungsfeld kann ein `environment.objectContext`-Objekt bereitstellen, mit dem Sie Kontext zum Stripe-Objekt einer aktuellen Seite erhalten können. Weitere Informationen finden Sie unter [Zugriff auf Stripe-Objekte im Dashboard](https://docs.stripe.com/stripe-apps/build-ui.md#access-stripe-objects). Verfügbare Darstellungsfelder für Ihre Erweiterung der Nutzeroberfläche: | Darstellungsfeld-ID | Seite | URLs | Objekttyp | | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | -------------------------- | | **`stripe.dashboard.payment.list`** | Zahlungsseite | `dashboard.stripe.com/payments` | `null` | | **`stripe.dashboard.payment.detail`** | Seite mit Zahlungsdetails | `dashboard.stripe.com/payments/:id` | `charge`, `payment_intent` | | **`stripe.dashboard.customer.list`** | Seite „Kund/innen“ | `dashboard.stripe.com/customers` | `null` | | **`stripe.dashboard.customer.detail`** | Seite mit Details zum Kunden/zur Kundin | `dashboard.stripe.com/customers/:id` | `customer` | | **`stripe.dashboard.invoice.list`** | Seite „Rechnungen“ | `dashboard.stripe.com/invoices` | `null` | | **`stripe.dashboard.invoice.detail`** | Seite mit Rechnungsdetails | `dashboard.stripe.com/invoices/:id` | `invoice` | | **`stripe.dashboard.product.list`** | Produktseite | `dashboard.stripe.com/products/` | `null` | | **`stripe.dashboard.product.detail`** | Seite mit Produktdetails | `dashboard.stripe.com/products/:id` | `product` | | **`stripe.dashboard.subscription.list`** | Abonnementseite | `dashboard.stripe.com/subscriptions` | `null` | | **`stripe.dashboard.subscription.detail`** | Seite mit Abodetails | `dashboard.stripe.com/subscriptions/:id` | `subscription` | | **`stripe.dashboard.payment-link.list`** | Payment Links-Seite | `dashboard.stripe.com/payment-links` | `null` | | **`stripe.dashboard.payment-link.detail`** | Detailseite zu Payment Link | `dashboard.stripe.com/payment-links/:id` | `payment_link` | | **`stripe.dashboard.home.overview`** | Startseite des Dashboards | `dashboard.stripe.com/dashboard` | `null` | | **`stripe.dashboard.balance.overview`** | Guthabenseite | `dashboard.stripe.com/balance/overview` | `null` | | **`stripe.dashboard.billing.overview`** | Abrechnungsseite | `dashboard.stripe.com/billing` | `null` | | **`stripe.dashboard.report.overview`** | Berichte > Übersichtsseite | `dashboard.stripe.com/reports/hub` | `null` | | **`stripe.dashboard.revenue-recognition.overview`** | Seite zur Umsatzrealisierung | `dashboard.stripe.com/revenue-recognition` | `null` | | **`stripe.dashboard.shipping-rates.list`** | Seite mit Versandkosten | `dashboard.stripe.com/shipping-rates` | `null` | | **`stripe.dashboard.shipping-rates.detail`** | Seite mit Details zu Versandkosten | `dashboard.stripe.com/shipping-rates/:id` | `shipping_rate` | | **`stripe.dashboard.tax-report.overview`** | Berichte > „Steuern“ | `dashboard.stripe.com/tax/reporting` | `null` | | **`stripe.dashboard.drawer.default`** | Verfügbar für alle Seiten (weitere Informationen finden Sie unter [Verfügbarkeit im gesamten Dashboard](https://docs.stripe.com/stripe-apps/reference/viewports.md#dashboard-wide-availability)) | `null` | | | **`onboarding`** | Es wird festgelegt, wie Ihre Nutzerinnen und Nutzer nach der Installation eingerichtet werden. Mit der Komponente `OnboardingView` als Hauptelement wird der Vorgang in einem Modal-Fenster angezeigt. Weitere Informationen finden Sie im [OnboardingView](https://docs.stripe.com/stripe-apps/components/onboardingview.md)-Leitfaden. | `null` | | | **`settings`** | Einstellungsseite der App (Weitere Informationen finden Sie unter [App-Einstellungen hinzufügen](https://docs.stripe.com/stripe-apps/app-settings.md).) | `null` | | ## App-Verfügbarkeit Sie können Ihre Anwendung auf allen Seiten oder speziell für eine einzelne Seite im Dashboard zur Verfügung stellen. ### Verfügbarkeit im gesamten Dashboard Wenn Ihre App eine Ansicht für das Darstellungsfeld `stripe.dashboard.drawer.default` bereitstellt, wird diese Ansicht auf jeder Seite im Dashboard angezeigt, außer dort, wo Sie seitenspezifische Ansichten definiert haben. Wenn das Feld `ui_extension.views` im `stripe-app.json`-Manifest Ihrer App beispielsweise wie folgt lautet: ```json { "id": "com.example.app", "version": "1.2.3", "name": "Example App", "icon": "./example_icon_32.png", "permissions": [ { "permission": "customer_read", "purpose": "Receive access to the customer information" } ],"ui_extension": { "views": [ { "viewport": "stripe.dashboard.customer.detail", "component": "CustomerView" }, { "viewport": "stripe.dashboard.drawer.default", "component": "EverywhereElseView" } ] } } ``` „CustomerView“ würde angezeigt, wenn die Anwendung auf der Kundendetailseite geöffnet ist, und „EverywhereElseView“ würde auf jeder anderen Seite im Dashboard angezeigt. Die Ansicht `stripe.dashboard.drawer.default` empfängt keine `objectContext`-Daten, wie dies bei einer seitenspezifischen Ansicht der Fall ist. Wenn Ihre App auf Informationen wie die `id` einer Rechnung zugreifen muss, die auf einer Seite mit „Rechnungsdetails“ angezeigt wird, müssen Sie eine Ansicht erstellen, die den Darstellungsbereich `stripe.dashboard.invoice.detail` verwendet. Weitere Informationen finden Sie unter [Seitenspezifische Verfügbarkeit](https://docs.stripe.com/stripe-apps/reference/viewports.md#page-specific-availability). ### Seitenspezifische Verfügbarkeit Seitenspezifische Ansichten beziehen sich auf die aktuell aufgerufene Seite und ermöglichen es Apps, über die Eigenschaft `environment` zusätzlichen Kontext über die Seite zu erhalten. Weitere Informationen finden Sie unter [Zugriff auf Stripe-Objekte im Dashboard](https://docs.stripe.com/stripe-apps/build-ui.md#access-stripe-objects). Wenn Ihre App zum Beispiel über eine Ansicht für das Darstellungsfeld `stripe.dashboard.product.detail` verfügt und ein/e Nutzer/in Ihre App auf der Seite „Produktdetails“ öffnet, wird diese Ansicht in der App angezeigt. Wenn Ihre App weder über eine seitenspezifische Ansicht für die aktuelle Seite noch über eine App-spezifische Standardansicht verfügt, wird eine allgemeine Standardansicht angezeigt, die dem/der Nutzer/in den Zugriff auf die App veranschaulicht. Wenn Ihre App beispielsweise über zwei Ansichten auf seitenspezifischen Darstellungsfeldern verfügt, die im folgenden App-Manifest angezeigt werden: ```json { "id": "com.example.app", "version": "1.2.3", "name": "Example App", "icon": "./example_icon_32.png", "permissions": [ { "permission": "customer_read", "purpose": "Receive access to the customer information" } ],"ui_extension": { "views": [ { "viewport": "stripe.dashboard.customer.detail", "component": "CustomerView" }, { "viewport": "stripe.dashboard.product.detail", "component": "ProductView" } ] } } ``` Wenn die Endnutzer/innen Ihre App auf der Startseite des Dashboards öffnen, werden Links zu den Seiten „Kund/innen“ und „Produkte“ angezeigt. Wenn die Nutzer/innen dann die Kundenseite aufrufen, zeigt die App eine Meldung an, in der sie aufgefordert werden, einen Kunden/eine Kundin auszuwählen, um zugehörige Informationen in Ihrer App anzuzeigen. ## See also - [App gestalten](https://docs.stripe.com/stripe-apps/design.md) - [Funktionsweise von Nutzeroberflächen-Erweiterungen](https://docs.stripe.com/stripe-apps/how-ui-extensions-work.md) - [Dokumentation zu Berechtigungen](https://docs.stripe.com/stripe-apps/reference/permissions.md) - [Dokumentation zu Erweiterungs-SDK für die Nutzeroberfläche](https://docs.stripe.com/stripe-apps/reference/extensions-sdk-api.md)