Technical Archives - Collaboris https://www.collaboris.com/category/technical/ We make compliance simple Tue, 12 Nov 2024 11:26:41 +0000 en-GB hourly 1 https://www.collaboris.com/wp-content/uploads/2016/07/collaboris_favicon.png Technical Archives - Collaboris https://www.collaboris.com/category/technical/ 32 32 How to use SharePoint with your trusted partners https://www.collaboris.com/how-to-use-sharepoint-with-your-trusted-partners/ Wed, 19 Nov 2014 11:45:54 +0000 http://collaboriscom.wpengine.com/?p=190 How to use SharePoint with your trusted partners For many SharePoint is a bit of a black box. A large number of companies use it as an Intranet or document management system, but few really understand exactly what it can do. SharePoint itself isn’t entirely without blame. The platform has so many features and functions that […]

The post How to use SharePoint with your trusted partners appeared first on Collaboris.

]]>

How to use SharePoint with your trusted partners

For many SharePoint is a bit of a black box. A large number of companies use it as an Intranet or document management system, but few really understand exactly what it can do. SharePoint itself isn’t entirely without blame. 

The platform has so many features and functions that it can be a little confusing for the average business user to know what it does best. Over the years we have tried to develop an easy way to explain SharePoint to customers. Our five-point summary of SharePoint goes something like this:

1. SharePoint is probably the best enterprise document management system available. Use it a bit like a business-friendly Dropbox via OneDrive, create documents with Office Web Apps, or store fully version-controlled archives of files. SharePoint has document management covered!

2. SharePoint makes for a great Intranet platform. It has rich content editing and publishing controls and integrates with the existing the user directories your company is probably already using.

3. SharePoint is a powerful collaboration tool. One of its core strengths is the ability to create dedicated self-contained sites that can store collateral for a single team or project. Content can be anything from files and documents, video and audio, to calendars and tasks lists.

4. SharePoint is social. The latest versions of SharePoint are really powerful social tools. Use it to find and chat to colleagues, take part in discussions, or just see what is going on in the office.

5. SharePoint also makes for a great Extranet. It is a powerful and secure way to work with external parties, trusted partners and even vendors.

Extranet or Intranet?

Depending on your experience with SharePoint you might be familiar with some of the above. Likely you know the first, but maybe some of the others are less clear. For many the fifth and final point will raise some questions. Maybe you’ve never used SharePoint to work with people outside of your company.

An Extranet is the name given to such a system. It is just like your Intranet - a place to store content, documents, and to collaborate - but it is accessible to trusted partners outside of your main company.

Extranets have a raft of benefits. They make it easy to share files, rather than emailing them back and forth, and even create documents collaboratively. They can be a place to chat, hold online meetings, and collect together notes and other collateral.

Building a great Extranet

So now we know what an Extranet is, and that SharePoint is pretty well suited to this use case, how do we go about building a great one? We think there are five key things to think about.

1. Where to host?

There are now several versions of SharePoint and different ways to host it. The biggest decision is between SharePoint ‘On Premises’ and SharePoint Online.

‘On Premises’ is the traditional version that many companies host internally, though it can be set-up by a third party and hosted externally. This version will need a little configuration to ensure third parties can access (see below).

SharePoint Online is hosted in the Cloud and is part of Office 365. Microsoft is putting a lot of its efforts into this version, and it does support some native functionality for external sharing of sites and content. It is worth bearing in mind that moving to the Cloud may have wider ramifications, outside of an Extranet, that need to be considered.

2. User access

SharePoint Online can be configured to use existing Active Directory. It also supports external sharing with users who have Microsoft registered accounts.

SharePoint ‘On Premises’ is nearly always integrated Active Directory for normal company user access. Extradium from RioLinx is a great way to add support for third parties. This add-on allows external users to be granted access by administrators via the standard SharePoint interface. There is no need to get IT departments involved, and no need to clutter up Active Directory with temporary or external accounts.

3. Security

The out of the box SharePoint security model is the perfect means to ensure third parties on an Extranet can only access content that has been explicitly shared. Sites, lists, or individual files and list items can be secured to specific users or groups of people. Permissions can then be set at different levels - read only, edit, full access or anything in-between.

SharePoint also supports the concept of ‘Site Collections’ which allows an Extranet to be created in its own separate container, logically separated from an Intranet or sensitive company information.

4. Sharing documents (and asking for reading confirmation)

SharePoint offers a wealth of document management features which makes it easy to work collaboratively on all manner of projects. Features include versioning, check in/out, publishing and approval workflows, and Office Web Apps for browser-based file creation and editing.

Our own product, DocRead for SharePoint takes these built in features a step further by adding the ability to distribute documents for required reading and formal acknowledgement. In an Extranet environment this is the ideal way to ensure partners sign up to any applicable terms and conditions or policies related to their work.

5. Feedback from partners

Building on the features of DocRead, DocSurvey for SharePoint allows Extranet users to be tested on their understanding and comprehension of documents. Utilising intuitive and easy to fill out surveys, DocRead makes it easy to gather a variety of feedback from external partners.

If you combine DocRead and DocSurvey with Extradium then this provides a fantastic solution for managing third-party risk

You may also like:

The post How to use SharePoint with your trusted partners appeared first on Collaboris.

]]>
Eight benefits of using SharePoint as an Extranet https://www.collaboris.com/eight-benefits-of-using-sharepoint-as-an-extranet/ Wed, 12 Nov 2014 10:33:52 +0000 http://collaboriscom.wpengine.com/?p=194 Eight benefits of using SharePoint as an ExtranetSharePoint has a long history of being put to work as an enterprise grade Intranet platform, allowing organisations of all shapes and sizes to drive employee collaboration and communication. Its use as an Extranet tool isn’t quite so common, which is mainly down to some companies not fully […]

The post Eight benefits of using SharePoint as an Extranet appeared first on Collaboris.

]]>

Eight benefits of using SharePoint as an Extranet

SharePoint has a long history of being put to work as an enterprise grade Intranet platform, allowing organisations of all shapes and sizes to drive employee collaboration and communication. Its use as an Extranet tool isn’t quite so common, which is mainly down to some companies not fully understanding the nuances between Extranets and Intranets. The good news is SharePoint actually makes an excellent Extranet platform, with a whole host of useful features and functions. In this post we will look at eight clear benefits to using SharePoint for such a purpose.

Defining an Extranet

Firstly, what exactly is a SharePoint Extranet? In essence an Extranet is functionally identical to an Intranet but is accessed in a different manner. Extranets are used by third parties and partners, outside of the primary business or organisation, to collaborate on specific projects or pieces of work. An Extranet needs to allow these users controlled access to appropriate functionality and content, whilst securing away the main Intranet or internal business systems.

With that in mind, let’s look at eight benefits to building an Extranet with SharePoint.

1. Managing third party access

SharePoint typically uses Active Directory integration for user access, which works well in standard Intranet scenarios. But for Extranets, where third party users need to be added, secured and controlled in a slightly different manner, Sharepoint benefits from tools such as Extradium from RioLinx. This powerful enterprise product allows administrators to add third parties to SharePoint using the standard end user interface. This removes the often time consuming process of getting an IT department involved, and doesn’t clutter up company user directories with temporary accounts.

2. Security model

Tools such as Extradium, create standard user accounts, so once added third parties can be subjected to the same out of the box security model as any other SharePoint user. SharePoint supports assigning permissions directly to users, as well as to groups. Groups offer the most control and flexibility, and can be used to easily manage distinct sets of people with the same role e.g. All external Project Managers. Different levels of permissions can then be applied to users or groups, allowing a high level of control over what third parties can access or modify.

3. Document management

