28
Skype Connection Kit Solution SharePoint® 2010 User Guide © VEA GmbH Version 2.0.2 August 2011

Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

  • Upload
    others

  • View
    3

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

Skype Connection

Kit Solution SharePoint® 2010 User Guide

© VEA GmbH

Version 2.0.2

August 2011

Page 2: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

Contents 1 Description ............................................................................................................................................................................. 3

1.1 Skype Connection Kit for SharePoint Foundation – Components .................................................................................... 4

2 Typical Use Cases ................................................................................................................................................................... 6

2.1 Contact your Team .......................................................................................................................................................... 6

2.1.1 Settings used: ......................................................................................................................................................... 6

2.2 Collaborate with the users assigned to a Task list ........................................................................................................... 6

2.2.1 Settings used: ......................................................................................................................................................... 6

2.3 Enabling Skype Conferencing in a meeting workspace .................................................................................................... 7

2.4 Who is available ............................................................................................................................................................... 7

3 Installation .............................................................................................................................................................................. 8

3.1 Prerequisites .................................................................................................................................................................... 8

3.2 One step Installation ........................................................................................................................................................ 8

3.3 Conventional Installation ................................................................................................................................................. 8

4 Web Part Configuration & Settings ...................................................................................................................................... 12

4.1 Access Rights for Visitors ............................................................................................................................................... 12

4.2 Skype Connection Kit Settings ....................................................................................................................................... 13

4.3 Skype Connection Kit Profile Updater Job Setting ......................................................................................................... 15

4.4 'Skype People' List (only for Foundation Version) ......................................................................................................... 16

4.5 Skype User Properties (only for Server Version) ............................................................................................................ 17

4.6 Web Part – My Skype Account ....................................................................................................................................... 18

4.7 Feature – VEA Skype Connection Kit Skype Accounts .................................................................................................... 19

4.8 Web Part – Skype Conference ....................................................................................................................................... 19

4.8.1 Participant Settings .............................................................................................................................................. 20

4.8.2 Conferencing Layout ............................................................................................................................................ 20

4.8.3 Dialog Settings...................................................................................................................................................... 21

4.8.4 Advanced Dialog Templating ................................................................................................................................ 21

4.8.5 Advanced Participant Templating ........................................................................................................................ 22

4.8.6 AJAX ..................................................................................................................................................................... 23

4.9 Web Part – Site Users Skype Conference ....................................................................................................................... 23

4.9.1 Conferencing Layout ............................................................................................................................................ 23

4.9.2 Dialog Settings...................................................................................................................................................... 24

4.9.3 AJAX ..................................................................................................................................................................... 24

4.10 Web Part – Meeting Workspace Skype Conference ................................................................................................. 25

4.10.1 Conferencing Layout ............................................................................................................................................ 25

4.10.2 Dialog Settings...................................................................................................................................................... 25

4.10.3 AJAX ..................................................................................................................................................................... 26

4.11 Placeholders .............................................................................................................................................................. 26

4.11.1 Placeholders related to Skype Presence Status and Skype functions .................................................................. 26

4.11.2 Placeholders to get field values and user properties ........................................................................................... 27

Page 3: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.11.3 Advanced placeholders ........................................................................................................................................ 28

1 Description The Skype Connection Kit is a simple to use, yet powerful conferencing and group communication solution.

There are 2 versions, one designed for SharePoint 2010 Foundation and the other for SharePoint 2010 Server. In any case, it has tremendous installation and administration advantages over OCS and Lync...

Features include:

Seamless integration of the Skype Presence Information The Skype Presence Information being automatically refreshed, embraces presence and communication functionality similar to OCS or Lync.

In context menu to access all communication tools This Skype Presence Indicator offers an in-context menu, which gives your teams quick and powerful access to each other, even when working at a distance and in different time zones.

Initiating single calls or conferences directly out of SharePoint With one click you can call a single person or a group of persons through Skype directly out of SharePoint. Instant Messaging and sending emails to individuals or a group of persons is supported in the same way. Defining the groups and selecting the persons is made very flexible and implemented in a powerful manner.

Fast and simple installation With the Skype Connection Kit there is no need to set up and configure a server for your group communication. Add this solution to your site collection, activate the features, and fill in the Skype User credentials of your team --- you are connected. All this can be done in a very short time.

Technically the presence indicator is updated through a background service running on the SharePoint server. This ensures full performance and fast page rendering of your SharePoint installation with the Skype Connection Kit.

As mentioned, Skype Connection Kit is available in 2 Versions:

For SharePoint 2010 Foundation: To manage the Skype User settings it uses its own list, called Skype People List

For SharePoint 2010 Server: The Skype User settings are amended as properties to the User Profile properties.

Page 4: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

1.1 Skype Connection Kit for SharePoint Foundation – Components

After installation, there are in total 3 features available:

1. VEA Skype Connection Kit for SharePoint Foundation or SharePoint Server:

This feature contains four Web Parts and a Custom Field to display and manage Skype Presence, start Conferences

and Conversations. It also offers a Web Part providing a link to edit the personal Skype Profile in the 'Skype People

List'.

2. VEA Skype Connection Kit 'People List' Updater Job or Profile Updater Job:

This feature creates and manages a SharePoint timer job to update the Skype Presence status of users in the 'Skype

People' list. Job settings may be changed via the site administration page or Central Administration.

3. VEA Skype Connection Kit Skype Accounts:

This feature adds a menu entry to the Personal Menu to edit the personal Skype Profile in the 'Skype People' list.

The central component of the Skype Connection Kit is the list which holds the Skype User settings. In case of the Foundation

version it is a user list called 'Skype People'. For the Server version, the necessary properties are amended to the User Profile

properties. They hold the necessary credentials for the Skype functions and mailing.

When deploying the solution, the 'Skype People' list is automatically created. For the Server version, the Administrator needs

to take care, that properties have been created correctly. The Administrator may enter the credentials for the users or let

them enter their Skype account themselves by using a specialized web part or an entry in the personal menu.

Page 5: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

The users can create their own entry with the Skype Accounts Feature or with the 'My Skype Account' Web Part (not

shown in the scheme above).

The Skype Presence in this list is updated regularly by the Updater Job (default: every 1 minute). This job ensures

that the presence is updated regularly in the background without putting traffic load on your SharePoint site itself. To do this,

it uses a Skype service accessible at mystatus.skype.com with the corresponding SkypeUserName. Access to

mystatus.skype.com has to be enabled.

Skype provides the presence information only, when the users have agreed to1. The users therefore must have agreed in their

privacy settings (in the client software provided by Skype) to allow the online status to be shown on the web.

Once the 'infrastructure' is set up, the Integrated Skype Presence Information is available wherever Name (with

presence) fields are available, i.e. the 'Assigned To' field in the Tasks List or the 'Created by' field etc. Wherever you see the

Skype Presence, a drop-down-menu is available to manage communication actions with that particular person. The availability

of actions depends of the data provided in the Skype People List. Call, Chat and Add are available, when a Skype User Name is

given. MailTo is available, when an email address is provided.

Finally, the Skype Conferencing web parts are provided to establish and initiate any group communication like

Chatting, Calling and Emailing with a group of people. There are 2 preconfigured Skype Conferencing web parts, one to show

the team presence (Site Users Skype Conferencing) and another one to be added to a meeting workspace. The latter will add

group communication functionality to the 'Attendees' of a meeting workspace.

1 NOTE: VEA will shortly deliver a Skye Server service that can circumvent the above rule and provides additional

features like sending SharePoint alerts via Skype, recording calls and automatically providing the recorded call in your SharePoint site to your users. For more information about this service, contact us at [email protected].

Page 6: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

2 Typical Use Cases

2.1 Contact your Team

This use case shows how to display the Skype presence of team members. This is based on the preconfigured 'Site Users Skype

Conference' Web Part.

2.1.1 Settings used:

Conferencing Settings:

Site User Group: Site Members

Dialog Settings:

Dialog Title: Team communication

2.2 Collaborate with the users assigned to a Task list

The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

