通過單擊操作建立 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. 的文件選項 <!-- document.write(''); //--&gt <!-- document.write(''); //--&gt 列印本頁 列印本頁 將此頁作為電子郵件傳送 將此頁作為電子郵件傳送 討論 樣例程式碼 英文原文

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 以多次建立相同的結構

  結束語

  在本文中， 我們給出了一個簡單的解決方案，它使您能夠以一種自動化方式定義站點結構。使用這種解決方案的用例非常多樣；例如，您可能需要在多個伺服器上定義站點區 域，或者您的站點中具有大量重複的站點結構。這個解決方案幫助您避免將時間浪費在執行大量既耗時又單調的任務上。

}