Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
xml
xml
<!-- Example Group Declarations --> 

<pags-store xmlns="https://source.jasig.org/schemas/uportal/io/pags">
  <name>Default</name>
  <description>Default Person Attribute Group Store</description>

<!-- Group declarations: -->

<!--
  Group pags_root: "PAGS Root"
  IMPORTANT: The PAGS Root group is REQUIRED for uPortal to function. It Must be a member of the Everyone group in the
  local group store
-->
  <pags-group>
    <name>PAGS Root</name>
    <description>Root group for all PAGS groups.  Convenience for adding PAGS groups to a local group.</description>
    <members>
      <member-key>All Users (PAGS)</member-key>
      <member-key>Authenticated Users</member-key>
      <member-key>Desktop Device Access</member-key>
      <member-key>Mobile Device Access</member-key>
      <member-key>Respondr Theme Users</member-key>
    </members>
  </pags-group>

<!--
  Group all_users: "All Users (PAGS)"
  All IPersons are members of this group
  IMPORTANT: The All Users group is REQUIRED for uPortal to function. It Must be a member of the PAGS Root group
-->
  <pags-group>
    <name>All Users (PAGS)</name>
    <description>All Portal Users</description>
    <members>
      <member-key>All Staff (PAGS)</member-key>
    <members>
    <selection-test>
      <test-group>
        <name></name>
        <description></description>
        <test>
          <name></name>
          <description></description>
          <attribute-name></attribute-name>
          <tester-class>org.jasig.portal.groups.pags.testers.AlwaysTrueTester</tester-class>
          <test-value></test-value>
        </test>
      </test-group>
    </selection-test>
  </pags-group>

<!-- ********** Here's our new "All Staff" group we are declaring *********** -->
  <pags-group>
    <name>All Staff (PAGS)</name>
    <description>All Staff Users</description>
    <selection-test>
      <test-group>
        <test>
          <name></name>
          <description></description> <attributedescription>
          <attribute-name>eduPersonAffiliation</attribute-name>
          <tester-class>org.jasig.portal.groups.pags.testers.StringEqualsTester</tester-class>
          <test-value>staff</test-value>
        </test>
      </test-group>
    </selection-test>
  </pags-group>

...

<!-- End Group declarations: -->
</pags-store>

...

Code Block
xml
xml
<!-- Example Group Declarations --> 
<?xml version="1.0"?>
<!DOCTYPE Group-Store PUBLIC "-//uPortal//PAGSGroupStore/EN" "PAGSGroupStore.dtd">
<Group-Store>
<!-- Group 
<pags-store xmlns="https://source.jasig.org/schemas/uportal/io/pags">
  <name>Default</name>
  <description>Default Person Attribute Group Store</description>

<!-- Group declarations: -->

<!--
   Group pags_root: "PAGS Root"
   IMPORTANT: The PAGS Root group is REQUIRED for uPortal to function. It Must be a member of the Everyone group in the
   local group store
-->
   <pags-group>
<group>     <group-key>pags_root</group-key>     <group-name>PAGS<name>PAGS Root</group-name>
    <group-description>Root    <description>Root group for all PAGS groups.   Convenience for adding PAGS groups to a local group.</group-description>
     <members>       <member-key>all_users< <members>
      <member-key>All Users (PAGS)</member-key>
    </members>   </group>   <!--
  Group all_users: "All Users (PAGS)"
  All IPersons are members of this group
  IMPORTANT: The All Users group is REQUIRED for uPortal to function. It Must be a member of the PAGS Root group
-->
  <group>
    <group-key>all_users</group-key>
    <group-name>All Users (PAGS)</group-name>
    <group-description>All Portal Users</group-description>
    <selection-test>
      <test-group>
        <test>
         <member-key>Authenticated Users</member-key>
      <member-key>Desktop Device Access</member-key>
      <member-key>Mobile Device Access</member-key>
      <member-key>Respondr Theme Users</member-key>
    </members>
  </pags-group>

<!--
  Group all_users: "All Users (PAGS)"
  All IPersons are members of this group
  IMPORTANT: The All Users group is REQUIRED for uPortal to function. It Must be a member of the PAGS Root group
-->
  <pags-group>
    <name>All Users (PAGS)</name>
    <description>All Portal Users</description>
    <members>
      <member-key>All Staff (PAGS)</member-key>
    <members>
    <selection-test>
      <test-group>
        <name></name>
        <description></description>
        <test>
          <name></name>
          <description></description>
          <attribute-name></attribute-name>
         
          <tester-class>org.jasig.portal.groups.pags.testers.AlwaysTrueTester</tester-class>
         
          <test-value></test-value>
       
        </test>
           </test-group>
       </selection-test>
  </pags-group>

<!-- Don't forget to define your new sub-group using the members directive if you want the group to be a sub-group of "All Users" -->  ********** Here's our new "All Staff" group we are declaring *********** -->
  <pags-group>
    <members>     <name>All Staff (PAGS)</name>
    <member-key>all_staff</member-key>
    </members>
  </group>

<group>
<group-key>all_staff</group-key><description>All Staff Users</description>
    <!--
     <group-name>All Staff (PAGS)</group-name>  If you  <group-description>All Staff Users</group-description>
    <selection-test>
  want to declare a group within another, you must include the <members> directive.
   <test-group>      In other words, <test>the "ITS Dept" below is a subgroup of the   <attribute-name>eduPersonAffiliation</attribute-name>
    "All Staff" group as indicated in the example
     <tester-class>org.jasig.portal.groups.pags.testers.StringEqualsTester</tester-class>->
    <members>
      <test-value>staff</test-value><member-key>ITS Dept (PAGS)</member-key>
    </members>
    </<selection-test>
      </test<test-group>
    </selection-test>
    <!--  <test>
       If  you want to<name></name>
declare a group within another, you must include the <members> directive.<description></description>
         In other words, the "ITS Dept" below is a subgroup of the "All Staff" group as indicated in the example <attribute-name>eduPersonAffiliation</attribute-name>
          <tester-class>org.jasig.portal.groups.pags.testers.StringEqualsTester</tester-class>
           <test-->value>staff</test-value>
        <members></test>
      <member-key>its<</membertest-key>group>
    </members>selection-test>
  </pags-group>

<group>  <group-key>its</group-key><pags-group>
    <group-name>ITS<name>ITS Dept (PAGS)</group-name>
    <group-description>All<description>All ITS department Users</group-description>
    <selection-test>
      <test-group>
        <test>
          <attribute-name>ou</attribute-name>
          <tester-class>org.jasig.portal.groups.pags.testers.StringEqualsTester</tester-class>
          <test-value>ITS</test-value>
        </test>
      </test-group>
    </selection-test>
  </pags-group>


...

<!-- End Group declarations: -->
</Grouppags-Store>store>


From the example above we have created a hierarchy of groups (below is a screen shot of the Groups Administration listing the new PAGS groups, ITS Dept (PAGS), from the declaration above).  

...