For on-premise SharePoint 2013, both Foundation and Server, using SSOM (Server Side Object Model).

Alpha version, not for production.

• SPTools provide a framework which allows you to extend SharePoint in all possible directions using scripting in IronPython and other DLR (Dynamic Language Runtime) languages. Dynamically loaded DLLs can also be integrated, runtime-compiled C# support is upcoming. You don't need to run or even own Visual Studio to do serious SharePoint development.
• Our approach allows you to activate and configure all extensions across the portal from a single custom list with a wizard-like form UI bound to actual SharePoint structures.
• Faster and less demanding development, easier automated testing, transparent administration. And you can debug IronPython scripts even on a production portal without the users noticing.

Shows the status of SPTools installation. Tells you if all necessary structures exist, runs tests on all present plugins and reports the results.

Located at /_layouts/15/NVR.SPTools/Status.aspx

A simple SharePoint Service Application that holds configuration data and indexes. The configurations themselves are loaded from our configuration list (SiteConfig). All functionalities query this service to find out what functionalities should be running where and with what configuration.

Only one instance of this service should be running per farm.

Second simple SharePoint Service Application - this one holds scripts that were uploaded to the SiteScripts library. The NVRRepoServiceClient is also able to run scripts in different languages using engines that made themselves available through the SharePoint Service Locator.

Only one instance of this service should be running per farm.

Used for fast retrieval of one or more JS and CSS files from SiteScripts. Results are cached until some of the files change, in future they could also be minified.

Request files like this: /_layouts/15/NVR/GetScript.aspx?FilePaths=/relative/paths.js;/to/files/in/SiteScripts.js

This control is added to every page and uses SharePoint Service Locator to run all registered IPageHead providers. Included are JavaScript loaders, CSS loaders, dynamic ribbon buttons... and all of them use NVRConfigService to find out what should be running in the page being rendered.

All of these just look to NVRConfigService what plugins are configured to run for given location and event type and execute them. Currently these receivers have to be added manually, in the future the plugin install scripts will be able to handle that.

These item receivers are targeted to content type 0x01, so they run on every item and every event everywhere. They don't do anything unless they find a configuration telling them they should.

Empty generic SharePoint page able to run plugins. The plugin can either treat it as an ASP.NET page, build, display and handle controls, or it can be used as a simple backend.

Our custom form iterator allows you to prefill values in forms with URL parameters (FieldInternalName=Value) and set some fields to non-editable even in edit forms.

Extension methods for the Server Side Object Model that make a lot of clumsy API stuff simpler and allow hassle-free programming in dynamic scripting languages. More details on https://github.com/NAVERTICA/Navertica.SharePoint.Extensions

Used for making scripting engines available. Included implementations for DLR (IronPython, IronRuby, ...) and DLL loader - loading classes from DLLs. Using PowerShell might also be possible.

A really simple interface for loading and running simple language independent plugin classes. To have your plugin automatically loaded, it has to contain the string "plugin" in its filename. Once it is in SiteScripts, it should be possible to execute it by adding a configuration entry and referring to it by its Name.

C# receiver plugin for setting different individual item rights to different groups and users depending on contents of user fields in the item itself or in items connected with lookups

C# receiver that simply takes values from one fields and copies them to another (usually text) field - useful for example when grouping items, some field types cannot be used for grouping, so just duplicate them automatically into another field, hide it in forms and use it for grouping in list views.

C# receiver for maintaining bidirectional lookup relations - an item in list A has a lookup value pointing to an item in list B, Linked Lookup automatically updates the item in list B to point back to the item in list A.

IronPython plugins calling the NVRConfigService and NVRRepoService in order to reflect updates in SiteConfig and SiteScripts, so that the data is always current.

Simple JavaScript plugin set up to run on every page, it only prints "Example.js running" to browser's developer console.

Will be automatically created when activating the NVRInfrastructure feature.

This list will be installed on activation of NVRInfrastructure if it doesn't exist. When installed for the first time, all rights will be removed so that only admins can view and edit configurations.

Properties:

• Title - free to use for anything
• Apps - application/plugin names this config entry adresses - one config entry can be used by several plugins, all of which will have their own sections
• Package - only used for grouping
• Order - several configs for one App name can be loaded, and the order of execution is set using this property
• Active - only entries marked as Active will be used
• Aproved - if an entry is not approved, it will load only for users in the Active For field
• Active For - users in this field will be able to load this config entry even if it is not Approved
• Debug - depending on the plugins and functionalities used, this can mean enhanced debug logging etc.
• URL
  • Can contain one or more relative URLs, each on its own line, for example /Lists/SiteConfig/*
  • URLs can contain * and ? as wildcards
  • If an URL pattern prefixed with minus - matches, this config entry will not be used even if other URL patterns/CT/ListType match
  • If empty, this configuration entry will depend on other properties to evaluate when to run
• CTs (Content types)
  • Can contain one or more ContentTypeIds, each on its own line, for example 0x0108 for all Tasks
  • can contain * and ? as wildcards
  • if a pattern prefixed with minus - matches, this config entry will not be used even if other URL patterns/CT/ListType match
• List Type
  • Can contain one or more list types
• JSON
  • Use Default=1 in URL to edit the JSON contents as text.
  • Otherwise the field will look in SiteScripts/Schema for file with its internal name, in this case NVR_SiteConfigJSON.js This file contains a function that will construct a JSON schema and pass it to json-edit to dynamically build a form with it.

Configurations will be deemed active if

• Active is true
• Approved is true or the current user is in the Active For field
• Every non-empty property matches - if URL, CT and LT properties are present, this config entry will only be included if it matches all three of them - it has to be on the right URL, the item has to have the right CT, and it has to be in the right LT. If a -prefixed possibility matches in any one of the properties, the config entry will not be used.

This library will be installed on activation of NVRInfrastructure if it doesn't exist. The first time around, all rights will be removed so that only admins can add and edit scripts.

Order of installation:

1. NVRLibraries.wsp
2. NVRLogging.wsp
3. NVRConfigService.wsp (install and instantiate service)
4. NVRRepoService.wsp (install and instantiate service)
5. NVRPluginEngine.wsp
6. NVRFormIterator.wsp
7. Navertica.SPTools.wsp

Only a single instance of each service should be running in a farm.

PowerShell scripts for the entire installation are upcoming.

1. NVRRepoServiceAdmin and NVRConfigServiceAdmin farm features must be installed and visible on (_admin/ManageFarmFeatures.aspx)
2. In Central Administration Application Management page there will be new links to manage these services
3. Both need to be installed and run using (_admin/Server.aspx)
4. New instance for both service apps needs to be added, together with proxies (_admin/ServiceApplications.aspx)
5. Both proxies need to be associated with the web application where we want to use them - Service Application Associations (_admin/ApplicationAssociations.aspx)

Not every enhancement and functionality has to be an addon, but for pieces that will be used frequently, it's worth doing it right.

A complete addon (as opposed to a plugin, which is just a piece of functionality loaded and used in the portal) is composed of several files that are copied into the SiteScripts library, and several files that are copied to SiteConfig, plus optional media files. The easiest way today to pack and distribute an addon is to put it in a .wsp, which is kind of ironic, given how we boast there's no downtime to deploying our type of plugins, but we do have other options coming up.

The feature should contain two folders, SiteConfig and SiteScripts, which will be copied to _LAYOUTS/FeatureName and have to contain scripts/DLLplugin files for SiteScripts and config files with JSON and metadata for SiteConfig.

In order to be visible in the Add an App page, the addon has to provide SiteConfig configuration with these two files:

Filename: FeatureName.metadata.json

Contents:

{
  "ContentType": "NVR_SiteConfigJSON",
  "NVR_SiteConfigApp": "JavaScripts",
  "NVR_SiteConfigPackage": "YOUR_CUSTOM_PACKAGE_NAME",
  "NVR_SiteConfigListType": null,
  "NVR_SiteConfigUrl": "*/_layouts/15/addanapp.aspx*",
  "NVR_SiteConfigOrder": 1,  
  "NVR_SiteConfigActive": true,
  "NVR_SiteConfigApproved": true,
  "Title": "Add YOUR_FEATURE into 'Add an App' page"
}

Filename: FeatureName.json

Contents:

{
    "JavaScripts": {
      "LibLinks": [
        ""
      ],
      "ScriptLinks": [
        "YOUR_FOLDER_UNDER_SITESCRIPTS/YOUR_FEATURE_NAME/NVRAddAppEntriesIcon.js"
      ]
    }
}

In the SiteScripts folder, you have the NVRAddAppEntriesIcon.js and on the same level there is Info.html, which contains the information to be displayed on the Add an App page details.

The NVRAddAppEntriesIcon.js file looks like this and is configured using variables on top. It will redirect you to a SiteConfig NewForm, and provided our custom NVRFormIterator is running, some form properties will be prefilled for you.

(function() {
    if (!window["NVRAddAppEntries"]) window["NVRAddAppEntries"] = {};

    var appName = "DuplicateFields";
    var connectedApps = ["ItemUpdated", "ItemAdded"]; // []
    var packageName = "Receivers";
    var contentTypeId = "";
    var infoFilePath = "/NVR/DuplicateFields/Info.html";
    var minimalJSONconfig = '{"ItemUpdated": {"DuplicateFields--I": "DuplicateFields"},"ItemAdded": {"DuplicateFields--I": "DuplicateFields"} }';
	
	
    var relSource = NVR.getUrlParts(decodeURIComponent(tmpsrc)).pathname;
    
    window["NVRAddAppEntries"][appName] =
    {
        "Name": appName,
        "IconUrl": "/_layouts/15/images/ltdl.png?rev=23",
        "AppInstallUrl": "/Lists/SiteConfig/NewForm.aspx?"
            + "NVR_SiteConfigActive=true"
            + "&NVR_SiteConfigApp=" + appName + connectedApps.join("%0A") + "&Title=" + appName + "%20-%20/" + relSource
            + "&NVR_SiteConfigPackage=" + packageName
            + "&Source=" + NVR.common.get_url_param("Source")
            + "&NVR_SiteConfigUrl=/" + relSource
            + "&NVR_SiteConfigJSON=" + encodeURIComponent(minimalJSONconfig)
            + "&ContentTypeId=" + contentTypeId,
        "AppDetailsUrl": 'javascript:SP.UI.ModalDialog.showModalDialog({' +
            'url: "/_layouts/15/NVR.SPTools/GetScript.aspx?FilePaths=' + infoFilePath + '",' +
            'width: 800,' +
            'height: 600,' +
            'allowMaximize: true});'
    };
})();

The feature in the .wsp should have a feature event receiver that is inherited from Navertica.SharePoint.NVRFeatureReceiver.

The feature also has to have two custom properties defined, NVR_SiteScriptsFolder and NVR_SiteConfigFolder, where the relative way to the _LAYOUTS/YOUR_FEATURE_FOLDER/SiteConfig and SiteScripts is stored, so that on activation all the files get copied to SiteConfig and SiteScripts.

Copyright (C) 2015 NAVERTICA a.s. http://www.navertica.com

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.