SharePoint offers a complete set of document management and collaboration features, that work extremely well in an Extranet scenario. As well as the standard feature set – including check in/out, version control and publishing approval workflows – SharePoint 2013 supports the extremely powerful Office Web Apps. This is an excellent way for third parties to work on and collaborate with documents in real time with other users, via the web browser or mobile apps.

4. Social communication

SharePoint 2013 offers a range of social collaboration and communication tools. Both users and content can be ‘followed’ and ‘liked’, which provides a really simple means to track and be notified of updates. A central Newsfeed keeps everyone in the loop, and a dedicated Community site template is a great way for multiple users to comment on group discussions.

Extranets typically involve collaboration between multiple teams, and the latest social tools in SharePoint are a really effective way to break down boundaries.

5. Secure controlled publishing

SharePoint 2013 supports the notion of ‘publishing sites’, which is a controlled way for content to be authored, branded, and published out to an Extranet. Content can be created centrally by a specific set of approved users, pushed through a dedicated workflow, and then published for consumption.

6. Powerful search

More and more users choose search over navigation to get to content. In an Extranet scenario, where third party users will be much less familiar with a systems structure and content classifications – search is even more relevant.

SharePoint 2013 offers some truly amazing leaps in search functionality over previous versions. Search has been rebuilt in this latest version, and it is now central to how content can be published across sites and pages. SharePoint 2013 is also the first version to include, for free, the complete FAST search product. This previously separate add on provides a real turbo boost to search indexing and results, meaning users find what they are looking for that little bit quicker.

7. Mobile support and access

Extranets typically support ad-hoc working between large numbers of different users in geographically disperse locations. In these scenarios mobile working is really important. SharePoint offers mobile friendly versions of all of its out of the box site and page templates. In addition Microsoft makes available a number of mobile apps across devices, such as the Newsfeed app for keeping people upto date on news and events.
Third party offerings, like SharePlus from Infragistics, offer even richer functionality with full offline support for documents and lists and easy editing tools.

8. Extend functionality with third party tools

Throughout this post we have referenced a number of really useful add ons to SharePoint that make it even more suitable for Extranet systems:

  • Extradium for easy management of third party users
  • SharePlus for rich mobile access
  • Our very own DocRead and DocSurvey for mandatory document acknowledgments and testing understanding.

SharePoint has an incredibly varied and mature community of third party products around it. With the release of the SharePoint 2013 ‘App Store’ these extra features have become even easier to manage and deploy. With such a rich native feature set, SharePoint is for many a great Extranet platform. With the addition of trusted third party products, like those in this post, its comes even better.

Find out more about how DocRead and Extradium can reduce the risks of working with third parties in SharePoint Extranets.

You may also like:

The post Eight benefits of using SharePoint as an Extranet appeared first on Collaboris.

]]>
Types of audiences that can be used by DocRead https://www.collaboris.com/types-of-audiences-that-can-be-used-by-docread/ Fri, 16 Mar 2018 11:19:51 +0000 https://www.collaboris.com/?p=1202442 Note: The information in this post relates to DocRead for on-premises SharePoint only. DocRead uses the SharePoint API to get the list of users that have been assigned to a DocRead audience. Because of limitations with this API DocRead audiences can only contain individual windows users, SharePoint Groups, ASP.Net roles, standard Windows security groups and SharePoint audiences. […]

The post Types of audiences that can be used by DocRead appeared first on Collaboris.

]]>
Note: The information in this post relates to DocRead for on-premises SharePoint only. 

DocRead uses the SharePoint API to get the list of users that have been assigned to a DocRead audience. Because of limitations with this API DocRead audiences can only contain individual windows users, SharePoint Groups, ASP.Net roles, standard Windows security groups and SharePoint audiences. Active Directory Universal security groups and distribution lists are not supported.

