topic Re: How to rename authorityDisplayName Group using web services? in Alfresco Archive

How to rename authorityDisplayName Group using web services?

relax — Thu, 21 Jan 2010 08:51:17 GMT

Hello,I create a User Groups using a web service. Then I would like to rename the group created by another name using web service. Post http://forums.alfresco.com/en/viewtopic.php?f=35&t=21490 talking about AuthorityService.Is there a way to find AuthorityServiceImpl using web service?Is there a

Re: How to rename authorityDisplayName Group using web services?

mrogers — Thu, 21 Jan 2010 09:16:13 GMT

I don't think you can change the "groupName".

You can change a group's "display name" through the "groups" web script or the authority service.

Re: How to rename authorityDisplayName Group using web services?

relax — Thu, 21 Jan 2010 10:14:34 GMT

Hello,
problem centered, I would like to change a group's "display name" using web service.

Is there a method to invoke a web script programmatically, in a java class?

Thank you.

Re: How to rename authorityDisplayName Group using web services?

relax — Tue, 26 Jan 2010 11:48:57 GMT

Hello,
what are the steps to invoke

Update the details of a group
PUT /alfresco/wcservice/api/groups/{shortName}

in mode PUT?

Re: How to rename authorityDisplayName Group using web services?

mdavid_cu — Sun, 31 Jan 2010 05:43:33 GMT

Another way to rename groups' "display name" using web services can be something like that



package org.my.self.test;

import java.rmi.RemoteException;

import org.alfresco.webservice.accesscontrol.AccessControlServiceSoapBindingStub;
import org.alfresco.webservice.authentication.AuthenticationFault;
import org.alfresco.webservice.repository.RepositoryFault;
import org.alfresco.webservice.repository.RepositoryServiceSoapBindingStub;
import org.alfresco.webservice.repository.UpdateResult;
import org.alfresco.webservice.types.CML;
import org.alfresco.webservice.types.CMLUpdate;
import org.alfresco.webservice.types.NamedValue;
import org.alfresco.webservice.types.Node;
import org.alfresco.webservice.types.Predicate;
import org.alfresco.webservice.types.Query;
import org.alfresco.webservice.types.Reference;
import org.alfresco.webservice.types.Store;
import org.alfresco.webservice.util.AuthenticationUtils;
import org.alfresco.webservice.util.Constants;
import org.alfresco.webservice.util.Utils;
import org.alfresco.webservice.util.WebServiceFactory;

public class TestRenameGroup {

   public static void renameGroup(String groupName, String newName) {
      String query = "+PATH:\"/sys:system/sys:authorities//*\" + @usr\\:authorityName:\""
            + groupName + "\"";
      RepositoryServiceSoapBindingStub repositoryService = WebServiceFactory
            .getRepositoryService();
      try {
         Node[] nodes = repositoryService.get(new Predicate(null, new Store(
               "user", "alfrescoUserStore"), new Query(
               Constants.QUERY_LANG_LUCENE, query)));

         CMLUpdate update = new CMLUpdate(new NamedValue[] {Utils.createNamedValue("{http://www.alfresco.org/model/user/1.0}authorityName", newName)},
               new Predicate(new Reference[] { nodes[0].getReference() },
                     null, null), null);
         CML cml = new CML();
         cml.setUpdate(new CMLUpdate[]{update});
         UpdateResult[] updateResults = repositoryService.update(cml);
         for (UpdateResult updateResult : updateResults) {
            System.out.println(updateResult.getStatement());
         }
         
      } catch (RepositoryFault e) {
         // TODO Auto-generated catch block
         e.printStackTrace();
      } catch (RemoteException e) {
         // TODO Auto-generated catch block
         e.printStackTrace();
      }
   }

   public static void main(String[] args) {
      try {
         WebServiceFactory
               .setEndpointAddress("http://10.7.16.199:8080/alfresco/api");
         AuthenticationUtils.startSession("admin", "admin");

         renameGroup("GROUP_NODE_READER_ONLY", "GROUP_NODE_READER_ONLY1");
      } catch (AuthenticationFault e) {
         // TODO Auto-generated catch block
         e.printStackTrace();
      }
   }
}
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: How to rename authorityDisplayName Group using web services?

relax — Wed, 10 Feb 2010 12:05:10 GMT

Hello,
thank you for your response. I would like to rename the group "test" in "test123". My java main is

public static void main(String[] args) {
      try {
         WebServiceFactory
               .setEndpointAddress("http://192.168.11.235:8080/alfresco/api");
         AuthenticationUtils.startSession("admin", "admin");
         renameGroup1("test", "test12345");
         AuthenticationUtils.endSession();
      } catch (AuthenticationFault e) {
         e.printStackTrace();
      }
   }‍‍‍‍‍‍‍‍‍‍‍

but I have a java.lang.NullPointerException

Exception in thread "main" java.lang.NullPointerException
   at it.eng.alfresco.webservice.space.creation.test.TestRenameGroup.renameGroup1(TestRenameGroup.java:73)
   at it.eng.alfresco.webservice.space.creation.test.TestRenameGroup.main(TestRenameGroup.java:97)‍‍‍

Node[] nodes is null.

Is there a parameter that I must change in renameGroup method?

Is there, perhaps, a problem in the query?

Regards

Re: How to rename authorityDisplayName Group using web services?

relax — Fri, 12 Feb 2010 11:34:05 GMT

Hello,
after some tests, I suppose this a problem in group's authorityDisplayName.
This is the step of test in Alfresco 3.2r2.

1. Login as alfresco admin
2. Create a rootGroup named test
3. This is the principal properties that I see in Alfresco Node Browser for group test

Properties
Reference: workspace://SpacesStore/1fe88e02-6e91-4c6d-8c88-f4d3114c1112
Name: {http://www.alfresco.org/model/content/1.0}authorityName   
Value: GROUP_test
Name: {http://www.alfresco.org/model/system/1.0}store-identifier   
Value: SpacesStore
Name: {http://www.alfresco.org/model/content/1.0}authorityDisplayName   
Value: test
Name: {http://www.alfresco.org/model/system/1.0}store-protocol   
Value: workspace‍‍‍‍‍‍‍‍‍‍

4. I start the web service java main for rename authorityDisplayName property

public class TestRenameGroup {
    public static void renameGroup5(String uuid, String authorityDisplayName) {
      RepositoryServiceSoapBindingStub repositoryService = WebServiceFactory
            .getRepositoryService();
      try {
         Store store = new Store("workspace", "SpacesStore");
         Reference reference = new Reference(store, uuid, null);
         Reference[] references = { reference };
         NamedValue[] namedValues = new NamedValue[] { Utils.createNamedValue("{http://www.alfresco.org/model/content/1.0}authorityDisplayName", authorityDisplayName) };
         Predicate predicate = new Predicate(references, store, null);
         CMLUpdate update = new CMLUpdate(namedValues, predicate, null);
         CML cml = new CML();
         cml.setUpdate(new CMLUpdate[] { update });
         UpdateResult[] updateResults = repositoryService.update(cml);
         for (UpdateResult updateResult : updateResults) {
            System.out.println(updateResult.getStatement());
         }
      } catch (RepositoryFault e) {
         e.printStackTrace();
      } catch (RemoteException e) {
         e.printStackTrace();
      }
   }
   public static void main(String[] args) {
      try {
         WebServiceFactory
               .setEndpointAddress("http://192.168.11.235:8080/alfresco/api");
         AuthenticationUtils.startSession("admin", "admin");
         renameGroup5("1fe88e02-6e91-4c6d-8c88-f4d3114c1112", "Test2_A");
         AuthenticationUtils.endSession();
      } catch (AuthenticationFault e) {
         e.printStackTrace();
      }
   }
}‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

5. This is the principal properties that I see in Alfresco Node Browser for group test now!

Properties
Reference: workspace://SpacesStore/1fe88e02-6e91-4c6d-8c88-f4d3114c1112
Name: {http://www.alfresco.org/model/content/1.0}authorityName   
Value: GROUP_test
Name: {http://www.alfresco.org/model/system/1.0}store-identifier   
Value: SpacesStore
Name: {http://www.alfresco.org/model/content/1.0}authorityDisplayName   
Value: Test2_A
Name: {http://www.alfresco.org/model/system/1.0}store-protocol   
Value: workspace‍‍‍‍‍‍‍‍‍‍

6. Logout Alfresco
7. Login as alfresco admin
8. Go in Manage User Groups
9. I see the display name group test.
It's not display name Test2_A.

Why?

This problem there is also I use web script, see

http://forums.alfresco.com/en/viewtopic.php?f=36&t=25023

Thank you.

Re: How to rename authorityDisplayName Group using web services?

mdavid_cu — Tue, 16 Feb 2010 18:36:58 GMT

Try to rename parameter's value
{http://www.alfresco.org/model/content/1.0}authorityName

Note: the value of this parameter must be added the prefix: "GROUP_"+the_new_value

Re: How to rename authorityDisplayName Group using web services?

relax — Mon, 01 Mar 2010 17:17:34 GMT

Hello,
I try to rename parameter's value {http://www.alfresco.org/model/content/1.0}authorityName
with authorityName = "GROUP_"+the_new_value
but I have a java.lang.UnsupportedOperationException: The name of an authority can not be changed

AxisFault
 faultCode: {http://schemas.xmlsoap.org/soap/envelope/}Server.generalException
 faultSubcode: 
 faultString: 
 faultActor: 
 faultNode: 
 faultDetail: 
   {http://www.alfresco.org/ws/service/repository/1.0}RepositoryFault:<ns1:errorCode>0</ns1:errorCode><ns1:message>java.lang.UnsupportedOperationException: The name of an authority can not be changed</ns1:message>
   {http://xml.apache.org/axis/}exceptionName:org.alfresco.repo.webservice.repository.RepositoryFault
   {http://xml.apache.org/axis/}stackTrace:
   at org.alfresco.repo.webservice.repository.RepositoryWebService.update(RepositoryWebService.java:341)
   at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
   at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
   at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
   at java.lang.reflect.Method.invoke(Method.java:597)
   at org.apache.axis.providers.java.RPCProvider.invokeMethod(RPCProvider.java:397)
   at org.apache.axis.providers.java.RPCProvider.processMessage(RPCProvider.java:186)
   at org.apache.axis.providers.java.JavaProvider.invoke(JavaProvider.java:323)
   at org.apache.axis.strategies.InvocationStrategy.visit(InvocationStrategy.java:32)
   at org.apache.axis.SimpleChain.doVisiting(SimpleChain.java:118)
   at org.apache.axis.SimpleChain.invoke(SimpleChain.java:83)
   at org.apache.axis.handlers.soap.SOAPService.invoke(SOAPService.java:454)
   at org.apache.axis.server.AxisServer.invoke(AxisServer.java:281)
   at org.apache.axis.transport.http.AxisServlet.doPost(AxisServlet.java:699)
   at javax.servlet.http.HttpServlet.service(HttpServlet.java:637)
   at org.apache.axis.transport.http.AxisServletBase.service(AxisServletBase.java:327)
   at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
   at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)
   at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
   at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)
   at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)
   at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:128)
   at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
   at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
   at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:286)
   at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:845)
   at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:583)
   at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:447)
   at java.lang.Thread.run(Thread.java:619)

   {http://xml.apache.org/axis/}hostname:ubuntu-desktop


   at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
   at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:39)
   at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:27)
   at java.lang.reflect.Constructor.newInstance(Constructor.java:513)
   at java.lang.Class.newInstance0(Class.java:355)
   at java.lang.Class.newInstance(Class.java:308)
   at org.apache.axis.encoding.ser.BeanDeserializer.<init>(BeanDeserializer.java:104)
   at org.apache.axis.encoding.ser.BeanDeserializer.<init>(BeanDeserializer.java:90)
   at org.alfresco.webservice.repository.RepositoryFault.getDeserializer(RepositoryFault.java:146)
   at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
   at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
   at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
   at java.lang.reflect.Method.invoke(Method.java:597)
   at org.apache.axis.encoding.ser.BaseDeserializerFactory.getSpecialized(BaseDeserializerFactory.java:154)
   at org.apache.axis.encoding.ser.BaseDeserializerFactory.getDeserializerAs(BaseDeserializerFactory.java:84)
   at org.apache.axis.encoding.DeserializationContext.getDeserializer(DeserializationContext.java:464)
   at org.apache.axis.encoding.DeserializationContext.getDeserializerForType(DeserializationContext.java:547)
   at org.apache.axis.message.SOAPFaultDetailsBuilder.onStartChild(SOAPFaultDetailsBuilder.java:157)
   at org.apache.axis.encoding.DeserializationContext.startElement(DeserializationContext.java:1035)
   at org.apache.xerces.parsers.AbstractSAXParser.startElement(Unknown Source)
   at org.apache.xerces.impl.XMLNSDocumentScannerImpl.scanStartElement(Unknown Source)
   at org.apache.xerces.impl.XMLDocumentFragmentScannerImpl$FragmentContentDispatcher.dispatch(Unknown Source)
   at org.apache.xerces.impl.XMLDocumentFragmentScannerImpl.scanDocument(Unknown Source)
   at org.apache.xerces.parsers.XML11Configuration.parse(Unknown Source)
   at org.apache.xerces.parsers.XML11Configuration.parse(Unknown Source)
   at org.apache.xerces.parsers.XMLParser.parse(Unknown Source)
   at org.apache.xerces.parsers.AbstractSAXParser.parse(Unknown Source)
   at org.apache.xerces.jaxp.SAXParserImpl$JAXPSAXParser.parse(Unknown Source)
   at org.apache.xerces.jaxp.SAXParserImpl.parse(Unknown Source)
   at org.apache.axis.encoding.DeserializationContext.parse(DeserializationContext.java:227)
   at org.apache.axis.SOAPPart.getAsSOAPEnvelope(SOAPPart.java:696)
   at org.apache.axis.Message.getSOAPEnvelope(Message.java:435)
   at org.apache.axis.handlers.soap.MustUnderstandChecker.invoke(MustUnderstandChecker.java:62)
   at org.apache.axis.client.AxisClient.invoke(AxisClient.java:206)
   at org.apache.axis.client.Call.invokeEngine(Call.java:2784)
   at org.apache.axis.client.Call.invoke(Call.java:2767)
   at org.apache.axis.client.Call.invoke(Call.java:2443)
   at org.apache.axis.client.Call.invoke(Call.java:2366)
   at org.apache.axis.client.Call.invoke(Call.java:1812)
   at org.alfresco.webservice.repository.RepositoryServiceSoapBindingStub.update(RepositoryServiceSoapBindingStub.java:986)
   at it.eng.alfresco.webservice.space.creation.test.TestRenameGroup.renameGroup5(TestRenameGroup.java:57)
   at it.eng.alfresco.webservice.space.creation.test.TestRenameGroup.main(TestRenameGroup.java:37)
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Re: How to rename authorityDisplayName Group using web services?

dward — Mon, 01 Mar 2010 18:08:39 GMT

The first test was correct. Alfresco Explorer doesn't display authority display names. Only Share.

Re: How to rename authorityDisplayName Group using web services?

relax — Tue, 02 Mar 2010 09:59:44 GMT

Hello,
in Share admin console there are correct authority display names.
Why not appear in Alfresco Explorer?

Re: How to rename authorityDisplayName Group using web services?

dward — Tue, 02 Mar 2010 11:30:43 GMT

I have logged https://issues.alfresco.com/jira/browse/ALF-1921 .

Re: How to rename authorityDisplayName Group using web services?

relax — Mon, 15 Mar 2010 17:25:52 GMT

Hello,
this is a work around in Alfresco 3.2r2 to visualize AuthorityDisplayName in Alfresco Explorer for User Groups.
I changed the class

org.alfresco.web.bean.wizard.BaseInviteUsersWizard.java

in web-client project of alfresco source.

/*

 * Copyright (C) 2005-2007 Alfresco Software Limited.

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.



 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.



 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.



 * As a special exception to the terms and conditions of version 2.0 of 

 * the GPL, you may redistribute this Program in connection with Free/Libre 

 * and Open Source Software ("FLOSS") applications as described in Alfresco's 

 * FLOSS exception.  You should have recieved a copy of the text describing 

 * the FLOSS exception, and it is also available here: 

 * http://www.alfresco.com/legal/licensing"

 */

package org.alfresco.web.bean.wizard;



import java.io.IOException;

import java.io.ObjectInputStream;

import java.io.Serializable;

import java.text.MessageFormat;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.HashSet;

import java.util.List;

import java.util.Map;

import java.util.ResourceBundle;

import java.util.Set;

import java.util.regex.Matcher;

import java.util.regex.Pattern;



import javax.faces.component.UISelectOne;

import javax.faces.context.FacesContext;

import javax.faces.event.ActionEvent;

import javax.faces.model.DataModel;

import javax.faces.model.ListDataModel;

import javax.faces.model.SelectItem;

import javax.transaction.UserTransaction;



import org.alfresco.model.ContentModel;

import org.alfresco.repo.search.impl.lucene.LuceneQueryParser;

import org.alfresco.repo.security.permissions.AccessDeniedException;

import org.alfresco.service.cmr.dictionary.DictionaryService;

import org.alfresco.service.cmr.repository.NodeRef;

import org.alfresco.service.cmr.search.LimitBy;

import org.alfresco.service.cmr.search.ResultSet;

import org.alfresco.service.cmr.search.SearchParameters;

import org.alfresco.service.cmr.search.SearchService;

import org.alfresco.service.cmr.security.AuthorityService;

import org.alfresco.service.cmr.security.AuthorityType;

import org.alfresco.service.cmr.security.PermissionService;

import org.alfresco.service.cmr.security.PersonService;

import org.alfresco.service.namespace.NamespaceService;

import org.alfresco.util.SearchLanguageConversion;

import org.alfresco.web.app.Application;

import org.alfresco.web.bean.TemplateMailHelperBean;

import org.alfresco.web.bean.repository.Node;

import org.alfresco.web.bean.repository.Repository;

import org.alfresco.web.bean.repository.User;

import org.alfresco.web.data.IDataContainer;

import org.alfresco.web.data.QuickSort;

import org.alfresco.web.ui.common.SortableSelectItem;

import org.alfresco.web.ui.common.Utils;

import org.alfresco.web.ui.common.component.UIGenericPicker;

import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;

import org.apache.lucene.search.BooleanQuery;

import org.springframework.mail.javamail.JavaMailSender;



/**

 * Backing bean for the Invite Users wizard(s)

 * 

 * @author Kevin Roast

 */

public abstract class BaseInviteUsersWizard extends BaseWizardBean

{

   private static final long serialVersionUID = -5145813383038390250L;

   

   private final static Log logger = LogFactory.getLog(BaseInviteUsersWizard.class);

   

   /** I18N message strings */

   protected static final String MSG_USERROLES = "invite_users_summary";

   private static final String MSG_USERS  = "users";

   private static final String MSG_GROUPS = "groups";

   private static final String MSG_INVITED_TO = "invited_to";

   private static final String MSG_INVITED_ROLE  = "invite_role";

   private static final String MSG_MAX_USERS  = "max_users_returned";

   private static final String MSG_SEARCH_MINIMUM = "picker_search_min";

   

   protected static final String STEP_NOTIFY = "notify";

   

   private static final String NOTIFY_YES = "yes";

   private static final String NOTIFY_NO = "no";

   

   private static final String separator = "_|_";

   

   /** NamespaceService bean reference */

   transient private NamespaceService namespaceService;

   

   /** JavaMailSender bean reference */

   transient private JavaMailSender mailSender;

   

   /** AuthorityService bean reference */

   transient private AuthorityService authorityService;

   

   /** PermissionService bean reference */

   transient protected PermissionService permissionService;

   

   /** personService bean reference */

   transient private PersonService personService;

   

   /** Helper providing template based mailing facilities */

   protected TemplateMailHelperBean mailHelper;

   

   /** datamodel for table of roles for users */

   transient private DataModel userRolesDataModel = null;

   

   /** list of user/group role wrapper objects */

   protected List<UserGroupRole> userGroupRoles = null;

   

   /** True to allow duplicate authorities (with a different role) */

   protected boolean allowDuplicateAuthorities = true;

   

   /** Flag to determine if the maximum number of users have been returned */

   protected boolean maxUsersReturned = false;

   

   /** dialog state */

   private String notify = NOTIFY_NO;

   

   /**

    * @return a cached list of available permissions for the type being dealt with

    */

   protected abstract Set<String> getPermissionsForType();

   

   /**

    * @return Returns the node that the permissions are being applied to

    */

   protected abstract Node getNode();

   

   /**

     * @return Returns the list of email templates for user notification

     */

    public List<SelectItem> getEmailTemplates()

    {

        List<SelectItem> wrappers = null;



        try

        {

            FacesContext fc = FacesContext.getCurrentInstance();

            NodeRef rootNodeRef = this.getNodeService().getRootNode(Repository.getStoreRef());

            NamespaceService resolver = Repository.getServiceRegistry(fc).getNamespaceService();

            List<NodeRef> results = this.getSearchService().selectNodes(rootNodeRef, getEmailTemplateXPath(), null, resolver, false);



            wrappers = new ArrayList<SelectItem>(results.size() + 1);

            if (results.size() != 0)

            {

                DictionaryService dd = Repository.getServiceRegistry(fc).getDictionaryService();

                for (NodeRef ref : results)

                {

                    if (this.getNodeService().exists(ref) == true)

                    {

                        Node childNode = new Node(ref);

                        if (dd.isSubClass(childNode.getType(), ContentModel.TYPE_CONTENT))

                        {

                            wrappers.add(new SelectItem(childNode.getId(), childNode.getName()));

                        }

                    }

                }



                // make sure the list is sorted by the label

                QuickSort sorter = new QuickSort(wrappers, "label", true, IDataContainer.SORT_CASEINSENSITIVE);

                sorter.sort();

            }

        }

        catch (AccessDeniedException accessErr)

        {

            // ignore the result if we cannot access the root

        }



        // add an entry (at the start) to instruct the user to select an item

        if (wrappers == null)

        {

            wrappers = new ArrayList<SelectItem>(1);

        }

        wrappers.add(0, new SelectItem("none", Application.getMessage(FacesContext.getCurrentInstance(), "select_a_template")));



        return wrappers;

    }



    protected abstract String getEmailTemplateXPath();



    /**

    * @param namespaceService   The NamespaceService to set.

    */

   public void setNamespaceService(NamespaceService namespaceService)

   {

      this.namespaceService = namespaceService;

   }

   

   protected NamespaceService getNamespaceService()

   {

      if (namespaceService == null)

      {

         namespaceService = Repository.getServiceRegistry(FacesContext.getCurrentInstance()).getNamespaceService();

      }

      return namespaceService;

   }

   

   /**

    * @param mailSender          The JavaMailSender to set.

    */

   public void setMailSender(JavaMailSender mailSender)

   {

      this.mailSender = mailSender;

   }

   

   /**

    * @param permissionService   The PermissionService to set.

    */

   public void setPermissionService(PermissionService permissionService)

   {

      this.permissionService = permissionService;

   }

   

   protected PermissionService getPermissionService()

   {

      if (permissionService == null)

      {

         permissionService = Repository.getServiceRegistry(FacesContext.getCurrentInstance()).getPermissionService();

      }

      return permissionService;

   }

   

   /**

    * @param personService   The PersonService to set.

    */

   public void setPersonService(PersonService personService)

   {

      this.personService = personService;

   }

   

   protected PersonService getPersonService()

   {

      if (personService == null)

      {

         personService = Repository.getServiceRegistry(FacesContext.getCurrentInstance()).getPersonService();

      }

      return personService;

   }

   

   /**

    * @param authorityService    The authorityService to set.

    */

   public void setAuthorityService(AuthorityService authorityService)

   {

      this.authorityService = authorityService;

   }

   

   protected AuthorityService getAuthorityService()

   {

      if (authorityService == null)

      {

         authorityService = Repository.getServiceRegistry(FacesContext.getCurrentInstance()).getAuthorityService();

      }

      return authorityService;

   }



   /**

    * Initialises the wizard

    */

   @Override

   public void init(Map<String, String> parameters)

   {

      super.init(parameters);

      

      maxUsersReturned = false;

      notify = NOTIFY_NO;

      userRolesDataModel = null;

      userGroupRoles = new ArrayList<UserGroupRole>(8);

      mailHelper = new TemplateMailHelperBean();

      mailHelper.setMailSender(mailSender);

      mailHelper.setNodeService(getNodeService());

   }



   /**

    * @see org.alfresco.web.bean.dialog.BaseDialogBean#finishImpl(javax.faces.context.FacesContext, java.lang.String)

    */

   @Override

   protected String finishImpl(FacesContext context, String outcome) throws Exception

   {

      User user = Application.getCurrentUser(context);

      String from = (String)this.getNodeService().getProperty(user.getPerson(), ContentModel.PROP_EMAIL);

      if (from == null || from.length() == 0)

      {

         // if the user does not have an email address get the default one from the config service

         from = Application.getClientConfig(context).getFromEmailAddress();

      }

      

      // get the Space to apply changes too

      NodeRef nodeRef = this.getNode().getNodeRef();

      

      // set permissions for each user and send them a mail

      for (int i=0; i<this.userGroupRoles.size(); i++)

      {

         UserGroupRole userGroupRole = this.userGroupRoles.get(i);

         String authority = userGroupRole.getAuthority();

         

         // find the selected permission ref from it's name and apply for the specified user

         Set<String> perms = getPermissionsForType();

         for (String permission : perms)

         {

            if (userGroupRole.getRole().equals(permission))

            {

               this.getPermissionService().setPermission(

                     nodeRef,

                     authority,

                     permission,

                     true);

               break;

            }

         }

         

         // Create the mail message for sending to each User

         if (NOTIFY_YES.equals(this.notify))

         {

            // if User, email then, else if Group get all members and email them

            AuthorityType authType = AuthorityType.getAuthorityType(authority);

            if (authType.equals(AuthorityType.USER))

            {

               if (this.getPersonService().personExists(authority) == true)

               {

                  this.mailHelper.notifyUser(

                        this.getPersonService().getPerson(authority), nodeRef, from, userGroupRole.getRole());

               }

            }

            else if (authType.equals(AuthorityType.GROUP))

            {

               // else notify all members of the group

               Set<String> users = this.getAuthorityService().getContainedAuthorities(AuthorityType.USER, authority, false);

               for (String userAuth : users)

               {

                  if (this.getPersonService().personExists(userAuth) == true)

                  {

                     this.mailHelper.notifyUser(

                           this.getPersonService().getPerson(userAuth), nodeRef, from, userGroupRole.getRole());

                  }

               }

            }

         }

      }

      

      // reset max users flag

      this.maxUsersReturned = false;

      

      return outcome;

   }

   

   /* (non-Javadoc)

    * @see org.alfresco.web.bean.dialog.BaseDialogBean#cancel()

    */

   @Override

   public String cancel()

   {

      // reset max users flag

      this.maxUsersReturned = false;

      

      return super.cancel();

   }



   /**

    * @see org.alfresco.web.bean.dialog.BaseDialogBean#getFinishButtonDisabled()

    */

   @Override

   public boolean getFinishButtonDisabled()

   {

      boolean disabled = true;

      

      String stepName = Application.getWizardManager().getCurrentStepName();

      if (STEP_NOTIFY.equals(stepName))

      {

         disabled = false;

      }

      

      return disabled;

   }



   /**

    * Returns the properties for current user-roles JSF DataModel

    * 

    * @return JSF DataModel representing the current user-roles

    */

   public DataModel getUserRolesDataModel()

   {

      if (this.userRolesDataModel == null)

      {

         this.userRolesDataModel = new ListDataModel();

      }

      

      // only set the wrapped data once otherwise the rowindex is reset

      if (this.userRolesDataModel.getWrappedData() == null)

      {

         this.userRolesDataModel.setWrappedData(this.userGroupRoles);

      }

      

      return this.userRolesDataModel;

   }

   

   /**

    * Query callback method executed by the Generic Picker component.

    * This method is part of the contract to the Generic Picker, it is up to the backing bean

    * to execute whatever query is appropriate and return the results.

    * 

    * @param filterIndex        Index of the filter drop-down selection

    * @param contains           Text from the contains textbox

    * 

    * @return An array of SelectItem objects containing the results to display in the picker.

    */

   public SelectItem[] pickerCallback(int filterIndex, String contains)

   {

      FacesContext context = FacesContext.getCurrentInstance();

      

      // quick exit if not enough characters entered for a search

      String search = contains.trim();

      int searchMin = Application.getClientConfig(context).getPickerSearchMinimum();

      if (search.length() < searchMin)

      {

         Utils.addErrorMessage(MessageFormat.format(Application.getMessage(context, MSG_SEARCH_MINIMUM), searchMin));

         return new SelectItem[0];

      }

      

      SelectItem[] items;

      this.maxUsersReturned = false;

      

      UserTransaction tx = null;

      try

      {

         tx = Repository.getUserTransaction(context, true);

         tx.begin();

         

         int maxResults = Application.getClientConfig(context).getInviteUsersMaxResults();

         

         List<SelectItem> results;

         

         if (filterIndex == 0)

         {

            // Use lucene search to retrieve user details

            String term = LuceneQueryParser.escape(search);

            StringBuilder query = new StringBuilder(128);

            if (contains == null || contains.length() == 0)

            {

               // if there is no search term, search for all people

               query.append("+TYPE:\"");

               query.append(ContentModel.TYPE_PERSON.toString());

               query.append("\"");

            }

            else

            {

               Utils.generatePersonSearch(query, term);

            }

               

            if (logger.isDebugEnabled())

            {

               logger.debug("Maximum invite users results size: " + maxResults);

               logger.debug("Using query to find users: " + query.toString());

            }

            

            SearchParameters searchParams = new SearchParameters();

            searchParams.addStore(Repository.getStoreRef());

            searchParams.setLanguage(SearchService.LANGUAGE_LUCENE);

            searchParams.setQuery(query.toString());

            if (maxResults > 0)

            {

               searchParams.setLimit(maxResults);

               searchParams.setLimitBy(LimitBy.FINAL_SIZE);

            }

            

            ResultSet resultSet = Repository.getServiceRegistry(context).getSearchService().query(searchParams);

            List<NodeRef> nodes;

            try

            {

               nodes = resultSet.getNodeRefs();

            }

            finally

            {

                resultSet.close();

            }

            

            results = new ArrayList<SelectItem>(nodes.size());

            for (int index=0; index<nodes.size(); index++)

            {

               NodeRef personRef = nodes.get(index);

               String firstName = (String)this.getNodeService().getProperty(personRef, ContentModel.PROP_FIRSTNAME);

               String lastName = (String)this.getNodeService().getProperty(personRef, ContentModel.PROP_LASTNAME);

               String username = (String)this.getNodeService().getProperty(personRef, ContentModel.PROP_USERNAME);

               if (username != null)

               {

                  SelectItem item = new SortableSelectItem(username, firstName + " " + lastName + " [" + username + "]", lastName);

                  results.add(item);

               }

            }

         }

         else

         {

            results = addGroupItems(search, maxResults);

         }

         

         items = new SelectItem[results.size()];

         results.toArray(items);

         Arrays.sort(items);

         

         // set the maximum users returned flag if appropriate

         if (results.size() == maxResults)

         {

            this.maxUsersReturned = true;

         }

         

         // commit the transaction

         tx.commit();

      }

      catch (BooleanQuery.TooManyClauses clauses)

      {

         Utils.addErrorMessage(Application.getMessage(

                  FacesContext.getCurrentInstance(), "too_many_users"));

         

         try { if (tx != null) {tx.rollback();} } catch (Exception tex) {}

         

         items = new SelectItem[0];

      }

      catch (Throwable err)

      {

         Utils.addErrorMessage(MessageFormat.format(Application.getMessage(

               FacesContext.getCurrentInstance(), Repository.ERROR_GENERIC), err.getMessage()), err );

         try { if (tx != null) {tx.rollback();} } catch (Exception tex) {}

         

         items = new SelectItem[0];

      }

      

      return items;

   }

   

   private List<SelectItem> addGroupItems(String search, int maxResults)

   {

       Set<String> groups = getGroupsByDisplayName(search);

       

       List<SelectItem> results = new ArrayList<SelectItem>(groups.size());

       

       int count = 0;

       String authorityName = null;

       String authorityDisplayName = null;

       

       for (String authorityName_authorityDisplayName : groups)

       {

          // get display name, if not present strip prefix from group id

          // groupDisplayName = getAuthorityService().getAuthorityDisplayName(group);

          

//          if (groupDisplayName == null || groupDisplayName.length() == 0)

//          {

//             //groupDisplayName = group.substring(PermissionService.GROUP_PREFIX.length());

//             groupDisplayName = group;

//          }

          if(authorityName_authorityDisplayName.contains(separator)) {

             authorityName = authorityName_authorityDisplayName.substring(0, authorityName_authorityDisplayName.indexOf(separator));

             authorityDisplayName = authorityName_authorityDisplayName.substring(authorityName_authorityDisplayName.indexOf(separator) + separator.length());

          } else {

             authorityName = authorityName_authorityDisplayName;

             authorityDisplayName = authorityName_authorityDisplayName;

          }

          if(authorityDisplayName.contains(PermissionService.GROUP_PREFIX)) {

             authorityDisplayName = authorityDisplayName.substring(PermissionService.GROUP_PREFIX.length());

          }

          //results.add(new SortableSelectItem(group, groupDisplayName, groupDisplayName));

         results.add(new SortableSelectItem(authorityName, authorityDisplayName, authorityDisplayName));

          

          if (++count == maxResults) break;

       }

       return results;

   }

   

   protected Set<String> getGroups(String search)

   {

       // groups - text search match on supplied name

       String term = PermissionService.GROUP_PREFIX + "*" + search + "*";

       Set<String> groups;

       groups = getAuthorityService().findAuthorities(AuthorityType.GROUP, term);

       groups.addAll(getAuthorityService().getAllAuthorities(AuthorityType.EVERYONE));

       return groups;

   }

   

   

   

   protected Set<String> getGroupsByDisplayName(String search)

   {

      Set<String> resultGroups = new HashSet<String>();

       // groups - text search match on supplied name

       String term = "*" + search + "*";

       Set<String> groups;

       Pattern pattern = null;

       if (term != null)

       {

           String regExpString = SearchLanguageConversion.convert(SearchLanguageConversion.DEF_LUCENE, SearchLanguageConversion.DEF_REGEX, term);

           pattern = Pattern.compile(regExpString, Pattern.CASE_INSENSITIVE);

       }

       

       groups = getAuthorityService().findAuthorities(AuthorityType.GROUP, null);

       for(String groupName: groups){

          String displayName = getAuthorityService().getAuthorityDisplayName(groupName);

          if(displayName == null){

             //considero il groupname se non e' definito il displayname

             displayName = groupName;

          } else {

             displayName = PermissionService.GROUP_PREFIX + displayName;

          }

          String authorityDisplayName = groupName + separator + displayName;

          //addAuthorityNameIfMatches(resultGroups, groupName + separator + displayName, pattern);

          if (pattern == null) {

             resultGroups.add(authorityDisplayName);

          } else {

             Matcher m = pattern.matcher(displayName);

             if (m.matches()) {

                resultGroups.add(authorityDisplayName);

                 }

          }

       }

       

       resultGroups.addAll(getAuthorityService().getAllAuthorities(AuthorityType.EVERYONE));

       return resultGroups;

   }

     

   private void addAuthorityNameIfMatches(Set<String> authorities, String authorityName, Pattern pattern)

   {

      if (pattern == null) {

           authorities.add(authorityName);

      } else {

           Matcher m = pattern.matcher(authorityName);

           if (m.matches()) {

                authorities.add(authorityName);

           }

      }

   }

   

   /**

    * Action handler called when the Add button is pressed to process the current selection

    */

   public void addSelection(ActionEvent event)

   {

      UIGenericPicker picker = (UIGenericPicker)event.getComponent().findComponent("picker");

      UISelectOne rolePicker = (UISelectOne)event.getComponent().findComponent("roles");

      

      String[] results = picker.getSelectedResults();

      if (results != null)

      {

         String role = (String)rolePicker.getValue();

         if (role != null)

         {

            for (int i=0; i<results.length; i++)

            {

               addAuthorityWithRole(results[i], role);

            }

         }

      }

   }



   /**

    * Add an authority with the specified role to the list managed by this wizard.

    * 

    * @param authority        Authority to add (cannot be null)

    * @param role             Role for the authorities (cannot be null)

    */

   public void addAuthorityWithRole(String authority, String role)

   {

      // only add if authority not already present in the list with same role

      boolean foundExisting = false;

      for (int n=0; n<this.userGroupRoles.size(); n++)

      {

         UserGroupRole wrapper = this.userGroupRoles.get(n);

         if (authority.equals(wrapper.getAuthority()) &&

               (!this.allowDuplicateAuthorities || role.equals(wrapper.getRole())))

         {

            foundExisting = true;

            break;

         }

      }

      

      if (foundExisting == false)

      {

         StringBuilder label = new StringBuilder(64);

         

         // build a display label showing the user and their role for the space

         AuthorityType authType = AuthorityType.getAuthorityType(authority);

         if (authType == AuthorityType.GUEST || authType == AuthorityType.USER)

         {

            if (authType == AuthorityType.GUEST || getPersonService().personExists(authority) == true)

            {

               // found a User authority

               label.append(buildLabelForUserAuthorityRole(authority, role));

            }

         }

         else

         {

            // found a group authority

            label.append(buildLabelForGroupAuthorityRole(authority, role));

         }

         

         this.userGroupRoles.add(new UserGroupRole(authority, role, label.toString()));

      }

   }

   

   /**

    * Action handler called when the Remove button is pressed to remove a user+role

    */

   public void removeSelection(ActionEvent event)

   {

      UserGroupRole wrapper = (UserGroupRole)getUserRolesDataModel().getRowData();

      if (wrapper != null)

      {

         this.userGroupRoles.remove(wrapper);

      }

   }

   

   /**

    * Property accessed by the Generic Picker component.

    * 

    * @return the array of filter options to show in the users/groups picker

    */

   public SelectItem[] getFilters()

   {

      ResourceBundle bundle = Application.getBundle(FacesContext.getCurrentInstance());

      

      return new SelectItem[] {

            new SelectItem("0", bundle.getString(MSG_USERS)),

            new SelectItem("1", bundle.getString(MSG_GROUPS)) };

   }

   

   /**

    * @return The list of available roles for the users/groups

    */

   public SelectItem[] getRoles()

   {

      ResourceBundle bundle = Application.getBundle(FacesContext.getCurrentInstance());

      

      // get available roles (grouped permissions) from the permission service

      Set<String> perms = getPermissionsForType();

      SelectItem[] roles = new SelectItem[perms.size()];

      int index = 0;

      for (String permission : perms)

      {

         String displayLabel = bundle.getString(permission);

         if (displayLabel.startsWith("$$") == true)

         {

             displayLabel = permission;

         }

         roles[index++] = new SelectItem(permission, displayLabel);

      }

      

      return roles;

   }

   

   /**

    * @return Returns the notify listbox selection.

    */

   public String getNotify()

   {

      return this.notify;

   }



   /**

    * @param notify The notify listbox selection to set.

    */

   public void setNotify(String notify)

   {

      this.notify = notify;

   }

   

   @Override

   public String next()

   {

      String stepName = Application.getWizardManager().getCurrentStepName();

      

      if (STEP_NOTIFY.equals(stepName))

      {

         FacesContext context = FacesContext.getCurrentInstance();

         

         // prepare automatic text for email and display

         StringBuilder buf = new StringBuilder(256);

         

         String personName = Application.getCurrentUser(context).getFullName(this.getNodeService());

         String msgInvitedTo = Application.getMessage(context, MSG_INVITED_TO);

         Node node = this.getNode();

         String path = this.getNodeService().getPath(node.getNodeRef()).toDisplayPath(

                 this.getNodeService(), getPermissionService());

         buf.append(MessageFormat.format(msgInvitedTo, new Object[] {

               path + '/' + node.getName(),

               personName}) );

         

         // default the subject line to an informative message

         this.mailHelper.setSubject(buf.toString());

         

         // add the rest of the automatic body text

         buf.append("\r\n\r\n");

         

         String msgRole = Application.getMessage(context, MSG_INVITED_ROLE);

         String roleText;

         if (this.userGroupRoles.size() != 0)

         {

            String roleMsg = Application.getMessage(context, userGroupRoles.get(0).getRole());

            roleText = MessageFormat.format(msgRole, roleMsg);

         }

         else

         {

            roleText = MessageFormat.format(msgRole, "[role]");

         }

         

         buf.append(roleText);

         

         // set the body content and default text to this text

         this.mailHelper.setAutomaticText(buf.toString());

         this.mailHelper.setBody(this.mailHelper.getAutomaticText());

      }

      

      return null;

   }

   

   /**

    * @return TemplateMailHelperBean instance for this wizard

    */

   public TemplateMailHelperBean getMailHelper()

   {

      return this.mailHelper;

   }

   

   /**

    * Helper to build a label of the form:

    *    Firstname Lastname (Role)

    */

   public String buildLabelForUserAuthorityRole(String authority, String role)

   {

      // found a User authority

      NodeRef ref = this.getPersonService().getPerson(authority);

      String firstName = (String)this.getNodeService().getProperty(ref, ContentModel.PROP_FIRSTNAME);

      String lastName = (String)this.getNodeService().getProperty(ref, ContentModel.PROP_LASTNAME);

      

      StringBuilder buf = new StringBuilder(100);

      buf.append(firstName)

         .append(" ")

         .append(lastName != null ? lastName : "")

         .append(" (")

         .append(Application.getMessage(FacesContext.getCurrentInstance(), role))

         .append(")");

      

      return buf.toString();

   }

   

   /**

    * Helper to build a label for a Group authority of the form:

    *    Groupname (role)

    */

   public String buildLabelForGroupAuthorityRole(String authority, String role)

   {

      String groupDisplayName = this.authorityService.getAuthorityDisplayName(authority);

      if (groupDisplayName == null || groupDisplayName.length() == 0)

      {

         groupDisplayName = authority.substring(PermissionService.GROUP_PREFIX.length());

      }

      

      StringBuilder buf = new StringBuilder(100);

      buf.append(groupDisplayName)

         .append(" (")

         .append(Application.getMessage(FacesContext.getCurrentInstance(), role))

         .append(")");

      

      return buf.toString();

   }

   

   /**

    * @return summary text for the wizard

    */

   public String getSummary()

   {

      FacesContext fc = FacesContext.getCurrentInstance();

      

      // build a summary section to list the invited users and there roles

      StringBuilder buf = new StringBuilder(128);

      for (UserGroupRole userRole : this.userGroupRoles)

      {

         buf.append(Utils.encode(userRole.getLabel()));

         buf.append("<br>");

      }

      

      return buildSummary(

            new String[] {Application.getMessage(fc, MSG_USERROLES)},

            new String[] {buf.toString()});

   }

   

   /**

    * @return flag to indicate whether maximum users have been returned

    */

   public boolean getHaveMaximumUsersBeenReturned()

   {

      return this.maxUsersReturned;

   }

   

   /**

    * @return Message to display when the maximum number of users have been returned

    */

   public String getMaximumUsersMsg()

   {

      FacesContext context = FacesContext.getCurrentInstance();

      

      String pattern = Application.getMessage(context, MSG_MAX_USERS);

      String msg = MessageFormat.format(pattern, 

               Application.getClientConfig(context).getInviteUsersMaxResults());

      

      return Utils.encode(msg);

   }

   

   private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException

   {

      in.defaultReadObject();



      this.userRolesDataModel = new ListDataModel();

      this.userRolesDataModel.setWrappedData(this.userGroupRoles);



   }

   

   /**

    * Simple wrapper class to represent a user/group and a role combination

    */

   public static class UserGroupRole implements Serializable

   {

      private static final long serialVersionUID = -3200146057437311225L;

      

      public UserGroupRole(String authority, String role, String label)

      {

         this.authority = authority;

         this.role = role;

         this.label = label;

      }

      

      public String getAuthority()

      {

         return this.authority;

      }

      

      public String getRole()

      {

         return this.role;

      }

      

      public String getLabel()

      {

         return this.label;

      }

      

      private String authority;

      private String role;

      private String label;

   }

}

‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