Działanie.Wyślij

Ta strona dokumentuje akcję Action.Submit , która zbiera pola wejściowe, scala je z opcjonalnym polem danych i wysyła zdarzenie z powrotem do klienta w celu przetworzenia. Zebrane dane wejściowe obejmują te na bieżącej karcie oraz na dowolnych kartach nadrzędnych, jeśli znajdują się w Show Card.

Ważna uwaga dotycząca ułatwień dostępu: W wersji 1.3 schematu wprowadziliśmy właściwość label dla danych wejściowych w celu zwiększenia ułatwień dostępu. Jeśli docelowa aplikacja hosta obsługuje v1.3, należy użyć Label zamiast TextBlock, jak pokazano w poniższych przykładach. Po zaktualizowaniu większości aplikacji Host do najnowszej wersji, odpowiednio zaktualizujemy przykłady.

Działanie.Wyślij

Zbiera pola wejściowe, scala z opcjonalnym polem danych i wysyła zdarzenie do klienta. Do klienta należy określenie sposobu przetwarzania tych danych.

Właściwości Action.Submit

Właściwości dziedziczone

Example

Podstawowa akcja. Przykład zatwierdzenia (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.3",
	"body": [
		{
			"type": "TextBlock",
			"text": "Present a form and submit it back to the originator"
		},
		{
			"type": "Input.Text",
			"id": "firstName",
			"placeholder": "What is your first name?",
			"label": "What is your first name?"
		},
		{
			"type": "Input.Text",
			"id": "lastName",
			"placeholder": "What is your last name?",
			"label": "What is your last name?"
		}
	],
	"actions": [
		{
			"type": "Action.Submit",
			"title": "Action.Submit",
			"data": {
				"x": 13
			}
		}
	]
}

Właściwości

dane

Początkowe dane, z którymi będą łączone pola wejściowe. Są to zasadniczo "ukryte" właściwości.

• Typ: string, object
• Wymagane: Nie

powiązaneWejścia

Określa, które dane wejściowe są skojarzone z akcją przesyłania.

• Typ: AssociatedInputs
• Wersja: 1.3
• Wymagane: Nie, wartość domyślna: "auto"
• Dozwolone wartości:
  • "Auto": Dane wejściowe na bieżącej karcie i wszystkich kartach nadrzędnych będą walidowane i przesłane dla tej Akcji.
  • "None": Żadne z danych wejściowych nie zostanie zweryfikowane lub przesłane dla tej akcji.

associatedInputs — przykład (JSON)

{
	"type": "AdaptiveCard",
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"version": "1.3",
	"body": [
		{
			"type": "Input.Text",
			"id": "name",
			"label": "Please enter your name:",
			"isRequired": true,
			"errorMessage": "Name is required"
		}
	],
	"actions": [
		{
			"type": "Action.Submit",
			"title": "Cancel",
			"associatedInputs": "none"
		},
		{
			"type": "Action.Submit",
			"title": "Submit"
		}
	]
}

title

Etykieta przycisku lub linku reprezentującego tę akcję.

• Typ: string
• Wymagane: Nie

iconUrl

Opcjonalna ikona wyświetlana w akcji w połączeniu z tytułem. Obsługa danych URI w wersji 1.2 lub nowszej.

• Typ: uri
• Wersja: 1.1
• Wymagane: Nie

id

Unikatowy identyfikator skojarzony z tą akcją.

• Typ: string
• Wymagane: Nie

styl

Określa styl akcji, który wpływa na sposób wyświetlania akcji, wypowiedzi itp.

• Typ: ActionStyle
• Wersja: 1.2
• Wymagane: Nie
• Dozwolone wartości:
  • "default": Akcja jest wyświetlana normalnie.
  • "positive": Działanie jest wyświetlane w sposób pozytywny (zwykle przycisk przechodzi na kolor wyróżniający).
  • "destructive": Akcja jest wyświetlana z destruktywnym stylem (zazwyczaj przycisk staje się czerwony).

Zapasowy

Opisuje, co należy zrobić, gdy napotkany zostanie nieznany element lub nie można spełnić wymagań tego lub elementów podrzędnych.

• Typ: Action, FallbackOption
• Wersja: 1.2
• Wymagane: Nie
• Dozwolone wartości:
  • Action.Execute, , Action.OpenUrl, Action.ShowCard, Action.Submit, Action.ToggleVisibility.
  • "drop": Powoduje, że ten element zostanie natychmiast usunięty, gdy napotkane są nieznane elementy, a nieznany element nie przenosi się wyżej.

etykietka narzędzia

Definiuje tekst, który powinien być wyświetlany użytkownikowi końcowemu podczas umieszczania wskaźnika myszy na akcji i odczytywania podczas korzystania z oprogramowania do narracji.

• Typ: string
• Wersja: 1.5
• Wymagane: Nie

Przykład podpowiedzi (JSON)

{
	"type": "AdaptiveCard",
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"version": "1.5",
	"body": [
		{
			"label": "Please enter your name below:",
			"type": "Input.Text",
			"id": "name"
		}
	],
	"actions": [
		{
			"type": "Action.Execute",
			"title": "Submit",
			"tooltip": "Click here to add your name to the waiting list."
		}
	]
}

jest włączony

Określa, czy akcja powinna być włączona.

• Typ: boolean
• Wersja: 1.5
• Wymagane: Nie, wartość domyślna: true

isEnabled — przykład (JSON)

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Disabled Execute Button",
      "wrap": true
    }
  ],
  "actions": [
    {
      "type": "Action.Execute",
      "title": "Enabled"
    },
    {
      "type": "Action.Execute",
      "title": "Disabled",
      "isEnabled": false
    }
  ]
}

mode

Określa, czy akcja powinna być wyświetlana jako przycisk, czy w menu dodatkowym.

• Typ: ActionMode
• Wersja: 1.5
• Wymagane: Nie, wartość domyślna: "primary"
• Dozwolone wartości:
  • "primary": Akcja jest wyświetlana jako przycisk.
  • "secondary": Akcja jest umieszczana w menu rozwijanym (zwykle pod przyciskiem ...).

Przykład trybu (JSON)

{
	"type": "AdaptiveCard",
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"version": "1.5",
	"body": [
		{
			"type": "TextBlock",
			"text": "Please confirm your data:",
			"wrap": true,
			"style": "heading"
		},
		{
			"type": "FactSet",
			"facts": [
				{
					"title": "First Name",
					"value": "John"
				},
				{
					"title": "Last Name",
					"value": "Smith"
				},
				{
					"title": "Phone number ",
					"value": "(555) 555-5555"
				}
			]
		}
	],
	"actions": [
		{
			"type": "Action.Execute",
			"title": "Confirm data"
		},
		{
			"type": "Action.Execute",
			"title": "Edit data",
			"data": "edit",
			"mode": "secondary"
		},
		{
			"type": "Action.Execute",
			"title": "Delete data",
			"data": "delete",
			"mode": "secondary"
		}
	]
}

Wymaga

Seria par klucz/wartość wskazująca funkcje, które element wymaga wraz z odpowiednią minimalną wersją. Gdy brakuje funkcji lub jej wersja jest niewystarczająca, zostanie wyzwolone zastępcze rozwiązanie.

• Typ: Dictionary<string>
• Wersja: 1.2
• Wymagane: Nie