create one with users assigned to tasks. Please consider that it is possible to filter the users based on views or CAML Queries

too.

Our example consists of 2 web parts: 'Skype Conference' and the Tasks web part. Add the Tasks web part to a page. Add

above it the 'Skype Conference' web part too. Adjust the settings of the 'Skype Conference' web part as it is shown below.

2.2.1 Settings used:

Paricipant Settings:

Source: List List Name: Tasks

Conferencing Layout:

Show Users: not enabled

The Skype Presence is shown automatically in the Tasks web part.

Page 7: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

2.3 Enabling Skype Conferencing in a meeting workspace

This use case shows how to create Skype conferences with the attendees of a meeting. Just open a meeting workspace and

add the 'Meeting Workspace Skype Conference' web part to it and rename it to in our case 'Skype Conference. Here you go.

2.4 Who is available

By default Skype presence is shown automatically at many places and refreshes itself.

Page 8: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

3 Installation

3.1 Prerequisites

Before you attempt to install the solutions you need to make sure that you have the following installed on your server(s):

Microsoft SharePoint Server 2010 or SharePoint Foundation 2010

3.2 One step Installation

1. VEASkypeConnectionKitF contains the files for SharePoint 2010 Foundation. VEASkypeConnectionKitP contains the files for SharePoint 2010 Server.

2. The description refers to the Foundation version AND to the Server version. File names or references particular to the Server version are put into parenthesis.

3. Unpack the VEASkypeConnectionKitF.zip (VEASkypeConnectionKitP.zip) and place the files in the respective folders onto your SharePoint Server.

4. Unblock the PowerShell installation Script Inst.ps1 Right click in Explorer on Inst.ps1, select “Properties”, click on “Unblock”.

5. Start the Install.BAT (Run as administrator) Right click on Install.BAT, select “Run as administrator” All Solutions will be installed, deployed and its features will be activated on the site you have chosen. No further installation steps will be required, besides the entering of the Skype User Names.

3.3 Conventional Installation

1. VEASkypeConnectionKitF contains the files for SharePoint 2010 Foundation. VEASkypeConnectionKitP contains the files for SharePoint 2010 Server.

2. The description refers to the Foundation version AND to the Server version. File names or references particular to the Server version are put into parenthesis.

3. Unpack the VEASkypeConnectionKitF.zip (VEASkypeConnectionKitP.zip) and place the files in the respective folders onto your SharePoint Server.

4. Add the Solution by either running Install2010.bat or manually entering: stsadm.exe -o addsolution -filename VEASkypeConnectionKitF.wsp (VEASkypeConnectionKitP.wsp) and the same for VEASCKListUpdaterJob.wsp (VEASCKProfileUpdaterJob.wsp)

5. Deploy the solution by navigating with your browser to Central Administration > System Settings > Farm Management > Manage farm solutions

6. You should now see the VEASkypeConnectionKitF.wsp (VEASkypeConnectionKitP.wsp) and VEASCKListUpdaterJob.wsp (VEASCKProfileUpdaterJob) in the farm's solution store:

Page 9: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to
Page 10: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

7. Click on VEASkypeConnectionKitF.wsp (VEASkypeConnectionKitP.wsp) and VEASCKListUpdaterJob.wsp

(VEASCKProfileUpdaterJob.wsp) to deploy the solutions:

8. Proceed to activate Skype Connection Kit Updater Job feature on your SharePoint server. This is only possible via command line in administrator mode. For SharePoint 2010 Foundation, please use: "c:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\bin\STSADM.EXE" -o activatefeature -id 064d8aad-ab25-482b-a5a0-3e54b9f06e75 -url http://sp.contonso.com. For SharePoint 2010 Server, please use: "c:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\bin\STSADM.EXE" -o activatefeature -id cf69b517-f89a-47b3-bc57-a85e6cb89030 -url http://sp.contonso.com. Please replace “http://sp.contonso.com” with the URL of your site collection.

9. Proceed to activate the other Skype Connection features by navigating to the “Site Actions/Site Settings” page in your top-level site:

Page 11: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

10. Choose “Site collection features” to navigate to the Site Collection Features page:

