CardFactory class

Paket:

botbuilder-core

Stellt Methoden zum Formatieren der verschiedenen Kartentypen bereit, die ein Bot zurückgeben kann.

Hinweise

Alle diese Funktionen geben ein Attachment-Objekt zurück, das den Anlagen einer vorhandenen Aktivität Auflistung direkt hinzugefügt oder als Eingabe an eine der MessageFactory Methoden zum Generieren einer neuen Aktivität übergeben werden kann.

In diesem Beispiel wird eine Nachricht gesendet, die eine einzelne Hero-Karte enthält.

const { MessageFactory, CardFactory } = require('botbuilder');

const card = CardFactory.heroCard(
     'White T-Shirt',
     ['https://example.com/whiteShirt.jpg'],
     ['buy']
);
const message = MessageFactory.attachment(card);
await context.sendActivity(message);

Eigenschaften

contentTypes

Listet das Inhaltstypschema für jede Kartenformatvorlage auf.

Methoden

actions(string | CardAction[] | undefined)	Gibt ein ordnungsgemäß formatiertes Array von Aktionen zurück.
adaptiveCard(any)	Gibt eine Anlage für eine adaptive Karte zurück.
animationCard(string, string | MediaUrl[], string | CardAction[], Partial<AnimationCard>)	Gibt eine Anlage für eine Animationskarte zurück.
audioCard(string, string | MediaUrl[], string | CardAction[], Partial<AudioCard>)	Gibt eine Anlage für eine Audiokarte zurück.
heroCard(string, string | CardImage[], string | CardAction[], Partial<HeroCard>)	Gibt eine Anlage für eine Hero-Karte zurück.
heroCard(string, string, string | CardImage[], string | CardAction[], Partial<HeroCard>)	Gibt eine Anlage für eine Hero-Karte zurück.
images(string | CardImage[] | undefined)	Gibt ein ordnungsgemäß formatiertes Array von Kartenbildern zurück.
media(string | MediaUrl[] | undefined)	Gibt ein ordnungsgemäß formatiertes Array von Medien-URL-Objekten zurück.
o365ConnectorCard(O365ConnectorCard)	Gibt eine Anlage für eine Office 365-Verbinderkarte zurück.
oauthCard(string, string, string, string, TokenExchangeResource)	Gibt eine Anlage für eine OAuth-Karte zurück.
receiptCard(ReceiptCard)	Gibt eine Anlage für eine Belegkarte zurück.
signinCard(string, string, string)	Gibt eine Anlage für eine Anmeldekarte zurück.
thumbnailCard(string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)	Gibt eine Anlage für eine Miniaturansichtskarte zurück.
thumbnailCard(string, string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)	Gibt eine Anlage für eine Miniaturansichtskarte zurück.
videoCard(string, string | MediaUrl[], string | CardAction[], Partial<VideoCard>)	Gibt eine Anlage für eine Grafikkarte zurück.

Details zur Eigenschaft

contentTypes

Listet das Inhaltstypschema für jede Kartenformatvorlage auf.

static contentTypes: any

Eigenschaftswert

any

Details zur Methode

actions(string | CardAction[] | undefined)

Gibt ein ordnungsgemäß formatiertes Array von Aktionen zurück.

static function actions(actions: string | CardAction[] | undefined): CardAction[]

Parameter

actions

string | CardAction[] | undefined

Das Array der Aktion, die auf der Karte enthalten sein soll. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

Gibt zurück

CardAction[]

Ein ordnungsgemäß formatiertes Array von Aktionen.

adaptiveCard(any)

Gibt eine Anlage für eine adaptive Karte zurück.

static function adaptiveCard(card: any): Attachment

Parameter

card

any

Eine Beschreibung der zurückzugebenden adaptiven Karte.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Adaptive Karten sind ein offenes Kartenaustauschformat, mit dem Entwickler UI-Inhalte auf gemeinsame und konsistente Weise austauschen können. Bei Kanälen, die adaptive Karten noch nicht nativ unterstützen, rendert das Bot-Framework die Karte auf ein Bild herunter, das formatiert wurde, um im Zielkanal gut zu aussehen. Für Kanäle, die Herokarten unterstützen können Sie weiterhin Adaptive Kartenaktionen einschließen und sie werden zusammen mit der gerenderten Version der Karte als Schaltflächen gesendet.

Weitere Informationen zu adaptiven Karten und zum Herunterladen des neuesten SDK finden Sie unter adaptivecards.io.

Zum Beispiel:

const card = CardFactory.adaptiveCard({
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
      {
         "type": "TextBlock",
         "text": "Default text input"
      }
  ],
  "actions": [
      {
         "type": "Action.Submit",
         "title": "OK"
      }
  ]
});

animationCard(string, string | MediaUrl[], string | CardAction[], Partial<AnimationCard>)

Gibt eine Anlage für eine Animationskarte zurück.

static function animationCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<AnimationCard>): Attachment

Parameter

title

string

Der Kartentitel.

media

string | MediaUrl[]

Die Medien-URLs für die Karte.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<AnimationCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.

audioCard(string, string | MediaUrl[], string | CardAction[], Partial<AudioCard>)

Gibt eine Anlage für eine Audiokarte zurück.

static function audioCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<AudioCard>): Attachment

Parameter

title

string

Der Kartentitel.

media

string | MediaUrl[]

Die Medien-URL für die Karte.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<AudioCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.

heroCard(string, string | CardImage[], string | CardAction[], Partial<HeroCard>)

Gibt eine Anlage für eine Hero-Karte zurück.

static function heroCard(title: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<HeroCard>): Attachment

Parameter

title

string

Der Kartentitel.

images

string | CardImage[]

Wahlfrei. Das Array von Bildern, die auf der Karte enthalten sein sollen. Jedes Element kann ein CardImage- oder die URL des einzuschließden Bilds sein.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<HeroCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Herokarten weisen tendenziell ein dominantes Bild mit voller Breite auf. Kanäle rendern in der Regel den Text und die Schaltflächen der Karte unterhalb des Bilds.

Zum Beispiel:

const card = CardFactory.heroCard(
     'White T-Shirt',
     ['https://example.com/whiteShirt.jpg'],
     ['buy']
);

heroCard(string, string, string | CardImage[], string | CardAction[], Partial<HeroCard>)

Gibt eine Anlage für eine Hero-Karte zurück.

static function heroCard(title: string, text: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<HeroCard>): Attachment

Parameter

title

string

Der Kartentitel.

text

string

Der Kartentext.

images

string | CardImage[]

Wahlfrei. Das Array von Bildern, die auf der Karte enthalten sein sollen. Jedes Element kann ein CardImage- oder die URL des einzuschließden Bilds sein.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<HeroCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Herokarten weisen tendenziell ein dominantes Bild mit voller Breite auf. Kanäle rendern in der Regel den Text und die Schaltflächen der Karte unterhalb des Bilds. Zum Beispiel:

const card = CardFactory.heroCard(
     'White T-Shirt',
     ['https://example.com/whiteShirt.jpg'],
     ['buy']
);

images(string | CardImage[] | undefined)

Gibt ein ordnungsgemäß formatiertes Array von Kartenbildern zurück.

static function images(images: string | CardImage[] | undefined): CardImage[]

Parameter

images

string | CardImage[] | undefined

Das Array von Bildern, die auf der Karte enthalten sein sollen. Jedes Element kann ein CardImage- oder die URL des einzuschließden Bilds sein.

Gibt zurück

CardImage[]

Ein ordnungsgemäß formatiertes Array von Kartenbildern.

media(string | MediaUrl[] | undefined)

Gibt ein ordnungsgemäß formatiertes Array von Medien-URL-Objekten zurück.

static function media(links: string | MediaUrl[] | undefined): MediaUrl[]

Parameter

links

string | MediaUrl[] | undefined

Die Medien-URLs. Jede string wird in ein Medien-URL-Objekt konvertiert.

Gibt zurück

MediaUrl[]

Ein ordnungsgemäß formatiertes Array von Medien-URL-Objekten.

o365ConnectorCard(O365ConnectorCard)

Gibt eine Anlage für eine Office 365-Verbinderkarte zurück.

static function o365ConnectorCard(card: O365ConnectorCard): Attachment

Parameter

card

O365ConnectorCard

eine Beschreibung der zurückzugebenden Office 365-Connectorkarte.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Zum Beispiel:

const card = CardFactory.o365ConnectorCard({
  "title": "card title",
  "text": "card text",
  "summary": "O365 card summary",
  "themeColor": "#E67A9E",
  "sections": [
      {
          "title": "**section title**",
          "text": "section text",
          "activityTitle": "activity title",
      }
  ]
});

oauthCard(string, string, string, string, TokenExchangeResource)

Gibt eine Anlage für eine OAuth-Karte zurück.

static function oauthCard(connectionName: string, title: string, text?: string, link?: string, tokenExchangeResource?: TokenExchangeResource): Attachment

Parameter

connectionName

string

Der Name der zu verwendenden OAuth-Verbindung.

title

string

Der Titel für die Anmeldeschaltfläche der Karte.

text

string

Wahlfrei. Zusätzlicher Text, der auf der Karte enthalten sein soll.

link

string

Wahlfrei. Der zu verwendende Anmeldelink.

tokenExchangeResource

TokenExchangeResource

wahlfrei. Die Ressource, mit der versucht werden soll, den Tokenaustausch durchzuführen.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

OAuth-Karten unterstützen den SSO-Dienst (Single Sign On) des Bot Frameworks.

receiptCard(ReceiptCard)

Gibt eine Anlage für eine Belegkarte zurück.

static function receiptCard(card: ReceiptCard): Attachment

Parameter

card

ReceiptCard

Eine Beschreibung der zurückzugebenden Belegkarte.

Gibt zurück

Attachment

Eine Anlage.

signinCard(string, string, string)

Gibt eine Anlage für eine Anmeldekarte zurück.

static function signinCard(title: string, url: string, text?: string): Attachment

Parameter

title

string

Der Titel für die Anmeldeschaltfläche der Karte.

url

string

Die URL der zu verwendenden Anmeldeseite.

text

string

Wahlfrei. Zusätzlicher Text, der auf der Karte enthalten sein soll.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Für Kanäle, die anmeldekarten nicht nativ unterstützen, wird eine alternative Nachricht gerendert.

thumbnailCard(string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)

Gibt eine Anlage für eine Miniaturansichtskarte zurück.

static function thumbnailCard(title: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<ThumbnailCard>): Attachment

Parameter

title

string

Der Kartentitel.

images

string | CardImage[]

Wahlfrei. Das Array von Bildern, die auf der Karte enthalten sein sollen. Jedes Element kann ein CardImage- oder die URL des einzuschließden Bilds sein.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<ThumbnailCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Miniaturansichtskarten ähneln Herokarten, aber anstelle eines Bilds mit voller Breite werden sie in der Regel mit einer kleineren Miniaturansicht des Bilds gerendert. Kanäle rendern den Text der Karte in der Regel auf einer Seite des Bilds, wobei alle Schaltflächen unterhalb der Karte angezeigt werden.

thumbnailCard(string, string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)

Gibt eine Anlage für eine Miniaturansichtskarte zurück.

static function thumbnailCard(title: string, text: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<ThumbnailCard>): Attachment

Parameter

title

string

Der Kartentitel.

text

string

Der Kartentext.

images

string | CardImage[]

Wahlfrei. Das Array von Bildern, die auf der Karte enthalten sein sollen. Jedes Element kann ein CardImage- oder die URL des einzuschließden Bilds sein.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<ThumbnailCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.

Hinweise

Miniaturansichtskarten ähneln Herokarten, aber anstelle eines Bilds mit voller Breite werden sie in der Regel mit einer kleineren Miniaturansicht des Bilds gerendert. Kanäle rendern den Text der Karte in der Regel auf einer Seite des Bilds, wobei alle Schaltflächen unterhalb der Karte angezeigt werden.

videoCard(string, string | MediaUrl[], string | CardAction[], Partial<VideoCard>)

Gibt eine Anlage für eine Grafikkarte zurück.

static function videoCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<VideoCard>): Attachment

Parameter

title

string

Der Kartentitel.

media

string | MediaUrl[]

Die Medien-URLs für die Karte.

buttons

string | CardAction[]

Wahlfrei. Das Array von Schaltflächen, die auf der Karte enthalten sein sollen. Jede string im Array wird in eine schaltfläche imBack konvertiert, wobei ein Titel und Wert auf den Wert der Zeichenfolge festgelegt ist.

other

Partial<VideoCard>

Wahlfrei. Alle zusätzlichen Eigenschaften, die auf der Karte enthalten sein sollen.

Gibt zurück

Attachment

Eine Anlage.