Also please be aware that, if you configure DocRead to support SharePoint Audiences on a specific site, you will only be able to assign SharePoint Audiences and SharePoint groups to DocRead Audiences on that site, windows users and Active Directory groups would need to be nested inside SharePoint groups. This is due to limitations with the SharePoint audiences control used by DocRead (People Picker).

You may also be interested in:

The post Types of audiences that can be used by DocRead appeared first on Collaboris.

]]>
Amend the Owstimer.exe.config to support DocRead under FBA https://www.collaboris.com/amend-the-owstimer-exe-config-to-support-docread-under-fba/ Mon, 15 Dec 2014 06:58:06 +0000 http://collaboriscom.wpengine.com/?p=458 Amend the Owstimer.exe.config to support DocRead under FBAIf you choose to use a different authentication mechanism such as FBA that requires a ‘Role’ and ‘Membership’ provider specified in your web.config then you will also need to copy these entries to your owstimer.exe.config file. Here’s an example of a working owstimer.exe.config file that is set-up to use Extradium. […]

The post Amend the Owstimer.exe.config to support DocRead under FBA appeared first on Collaboris.

]]>

Amend the Owstimer.exe.config to support DocRead under FBA

If you choose to use a different authentication mechanism such as FBA that requires a ‘Role’ and ‘Membership’ provider specified in your web.config then you will also need to copy these entries to your owstimer.exe.config file.

Here’s an example of a working owstimer.exe.config file that is set-up to use Extradium. (Extradium is an identity management solution that allows you to make your SharePoint accessible externally and works really well with DocRead). If you don’t do this, then the DocRead timer jobs will not be able to access the FBA database causing the SharePoint API to return empty groups. This will result in tasks being removed, so it’s vitally important you copy the entries from your web.config.

Example :

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
 <startup useLegacyV2RuntimeActivationPolicy="true">
 <supportedRuntime version="v4.0.30319" />
 </startup>
 <runtime>
 <NetFx40_LegacySecurityPolicy enabled="true" />
 <appDomainManagerAssembly value="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" />
 <appDomainManagerType value="Microsoft.SharePoint.SPAppDomainManager" />
 </runtime>
<system.web>
 <membership defaultProvider="i">
 <providers>
 <add name="i" type="Microsoft.SharePoint.Administration.Claims.SPClaimsAuthMembershipProvider, Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" />
 <add name="ext" type="RioLinx.Extradium.Providers.ExtradiumMembershipProvider, RioLinx.Extradium.Providers, Version=3.0.0.0, Culture=neutral, PublicKeyToken=ee2f606d34db8cb1" />
 </providers>
 </membership>
 <roleManager defaultProvider="c" enabled="true" cacheRolesInCookie="false">
 <providers>
 <add name="c" type="Microsoft.SharePoint.Administration.Claims.SPClaimsAuthRoleProvider, Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" />
 <add name="extg" type="RioLinx.Extradium.Providers.ExtradiumRoleProvider, RioLinx.Extradium.Providers, Version=3.0.0.0, Culture=neutral, PublicKeyToken=ee2f606d34db8cb1" />
 </providers>
 </roleManager>
</system.web>
</configuration>

The post Amend the Owstimer.exe.config to support DocRead under FBA appeared first on Collaboris.

]]>
How to update multiple documents in a SharePoint document library with PowerShell https://www.collaboris.com/how-to-update-multiple-documents-in-a-sharepoint-document-library-with-powershell/ Wed, 12 Nov 2014 07:59:24 +0000 http://collaboriscom.wpengine.com/?p=546 How to update multiple documents in a SharePoint document library with PowerShellWe recently received a query for DocRead to see if it was possible to set the ‘Required Audience’ and ‘Acknowledgement Days’ to about 100 policies on mass (via a script). Hence, being one who is always up for a challenge, I loaded up PowerGUI and […]

The post How to update multiple documents in a SharePoint document library with PowerShell appeared first on Collaboris.

]]>

How to update multiple documents in a SharePoint document library with PowerShell