Activate the VEA Skype Connection Kit for SharePoint Foundation (VEA Skype Connection Kit) and VEA Skype Connection Kit Skype Accounts feature

Adding the Web Part to a Page

Navigate to a page where you would like to place the web part and choose "Site Actions/Edit Page"

Add the web part to the appropriate zone. The web part is listed in the "VEA" gallery section:

After adding the Skype Conference web part, you may proceed to the configuration of the web part.

Page 12: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4 Web Part Configuration & Settings

4.1 Access Rights for Visitors

By default SharePoint does not allow members of the Visitors Group to see the membership of the Owners Group. As such

they cannot see the members of that SharePoint group. The result is that Visitors would not see Owners in any of the Skype

Conferencing Web Parts and would not be able to invite them to call, chat or conference.

If you want to allow Visitors to see the Owners, you must set the Group Permissions of the Owner Group accordingly.

To do this, at the site collection level got to Site Actions -> Site Settings -> Users and Permissions -> People and groups. There

you click 'Groups' to get access to the Group Settings:

You will see the available groups. Click to edit the settings of the Owners Group and under Group Settings set 'Who can view

the membership of the group? To 'Everyone'

Page 13: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.2 Skype Connection Kit Settings

The Skype Connection Kit Settings can be accessed via Site Actions / Site Settings / Site Administration:

This opens the configuration window of the Skype Connection Kit2:

Section Skype People List (only for Foundation Version):

2 NOTE: While the Skype Connection Kit supplies a vast number of settings to adjust its appearance and providing a high level

of flexibility, it works out of the box with its default settings.

Page 14: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

Here you set the location and name of the 'Skype People List'. If not existing, the list will be automatically created at

http://localhost. In case you have several web applications, with the same list, you need to specify that common list here.

On the top right you find a link with direct access to the Skype People list. Alternatively navigate to the root of your site

collection. Under lists, you will find “SkypePeople”.

Appearance section:

Under Appearance you can disable the Skype Presence feature and set the update interval of the presence indicator

Further you set the default templates for the Name (with presence) fields:

Presence Template:

Leave this field empty to show the dropdown menu or

combine text with html and one of the following placeholders:

- {dropdownmenu} shows the dropdownmenu.

- {SPUser.x} where x is replaced with one of: Name, LoginName, EMail, ID, Picture, Icon, Sid

Presence Dropdown Menu Text:

Leave this field empty to show the user name or combine text with one of the following placeholders:

- {SPUser.x} where x is replaced with one of: Name, LoginName, Email, ID, Picture, Icon, Sid

Presence DropDown Menu Icon:

Leave this field empty to show the skype presence icon or use the placeholder {simple} to show the SharePoint presence

icon or any URL to a picture.

You may also modify the values for the presence status texts and the drop-down-menu captions. The intention is to allow

other language setups, i.e. German instead of English.

Drop-down-menu:

Timer Job section:

This section contains some instructions with regards to the Update Timer job.

License section:

Here you enter the license code you received when purchasing this web part. When installing this web part on your server, a

unique serial number is created and shown here as well. Once you entered your license code, please activate it to quit the

trial mode.

Page 15: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.3 Skype Connection Kit Profile Updater Job Setting

The Skype Connection Kit Settings can be accessed via Site Actions / Site Settings / Site Administration:

This opens the status window of the Skype Connection Kit Profile Updater Job:

Here you find the information whether Skype Users properties have been correctly amended to the User Profile.

If not, the message below will be shown:

For more details, please refer to chapter 4.5 Skype User Properties (only for Server Version).

Page 16: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.4 'Skype People' List (only for Foundation Version)

The Skype People List can be accessed via the Skype Connection Kit Settings. Alternatively navigate to the root of your site

collection. Under lists, you will find 'SkypePeople'.

Here you may enter the details of users with Skype User Accounts. For Title you normally enter the name of person:

Only people, referenced in this list will be available for conferencing and chat. If no email address is entered in the 'Skype People' List, the email address of the normal User Profile is taken. If there is no email address at all, the mail action will not be available.

