[Rt-commit] rt branch, 4.4/custom-roles-initialdata-doc, created. rt-4.4.1-247-g58bc36f

[Jim Brandt]

The branch, 4.4/custom-roles-initialdata-doc has been created
        at  58bc36f0854114011d445001b22d76a36875807b (commit)

- Log -----------------------------------------------------------------
commit 58bc36f0854114011d445001b22d76a36875807b
Author: Jim Brandt <jbrandt at bestpractical.com>
Date:   Thu Jan 12 10:21:21 2017 -0500

    Add initialdata docs for CustomRoles

diff --git a/docs/initialdata.pod b/docs/initialdata.pod
index 36cd34d..2ef3b9a 100644
--- a/docs/initialdata.pod
+++ b/docs/initialdata.pod
@@ -100,6 +100,17 @@ It also accepts an C<Attributes> key, which is equivalent to pushing its
 arrayref of values onto C<@Attributes>, below, with C<Object> set to the
 new group.
 
+=head2 C<@CustomRoles>
+
+    push @CustomRoles, {
+        Name        => 'Support Rep',
+        Description => 'Support representative assigned for this ticket',
+    };
+
+Creates a new L<RT::CustomRole> for each hashref. The above example will create the
+role globally. To apply the role to only a specific queue, use the C<ApplyTo> entry
+as described in L</@CustomFields> below.
+
 =head2 C<@Queues>
 
     push @Queues, {
@@ -340,6 +351,17 @@ user defined group, or user you want to grant the right B<to>.
       Queue     => 'Name',
       GroupType => 'Requestor, Owner, AdminCc, or Cc',
 
+=item A system-level custom role
+
+    GroupDomain => 'RT::System-Role',
+    CustomRole  => 'Supervisor',
+
+=item A queue-level custom role
+
+    Queue       => 'Customer Support',
+    GroupDomain => 'RT::Queue-Role',
+    CustomRole  => 'Customer',
+
 =item A group you created
 
     GroupDomain => 'UserDefined',

-----------------------------------------------------------------------