New command: add urlToItem resolver to an external connection

[waldekmastykarz]

Usage

m365 external connection urltoitemresolver add [options]

Description

Adds a URL to item resolver to an external connection

Options

Option	Description
-c, --externalConnectionId <externalConnectionId>	The ID of the external connection to which to add the resolver
-u, --baseUrls <baseUrls>	Comma-separated list of base URLs
--urlPattern <urlPattern>	Regex pattern to match URLs
-i, --itemId <itemId>	Pattern that matches captured matches from the URL with the external item ID
--priority <priority>	Integer that defines the resolution order

Examples

Adds a URL to item resolver to an existing connection:

m365 external connection urltoitemresolver add --connectionId "samplesolutiongallery" --baseUrls "https://adoption.microsoft.com" --urlPattern "/sample-solution-gallery/sample/(?<sampleId>[^/]+)" --itemId "{sampleId}" --priority 1

Default properties

No response

Additional Info

Uses the following endpoint: https://learn.microsoft.com/en-us/graph/api/externalconnectors-externalconnection-update?view=graph-rest-1.0&tabs=http. Requires the external connection to exist.

The body payload needs to be structured as follow:

{
  activitySettings: {
      urlToItemResolvers: [
        {
          '@odata.type': '#microsoft.graph.externalConnectors.itemIdResolver',
          urlMatchInfo: {
            baseUrls: [
              'https://adoption.microsoft.com'
            ],
            urlPattern: '/sample-solution-gallery/sample/(?<sampleId>[^/]+)'
          },
          itemId: '{sampleId}',
          priority: 1
        }
      ]
    }
}

[waldekmastykarz]

@pnp/cli-for-microsoft-365-maintainers any feedback before we open it up?

[waldekmastykarz]

Also, let's align the name with #5531

[martinlingstuyl]

Looks good to me, except the example contains a plural 'urlPatterns' option...

[waldekmastykarz]

Fixed it! Thanks for pointing out!

[martinlingstuyl]

This subject also highlights for me that we need some extra stuff on the site. For example: on command pages we could add a horizontal carroussel with sample scripts that contain the command in question.
Also we should definitely add scenario pages, and this could be one subject where a scenario could be helpful. Something for another day, but good to keep in mind.