We recently received a query for DocRead to see if it was possible to set the ‘Required Audience’ and ‘Acknowledgement Days’ to about 100 policies on mass (via a script). Hence, being one who is always up for a challenge, I loaded up PowerGUI and set to work!

Prerequisites

This script can easily be modified to set any column value, but, obviously my example was specifically to update ‘Required Audience’ and / or ‘Recommended Audience’ columns that DocRead relies upon to distribute the documents to correct groups. To follow my example, you will need to :

  • Have enabled DocRead on the site containing the Document library.
  • Attached DocRead to the Document Library.
  • Populated the Document Library with a few important policies.

Instructions

  1. Copy the script below (into notepad) and save as ‘DocRead-Set-DocProps.ps1’ on one of your WFE’s.
  2. Login to the WFE as a user who is an admin and who also has contribute permissions on the Document Library containing the policies.
  3. Load a SharePoint PowerShell session.
  4. Within the PowerShell session, ‘CD’ into the directory where you saved the script. (e.g. CD c:Powershell).
  5. Now copy this line, changing the values in orange to match your url, document library name, comment, and group names.
  6. .DocRead-Set-DocProps.ps1 -prmUrl “http://localhost” -prmFolder “Documents” -prmCommentField “DocRead Comment” -prmComment “Your comment” -prmRequiredGroupName “DocRead test group” -prmRecommendedGroupName “Approvers” –prmRequiredAckDays 4 -prmRecommendedAckDays 5 -prmOverrideCheckOut 0
  7. Run it!
  8. Once it has run, the script will checkout each document, amend the audience and comment columns, check in and optionally approve and publish the document.
  9. For DocRead users, the next step is to process site readerships via the DocRead menu.

The PowerShell Script

(Please note : this sample script has only been tested on version DocRead 2.3)

param(
[string]$prmUrl,
[string]$prmFolder,
[string]$prmCommentField,
[string]$prmComment,
[string]$prmRequiredGroupName,
[string]$prmRecommendedGroupName,
[int]$prmRequiredAckDays,
[int]$prmRecommendedAckDays,
[boolean]$prmOverrideCheckOut
)

# Load up SP required snap in.
if(-not(Get-PSSnapin | Where { $_.Name -eq "Microsoft.SharePoint.PowerShell"})) {
  Add-PSSnapin Microsoft.SharePoint.PowerShell;
}

$web = Get-SPWeb $prmUrl

# Get the folder
$folder = $web.GetFolder($prmFolder);


# Only do this if the folder is in the web.
if ($folder.Exists) {

    # Loop through files and check out if file is not already checked out
    $folder.Files | ForEach-Object     {
    
        if ($_.CheckOutType -ne "None" -and $prmOverrideCheckOut) {
            $_.CheckIn("Override Checkout")
        }
        
        # Check if file is not checked in if ($_.CheckOutType -eq "None") 
        {          
          Write-Host Checking out         : $_.Name
          $_.CheckOut()
          
          # Set Comment field
          if ($prmCommentField) {
              $_.Item[$prmCommentField] = $prmComment
          }
          
          # Set Required Audience
          if ($prmRequiredGroupName) {
              
              if (!$prmRequiredAckDays) {
                  $reqAckDays = 7
              } else {
                $reqAckDays = $prmRequiredAckDays
              }
              
              $reqUserGroup = $web.Groups[$prmRequiredGroupName]
              Write-Host Setting Required Audience    : $prmRequiredGroupName
              $_.Item["Required Audiences"] = ";#;;;;;;;;" + 
                                  $reqUserGroup.Name + ";#" + 
                                $reqAckDays + ";#"
          }
          
          # Set Recommended Audience
          if ($prmRecommendedGroupName) {
              
              if (!$prmRecommendedAckDays) {
                  $recAckDays = 7
              } else {
                $recAckDays = $prmRecommendedAckDays
              }
              
              $recUserGroup = $web.Groups[$prmRecommendedGroupName]
              Write-Host Setting Recommended Audience : $prmRecommendedGroupName
              $_.Item["Recommended Audiences"] = ";#;;;;;;;;" +
                                      $recUserGroup.Name + ";#" + 
                                    $recAckDays + ";#"
          }
          
          $_.Item.Update()          
          $_.CheckIn("Checked in.")
          # Check for a publish
          if (($_.Level -eq [Microsoft.SharePoint.SPFileLevel]::Draft)) {
            Write-Host Publishing a major version
              $_.Publish("Published.")
            $_.Update();
          }
                          
          # Check for an approve
          if ($_.Item.ModerationInformation){      

            if ($_.Item.ModerationInformation.Status -eq 
                    [Microsoft.SharePoint.SPModerationStatusType]::Pending) {
                Write-Host Approving
                $_.Approve("Approved")
                $_.Update();
            }
          }
        } 
        else 
        {
          Write-Host $_.Name already checked out;
        }
    }
}
$web.Dispose()

 

