SPTools V.1.6 â€“ SharePoint to TYPO3 connection tool

SPTools-features

Page 1/31

SPTools V.1.6 – SharePoint to TYPO3 connection tool

SPTools features

Content

General information ...........................................................................................................................2

SPTools - SharePoint document library integration...........................................................................3

SPTools - SharePoint picture library integration................................................................................7

SPTools - SharePoint event list integration .....................................................................................12

SPTools - SharePoint custom list integration ..................................................................................17

SPTools – features for forms ...........................................................................................................22

SPTools - SharePoint to TYPO3 synchronization ...........................................................................25

SPTools - SharePoint content synchronization with the TYPO3 database .....................................26

SPTools - SharePoint files synchronization with the TYPO3 file-system ........................................27

TYPO3 Backend - SPTools configuration........................................................................................30

SPTools security ..............................................................................................................................31

SPTools 1.6 system requirements...................................................................................................31

SPTools-features

Page 2/31

General information

We welcome you to the Microsoft© SharePoint connection application for TYPO3 called "SPTools".

This application is designed for companies who are running or are planning to run SharePoint and

TYPO3 simultaneously for different purposes but want to share content and user interaction to get

the best out of both systems without barriers.

In many cases companies use SharePoint systems for intranet purposes and TYPO3 as their

WCMS (Web Content Management System).

SPTools connects both systems to display SharePoint documents and images, show custom lists

like Events, News or Product sheets in the TYPO3 frontend or synchronize them for TYPO3

backend access.

In the opposite direction users can upload documents from TYPO3 to SharePoint libraries and

submit forms like contact requests, feedbacks or event registrations to SharePoint lists.

SPTools is easy to configure and to extend by flexible configuration forms in the TYPO3 backend

and work homogeneously with your SharePoint access-rights settings.

SPTools-Funktionen Seite 3/31

SPTools - SharePoint document library integration SPTools allows a direct publication of documents from your SharePoint to your TYPO3 website.

The following features are supported:

�• Folder tree view - Display SharePoint folders in a tree view

�• List view - Show SharePoint documents in a list view

�• Single view - Display selected Meta-Information and attached forms in a single view

�• Single download - Secure download of latest document version

�• Basket with multiple downloads - Put documents in a basket and download complete

package

�• Meta-Information - Display selected Meta-Information like Description, Category etc.

�• Fulltext search in Meta-Information columns - Search in columns like Keywords,

Description etc.

�• Upload-Forms - TYPO3-Users can upload documents to SharePoint libraries and assign

additional Meta-Information

�• Response forms attached to document items - Users can send form data to SharePoint

lists attached to documents, e.g. a feedback to a certain document

�• Versioning - Activate the download of previous versions of a document

�• Approval - SPTools only displays approved documents

�• SharePoint access-rights - Only documents with read rights of the public user or the user

who is logged-in are displayed


Fig. 1: SharePoint – document library list view


Fig. 2: SharePoint – document versions


Fig. 3: TYPO3 Frontend - SPTools document list with versioning


SPTools - SharePoint picture library integration

SPTools allows a direct publication of images from your SharePoint to your TYPO3 website.


�• Folder tree view - Display SharePoint folders in a tree view

�• List view - Show SharePoint images with thumbnails in a list view

�• Single view - Display preview image, selected Meta-Information and attached forms in a

single view

�• Single download - Secure download of images

�• Custom download - Secure download of images in user defined image width or height

�• Basket with multiple download - Put images in a basket and download complete package

with overview PDF incl. thumbnails

�• Meta-Information - Display selected Meta-Information like file size, description, category

etc.

�• Fulltext search in Meta-Information columns - Search in columns like Keywords,

Description etc.

�• Upload-Forms - TYPO3-Users can upload images to SharePoint libraries and assign

additional Meta-Information

�• Response forms attached to document items - Users can send form data to SharePoint

lists attached to images, e.g. a request for a printing service

�• Versioning - Activate the download of previous versions of an image

�• Approval - SPTools only displays approved images

�• SharePoint access-rights - Only images with read rights of the public user or the user

who is logged-in are displayed


Fig. 4: SharePoint – picture library list view



Fig. 5: TYPO3 Frontend - SPTools image list with thumbnail and picture upload

