Odśwież

Uwaga / Notatka

Czy tworzysz scenariusze obsługiwane przez karty adaptacyjne dla Copilot, Teams lub Outlook? Odwiedź centrum dokumentacji kart adaptacyjnych— nowy, jednorazowy sklep dla wszystkich potrzeb karty adaptacyjnej. Zawiera wszystkie potrzebne zasoby, w tym kompletną dokumentację dla wielu nowych funkcji, takich jak układ dynamiczny, ikona, znaczek, karuzela, wykresy i wiele innych.

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.

Odśwież

Definiuje sposób odświeżania karty, wysyłając żądanie do docelowego bota.

Wprowadzono w wersji 1.4

Właściwości odświeżania

Majątek Typ Required Description wersja
action Action.Execute Nie. Akcja do wykonania w celu odświeżenia karty. Użytkownicy mogą automatycznie uruchamiać tę akcję odświeżania lub zapewnić możliwość jej ręcznego wyzwolenia. 1.4
Wygasa string Nie. Znacznik czasu, który informuje hosta o wygaśnięciu zawartości karty i że powinno wyzwolić odświeżenie zgodnie z potrzebami. Format jest w formacie Instant zgodnym z ISO-8601. Np. 2022-01-01T12:00:00Z. 1.6
userIds string[] Nie. Lista identyfikatorów użytkowników, które informują klienta, dla których użytkowników akcja odświeżania powinna być uruchamiana automatycznie. Niektórzy klienci nie będą uruchamiać akcji odświeżania automatycznie, chyba że ta właściwość zostanie określona. Niektórzy klienci mogą ignorować tę właściwość i zawsze uruchamiać akcję odświeżania automatycznie. 1.4

Właściwości

akcja

Akcja do wykonania w celu odświeżenia karty. Klienci mogą automatycznie uruchamiać tę akcję odświeżania lub mogą zapewnić użytkownikom możliwość ręcznego wyzwolenia tej akcji.

  • Typ: Action.Execute
  • Wymagane: Nie
  • Dozwolone wartości:
    • Action.Execute

Wygasa

Znacznik czasu informujący hosta o wygaśnięciu zawartości karty, co powinno skutkować odpowiednim odświeżeniem. Format jest w formacie ISO-8601 typu Instant. Np. 2022-01-01T12:00:00Z.

  • Typ: string
  • Wersja: 1.6
  • Wymagane: Nie

userIds

Lista identyfikatorów użytkowników informująca klienta, dla których użytkowników powinna być automatycznie uruchomiona akcja odświeżania. Niektórzy klienci nie będą uruchamiać akcji odświeżania automatycznie, chyba że ta właściwość zostanie określona. Niektórzy klienci mogą ignorować tę właściwość i zawsze uruchamiać akcję odświeżania automatycznie.

  • Typ: string[]
  • Wymagane: Nie
  • Last updated on