<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><span style="font-size: 14px;"><strong>In this guide we will cover:</strong></span></p><p><span style="font-size: 14px;"><strong>- Creating Contract Rules</strong></span></p><p><br></p><p><br></p><p><strong>Admin Guides:</strong></p><ul><li><a href="https://usehalo.com/halopsa/guides/1843/" target="_blank" rel="noopener noreferrer"><strong>Agreements (Contracts)</strong></a></li></ul><p><br></p><p><strong>Related Guides:</strong></p><ul><li><span style="font-size: 14px;"><a data-fr-linked="true" href="https://usehalo.com/halopsa/guides/1975/" id="isPasted" target="_blank" rel="noopener noreferrer"><strong>Creating an Agreement/Recurring Invoice for a customer</strong></a></span></li></ul><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;"><em><strong>Note: In Halo the terms 'contract' and 'agreement' are used interchangeably. </strong></em></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Contract rules are used to automatically assign a new user to an existing contract based on set criteria. Making new user onboarding easier as you do not need to manually assign them to a contract.</span></p><p><br></p><p><span style="font-size: 18px;"><strong>Creating Contract Rules<br></strong></span></p><p><span style="font-size: 14px;">To enable contract/agreement rules head to configuration > agreements, enable the setting highlighted in figure 1. </span></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNjMzVlMmJlLWFhZWMtNGRiNS05NTNiLTU3NzRiNmFhYTUzMSJ9.jT-ws5JeOxQ3o9pe5n8u-kHP2sMXYMnF3OBcbJk3W8A" class="fr-fic fr-fil fr-dib" width="796" style="width: 798px; height: 216.971px;" height="217"></span></p><p><span style="font-size: 10pt;"><strong>Fig 1. Use agreement rules setting.</strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Once enabled you will be able to set the match type, the options for this are as follows:</span></p><p><br></p><ul><li><span style="font-size: 14px; color: rgb(0, 0, 0);"><strong>Use the first matched rule in the list. Apply the user to an agreement that matches the outcome if possible</strong> - Only the first rule in the sequence will be checked, if a user meets the criteria for this rule the outcome will be applied, if the user does not meet the criteria for this rule no outcomes will be applied. </span></li><li><span style="font-size: 14px; color: rgb(0, 0, 0);"><strong>Match all possible rules. Apply the user the first agreement that matches the outcome if possible</strong> - All rules in the list will be checked in order of sequence until the user matches criteria. If a user matches criteria of a rule the outcome of this rule will be applied and rules will stop being checked. If the user does not match any criteria of the rules in the list no outcomes will be applied. </span></li></ul><p><span style="font-size: 14px; color: rgb(0, 0, 0);">The second match type 'Match all possible rules. Apply the user the first agreement that matches the outcome if possible' is used when you have created a set of rules to encompass all users/agreements and are importing users in minimal imports. The first match type is typically used when you would only like users to be automatically assigned to one agreement, any users who do not meet the criteria for this agreement will not be assigned to an agreement. You can toggle between the two match types for each user import you complete. </span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Now you can select 'Rule Outcomes', select 'new' to setup a new rule. </span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Here, give your rule a name and a sequence. If the setting 'User must be a member of the Customer of the Agreement' is enabled this will ensure users are only assigned to an agreement for the same customer i.e. a user under one customer cannot be assigned to an agreement under a different customer. </span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Now you will need to set rule criteria, this will determine if the user matches the rule. When adding criteria you will be able to set this based on various user fields and various field criteria, ie. equal to, not equal to, starts with etc.</span></p><p><br></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJhMTA0MTUyLTZkODEtNGNjNC1iZjEwLTg2ZDdlNTI2MDcyOCJ9.1-XoD8-s0zCsMHPdaQ659GgF3ENyR-Vvou9odIpPIsk" class="fr-fic fr-fil fr-dib" width="605" style="width: 607px; height: 414.797px;" height="415"></span></p><p><span style="font-size: 10pt;"><strong>Fig 2. User fields to set criteria against.</strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Once you have set criteria you will need to choose the rule outcome, this is the contract type that any users who match this rule will be assigned to. You can set the 'contract type' and 'agreement subtype' that the users will be assigned to. The contract type and agreement subtype can be set against a specific contract under the details pane.</span></p><p><br></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFhNDJjOGZlLWNkNjgtNDFiMS1iNjhkLWQxZDJjMTNiODEyOSJ9.mCTnZ3lfKjAUwybDxaGJ_fKBD0Nlf_bhXK-PWyi2Qw4" class="fr-fic fr-fil fr-dib" width="302" style="width: 304px; height: 624.712px;" height="625"></span></p><p><span style="font-size: 10pt;"><strong>Fig 3. Contract type and agreement subtype set against a contract.</strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Once the outcome is set choose if the users will be covered by the contract or not, the value of this user, and how long the users are covered by this contract. </span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">In the figure 4 example I have set up a rule that will assign any users who have the string 'Halo' in their email to a contract with a bronze package contract type and a managed agreement subtype. In my Halo the contract BP0002 has this type and subtype so new users will be assigned to this contract. </span></p><p><br></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA0ZWQzYmM5LTY1ZmItNDI0Zi1iNGIyLWVkYjFmMzIzNGUwNSJ9.O3h9CnsFCm77Ex38XGrNqxCYOqpXZsffM85SLzz8Am0" class="fr-fic fr-fil fr-dib" width="1222" style="width: 1224px; height: 666.358px;" height="666"></span><br></p><p><span style="font-size: 10pt;"><strong>Fig 4. Example rule.</strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">You will need to create a rule for each of the contracts that you would like users to be assigned to automatically. Once setup is complete each time you create a new user in your Halo they will be assigned to the correct contract automatically. </span></p>