Otherwise let the user enter their credentials themselves. There are 2 possibilities to do this:

1. Through the web part 'My Skype Account' (see chapter 4.6 Web Part – My Skype Account)

2. Through the feature 'VEA Skype Connection Kit Skype Accounts', which adds an additional menu entry to the

personal menu (see chapter 4.7 Feature – VEA Skype Connection Kit Skype Accounts)

Page 17: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.5 Skype User Properties (only for Server Version)

Skype User properties normally are amended to the User Profile during installation and deployment of the web parts on the

SharePoint 2010 server.

Under some circumstances it is necessary to do this manually. Go to Central Administration -> Application Management ->

Service Application -> Manage service applications and click User Profile Service Application:

Under People click 'Manage User Properties' and add the required Skype User Properties:

These are the necessary properties in order to provide full functionality to the Skype Connection Kit:

SkypeUserName:

o Type: string (Single Value)

o Length: 100

o Policy Settings: Optional

o Default Privacy Setting: Everyone

o Edit Settings: Allow users to edit values for this property

o Display Settings: Show on the Edit Details page

SkypePresenceStatus:

o Type: integer

o Policy Settings: Optional

o Default Privacy Setting: Everyone

o Edit Settings: Allow users to edit values for this property

o Display Settings: Show on the Edit Details page

Page 18: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

The administrator now may add the 'Skype User Names' to the users. To do this, navigate back to the User Profile Service

Application. Under People click 'Manage User Profiles' and select the appropriate users:

Otherwise let the users enter their credentials. There are 3 possibilities to do this:

1. Through the User Profile (My Profile -> Edit My Profile)

2. Through the web part 'My Skype Account' (see chapter 4.6 Web Part – My Skype Account)

3. Through the feature 'VEA Skype Connection Kit Skype Accounts', which adds an additional menu entry to the

personal menu (see chapter 4.7 Feature – VEA Skype Connection Kit Skype Accounts)

4.6 Web Part – My Skype Account

There are 2 options for normal SharePoint users to edit their Skype Profile in the 'Skype People' list.

The first option is the adding the web part 'My Skype Account'. Then second is to activate the 'VEA Skype Connection Kit

Skype Accounts' feature.

Adding the web part 'My Skype Account' (classified to the category 'VEA') shows a menu link for the user, through which he

can access his 'Skype People' list entry.

This web part looks very simple:

Editing the web part reveals an Advanced Web Part Templating section:

Show Link: Here you can set the visibility of Edit link. Options are Always, OnlyIfAccountIsMissing, Never.

Link Template: Use {default} or your customized template to display a link to the personal entry in the Skype People List. Placeholders are: {default}, {popupurl}, {editorurl}, {linktext}, {username}, {userloginname} and {userid}. The {default} placeholder expands to: <a href='{popupurl}'>{linktext}</a>. {linktext} stands for the content of the property 'Link Text'.

Link Text: Edit the text you want to appear for the link to the personal entry in the Skype People List.

Page 19: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.7 Feature – VEA Skype Connection Kit Skype Accounts

Activating the feature 'VEA Skype Connection Kit Skype Accounts' provides an additional menu entry to the personal menu (top right of each SharePoint site) to edit the personal entry in the Skype People List.

4.8 Web Part – Skype Conference

The primary function of this web part is to manage a list of participants and to feed them to a Dialog Box for conferencing.

A second function is to provide a drop-down-menu to manage communication actions with single persons. The availability of

actions depends of the data provided in the Skype People List. Call, Chat and Add are available, when a Skype User Name is

given. MailTo is available, when an email address is provided.

The Web Part does not need to have its own list, but may use already available lists. So the list of participants itself is not part

of this web part. The conferencing web part just offers different options to refer to and existing list and in general shows its

content. There are vast customization options of both, the presentation of the participant list and the user interface of the

Dialog Box.

Page 20: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

Editing the web part reveals the following panel:

4.8.1 Participant Settings

Source: Select the source of participants. SiteUsers or List are available

Site User Groups: Specify the name of the participants Group (used

only if Source is 'SiteUsers').

