Cli-microsoft365: New command: teams deeplink tab generate

Created on 15 Jun 2020  路  9Comments  路  Source: pnp/cli-microsoft365

Usage

teams tab deeplink get [options]

Description

Generates a Microsoft Teams deep link from an existing Tab in a Channel

Options

| Option | Description |
| ----------------------- | ----------------------------------------- |
| --teamId <teamId> | The ID of the team where the tab exists |
| --channelId <channelId> | The ID of the channel where the tab exists |
| --tabId <tabId> | The ID of the tab to generate the deep link from |
| --label <label> | The label to use in the deep link |
| --tabType <tabTypeOptions> | The tab type. Allowed values Static,Configurable |

Additional Information

Generating a deep link to your tab - https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/deep-links#generating-a-deep-link-to-your-tab

Format of the deep link for a configurable tab should be

https://teams.microsoft.com/l/entity/{appId}/{entityId}?webUrl={contentUrl}&label={label}&context={context}

Format for a static tab should be (omitting context)

https://teams.microsoft.com/l/entity/{appId}/{entityId}?webUrl={contentUrl}&label={label}

{appId}, {entityId} and {contentUrl} can be obtained from the Tab object returned by Microsoft graph.

good first issue new feature work in progress

Most helpful comment

Hi @garrytrinder, @waldekmastykarz
Code coverage is fixed. Please review.

All 9 comments

Hi @garrytrinder
I am interested to work on this.

Great, it's all yours 馃憤馃徎

Thank you for the help 馃憦馃徎

Hi @garrytrinder
I have raised PR. Please review and guide on code coverage part. Couple of code lines are reported as uncovered.
Thank you.

Hi @garrytrinder, @waldekmastykarz
Code coverage is fixed. Please review.

Tad late to the party, but is there a reason to use generate as the verb rather than the more common get that we're using in other commands?

That's a fair point @waldekmastykarz no reason why I can't be get.

Thinking of it more, was there any particular line of thought to have it named teams deeplink tab rather than teams tab deeplink? Tab is a known artifact in teams, similar to channels and messages. Deeplink on the other hand is a property of a tab so from the hierarchy point of view it should go after tab. Thoughts?

Another fair point @waldekmastykarz and your comments do make a lot of sense, I've updated the spec to take on board your comments.

Closing issue as per discussion on associated PR.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

vineet2907 picture vineet2907  路  3Comments

VelinGeorgiev picture VelinGeorgiev  路  3Comments

andrewconnell picture andrewconnell  路  3Comments

arjunumenon picture arjunumenon  路  3Comments

garrytrinder picture garrytrinder  路  3Comments