Ensimmäisen mukautuvan kortin luominen

Power Automaten mukautuvat kortit voivat joko jakaa tietolohkoja tai kerätä tietoja lomakkeella tietylle tietolähteelle.

Kummassakin tapauksessa sinun on luonnosteltava, mitä tietojoukkoja jaat ja/tai mitä tietoja lomakkeen on kerättävä.

Vihje

Käytä yksinkertaisia tietolohkoja monimutkaisten taulukkomatriisien sijaan.

Edellytykset

  • Microsoft Teams, johon on asennettu työnkulkusovellus.

Lisää toiminto

Tässä toimintosarjassa lisäät toiminnon, joka käyttää työnkulun aiempien toimintojen tietoja tietojen julkaisuun Microsoft Teams -kanavaan.

  1. Kirjaudu Power Automateen.

  2. Valitse yläreunan siirtymispalkissa Omat työnkulut.

  3. Valitse Uusi > Pika – tyhjästä.

  4. Nimeä työnkulku.

  5. Valitse käynnistimeksi Käynnistä työnkulku manuaalisesti.

  6. Valitse Luo.

  7. Valitse ** Uusi vaihe**.

  8. Hae Microsoft Teams ja valitse sitten Julkaise mukautuva kortti Teams-kanavaan ja odota vastausta -toiminnoksi.

  9. Valitse Työryhmä ja Kanava, jolle haluat julkaista kortin.

  10. Liitä tämä JSON sanomaruutuun.

    {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.0",
        "body": [
            {
                "type": "TextBlock",
                "text": "Poll Request",
                "id": "Title",
                "spacing": "Medium",
                "horizontalAlignment": "Center",
                "size": "ExtraLarge",
                "weight": "Bolder",
                "color": "Accent"
            },
            {
                "type": "TextBlock",
                "text": "Header Tagline Text",
                "id": "acHeaderTagLine",
                "separator": true
            },
            {
                "type": "TextBlock",
                "text": "Poll Header",
                "weight": "Bolder",
                "size": "ExtraLarge",
                "spacing": "None",
                "id": "acHeader"
            },
            {
                "type": "TextBlock",
                "text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer vestibulum lorem eget neque sollicitudin, quis malesuada felis ultrices. ",
                "id": "acInstructions",
                "wrap": true
            },
            {
                "type": "TextBlock",
                "text": "Poll Question",
                "id": "acPollQuestion"
            },
            {
                "type": "Input.ChoiceSet",
                "placeholder": "Select from these choices",
                "choices": [
                    {
                        "title": "Choice 1",
                        "value": "Choice 1"
                    },
                    {
                        "title": "Choice 2",
                        "value": "Choice 2"
                    },
                    {
                        "title": "Choice 3",
                        "value": "Choice 3"
                    }
                ],
                "id": "acPollChoices",
                "style": "expanded"
            }
        ],
        "actions": [
            {
                "type": "Action.Submit",
                "title": "Submit",
                "id": "btnSubmit"
            }
        ]
    }
    
  11. Muuta seuraavat asiat JSON-tiedostossa.

    Tärkeä

    Älä poista lainausmerkkejä, kun teet muutoksia. Voit muuttaa autovaihtoehtoja tarpeidesi mukaan:

    Muutettava teksti Uusi teksti
    Alaotsikon teksti Power Automate -kysely
    Kyselyn otsikko Ensisijainen automalli
    Kyselyn kysymys Äänestä haluamaasi automallia valiten tässä mainituista vaihtoehdoista.
    Korvaa latinaksi oleva teksti kyselyn suorittamiseen liittyvällä syyllä tai liiketoimintakontekstilla. Teetämme työntekijöillämme kyselyn sen määrittämiseksi, pitäisikö meidän tarjota mukautettuja pysäköintipaikkoja, jotka on mitoitettu suosituimmille autoille.
    Vaihtoehto 1 (muuta kummassakin kohdassa) Tesla
    Vaihtoehto 2 (muuta kummassakin kohdassa) Lexus
    Vaihtoehto 3 (muuta kummassakin kohdassa) Honda
  12. Valitse Uusi vaihe ja sitten etsi ja valitse jokin Lähetä sähköpostiviesti -toiminnoista, johon sinulla on käyttöoikeus.

  13. Anna sähköpostiviestin vastaanottaja henkilönä, joka valitsi pikapainikkeen (käytä Sähköposti-tunnusta käynnistimen dynaamisesta sisällöstä).

  14. Määritä sähköpostiviestin leipäteksti seuraavasti. Korvaa aaltosulkeissa "{}" olevat sanat dynaamisilla tunnuksilla:
    Kyselyvastaus oli {acPollChoices} (acPollChoices on dynaaminen sisältö odota vastausta -toiminnosta). Sen on lähettänyt {käyttäjänimi} (käyttäjänimi on käynnistimestä tulevaa dynaamista sisältöä)

Mukautuvan kortin testaaminen

Testaa työsi suorittamalla aiemmin luomasi työnkulku ja vahvistamalla seuraavat asiat:

  • Työnkulussa ei ole suoritusvirheitä, ja se odottaa vastausta näyttäen mukautuvan kortin toiminnon odotusilmaisimen suoritusnäytöllä.

  • Uusi mukautuva kortti on julkaistu Teams-kanavalle.

  • Kun vastaat korttiin valitsemalla automallin ja valitset sitten Lähetä-painikkeen mukautuvan kortin alaosassa:

    • Mukautuvassa kortissa ei pitäisi tapahtua virheitä.

    • Työnkulun suorittaminen onnistuu.

  • Kortin korvaaminen on oleellista lähettämisen jälkeen, jos olet määrittänyt Päivityssanoma-alueen odota vastausta -toimintojen alaosassa (näytetään seuraavaksi vastaavan korvaavan kortin vieressä). Muussa tapauksessa kaikki lähetykset nollaavat lomakkeen.

    Korvaava kortti

  • Sähköposti-ilmoitus sisältää leipätekstin, jossa kerrotaan, kuka on lähettänyt vastauksen ja mikä auto valittiin.

Onnittelut! Olet juuri luonut ensimmäisen interaktiivisen mukautuvan korttisi!

Ensimmäinen valmis kortti

Mukautuvien korttien vianmääritysvihjeitä

Yleisimpiä ongelmia mukautuvien korttien luonnissa ovat seuraavat:

  • Työnkulun suoritusvirheet johtuvat usein jostakin seuraavista tekijöistä:

    Tässä tapauksessa virhe voi muistuttaa seuraavaa näyttökuvaa:

    Virhesanoma

    • Virheellisesti muotoiltu JSON – tämä ei yleensä ole niin monimutkaista kuin voisi olettaa. Kyse on yleensä seuraavanlaisista tilanteista:

      • JSON-arvojen ympärillä on kaarevat lainausmerkit tai lainausmerkit puuttuvat. Tarkista JSON aina sen varmistamiseksi, että kaikkien tekstiarvojen ympärillä on kaksinkertaiset lainausmerkit ja että lukujen ympärillä on lainausmerkit. Kaikkien lainausmerkkien on oltava suoria, ei kaarevia.

      • Voit vahvistaa JSON-muodon liittämällä JSONin korttitietojen editoriin.

    • Kuvien puuttuvat URL-osoitteet – mukautuvien korttien kaikkien kuva-arvojen on viitattava kelvolliseen URL-osoitteeseen. Koko kuvan sisältöä ei tueta suoraan mukautuvassa kortissa. Testaa kuvien linkit liittämällä URL-osoite selaimeen, jotta voit tarkistaa, näkyykö kuva.

  • Mukautuvat kortit eivät ehkä näytä odotetunlaisilta tyyli- ja rakennerajoitusten vuoksi:

    • Tarkista, että paikkamerkkiarvot, tekstityylit ja mahdolliset merkintäkielet ovat mukautuvan kortin rakennevaatimusten mukaisia (tutustu mukautuvien korttien rakenteen parhaisiin käytöntöihin tässä)

    • Hyödynnä Visual Studio Coden mukautuvan kortin varmistajaa. Voit asentaa sen Visual Studio Code -sovelluksesta avaamalla Extensions Marketplacen ja kirjoittamalla hakukenttään Adaptive Card Viewer.

      Visual Studio Code -tunniste

Katkaistu näyttökuva Visual Studio Codeen asennetusta Adaptive Card Viewer -laajennuksesta (pikanäppäimet: Ctrl+V+A käyttöönoton jälkeen).

  • Mukautuvan kortin lähettämisen jälkeen tapahtuvat virheet johtuvat usein seuraavista asioista:

    • Sellaisen toiminnon käyttäminen, jonka nimi ei sisällä "odota vastausta” -lauseketta

      Yritä uudelleen

    • Kortti yritetään lähettää useammin kuin kerran. Jokainen mukautuva kortti voidaan lähettää vain kerran, minkä jälkeen kaikki muut lähetykset ohitetaan.