List Site URL: Specify the URL of the list site (used only if Source is 'List'). Leave it empty to use the current site.

List Name: Specify the name of the participants list (used only if Source is 'List').

List View: Specify the name of the participants view (used only if Source is 'List').

User - field name: Field in the participants list that contains the SharePoint user account or email address. (Email address must be specified then in Skype People List)

Sort by user name: Check to sort the list by user names ascending.

List CAML Query: Specifiy a CAML query and clause. Leave clause empty to select all items limited by 'Max. Items'. Not applied, if you specified a View or selected SiteUsers as the 'Source'.

Max. Items: Specifiy the max. number of items to show.

4.8.2 Conferencing Layout

Show conference link: If set, the conference link will be shown. (Useful if you want to create a view of a list were you only have the drop-down-menu available for participants)

Link is on top: If set, the conference link will be shown on top of the participant list.

Conferencing Link Template: Leave it empty to show the {default-24} link. Valid placehoders are: {default}, {default-16/-24/-32/-48), {dialogurl}, {linktext}, {conferenceicon}, {conferenceicon-16/24/32/48}.

Conferencing Link Text: Set the text of the create conference link (e.g.: Get connected). One may refer to this text with the {linktext} placeholder in the 'Conference Link Template'.

Show Participants: If set, the participants will be shown. (Useful if you just want to use the conferencing link and the source list of the participants is visible on the same site)

Page 21: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.8.3 Dialog Settings

Dialog Title: Specify the title of the Dialog Box.

Dialog List Title: Specify the header line of the list. Leave it empty to use the default text "Please select your contacts:"

Dialog Icon: Enter a URL to an image to specify the icon of the dialog. Leave it empty to show the standard icon.

Dialog Width and Height: Specify width and height of the Dialog Box.

Call, Chat and Email-button caption: Specify the caption of the Call, Chat- or Email-button (or leave it empty to hide the button).

4.8.4 Advanced Dialog Templating

Dialog Participant Cell Template: Specify the template to apply for displaying a participant row. Leave the template empty to show the name of the user. Placeholders are {SPUser.xxx}, {Source.xxx}. HMTL-code is allowed

Available Functions Indicators: Set the template to show icons for available functions (skype or email related). Placeholders: {default}, {default-16}, {default-24}, {default-32}, {default-48}. Leave it empty to hide the indicators.

Distinct Items: If set, only distinct items will be displayed.

Participant Item Filter Mode: Select how invalid or missing Skype User Names will be handled in the conference dialog. Valid options are: ShowOnlyValidItems, IndicateErrors, ShowAllItems and DebugMode.

Page 22: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.8.5 Advanced Participant Templating

Advanced templating manages all settings of the participants lists view within the conferencing web part.

The following scheme shows the different aspects which can be configured:

DropDown Menu Text: You may specify a template for the dropdown menu caption. Leave it empty to show the user name. Valid placeholders are: {Source.xxx}, {SPUser.xxx}.

Presence Template (second cell): Leave it empty to show the dropdown menu. You may use placeholders like {dropdownmenu}, {Source.xxx}, {SPUser.xxx}, {status}, {statustext}, {statusicon-16/-24/-32/-48}, {action-call/-chat/-add}, {skypeusername}, {userid}, {username}, {userloginname}, {callicon-16/-24,-32,-48}. Furthermore the following icon placeholders are available: {chaticon-16/-24/-32/-48}, {addicon-16/-24/-32/-48}, {skypeicon-16/-24/-32/-48}, {conferenceicon-16/-24/-32/-48}.

User Picture Template (first cell): Use a template to configure appearance of the first cell. Leave it empty to show a user picture. Use {default} or {default-16,-24,-32,-48) to show the default custom template. You may use placeholders like {userimage}, {status}, {statustext}, {statusicon-16/-24/-32/-48}, {action-call/-chat/-add}, {skypeusername}, {userid}, {username}, {userloginname}, {callicon-16/-24,-32,-48}.

DropDown Menu Icon: Leave it empty to show the skype presence status icon, {simple} to show the SharePoint presence status icon or an URL to a picture.

