Archive

Archive for May, 2010

Sharepoint- Technical and Non-Technical Overview

May 31, 2010 Comments off

SharePoint at the Technical Front can be best described as :

A. Currently hosting multiple products:

1. Windows SharePoint Services 2003 and 2007(WSS)
2. SharePoint Portal Server 2003 (SPS)
3. Microsoft Office SharePoint Server 2007 (MOSS)

B. SQL Back-End servers of data feeding Web Front-End servers that render content.

C. Many complex technologies working together to create powerful, but easy to use tools.

Non-Technical Overview of SharePoint:

A. Web-based collaboration tool

B. SharePoint involves many complex technologies (SQL, IIS, and Office Client), it is designed to be easy-to-use and easy-to- understand.

C. Quick and easy way to create complex websites

D. Integrates with Office Applications

E. Flexible framework:

1. Short or long term data sharing
2. Private or public collaboration
3. Online or offline collaboration
4. Scalable

Some of the Common Uses and Solutions of SharePoint :

1. Team collaboration using several elements (Files, lists, surveys, discussions)

2. Publicly accessible presentation or “splash” page for information

3. Free form information sharing using Blog/Wikis

4. Access point for gathering data via survey or forms

5. Meeting Workspaces.

6. Personal Sites

Categories: SHAREPOINT Tags: , , , , ,

Generating an Output Page from a Presentation Template

May 27, 2010 Comments off

Today i tried to lay down sequence of events that needs to be followed for generating  an output page using a Presentation template and DCRs.

Step1: Open the DCR of the required data type which is to be used for page generation.

Step2: Click ‘Generate’ button. A window will open up asking the user to select a Presentation template using which the output page is to be generated. The Presentation templates provided here are the one listed inside <presentation> tag for the data type in templating.cfg

Step3: Select a Presentation template, mention an output file name(One should not mention the extension, as extension will depend as per the configuration defined in templating.cfg) and click Generate.


On clicking Generate the output page gets generated inside the preview directory of the presentation template as specified in templating.cfg.

Creation of Data Content Records (DCRs)

May 26, 2010 Comments off

We will be using the Interwoven Teamsite WebDesk Pro Templating features for creation of DCRs and generation of output pages.

A DCR is created when a user inputs data into a DCT. A DCR is essentially an XML document containing data entered by the user. The DCR have tag <record> as the root tag containing a number of <item> tags.

The data is present inside tag <value> which is nested inside tag <item>.

Let us look at how to create a DCR using a Interwoven TeamSite Templating interface

Step 1: Launch Interwoven TeamSite templating and browse to your workarea.


In the snapshot above, the workarea is Development_wa inside Developmet_branch. So as a first step we just browse to our Workarea ‘Development_wa’. This will list all the directories/files present inside Development_wa on the right side(as can be seen  in the snapshot).

Step 2: Select ‘New Data Record’ from the first menu bar from left.


Step 3 : Select the category and data type for which you need to capture data. The following screen comes up which asks you to select a category and data type. One needs to just browse to the category directory and one will find all the data types listed for that directory. On selection of a data type the data capture form gets displayed to the user.



Step 4 : Input some data into the data capture form.



Step 5: Save the DCR by clicking the Save option. By default the DCR will get saved in data directory of the selected data type.


Generating an Output Page from a Presentation Template in my Next Post.

Creation of Data Capture Templates(DCT)

May 25, 2010 Comments off

There is a DCT for each data type and should be present inside the directory of the data type. A DCT is an XML configuration file named datacapture.cfg.

This DCT contains the definition of data type itself i.e. the information the data type will contain. For example the sports_news data type can consist of a Paragraph containing text(News item) and an associated image(News image).

The DCT contains the tags corresponding to these data for data type sports_news. When a Data Content record is to be generated, the Data Capture Subsystem of TeamSite Templating interprets the tags in DCT and presents a form to the content contributor which can be filled up to capture data.

All the DCT use the following DTD which is specific to TeamSite Templating

/iw-home/local/config/datacapture5.0/dtd

The DTD has all the data elements which can used top create the DCT.

We will build a DCT step by step for data type sports_news assuming that each sports news needs the following information:

1. Heading

2. Description – Can be present as multiple paragraphs, but at least one Paragraph long

3. Image

DCT

—data-capture-requirements ,tag encloses the entire DCT. Attribute ‘type’ is mandatory here. This can have values as ‘content’, ‘metadata’ or  ‘workflow’. For Templating datacapture files we use ‘content’.This tag is MANDATORY.

—ruleset, tag encloses all the items in the DCT. The value of attribute ‘name’ forms the caption of data capture form displayed. This tag is MANDATORY.

—description, tag is OPTIONAL. It holds the description about the DCT which gets displayed at the top of the data capture form.

—container, tag represents a set of subelements.

—The <item> element is used to assign a user defined name to an element type.

—The information contained in <label> is displayed as the field name in data capture form.

—Instances of <text> are used to display single line text boxes. <text> can have following attributes –

1. required

2. maxlength

3. size

4. validation-regex – This is used to restrict the format of input text i.e. It is used to validate the input text. Regular Expressions are used to

validate an input. E.g. A valid three digit number can be validated as:-

o    validation-regex=”[1-9][0-9][0-9]”

Tag <browser> is used to enable a file browser so that content contributor can easily select an image. Following is a description of the attributes:

1. required – value is ‘t’ if mandatory

2. ceiling-dir –  It sets a limit for the directories to be browsed. A user can browse the directories above this directory only

3. initial-dir – This is the initial directory

4. extns – Images with extensions specified here will only be available for selection

A <replicant> represents a repeatable section in a DCT. It can contain a list of one <item> tags. But vice-versa does not hold true. Tag <replicant>

can have following parameters:

1. min – Used to specify the mininmum number of instances of the replicant list.

2. Max – Used to specify the maximum number of instances of the replicant list.

3. Default – Used to specify the default number of instances of the replicant list.

4. Hide-name – This will determine whether the label gets displayed for the sub-items.

In addition to the tags mentioned in the DCT above there are other tags also which can be used. Some of the commonly use are listed below-

1. <textarea>

2. <radio>

3. <checkbox>

4. <select> – This will contain a list of <option> tags nested inside it.

5. <hidden>This contains a value invisible to the user.

6. <readonly> – This will display the item as readonly.

7. <allowed> – This is used to enable or disable an item depending on the user’s role.

This will contain one or more <cred> tags nested inside it. Here is an illustration-

This above set of tags will present <text> only to the user with role as Administrator.

We can also form complex access statements by using <and>, <or> and <not> tags. E.g. If we want to restrict access to Author or Editor roles then

we cab specify the following –

Creation of DCRs in my Next Post.

Categories: INTERWOVEN Tags: ,

Interwoven TeamSite Templating

May 24, 2010 Comments off

Interwoven TeamSite Templating provides an easy configurable way to capture, edit & store the data input by content contributors and define the look and feel of the captured data. The data capture process is separate and independent of the data presentation process, hence allowing unlimited usage of the captured data. The independent nature of the presentation process allows one to define different appearances for the same data depending on where and how the data is being used.

In TeamSite Templating the data is captured using a Data Capture Template(DCT). The data captured using a DCT is saved in an XML format in a file called as a Data ContentRecord(DCR). The DCR’s act as a source of data for Presentation Templates. A Presentation Template can use multiple DCR’s to generate a page(this page can be a JSP, ASP, XML, etc. as per the configuration defined).

Getting started – Configuring templating.cfg

Before creation of a DCT and Presentation templates associated with the data type we define some configurations in templating.cfg.

templating.cfg is the main TeamSite Templating configuration file. It is present at the following location:
/iw-home/local/config

The file is in an XML format and has information related to the following:
1. Data Categories and Types available for Templating
2. File extension of the files generated using a template
3. Mapping between presentation template and a data type
4. Mapping between files generated using presentation templates and the branch on which the files can be generated
5. Users or roles permitted to create or edit a DCR for a data type

Following is a sample of file templating.cfg containing a single category News which has only a single data type sports_news.

A template, Sports_Page_Template.tpl is defined under data type sports_news which will generate a file with extension .html .

Points to be noted:

The data storage hierarchy will be as follows:

1. There should be a directory named ‘templatedata’ inside your workarea.
2. Category ‘News’ will have a directory named ‘News’ representing the category inside directory ‘templatedata’ defined inside a branch.
3. Data type ‘sports_news’ will have a directory named ‘sports_news’ representing the data type inside directory ‘News’.
4. Inside directory ‘sports_news’ there will be two directories present namely:-
5. data – This will store the Data Content Records
6. presentation – This will store the templates for the data type

The following are important pointers related to tags used in templating.cfg

1. Tag contains only one tag
2. The definition of template is present inside tag . At least one tag should be present inside tag.
3. Attribute ‘extension’ is used to specify the extension of files generated using the template defined inside tag
4. Tag is used to define the location of presentation template file.
5. Tag is used to specify the output location of generated files

Fundamental Concepts of Interwoven TeamSite

May 21, 2010 Comments off

Today i got a chance to sketch and induce the basic concepts of TeamSite. The two diagrams below explain the concepts while using interwoven Teamsite in brief :

1)    Teamsite Conceptual Diagram :

Teamsite Conceptual

A. Interwoven Teamsite is a content management solution. Teamsite can be accessed using a browser based GUI.

B. Every user has a private workarea equivalent to the entire website that is being managed.

Teamsite provides a common area called as staging from which content can be deployed to various environments such as Development Environment, QA/ Testing Environment, Pre Production Environment and Production Environment.

C.  The staging environment acts as the content repository. Content can be deployed only from the staging environment.

D. The teamsite user can get a latest copy of a file from staging area to workarea.

E. Each teamsite user can edit files in the workarea. Such files will be locked for editing so that other users are prevented from making changes to the file.

F. The user can submit modified files to staging area. Thereafter, the user can deploy the changes to Production from staging.

G. The actions that can be performed by a user are limited by the user role specified on login. The user must have appropriate privileges to deploy content.

2) Teamsite End-to-End Flow :

Teamsite Process














Let us discuss the team site process diagram shown above by taking an example. Let us say a developer needs to change a particular file and deploy the same to production.

The steps followed by the developer in the process diagram are:

A. The developer will login into teamsite and do a get latest of the file to be modified into his / her private workarea.

B.  The developer will then download the file for edit and make the required changes to the file content.

C.  The next step is to upload the file back into the work area after which it can be submitted to the staging area.

D. Once the file changes are present in the staging area, the developer can deploy the changes to the available environments like development, production etc.

Important Terms in Interwoven Teamsite

May 20, 2010 Comments off

Below are few of the important Terms used extensively in Teamsite :

Data Capture

The Data Capture sub-system enables the user to work with forms which are created through a ‘Data Capture Template’ (DCT). Once the user fills the required content in the DCT and saves it, a ‘Data Capture Record’ (DCR) is generated, which gets stored in the tool’s file system. This data is saved as an XML and is utilized to fill the ‘Presentation Template’ which governs the look of the final web page.
This sub-system can be employed in a TeamSite Templating Browser or a java environment.

The ‘Data Capture Subsystem’ consists of a series of Java applications to carry out the following tasks:

o Study datacapture.cfg and templating.cfg files and decide what data a user should be able to view
through WebDesk or WebDeskPro.
o Deduce the input of the person entering the data.
o Save the data entered in the required format.

Data Capture Template

A ‘Data Capture Template’ (DCT) consists of an XML file named datacapture.cfg which specifies the form to be used to get the data content from its subscribers.

It comprises of:

o Category
o Type

These specify what type of data the DCT uses. The content entered in the DCT is saved as an XML on TeamSite. One DCT can be used to generate multiple DCRs.

Data Presentation

Once the DCR gets created after the data entry in the DCT, the page can be generated through the page generation sub-system reachable by the command line. This enables the user to view the required data in the required format. An output file can also be created that uses data from more than one DCRs and database queries. This output file may also be deployed to a web server using OpenDeploy.

Presentation Template

A ‘Presentation Template’ specifies how the data entered looks on the generated page.

The data present in this template is obtained from the DCRs which was initially entered in the DCT. The TeamSite Templating can also be designed to fill the presentation template with selective information from a relational database.

These can also be used with:

o Component templates – i.e., a component of another presentation template or a nested template.
o A single DCR to fill multiple presentation templates, all having a different appearance and display.

It uses an XML file with extension .tpl.

The ‘Page Generation System’ is a simple sequence of programs and libraries, which helps to:

o Examine the presentation template and templating.cfg configuration files and
decide the user should be able to view through the TeamSite GUI.
o Deduce the input of the person entering the data.
o Use the DCR and presentation templates to generate the required results.

Data Content Record

A Data Content Record ‘DCR’ is XML file. It has the design information along with the data entered in the DCTs. The name of the DCR is user specific.

Categories: INTERWOVEN Tags: , , , , , ,
%d bloggers like this: