Avoiding deployment validation errors with SPFx packages

package-solution.json fileJust a quick note on a gotcha I came across when deploying an SPFx package to the App Catalog:

In the package-solution.json file, make sure your solution name doesn't use dot notation (or for my American friends, doesn't contain periods). This appears to prevent SharePoint from recognising your .sppkg file as a valid app package.



I started with a package-solution.json file that resembled the following - a nicely-qualified solution name, or so I thought:

{
    "solution": {
        "name": "Chorus.TiledNewsPart",
        "id": "83a75dd2-26d3-4235-b4ba-d0d4a8b19443",
        "version": "1.0.0.2"
    },
    "paths": {
        "zippedPackage": "solution/chorustilednewspart.sppkg"
    }
}

When I dropped the package into the App Catalog, I saw the following:










As you can see, things don't look good:

  • A bunch of fields (Title, Product ID, Metadata Language) haven't been populated.
  • The Valid App Package field value is No.
  • The Deployed field value is No.

Needless to say, my web part didn't make it through to any of my SharePoint sites either.

If we switch to a more NPM-style naming convention for my solution name in the package-solution.json file (use dashes, ditch the dots):

{
    "solution": {
        "name": "chorus-tiled-news-part", 
        "id": "83a75dd2-26d3-4235-b4ba-d0d4a8b19443", 
        "version": "1.0.0.3" 
    }, 
    "paths": { 
        "zippedPackage": "solution/chorustilednewspart.sppkg" 
    }
}

We now get a much better result when we add the package to the App Catalog - all fields are populated, the Valid App Package field value is Yes, and the Deployed field value is Yes:












And there you have it. Summary: dots bad, dashes good.

Comments

Post a Comment

Popular posts from this blog

Server-side activities have been updated

Image
If you use SharePoint Designer 2013 to build workflows, there's a fair chance you'll have come across the following error message:
Server-side activities have been updated. You need to restart SharePoint Designer to use the updated version of activities.  Needless to say, restarting SharePoint Designer rarely makes the error go away. The usual advice is:

Approach 1: Clear the cache folders
See for example How to Clear Your SharePoint Designer 2010/2013 Cache. If you've just deployed some custom workflow activities to your site, this will probably solve your problem (and you should clear the cache folders every time you deploy custom activities). If the error occurs spontaneously, this approach often won't help.

Approach 2: Reinstall SharePoint Designer
This might work if you've got a preview version of SharePoint Designer installed. If not, it's unlikely to help. It didn't work for me, and it didn't work for countless others on the forums.

Approach 3: Insta…
Read more

The target principal name is incorrect. Cannot generate SSPI context.

Image
Today's problem occured after I restarted a Hyper-V based SharePoint 2013 farm (Windows Server 2012, one SharePoint 2013 machine, one SQL Server 2012 machine, one DC). I fired up Central Administration and was hit with the following error:

Unknown SQL Exception 0 occurred. Additional error information from SQL Server is included below.

The target principal name is incorrect. Cannot generate SSPI context.

After checking the obvious things - testing connectivity to the DB server, checking the SQL service was running, verifying permissions, etc - I initially figured this was an issue with my Hyper-V snapshots being out of sync, so I ran the SharePoint Products Configuration Wizard. This hit me with the following error:

Failed to detect if this server is joined to a server farm. Possible reasons for this failure could be that you no longer have appropriate permissions to the server farm, the database server hosting the server farm is unresponsive, the configuration database is inaccessib…
Read more

Getting or Setting Multi-Value Metadata Fields with the REST API

Image
A couple of years ago, I published a series of posts on getting and setting taxonomy field values in SharePoint workflows by using the REST API in custom workflow activities. These custom activities have served me well, but they've always been unable to work with multi-value taxonomy fields. It's time to fix that.

Background As you probably already know, when you add a taxonomy field to a SharePoint list, SharePoint adds a corresponding hidden note field. For example, if you add a taxonomy field named Colours, you actually get:

A taxonomy field named Colours. Depending on whether the column allows the user to select multiple terms, the field accepts values of type SP.Taxonomy.TaxonomyFieldValue or Collection(SP.Taxonomy.TaxonomyFieldValue).A hidden note field, probably named Colours_0.  The hidden note field stores the contents of the field in a term string format. In a single-value taxonomy field, the format looks like this:
Red|87999a76-e3cb-433c-96ad-c6fe354db476
And in a mult…
Read more