LogoLogo
Maica's Homepage
Admin Guide
Admin Guide
  • Welcome to Maica Administration
  • Getting Started
    • Check your Salesforce Hosting
    • Licence Agreement
    • The Maica Release Process
    • Find your Maica Edition
    • The Implementation Process
  • Data
    • Data Objects
      • Agreement Item
      • Appointment
      • Availability
      • Booking Item
      • Checklist
      • Client Note
      • Connection
      • Contact
      • Delivery Activity
      • Funding
      • Funding Item
      • Invoice
      • Invoice Line Item
      • Location
      • Log
      • Payment Request
      • Preference
      • Price List
      • Price List Entry
      • Resource
      • Resource Participant
      • Service Agreement
      • Service Agreement Leave
      • Service Agreement Statement
      • Service Booking
      • Shift
      • Support Category
      • Support Item
      • Timesheet
      • Timesheet Entry
      • Unavailability
    • Permission Sets
    • Reference Data
      • Reference Data Template
      • Import Template
    • Data Import Utility
      • NDIS Support Catalogue
      • Data Import Flows
  • System Processes
    • Billing Invoice Generation
    • Timesheet Generation
    • Recurring Schedules
    • Travel Claiming and Expenses
    • Public Holiday Configuration
    • Configuring Maica Components
      • Appointment Services
      • Support Items
      • Support Categories
      • Overnight and 24 Hour Availability
  • Enable Maica Actions
  • Scheduled Jobs
  • Maica Timezone Management
  • Integrations
    • Create a Site
    • Xero Integration
      • Support Item Configuration
    • Stripe Integration
    • NDIS Notifications
  • Settings
    • Renewal Management
    • Claim Management
      • NDIS
        • Handle BPR Results & Remittance Files
        • BPR File Import Flows
      • Aged Care
    • Invoice Management
    • Support Item Management
    • Integration Management
      • NDIS Integration
      • Stripe Integration
      • Xero Integration
    • Connections Management
      • General Settings
      • Reciprocal Settings
    • General Settings
    • Planner Management
    • Rostering Management
    • Service Management
    • Timesheet Management
    • Validation Management
    • Travel Management
    • Billing Management
    • Maps Management
    • Participant Notes
Powered by GitBook

Further Maica Resources

  • Homepage
  • Features
  • FAQs
On this page
  • Fields & Relationships
  • Validation Rules
  • End Date Must Not Be Before Start Date
  • Required Resource Attributes when Resource type is Resource
  • Weekly Hours Minimum Must Be Less Than Weekly Hours Limit
  • Related User Required when Resource Type equals Resource
  • Automation
  • Flows
  • Resource Geocoding
  • Trigger Handlers
  • Resource Deactivation
  • Resource Geocoding

Was this helpful?

Export as PDF
  1. Data
  2. Data Objects

Resource

The Resource object in Maica is used to manage the details of your Service Delivery Staff, i.e. Care Workers or Coordinators.

PreviousPrice List EntryNextResource Participant

Last updated 9 months ago

Was this helpful?

Fields & Relationships

The table below provides a comprehensive overview of all fields and relationships for the Resource object in Maica. Please refer to the table below for detailed information.

Validation Rules

The list below outlines the Validation Rules applied to the Resource Object in Maica.

Please refer to the list below for more detailed information on each Validation Rule.

End Date Must Not Be Before Start Date

Ensures that the End Date cannot be before the Start Date.

Validation Rule Detail

Rule Name

VAL_RESOURCE_0001

Error Message

VAL_0001: The End Date cannot be before the Start Date.

Error Location

Top of Page

Error Condition Formula
AND(
    NOT(ISBLANK(maica_cc__Start_Date__c)),
    NOT(ISBLANK(maica_cc__End_Date__c)),
    maica_cc__Start_Date__c > maica_cc__End_Date__c
)

Required Resource Attributes when Resource type is Resource

This validation rule ensures key Resource attributes are populated when the Resource Type is Resource. These attributes are:

  • Employment Type

  • Weekly Hours Limit

  • Daily Hours Limit

  • Weekly Hours Minimum

Validation Rule Detail

Rule Name

VAL_RESOURCE_0002

Error Message

VAL_0002: When the Resource Type is Resource, the following fields are required: Employment Type, Weekly Hours Limit, Daily Hours Limit, Weekly Hours Minimum.

Error Location

Top of Page

Error Condition Formula
AND(
ISPICKVAL(maica_cc__Resource_Type__c, "Resource"),
OR(
ISPICKVAL(maica_cc__Employment_Type__c, ""),
ISBLANK(maica_cc__Weekly_Hours_Limit__c),
ISBLANK(maica_cc__Weekly_Hours_Minimum__c),
ISBLANK(maica_cc__Daily_Hours_Limit__c)
)
)

Weekly Hours Minimum Must Be Less Than Weekly Hours Limit

Ensures that the Weekly Hours Minimum is less than the Weekly Hours Limit.

Validation Rule Detail

Rule Name

VAL_RESOURCE_0003

Error Message

VAL_0003: Weekly Hours Minimum must be less than Weekly Hours Limit.

Error Location

Weekly Hours Minimum

Error Condition Formula
AND(
    NOT(ISNULL(maica_cc__Weekly_Hours_Minimum__c)),
    NOT(ISNULL(maica_cc__Weekly_Hours_Limit__c)),
    maica_cc__Weekly_Hours_Minimum__c >= maica_cc__Weekly_Hours_Limit__c
)

Related User Required when Resource Type equals Resource

Ensures the User lookup is populated when Resource Type = Resource.

Validation Rule Detail

Rule Name

VAL_RESOURCE_0004

Error Message

VAL_0004: A related User is required when Resource Type = Resource.

Error Location

User

Error Condition Formula
AND(
    ISPICKVAL(maica_cc__Resource_Type__c, "Resource"),
    ISBLANK(maica_cc__User__c)
)

Automation

Flows

The list below outlines the Flows applied to the Resource Object in Maica.

Please refer to the list below for more detailed information on each Flow.

Resource Geocoding

This Salesforce Autolaunched Flow is designed to geocode addresses for resources, updating their latitude and longitude based on the provided address information.

Flow Detail

Flow Label

Maica - Resource Geocoding

API Name

maica__Maica_Resource_Geocoding

Type

Autolaunched Flow

Flow Summary

This flow facilitates the geocoding of resource addresses by:

  • Detecting changes to resource records and ensuring address fields are populated.

  • Calling an Apex action to geocode the address.

  • Updating the resource record with the geocoded latitude and longitude.

Flow Description
  1. Start (Record-Triggered Flow):

    • The flow is initiated upon the creation or update of a resource record.

    • Checks if the latitude and longitude are set to 0.0 and ensures that the address fields (City, Street, State, and Postal Code) are not null.

    • Proceeds to geocode the address asynchronously after the record is saved.

  2. Geocode the Address (Apex Action):

    • Calls the GeocodeAddressInvocableProc Apex action to geocode the address.

    • Passes the address fields and the record ID as input parameters.

    • Captures the latitude and longitude from the geocoding result.

    • Proceeds to the Error decision.

  3. Error? (Decision):

    • Checks if there is an error message from the geocoding process.

    • If no error, proceeds to update the resource record with the geocoded latitude and longitude.

    • If an error is detected, the flow ends.

  4. Update Resource (Update Records):

    • Updates the resource record with the latitude and longitude from the geocoding result.

    • Ends the flow.

Trigger Handlers

The list below outlines the Trigger Handlers applied to the Resources Object in Maica.

Please refer to the list below for more detailed information on each Trigger Handler.

Resource Deactivation

This trigger is designed to manage the deactivation of resources in Maica.

Detail

Load Order

1

Label

ResourceDeactivation_MDTM

Execution, Logic & Outcome

Trigger Execution

The trigger logic defined in the ResourceDeactivation_MDTM class is executed when the trigger conditions are met.

  • Trigger Conditions:

    • When a new resource (maica__Resource__c) is created.

    • When an existing resource is updated.

    • Any specific field changes that are monitored by the trigger (defined in the handler class).

Logic Explanation

  1. Initialisation:

    • When a resource record is created or updated, the trigger is initialised. The ResourceDeactivation_MDTM metadata type configuration is loaded, ensuring that the trigger is active (Active__c is true) and has the correct load order (Load_Order__c is 1.0).

  2. Trigger Execution:

    • Upon initialisation, the trigger executes the logic defined in the ResourceDeactivation_MDTM class.

    • The class methods perform the following steps:

      • Validation: The resource status and related data are validated to ensure they meet the criteria required for deactivation.

      • Deactivation: The deactivation process is applied based on predefined criteria such as resource status and utilisation.

      • Update: Related records are updated, and relevant stakeholders are notified if necessary.

Trigger Outcome:

Once executed, the trigger ensures that each resource is deactivated correctly, based on the logic defined in the handler class. This helps maintain data integrity and operational efficiency.

Resource Geocoding

This trigger is designed to manage the geocoding of resources in Maica.

Detail

Load Order

2

Label

ResourceGeocode_MDTM

Execution, Logic & Outcome

Trigger Execution

The trigger logic defined in the ResourceGeocode_MDTM class is executed when the trigger conditions are met. The class contains the code that manages the geocoding process for resources.

  • Trigger Conditions:

    • When a new resource (maica__Resource__c) is created.

    • When an existing resource is updated.

    • Any specific field changes that are monitored by the trigger (defined in the handler class).

Logic Explanation

  1. Initialisation:

    • When a resource record is created or updated, the trigger is initialised. The ResourceGeocode_MDTM metadata type configuration is loaded, ensuring that the trigger is active (Active__c is true) and has the correct load order (Load_Order__c is 2.0).

  2. Trigger Execution:

    • Upon initialisation, the trigger executes the logic defined in the ResourceGeocode_MDTM class.

    • The class methods perform the following steps:

      • Validation: The resource address data is validated to ensure it is complete and accurate.

      • Geocoding: The validated address data is converted into geographical coordinates using geocoding services.

      • Update: The resource record is updated with the newly obtained geographical coordinates.

Trigger Outcome:

Once executed, the trigger ensures that each resource is geocoded correctly, based on the logic defined in the handler class. This helps maintain accurate geographical data for resources.

Click to view and download the complete Resource Schema.

here
Resource Schema