Fig. 6: TYPO3 Frontend - SPTools download form with custom dimensions


Fig. 7: TYPO3 Frontend - SPTools print service request form


SPTools - SharePoint event list integration SPTools allows a direct publication of events from your SharePoint to your TYPO3 website.


�• Event list view - Display upcoming events in a list view

�• Calendar view - Display events in a calendar view

�• Detailed view - Display event with additional information, downloads and forms

�• Attachments - Display attachments from SharePoint in TYPO3 event item detailed view

�• Forms - Display response forms in TYPO3 event list or detailed view for e.g. event

registrations to be stored in SharePoint

�• Fulltext search - Search for events in user defined SharePoint columns

�• Inline items - Display selected items from a different or the same SharePoint list or library

like "Related Events" or "Event Pictures"

�• Seamless workflow - Events can be created in Outlook-synchronized SharePoint calendar

and displayed on TYPO3 websites including date, title, location, description, categories and

attachments

�• Targeting - Events can be targeted via SharePoint user-/usergroup-access rightsaccess

rights to TYPO3 frontend users


Fig. 8: SharePoint – event detail view


Fig. 9: SharePoint – calendar view

Fig. 10: TYPO3 Frontend - SPTools calendar view


Fig. 11: TYPO3 Frontend - SPTools event details and registration form


Fig. 12: SharePoint – event details and registration form


SPTools - SharePoint custom list integration

SPTools allows a direct publication of events from your SharePoint to your TYPO3 website.


�• Custom content - SPTools can handle any kind of SharePoint custom lists like news,

products, contacts, etc.

�• Custom views - The TYPO3 frontend views can be custom-styled via SPTools HTML-

templates and style sheets

�• Attachments - Give access to attached files of SharePoint items

�• Forms - Send data from TYPO3 to SharePoint lists like news, feedback or product orders.

�• Category-view - SharePoint folders can be displayed as category views in SPTools

TYPO3 frontend

�• RTE-parsing - SharePoint RTE(Rich-Text-Editor)-images are parsed to be loaded via

SPTools (SharePoint-internal relative image paths are replaced)

�• Selected content - Specific folders can be selected as start folder for SPTools TYPO3

frontend content, e.g. show a list of products from only one product group

�• Inline items - Display selected items from different or same SharePoint list or library like

"Related news" or "Product pictures"/"Product specification sheets"

�• Targeting - Content can be targeted via SharePoint user-/usergroup-access rights to

TYPO3 frontend users, e.g. give access to upcoming products to the usergroup "press"


Fig. 13: SharePoint – custom list with news items


Fig. 14: SharePoint – news detail view


Fig. 15: TYPO3 Frontend - SPTools list of news items


Fig. 16: TYPO3 Frontend - SPTools news details with RTE-parsing, inline documents and inline

related news


SPTools – features for forms SPTools allows interaction between your SharePoint to your TYPO3 website via customer defined

forms.


�• Direct integration - SharePoint lists or libraries can be selected as receivers for form data

of SPTools TYPO3 frontend forms

�• Flexibility - SharePoint columns of the receiver list can be selected as form fields for the

SPTools frontend form

�• Scalability - Create as many forms as necessary for a list/list item

�• Cross-server - Receiver lists can be located in the same or different SharePoint Server or

website than the list/list item that is displayed

�• Stand-alone and inline forms - SPTools forms can be inline, acting within a list item, or

can be stand-alone

�• Text, attachments and uploads - Forms can handle plain text information plus upload

attachments to a SharePoint list or upload document(s) to a document library


Fig. 17: TYPO3 Frontend - SPTools Stand-alone image upload form with meta information fields


Fig. 18: TYPO3 Frontend – SPTools Inline event registration form with attachments upload


SPTools - SharePoint to TYPO3 synchronization There might be cases when you want to have SharePoint content duplicated inside the TYPO3

system, e.g. SharePoint News items should be synchronized with the TYPO3 News (tt_news)

Extension or SharePoint pictures from a picture library should be synchronized with the TYPO3

file-system to access them in TYPO3 standard content elements like "Text with images" or

"Images".

The synchronization capabilities of SPTools can be divided in two main components:

�• Synchronizing SharePoint content with the TYPO3 database

�• Synchronizing SharePoint files with the TYPO3 file-system


SPTools - SharePoint content synchronization with the TYPO3 database The following features are supported:

�• Cross-server - You can gather data from different SharePoint servers or websites

�• Flexibility - You can match any SharePoint list to any TYPO3 database

�• Attachments - You can synchronize SharePoint attachments to the TYPO3 file-system like

"News files" for the TYPO3 News-Extension (tt_news)

�• Field assignment - You can select SharePoint columns and match them to TYPO3

database fields, e.g. the SharePoint News-list column "Description" shall be synchronized

to the "bodytext" field of the TYPO3 News-Extension (tt_news)

�• Field data transformations - There are different transformation functions that can be

assigned to SharePoint data when written to the TYPO3 database, e.g. transformation of

SharePoint UTC-date-format to UNIX-timestamp

�• Content filter - You can assign filters to the synchronization on SharePoint fields, e.g. only

events of a SharePoint calendar that have the category "public website" should be

synchronized with an Event-Extension inside TYPO3

�• Custom storage folder - The synchronized items can be stored in a selected TYPO3

storage folder


SPTools - SharePoint files synchronization with the TYPO3 file-system The following features are supported:

�• Cross-server - You can gather files from different SharePoint servers or websites

�• Scalability - You can synchronize as many SharePoint document or picture libraries as

needed

�• Stand-alone - The files are stored in a file-/folder-structure outside the TYPO3 fileadmin-

folder to avoid conflicts with the regular TYPO3 file-management

�• Separate file browser - SPTools integrates a separate file browser in TYPO3 standard

content elements to give access to SharePoint synchronized files

�• Hybrid file information - Basically the SPTools file browser acts like the standard file

browser of TYPO3 but accesses only the SharePoint synchronized files. In addition this

SPTools file browser displays meta information (title, keywords, description) that are

coming live from the SharePoint library.


Fig. 19: TYPO3 Backend - SPTools backend file browser with Word document


Fig. 20: TYPO3 Backend – SPTools backend file browser with images


TYPO3 Backend - SPTools configuration We designed the configuration of SPTools inside the TYPO3 backend as simple and as flexible as

possible.

To use the whole flexibility of SPTools you only have to manage four TYPO3 backend datatypes:

�• SPTools connector definitions - Define different connections to SharePoint Servers or

Websites, e.g. "SharePoint of our Marketing department" and "SharePoint of our Sales

department"

�• SPTools list definitions - Define connections to SharePoint lists or libraries from the

connectors defined above, e.g. "Product list" or "Product picture library", select fields to be

queried, select fields for the full-text search and assign inline forms, e.g. "Product order"

�• SPTools form definitions - Define frontend forms (like "Product Order" above) by

selecting the SharePoint receiver list, the SharePoint fields that should be displayed in the

form, the number of attachments that can be uploaded by the user or if a special upload

field should be displayed (for document upload to SharePoint document libraries)

�• SPTools synchronization definitions - Define synchronizations by selecting a source

SharePoint list and the corresponding TYPO3 table, match SharePoint columns to TYPO3

fields, assign data transformations and filters


SPTools security There are two security issues that are part of the SPTools core:

�• Secure connection - The connection between the TYPO3 server(s) and the SharePoint

server(s) can be encrypted with SSL(-certificate)

�• Secure content/document access - The SPTools fully integrate the access-rights settings

that you made in SharePoint, e.g. if you want one specific customer to have access to

confidential documents concerning the products that this customer bought from your

company, just restrict the read-access rights of the affected storage folder or

items/documents in SharePoint to the user/usergroup representing that customer and

SPTools will consider that

SPTools 1.6 system requirements TYPO3 Frontend requirements:

�• PHP 5.2.9+

�• TYPO3 4.2.x

�• PHP extensions: SOAP, cURL, SSL, gd

�• Imagemagick

SharePoint requirements:

�• SharePoint Services (WSS) 3.0 or SharePoint Office Server (MOSS) 2007

�• or NEW: SharePoint Foundation 2010 or SharePoint Server 2010

Documents

SPTools V.1.6 â€“ SharePoint to TYPO3 connection tool