https://github.com/jaykul/connectorcards

A module to send connector card messages to the Office 365 API (because I can't find this command built-in).
https://github.com/jaykul/connectorcards

Last synced: about 1 month ago
JSON representation

A module to send connector card messages to the Office 365 API (because I can't find this command built-in).

• Host: GitHub
• URL: https://github.com/jaykul/connectorcards
• Owner: Jaykul
• Created: 2016-11-03T05:13:42.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2016-11-03T05:16:00.000Z (about 8 years ago)
• Last Synced: 2024-10-28T10:20:48.385Z (3 months ago)
• Language: PowerShell
• Size: 1.95 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: ReadMe.md

Awesome Lists containing this project

README

        
# Office365 Connector Cards

The [connector card](https://dev.outlook.com/Connectors/Reference) API is used for various things in Office365 connectors, but I wrote these functions for sending messages to the new Microsoft Teams.

This is the first draft. There's a lot of work needed to make the cmdlets _useable_. Maybe a few PSTypeNames, a couple of extra constructor functions, and some parameter sets to make sure that you only do things that make sense rendered.

For now, here are a couple examples in lieu of documentation. First, you must  configure it with the URL for your team -- captured from the Microsoft Teams Connectors configuration page:

```posh

Set-ConnectorUrl Forge Testing $TeamForgeTestingChannelUrl

```

Then you can send simple messages to the channel like this:

```posh

Send-Card -Group Forge -Channel Testing -Message "Hello World"

```

You can add an icon with three lines of text by adding a **section**:

```posh

$PesterImg = "http://pesterbdd.com/images/Pester.png"

Send-Card -Group Forge -Channel Testing -Message "Build Finished" -Sections (

    New-Section -Title "Pester Tests" -SubTitle "Pester Tests Succeeded" `

                -FullText "Code coverage **95%**." -AvatarUrl $PesterImg

)

```

And you can get much more creative, with _facts_ (displayed as a table) and _actions_ (a URL link, only one is _currently_ displayed per section, even through the API will accept a list of them). Note that you can always put links into the actual message, because all the non-title text fields support markdown.

```posh

$Pester = New-Section -SectionName "Pester Results" -Facts @{ 

    Passed = 2000

    Failed = 0

    Skipped = 3

} -AvatarUrl "http://pesterbdd.com/images/Pester.png" `

  -Title "Pester Tests" `

  -SubTitle "Pester Tests Succeeded" `

  -FullText "Pester tests _successful_, code coverage **95%**." 

Send-Card -Group Forge -Channel Testing -Title "Build Finished" -Message "Build succeeded" -Sections $Pester -Actions @{ 

    "See results in Web" = "http://google.com/"

}

```