通过单击操作创建 IBM Lotus Web Content Management 站点结构

xsi:noNamespaceSchemaLocation="SiteCreation.xsd">




auth_news
pt_newsDetail



[all authenticated portal users]
anonymous portal user




Default_News
Default_News
auth_news

txt_headline
Headline for default Content


rtf_body
Body for the default Content




Default_News
Default_News
auth_news

txt_headline
Headline for default Content


rtf_body
Body for the default Content





Default_News




auth_news
pt_newsDetail



[all authenticated portal users]
anonymous portal user

文档选项 未显示需要 JavaScript. 的文档选项 打印本页 打印本页 将此页作为电子邮件发送 将此页作为电子邮件发送 讨论 样例代码 英文原文

xsi:noNamespaceSchemaLocation="SiteCreation.xsd">




auth_news
pt_newsDetail



[all authenticated portal users]
anonymous portal user




Default_News
Default_News
auth_news

txt_headline
Headline for default Content


rtf_body
Body for the default Content




Default_News
Default_News
auth_news

txt_headline
Headline for default Content


rtf_body
Body for the default Content





Default_News




auth_news
pt_newsDetail



[all authenticated portal users]
anonymous portal user

\installedApps\
WCM_Local_ng_Portlet_PA_dvme0nk.ear\PA_dvme0nk.war\jsp\html\
createSiteStructure.jsp

charset=UTF-8" pageEncoding="UTF-8"%>
.
.
.

private Workspace workspace;
/*
	*Connect to Lotus Web Content Management workspace with current user if 
	*logged in or anonymous if user is not logged in
	*
	*Set the Lotus Web Content Management document library to aLibraryName
*/
public Workspace openWorkspaceLibrary(HttpServletRequest request, String aLibraryName) 
throws ServiceNotAvailableException, OperationFailedException {
	// Connect to WCM Workspace
	if (request.getUserPrincipal() != null)
	{
		workspace = WCM_API.getRepository().getWorkspace
		(request.getUserPrincipal());
	} else
	{
		workspace = WCM_API.getRepository().getAnonymousWorkspace();
	}

	//set library to the passed library name
	if (workspace != null) {
		DocumentLibrary docLib = workspace.getDocumentLibrary
		(aLibraryName);
		if(docLib != null){
			workspace.setCurrentDocumentLibrary(docLib);
		}
	}

	return workspace;
}

/*
	*Parse site element 
	*If site already available, retrieve the site object, edit the site
	*If site not already created, create a new site and set the name and 
	*display name and its settings
	*Save the site to the workspace
*/
public Site createSite(Element aSiteElement){

	String siteName = aSiteElement.getAttribute("Name");
	String siteDisplayName = aSiteElement.getAttribute("DisplayName");
	Site site = null;	
	try{

		DocumentId siteId = getWCMDocumentByName(siteName, DocumentTypes.Site);
		if (siteId != null){
			site = (Site)workspace.getById(siteId);
		}
		else{
			site = workspace.createSite();		
			site.setName(siteName);
		}
		site.setTitle(siteDisplayName);			
		site = (Site)retrieveAddSettings(site, aSiteElement, false);	

		workspace.save(site);

	}catch(Exception e){
		System.out.println("Exception = "+e);
		e.printStackTrace();

	}	
	return site;
} 

/*
*Parse site area element 
*If site area already available, retrieve the site area object, edit the site area
*If site area not already created, create a new site area and set the name 
*and display name and its settings
*Add a default content to the site area if available
*Save the site area to the workspace
*/
public SiteArea createSiteArea(Element aSiteAreaElement, DocumentId parentId){
  String siteAreaName = aSiteAreaElement.getAttribute("Name");
  String siteAreaDisplayName = aSiteAreaElement.getAttribute("DisplayName");

  SiteArea sa = null;
  try{
    String parentPath = workspace.getPathById(parentId,  true, true);
    String siteAreaPath = parentPath+ "/"+ siteAreaName;
    DocumentId siteAreaId = getWCMDocumentByPath(siteAreaPath,  
    Workspace.WORKFLOWSTATUS_ALL);

    if (siteAreaId != null){
      sa = (SiteArea)workspace.getById(siteAreaId);
    }else{
      sa = workspace.createSiteArea(parentId, null, 1);
    }

    sa = (SiteArea)retrieveAddSettings(sa, aSiteAreaElement, true);			
    if (sa != null){
      sa.setTitle(siteAreaDisplayName);

      sa.setName(siteAreaName);	
      workspace.save(sa);
      sa = addDefaultContentToSiteArea(sa, aSiteAreaElement);			

      if (sa != null){

        boolean saved = saveToWorkspace(sa);
        System.out.println("site area = " + sa.getName());

        if (!saved){
          return null;
        }					

        //checking if site area contains any other site area children
        NodeList SiteAreaNodeList = aSiteAreaElement.getChildNodes();

        for (Node node = aSiteAreaElement.getFirstChild(); node != null; 
        node = node.getNextSibling()) {
          if (node.getNodeType() == Node.ELEMENT_NODE && 
	      node.getNodeName().equals("SiteArea")) {
		  Element siteAreaEL = (Element)node;

		    SiteArea childSA = createSiteArea(siteAreaEL, sa.getId());
		    if (childSA != null){
			System.out.println("childSA  for = " +sa.getName()+ " = 
			" + childSA.getName());
		  }
		  else{
		  return null;
		  }
		}
	  }				
	}
      else{
        return null;
      }
    }			
    return sa;
  }catch(Exception e){
    System.out.println("Exception = "+e);
    e.printStackTrace();

  }		
  return null;
}

/*
*Parse the default content element 
*If content already available, retrieve the content object, and edit it
*If content not already created, create a new content object and set the 
*name and display name and its settings
*If authoring template provided, overwrite if already set
*Add text components and rich text components to the content
*Save the default content to the site area
*/
public SiteArea addDefaultContentToSiteArea(SiteArea aSiteArea, 
Element aSiteAreaElement){

	DocumentId defaultContentId = null;				

	Element defaultel = getChildByName(aSiteAreaElement, "DefaultContent");
	String contentName = getElementValueByTagName("Name", defaultel);

	defaultContentId = getWCMDocumentByName(contentName, DocumentTypes.Content);

	Content content = null;		

	String contentDisplayName = getElementValueByTagName("DisplayName", defaultel);

	String authoringTempName = getElementValueByTagName("AuthoringTemp", defaultel);

	DocumentId defaultAuthId = null;

	if (! authoringTempName.equals("")){
	  defaultAuthId = getWCMDocumentByName(authoringTempName, 
	  DocumentTypes.AuthoringTemplate);

	}
	System.out.println("defaultAuthId = "+ defaultAuthId);
	try{

	  //if content already existing in the library, re-use it
      if (defaultContentId != null){
	    content = (Content)workspace.getById(defaultContentId);

	    //if authoring template provided in the file, overwrite the existing one
	    if (defaultAuthId != null){
	      content.setAuthoringTemplateID(defaultAuthId);
	    }
	  }
	  else if (defaultAuthId != null){
	    //if content not available, create a new one
	    content = workspace.createContent(defaultAuthId, aSiteArea.getId(),null, 
	    ChildPosition.START);
	   	defaultContentId = content.getId();
	   	content.setName(contentName);
	  }
	  else{
		System.out.println("Exception = Authoring Template for default content "+ 
		contentName + " is missing");
		return null;
	  }

	  if (! contentDisplayName.equals("")){
		content.setTitle(contentDisplayName);
	  }

	  content = retrieveAddTextComponentToContent(content, defaultel);

	  if (content == null){
		return null;
	  }
	  content = retrieveAddRichTextComponentToContent(content, defaultel);

	  if (content == null){
		return null;
	  }

while(!content.isPublished()){
content.nextWorkflowStage();
}
workspace.save(content);

  }catch(Exception e){
	System.out.println("Exception = "+e);
	e.printStackTrace();							
  }

  System.out.println("defaultContent  for = " +aSiteArea.getName()+ " = " + 
  defaultContentId.getName());
  aSiteArea.setDefaultContent(defaultContentId);			
  return aSiteArea;
}

/*
*Parse DefaultContent element 
*Search for text component elements
*Looping over all text component child elements
*Calling method addTextComponent to add the 
*text component to the content
*/
public Content retriveAddTextComponentToContent(Content aContent, 
Element aContentElement){

  NodeList texttnl = aContentElement.getChildNodes();

  for (Node node = aContentElement.getFirstChild(); 
  node != null; 
  node = node.getNextSibling()) {
	if (node.getNodeType() == 
	Node.ELEMENT_NODE && 
	node.getNodeName().equals("TextComponent")) {
	  Element textCompel = (Element)node;

	  String textField = 
	  getElementValueByTagName("FieldName", textCompel);				
	  String text = 
	  getElementValueByTagName("Value", textCompel);
	  aContent = 
	  addTextComponent(aContent, textField, text);

	  if (aContent != null){
	    System.out.println("adding textField = 
	    "+ textField+" to content "
	    +aContent.getName());						
	  }
	}
  }	
  if (aContent == null){
	return null;
  }
  else{

	return aContent;
  }

}

/*
*Parse DefaultContent element 
*Search for rich text component elements
*Looping over all rich text component child elements
*Calling method addRichTextComponent to add the rich text 
*component to the content
*/
public Content retrieveAddRichTextComponentToContent
(Content aContent, Element aContentElement){
  NodeList richTexttnl = aContentElement.getChildNodes();
  for (Node node = aContentElement.getFirstChild(); node != null; 
  node = node.getNextSibling()) {
	if (node.getNodeType() == Node.ELEMENT_NODE && 
	node.getNodeName().equals("RichTextComponent")) {
	  Element richtextCompel = (Element)node;

	  String textField = 
	  getElementValueByTagName("FieldName", 
	  richtextCompel);					
	  String text = 
	  getElementValueByTagName("Value", 
	  richtextCompel);				

	  aContent = 
	  addRichTextComponent(aContent, textField, text);

	  if (aContent != null){
	    System.out.println("adding richtextField = 
	    "+ textField+" to content "+
	    aContent.getName());						
	  }
	}
  }
  if (aContent == null){
	return null;
  }
  else{
    return aContent;
  }
}

/*
* Get text component from the content according to 
*the text component name
* Set the text component with the value sent
* Add the text component to the content
*/
public Content addTextComponent
(Content aContent, String aTextField, String aValue){

	try{			
		TextComponent txtComp = 
		(TextComponent) aContent.getComponent(aTextField);
		txtComp.setText(aValue);		
		aContent.setComponent(aTextField,  txtComp);
	}catch(ComponentNotFoundException ex){
		System.out.println
		("Exception: "+aTextField+" is not a valid TextComponent");
		return null;
	}catch(Exception e){
		System.out.println("Exception = "+e);
		return null;
	}

	return aContent;
}

/*
* Get rich text component from the content according to the RTF name
* Set the rich text component with the value sent
* Add the rich text component to the content
*/
public Content addRichTextComponent(Content aContent, 
String aTextField, String aValue){
	try{
		RichTextComponent richTxtComp = 
		(RichTextComponent) aContent.getComponent(aTextField);
		richTxtComp.setRichText(aValue);		
		aContent.setComponent(aTextField,  richTxtComp);
		RichTextComponent rtf = 
		(RichTextComponent)aContent.getComponent(aTextField);
	}catch(ComponentNotFoundException ex){
		System.out.println("Exception: 
		"+aTextField+" is not a valid RichTextComponent");
		return null;
	}catch(Exception e){
		System.out.println("Exception = "+e);
		return null;
	}

	return aContent;
}

/*
*Parse site area or site element 
*Search for settings element
*call method retrieveAddTemplateMapping to add template mapping to site or site area
*call method addSecuritySettings to add security settings to site or site area
*/
public Object retrieveAddSettings(SiteFrameworkContainer aWCMObject, 
Element aObjectElement, boolean isSiteArea){

	Element settingsel = getChildByName(aObjectElement, "Settings");
	if ( settingsel!= null){
		if(isSiteArea )
		{
			aWCMObject = (SiteArea)retrieveAddTemplateMapping
			(aWCMObject, settingsel);
			aWCMObject = (SiteArea)addSecuritySettings
			(aWCMObject, settingsel);
		}
		else
		{
			aWCMObject = (Site)retrieveAddTemplateMapping
			(aWCMObject, settingsel);
			aWCMObject = (Site)addSecuritySettings
			(aWCMObject, settingsel);
		}
	}
	return aWCMObject;
}

/*
*Parse settings element 
*Search for SecuritySettings element
*For every SecuritySettings element, find the AccessRight element
*loop over the AccessRight elements and get the type of the access
*According to the access type, a specific method in Lotus 
*Web Content Management 
*will be called to add the access rights
*/
public Object addSecuritySettings
(SiteFrameworkContainer aWCMObject, Element settingsel){

  for (Node node = settingsel.getFirstChild(); node != null; 
  node = node.getNextSibling()) {
    if (node.getNodeType() == Node.ELEMENT_NODE && 
    node.getNodeName().equals("SecuritySettings")) {
      Element secel = (Element)node;	
      NodeList accessRightsnl = secel.getChildNodes();

      for (Node accessRightNode = secel.getFirstChild(); accessRightNode != 
      null; accessRightNode = accessRightNode.getNextSibling()) {
        if (accessRightNode.getNodeType() == Node.ELEMENT_NODE && 
        accessRightNode.getNodeName().equals("AccessRight")) {
         Element accessRightsel = (Element)accessRightNode;

         String accessType = accessRightsel.getAttribute("Type");

         NodeList accessnl = accessRightsel.getChildNodes();

         if(accessnl != null ) {	

            for(int y = 0 ; y < accessnl.getLength();y++) {			

              Node accnode = accessnl.item(y);

           if (accnode.getNodeType() == 
           accnode.ELEMENT_NODE && 
           accnode.getNodeName().equals("Access")) {
           Element el = (Element)accnode;			
           String access = el.getFirstChild().getNodeValue();	
           if (accessType.equals("addReadAccessMembers")){
           aWCMObject.addReadAccessMembers(new String[]{access});
             System.out.println("addReadAccessMembers for bject = 
             "+aWCMObject.getName()+" members = "+access);
			  }else if(accessType.equals
			  ("addEditAccessMembers")){
			  aWCMObject.addEditAccessMembers(new String[]{access});
			  System.out.println("addEditAccessMembers for bject = 
                "+aWCMObject.getName()+" members = 
                "+access);

              }else if(accessType.equals

              ("addDeleteAccessMembers")){	

              aWCMObject.addDeleteAccessMembers
              (new String[]{access});
              System.out.println
              ("addDeleteAccessMembers for bject = 
              "+aWCMObject.getName()+" members = "+access);
            }		

          }
        }
      }	
    }
  }		
  }		
  }	
	return aWCMObject;
}

/*
*Parse settings element 
*Search for TemplateMapping element
*For every TemplateMapping element
*Get the authoring template and presentation template names
*Retrieve the Lotus Web Content Management object from the names
*If item already contains a template mapping with the same authoring template, 
*remove it and add the new one
*Else, add the new template mapping
*Save the object, either the site or site area
*/
public Object retrieveAddTemplateMapping
(SiteFrameworkContainer aWCMObject, 
Element settingsel){
  DocumentId authId = null;
  DocumentId presId = null;

  NodeList tempnl = settingsel.getChildNodes();

  for (Node node = settingsel.getFirstChild(); node != 
  null; node = node.getNextSibling()) {
    if (node.getNodeType() == Node.ELEMENT_NODE && 
    node.getNodeName().equals("TemplateMapping")) {
      Element tempel = (Element)node;

      String authoringTemp = 
	  getElementValueByTagName("AuthoringTemp", tempel );
	  String presTemp = 
	  getElementValueByTagName("PresentationTemp", tempel );

	  authId = getWCMDocumentByName(authoringTemp, 
	  DocumentTypes.AuthoringTemplate);

	  presId = getWCMDocumentByName(presTemp, 
	  DocumentTypes.PresentationTemplate);

	  if (authId != null){
	    try{
		if (aWCMObject.hasTemplateMapping(authId)){
		}

		if (!aWCMObject.hasTemplateMapping(authId)){
		  aWCMObject.addTemplateMapping(authId, presId);	
		}
		else{

		  DocumentIdIterator docIt = aWCMObject.getAuthoringTemplateIds();
		    if (docIt.hasNext()){
		  DocumentId dids = (DocumentId)docIt.next();
		  aWCMObject.removeTemplateMapping(dids);
		  aWCMObject.addTemplateMapping(authId, presId);			
		}
	}

		  System.out.println("TemplateMapping authName = "+authoringTemp+" 
		  and presName = "+presTemp +" added to object " + aWCMObject.getName());
		  workspace.save(aWCMObject);
		  }catch(Exception e){
		  System.out.println("Exception ="+e);
		  e.printStackTrace();
		}
		}else{
	return null;
	}
  }
}

  return aWCMObject;		
}

/*
 * This is a helper method that receives a Lotus Web Content Management 
 * document object and adds it to the workspace
 */
public boolean saveToWorkspace(com.ibm.workplace.wcm.api.Document wcmDocument){

	try{
		String[] errors = workspace.save(wcmDocument);

		for (int i = 0; i < errors.length; i++){
			System.out.println("Error while saving "+ 
			wcmDocument.getName()+ " : "+errors[i]);
		}
		if (errors.length > 0 ){
			return false;
		}
	}catch(Exception e){
		System.out.println("Exception = "+e);
		e.printStackTrace();
		return false;
	}		
	return true;		
}

/*
 * This is a helper method that retrieves a Lotus Web Content Management 
 * object by its path and returns the DocumentId
 */
public DocumentId getWCMDocumentByPath(String wcmPath, int workFlowStatus) {
	DocumentId wcmDocumentId = null;
	try{


    if(wcmPath != null){					
     DocumentIdIterator docIdIter = workspace.findByPath(wcmPath, workFlowStatus);
     if(docIdIter != null && docIdIter.hasNext()){
        wcmDocumentId = docIdIter.nextId();
      }
    }
  }catch(Exception e){
    System.out.println("Exception = "+e);
    e.printStackTrace();
	}

	return wcmDocumentId;
}

/*
 * This is a helper method that gets the child element according to
 * its name of another element if 
 * it contains only one child with that name
 */
private Element getChildByName(Element element, String name) {
	Element rEl = null;
	for (Node node = element.getFirstChild(); node != null; node = 
	node.getNextSibling()) {
	   if (node.getNodeType() == Node.ELEMENT_NODE && 
	   node.getNodeName().equals(name)) {
	    	rEl = (Element)node;
	    		break;
	    }
	}	    
	return rEl;
}

/*
 * This is a helper method that  returns a string value of the given element
 */
public String getElementValueByTagName(String aTagName, Element aElement){
	String elementValue = "";

	NodeList nodeList = aElement.getElementsByTagName(aTagName);
	if(nodeList != null && nodeList.getLength() > 0) {
		Element el = (Element)nodeList.item(0);			
		elementValue = el.getFirstChild().getNodeValue();			
	}

	return elementValue;			
}

/*
 * This is a helper method that returns the DocumentId of a Lotus Web  
 * Content Management object based on its name
 */
public DocumentId getWCMDocumentByName(String wcmName, DocumentType documentTypes){

  DocumentId wcmDocumentId = null;
  try{
    if(wcmName != null){	

      DocumentIdIterator docIdIter = workspace.findByName(documentTypes, wcmName);
      if(docIdIter != null && docIdIter.hasNext()){
        wcmDocumentId = docIdIter.nextId();

      }
    }
  }catch(Exception e){
    System.out.println("Exception = "+e);
    e.printStackTrace();
  }
  if (wcmDocumentId == null && ( (documentTypes.equals
  (DocumentTypes.AuthoringTemplate)) || (documentTypes.equals
  (DocumentTypes.PresentationTemplate)) )){
    System.out.println("Exception:  "+wcmName+" could not be found in the Repository");
  }
  return wcmDocumentId;
}

/**
   * Closes the Lotus Web Content Management workspace
   */
public void closeWorkspace() {
	WCM_API.getRepository().endWorkspace();

增强

使用本文给出的解决方案可以进一步实现增强。例如，您可以执行下面的操作：

• 使用 XML 创建内容
• 向默认内容添加更复杂的组件
• 通过只更改站点区域的名称，修改 XML 以多次创建相同的结构

  结束语

  在本文中， 我们给出了一个简单的解决方案，它使您能够以一种自动化方式定义站点结构。使用这种解决方案的用例非常多样；例如，您可能需要在多个服务器上定义站点区 域，或者您的站点中具有大量重复的站点结构。这个解决方案帮助您避免将时间浪费在执行大量既耗时又单调的任务上。

}