Versions Compared

Key

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

...

Unknown Attachment

    

Authentication Log

The Authentication Log cleanup event recurs weekly, is set to pending by default, and has a default retention value of 365 days. The retention value is set on the Manage Tenants form.

Manage TenantsImage Removedimage-20240812-190901.pngImage Added


Bulk Update History

The Bulk Update History cleanup event recurs weekly, is set to pending by default, and has a default retention value of 365 days. The retention value is set on the Manage Tenants form.


Imports

The Delete old Import Files and Imported Records event recurs every day to cleanup records. The retention value for the records is set on the Manage Import File Format form. If the retention value is set too soon it could limit PCR's ability to troubleshoot issues relating to that import format.

Manage Import File Format exampleImage Removed


Messages

The Messages cleanup event recurs weekly, is set to pending by default, and has a default retention value of 365 days. The retention value for this event is set on the Manage Tenant form. System Messages (BIll generation, Bulk updates, etc.) and Messages of Inactive Users are effected by this event. The PCR-360 messaging system allows Users to send and receive messages from other PCR-360 users, those messages are not deleted by this cleanup event.

Excerpt

PCR-360 is capable of generating large amounts of data. Proper data retention policies and clean up processes will help to keep PCR-360 running as optimal as possible. Retention values apply to the length of time data is preserved before being permanently deleted from the application, whereas Aging is how long Services (or other entities, potentially) retain their current data associations before being "cleaned" for reuse. As a last distinction, Retention and Aging are both separate from Archiving, which defines how long data remains in the "primary" tables.

Data Retention values define how long, in days, the records are kept. Zero indicates records are cleaned up immediately. A negative number is not allowed, but if left blank the event will not clean up any records. Data Retention Events will only clean up the oldest months worth of data per run until the data retention days threshold. This ensures the system is not bogged down when there is a backlog of records. To utilize this event effectively it is recommended to run weekly. Once caught up, it can be changed to monthly, although any performance gains would likely be negligible.

Please contact the helpdesk with questions, or for assistance setting up retention policies.


API Request Logs 
    
The API Request Logs Deleted event recurs daily to cleanup outstanding REST API Request Logs. The number of days the Log is Retained is set on the Manage API Keys form.

Status
title

Adding Email Accounts

...

Users can also add email accounts to the tenant. These accounts serve as the "From" and "To" addresses for the automated email capabilities built into the application. Click on the 'Email Accounts' tab and click the 'Add' button (see image above).

...

In the form (see image above), Admin users are prompted to define a number of required fields for the new email account. This email account specification defines how PCR-360 will send and receive emails. PCR-360 sends email notifications and alerts, and can also "read" incoming emails to a specified email account. For example, if the subject of an incoming email references a specific Service Desk number, the application will add the email to the SD item's Email Thread; if no SD number is specified, the application will create a new Service Desk Inquiry.

...

  1. Open a browser and navigate to the Azure Active Directory admin center.

  2. Login with an account capable of administrating Active Directory

  3. Select Azure Active Directory in the left-hand navigation, then select App registrations under Manage.

    A screenshot of the App registrations
  4. Select New registration. On the Register, an application page, set the values as follows.

    • Set Name to "PCR360 Production" (or "PCR360 Test" depending on the environment being set up).

    • Set Supported account types to Accounts in any organizational directory and personal Microsoft accounts.

    • Under Redirect URI, set the first drop-down to Web and set the value to

      • This must be altered to reflect the URL of the PCR-360 Application

      • Appending /core/oauth2/validated to the end of the URL is required

      • https://<pcr360.customerUrl.edu>/core/oauth2/validated

  5. Select Register. Copy the value of the Application (client) ID and save it, you will need it later.

  6. Select Certificates & secrets under Manage. Select the New client secret button. Enter a value in Description and select one of the options for Expires and select Add.

  7. Copy the client secret value before you leave this page. You will need it later.

    Important

    This client secret is never shown again, so make sure you copy it now.

    A screenshot of the newly added client secret
  8. Select API permissions in the side bar

    API Permissions ExampleImage RemovedAPI Permissions ExampleImage Added



  9. Add the permission as shown

  10. Click Add a permission and select Microsoft Graph

    Configuration Permissions ExampleImage RemovedConfiguration Permissions ExampleImage Added



  11. Select Delegated Permissions

    API Permissions exampleImage RemovedAPI Permissions exampleImage Added



  12. Select the Mail.Read and Mail.Send permissions

    Send Permission example
  13. Select the User.Read permission

    Read Permission example



  14. Click the Add permissions button to add the selected permissions

    Add Permissions example

...

  1. Select the appropriate Account Type. 

  2. MAKE SURE TO USE THE EMAIL ADDRESS YOU WANT PCR-360 TO USE
    Add New Tenant Email form exampleImage Removed

    image-20240812-190942.pngImage Added



  3. On the OAuth2 Configuration tab enter Application ID and Secret KEY copied down from the Registering an Application steps above.

  4. Also enter in the following values:

    1. Authentication Authority URL: https://login.microsoftonline.com/common for this example

    2. Authorization Endpoint: /oauth2/v2.0/authorize

    3. Token Request Endpoint: /oauth2/v2.0/token

    4. Scopes (groups, or permissions): openid profile offline_access user.read mail.read mail.send

      Manage Tenant Email ExampleImage RemovedManage Tenant Email ExampleImage Added
  5. Save the Email Address

  6. Click the "Click to Authenticate" button

  7. Follow the prompts to authorize PCR-360 with your Email.

  8. Once completed the portal will redirect back to the application with a success message.

  9. The button on the OAuth2 Configuration tab should now say "Click to RE Authenticate"
    Authentication ExampleImage Removed

    image-20240812-190956.pngImage Added



  10. The application is now configured to send (and/or receive) emails using the email address that was authenticated

...