View Link Text: Specify the text of the {view} link. Only applied, if your Header/Footer Template contains the {view} placeholder.

List Footer Template: Specify a template to be showed at the end of the participant list. Valid placeholders are: {view} (only for Lists), {SPList.xxx}, {SPWeb.xxx}, {SPSite.xxx}, {SPUser.xxx}, {Query.xxx}.

List Header Template: Specify a template to be shown at the top of the participant list. Valid placeholders are: {view} (only for Lists), {SPList.xxx}, {SPWeb.xxx}, {SPSite.xxx}, {SPUser.xxx}, {Query.xxx}.

Distinct Items: If set, only distinct Participants (users) will be displayed.

Hidden Fields: Enter a list of fields to be hidden delimited by ';'

Apply Templates: If set, the advanced participant templating will be applied. Otherwise the settings of the Presence Template set in Skype Connection Kit Settings will be applied.

Presence Template (second cell)

User Picture Template (first cell)

List Header

List Footer

{dropdownmenu}

DropDown Menu Text

DropDown Menu Icon

Page 23: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.8.6 AJAX

Enable AJAX: If checked, the contents of the web part will be refreshed by AJAX function. It overrides the general Presence Refresh settings of set in the VEA Skype Connection Kit Settings.

Refresh interval: Refresh interval in seconds. A value below 1 means no refresh.

4.9 Web Part – Site Users Skype Conference

This web part is based on the generic 'Skype Conference' web part and is intended to show your teams presence. Add it to any site or workspace and you will have a group communication feature:

4.9.1 Conferencing Layout

Site User Groups: Specify the names of the participant groups delimited by ';'. Leave it empty to show all site users. To populate the property with all site group names enter a '*'.

Show User Picture: Uncheck to hide the user pictures..

Link Text: Set the text of the create conference link (e.g.: Get connected).

Page 24: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.9.2 Dialog Settings

Dialog Title: Specify the title of the Dialog Box.

Dialog List Title: Specify the header line of the list. Leave it empty to

use the default text "Please select your contacts:"

Dialog Icon: Enter a URL to an image to specify the icon of the dialog.

Leave it empty to show the standard icon.

Dialog Width and Height: Specify width and height of the Dialog Box.

Call, Chat and Email-button caption: Specify the caption of the Call, Chat- or Email-button (or leave it empty to hide the button).

4.9.3 AJAX

Enable AJAX: If checked, the contents of the web part will be refreshed by AJAX function. It overrides the general Presence Refresh settings of set in the VEA Skype Connection Kit Settings.

Refresh interval: Refresh interval in seconds. A value below 1 means no refresh.

Page 25: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.10 Web Part – Meeting Workspace Skype Conference

This web part is based on the generic 'Skype Conference' web part and is intended to extend the functionality of a meeting

workspace.

Add it to the i.e. a Basic Meeting template and you will have a group communication feature:

4.10.1 Conferencing Layout

Link Text: Set the text of the create conference link (e.g.: Get connected).

Show Attendees: If checked, the Skype Conferencing web part will render the render the view of the attendees list. The Attendees web part may then be deleted.

Hidden Fields: Enter a list of fields to be hidden delimited by ';'.

Manage Attendees Link Text: Set the text of the manage attendees link.

4.10.2 Dialog Settings

Dialog Title: Specify the title of the Dialog Box.

Dialog List Title: Specify the header line of the list. Leave it empty to

use the default text "Please select your contacts:"

Dialog Icon: Enter a URL to an image to specify the icon of the dialog.

Leave it empty to show the standard icon.

Dialog Width and Height: Specify width and height of the Dialog Box.

Call, Chat and Email-button caption: Specify the caption of the Call, Chat- or Email-button (or leave it empty to hide the button).

Page 26: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.10.3 AJAX

Enable AJAX: If checked, the contents of the web part will be refreshed by AJAX function. It overrides the general Presence Refresh settings of set in the VEA Skype Connection Kit Settings.

Refresh interval: Refresh interval in seconds. A value below 1 means no refresh.

