sptools v.1.6 – sharepoint to typo3 connection tool
TRANSCRIPT
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
SPTools-Funktionen Seite 4/31
Fig. 1: SharePoint – document library list view
SPTools-Funktionen Seite 5/31
Fig. 2: SharePoint – document versions
SPTools-Funktionen Seite 6/31
Fig. 3: TYPO3 Frontend - SPTools document list with versioning
SPTools-Funktionen Seite 7/31
SPTools - SharePoint picture library integration
SPTools allows a direct publication of images 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 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
SPTools-Funktionen Seite 8/31
Fig. 4: SharePoint – picture library list view
SPTools-Funktionen Seite 9/31
SPTools-Funktionen Seite 10/31
Fig. 5: TYPO3 Frontend - SPTools image list with thumbnail and picture upload
Fig. 6: TYPO3 Frontend - SPTools download form with custom dimensions
SPTools-Funktionen Seite 11/31
Fig. 7: TYPO3 Frontend - SPTools print service request form
SPTools-Funktionen Seite 12/31
SPTools - SharePoint event list integration SPTools allows a direct publication of events from your SharePoint to your TYPO3 website.
The following features are supported:
�• 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
SPTools-Funktionen Seite 13/31
Fig. 8: SharePoint – event detail view
SPTools-Funktionen Seite 14/31
Fig. 9: SharePoint – calendar view
Fig. 10: TYPO3 Frontend - SPTools calendar view
SPTools-Funktionen Seite 15/31
Fig. 11: TYPO3 Frontend - SPTools event details and registration form
SPTools-Funktionen Seite 16/31
Fig. 12: SharePoint – event details and registration form
SPTools-Funktionen Seite 17/31
SPTools - SharePoint custom list integration
SPTools allows a direct publication of events from your SharePoint to your TYPO3 website.
The following features are supported:
�• 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"
SPTools-Funktionen Seite 18/31
Fig. 13: SharePoint – custom list with news items
SPTools-Funktionen Seite 19/31
Fig. 14: SharePoint – news detail view
SPTools-Funktionen Seite 20/31
Fig. 15: TYPO3 Frontend - SPTools list of news items
SPTools-Funktionen Seite 21/31
Fig. 16: TYPO3 Frontend - SPTools news details with RTE-parsing, inline documents and inline
related news
SPTools-Funktionen Seite 22/31
SPTools – features for forms SPTools allows interaction between your SharePoint to your TYPO3 website via customer defined
forms.
The following features are supported:
�• 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
SPTools-Funktionen Seite 23/31
Fig. 17: TYPO3 Frontend - SPTools Stand-alone image upload form with meta information fields
SPTools-Funktionen Seite 24/31
Fig. 18: TYPO3 Frontend – SPTools Inline event registration form with attachments upload
SPTools-Funktionen Seite 25/31
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-Funktionen Seite 26/31
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-Funktionen Seite 27/31
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.
SPTools-Funktionen Seite 28/31
Fig. 19: TYPO3 Backend - SPTools backend file browser with Word document
SPTools-Funktionen Seite 29/31
Fig. 20: TYPO3 Backend – SPTools backend file browser with images
SPTools-Funktionen Seite 30/31
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-Funktionen Seite 31/31
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