The post How to update multiple documents in a SharePoint document library with PowerShell appeared first on Collaboris.

]]>
DocRead Upgrade Instructions https://www.collaboris.com/docread-upgrade-instructions/ Mon, 24 May 2021 12:23:24 +0000 https://www.collaboris.com/?p=1368478 DocRead Upgrade InstructionsInstructions on how to upgrade your DocRead installation to the latest versionNote: The information in this post relates to DocRead for on-premises SharePoint only.  You can also request our help at any time by submitting a support request to our Helpdesk team. Request Help If you prefer written instructions you can find step by […]

The post DocRead Upgrade Instructions appeared first on Collaboris.

]]>

DocRead Upgrade Instructions

Instructions on how to upgrade your DocRead installation to the latest version

Note: The information in this post relates to DocRead for on-premises SharePoint only. 

You can also request our help at any time by submitting a support request to our Helpdesk team.

If you prefer written instructions you can find step by step instructions in section 6 of the DocRead System Administrator's Guide.

Upgrading DocRead to the latest version means that you will be able to benefit from the new features and improvements that have been released. Upgrades are included in the annual support package available from Collaboris. If you are unsure whether you are eligible for upgrades, please contact your account manager in the first instance, or use the button above to contact the help desk. Thank you.

Related Posts

May 28, 2015

Our SupportThere are various resources and tools available to both customers and non-customers for ...

Read More

The post DocRead Upgrade Instructions appeared first on Collaboris.

]]>
Using DocRead in a hybrid scenario https://www.collaboris.com/using-docread-in-a-hybrid-scenario/ Thu, 06 Feb 2020 16:03:20 +0000 https://www.collaboris.com/?p=1367933 Using DocRead in a hybrid scenario DocRead needs to be installed into an on-premises version of SharePoint. It is possible for the same SharePoint Farm to have other sites running in SharePoint Online, but the site where DocRead is installed needs to be fully running on-premises. It is possible to create a “link” to a […]

The post Using DocRead in a hybrid scenario appeared first on Collaboris.

]]>

Using DocRead in a hybrid scenario

DocRead needs to be installed into an on-premises version of SharePoint.

It is possible for the same SharePoint Farm to have other sites running in SharePoint Online, but the site where DocRead is installed needs to be fully running on-premises.

It is possible to create a “link” to a document that is stored in the cloud in a SharePoint list and then assign the “link” to the correct group of users using DocRead. When a user tries to complete the DocRead task, the link will take them to the correct document (stored in the cloud) which can then be completed as normal using DocRead. Obviously you need to be sure that the cloud document remains in the same place as, if it is moved, then the link won’t work and the user will be unable to complete the task.

For this reason, it’s recommended that items to be assigned via DocRead are always placed into an on-premises document library or list that remains under your control to ensure that users can always get access to the important information you are trying to share.

The post Using DocRead in a hybrid scenario appeared first on Collaboris.

]]>