4.11 Placeholders

4.11.1 Placeholders related to Skype Presence Status and Skype functions

Placeholder Description Examples

{default} {default-16} {default-32} {default-48}

This placeholders are applicable to the “Template” field of the “Skype Presence Status” custom field and the “Second Cell Template” of “Advanced Participant Templating” of the “Skype Conference Web Part”. Shows two clickable icons. The one representing the skype presence status is used to start a call, the second to send a message. The template is available in different (16, 24, 32, 48) size in pixels.

{default}

is the same as entering the template: <a href='{action-call}'><img style='border:0' src='{statusicon}' /></a><a href='{action-chat}'><img style='border:0' src='{chaticon}'/></a>

{dropdownmenu} {DROPDOWNMENU}

This placeholders are applicable to the “Template” field of the “Skype Presence Status” custom field and the “Second Cell Template” of “Advanced Participant Templating” of the “Skype Conference Web Part”. Shows the dropdown menu. If in templates, {DROPDOWNMENU} is entered in upper case; no surrounding html-code will be generated to align template text with the dropdown menu

{dropdownmenu}

{statusicon} {statusicon-16} {statusicon-24} {statusicon-32} {statusicon-48} other available icons are: {callicon},{chaticon},{addicon}

URL to the skype presence status icon. Where -16/-24/-32/-48 means size in pixels.

<img src=”{statusicon}”/> One of:

{action-call} {action-chat} {action-add}

Skype actions: {action-call} creates a skype link to start a call. {action-chat} creates a skype link to send a message {action-add} creates a skpye link to add someone to its skype contat list.

{action-call} => skype:bernt.brot234?Call <a href='{action-call}'><img style='border:0' src='{statusicon}' /></a> Shows a status-icon one can click on to start a

call.

Page 27: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

{statustext} Shows the skype presence status text. The texts may be changed in the « Skype Connection Kit Setting »

{statustext} E.g.: Offline, Online etc.

{skypeusername} Shows the skype user name {skypeusername} E.g.: bernt.brot234

4.11.2 Placeholders to get field values and user properties

Placeholder Description Examples

{Source.xxx}

Source represents the source list (e.g.: Tasks, User Information List, Attendees) and xxx stands for a field name or index. {Source.xxx} is only applicable, if there is a source list (e.g. the list, one added the 'Skype Presence Field' to or the list used as the participants list in the SkypeConference Web Part).

{Source.Title}, {Source.1}

{SPUser.xxx} SPUser represents a SharePoint Account (e.g. the Assigned To user in the Tasks list. xxx stands for one of: ID = User id LoginName = User Login Name Name = User Name Email = User Email Sid = User Sid Notes = User Notes Picture = User Picture URL Icon = User Icon (<img src=pictureurl…/>)

{SPUser.Name} {SPUser.Icon}

Page 28: Skype Connection Kit Solution - Amrein Engineering€¦ · The following use case demonstrates how to create conferences based on any SharePoint list. Here we use the Tasks list to

4.11.3 Advanced placeholders

Placeholder Description Examples

{SPList.xxx} {SPWeb.xxx} {SPSite.xxx}

This placeholder is only applicable to the 'List Header' and 'List Footer' Property of the Skype Conference Web Part. The placeholder is intended to be used in advanced use cases. xxx stands for one of: ID Title

{SPList.ID}

{query.xxx} This placeholder is only applicable to the 'List Header' and 'List Footer' Property of the Skype Conference Web Part. The placeholder is intended to be used in advanced use cases. xxx stands for a query or form parameter

{query.ViewID} where ViewID would take part of the url as a query parameter (e.g.: http://host.com/script.aspx?ViewID=12)

{view} is used together with the Property View Link Text

This placeholder is only applicable to the 'List Header' and 'List Footer' Property of the Skype Conference Web Part. The placeholder shows a link to the list that is used as the source list.

Given that the 'List Footer' property would contain the placeholder {view} and the 'View Link Text ' property: <img style="border:0" src="_layouts/images/caladd.gif" /> Manage attendees The following link would be displayed in the Skype Conference Web Part footer: