Delen via

Functies die zijn geïnjecteerd vanuit de bibliotheek voor het genereren van talen

  • Artikel

VAN TOEPASSING OP: SDK v4

In het volgende artikel vindt u informatie over het injecteren van functies uit de lg-bibliotheek (Language Generation).

ActivityAttachment

Hiermee wordt een activityAttachment samengesteld uit een object en een type geretourneerd.

ActivityAttachment(<collection-of-objects>)
Parameter Vereist Type Omschrijving
<Inhoud> Ja object Object met de informatie van de bijlage
<type> Ja tekenreeks Een tekenreeks die het type bijlage aangeeft
Retourwaarde Type Omschrijving
<activityAttachment> object Een activityAttachment gevormd van de invoer

Voorbeeld:

In dit voorbeeld wordt een verzameling objecten geconverteerd naar een activityAttachment.

Stel dat u de volgende sjabloon hebt:

# externalHeroCardActivity(type, title, value)
[Activity
    attachments = ${ActivityAttachment(json(fromFile('.\\herocard.json')), 'herocard')}
]

en het volgende herocard.json:

{
  "title": "titleContent",
  "text": "textContent",
  "Buttons": [
    {
      "type": "imBack",
      "Title": "titleContent",
      "Value": "textContent",
      "Text": "textContent"
    }
  ],
  "tap": {
    "type": "${type}",
    "title": "${title}",
    "text": "${title}",
    "value": "${value}"
  }
}

Door aan te roepen externalHeroCardActivity() als een functie:

externalHeroCardActivity('signin', 'Signin Button', 'http://login.microsoft.com')

Het retourneert een herocard:

{
    "lgType" = "attachment",
    "contenttype" = "herocard",
    "content" = {
        "title": "titleContent",
        "text": "textContent",
        "Buttons": [
            {
            "type": "imBack",
            "Title": "titleContent",
            "Value": "textContent",
            "Text": "textContent"
            }
        ],
        "tap": {
            "type": "signin",
            "title": "Signin Button",
            "text": "Signin Button",
            "value": "http://login.microsoft.com"
        }
    }
}

expandText

Evalueer de tekst zonder opmaak in een object en retourneer de uitgebreide tekstgegevens.

expandText(<object>)
Parameter Vereist Type Omschrijving
<Object> Ja object Het object met tekst om uit te vouwen.
Retourwaarde Type Omschrijving
<geëvalueerd resultaat> object De uitgebreide tekstgegevens.

Voorbeeld

In dit voorbeeld wordt de tekst zonder opmaak in een JSON-object geëvalueerd en wordt het uitgevouwen tekstresultaat geretourneerd.

Stel dat u het volgende object hebt:

{
  "@answer": "hello ${user.name}",
  "user": {
    "name": "vivian"
  }
}

Aanroepen expandText(@answer) resulteert in het object hello vivian.

sjabloon

Retourneert het geëvalueerde resultaat van de opgegeven sjabloonnaam en het bereik.

template(<templateName>, '<param1>', '<param2>', ...)
Parameter Vereist Type Omschrijving
<templateName> Ja tekenreeks Een tekenreeks die de sjabloonnaam vertegenwoordigt
<param1>,< param2>, ... Ja Object De parameters die zijn doorgegeven aan de sjabloon
Retourwaarde Type Omschrijving
<geëvalueerd resultaat> object Het resultaat dat wordt geëvalueerd op basis van de sjabloon als een functie

Voorbeeld

In dit voorbeeld wordt het resultaat geëvalueerd van het aanroepen van de sjabloon als een functie.

Stel dat u de volgende sjabloon hebt:

# welcome(userName)
- Hi ${userName}
- Hello ${userName}
- Hey ${userName}

Bellen template("welcome", "DL") resulteert in een van de volgende opties:

  • Hallo DL
  • Hallo DL
  • Hey DL

fromFile

Retourneert het geëvalueerde resultaat van de expressie in het opgegeven bestand.

fromFile(<filePath>)
Parameter Vereist Type Omschrijving
<Filepath> Ja tekenreeks relatief of absoluut pad van een bestand bevat expressies
Retourwaarde Type Omschrijving
<Resultaat> tekenreeks De tekenreeksweergave van het geëvalueerde resultaat

Voorbeeld

In dit voorbeeld wordt het resultaat van het opgegeven bestand geëvalueerd.

Stel dat u een bestand hebt met de naam /home/user/test.txt. In het bestand ziet u het volgende:

`you have ${add(1,2)} alarms`

fromFile('/home/user/test.txt')

De fromFile() functie evalueert de expressie en het resultaat vervangt de oorspronkelijke expressie.

Bellen fromFile('/home/user/test.txt') resulteert in de tekenreeks die u 3 alarmen hebt.

isTemplate

Geef als resultaat of een bepaalde sjabloonnaam is opgenomen in de evaluator.

isTemplate(<templateName>)
Parameter Vereist Type Omschrijving
<templateName> Ja String Een sjabloonnaam die moet worden gecontroleerd
Retourwaarde Type Omschrijving
<Resultaat> Booleaanse waarde Of de opgegeven sjabloonnaam is opgenomen in de evaluator

Voorbeeld

In dit voorbeeld wordt de isTemplate() functie gebruikt om te controleren of een bepaalde sjabloonnaam zich in de evaluator bevindt. Dit zijn bijvoorbeeld drie sjablonen:

# welcome
- hi

# show-alarms
- 7:am and 8:pm

# add-to-do
- you add a task at 7:pm

Bellen isTemplate("welcome") zal resulteren in true. Bellen isTemplate("delete-to-do") zal resulteren in false.

Aanvullende informatie