Use custom metadata in policies and reports
AI summary
Custom Properties and Custom Relations appear in the Segment builder, Report filters, and Policy scopes once you create them. You can use them to filter and exclude objects from policies, group and total data in reports by custom fields, and automatically set values through automations.
Once a Custom PropertyCustom MetadataCustom Metadata is a Rencore Governance add-on that adds your own business fields to the inventory, such as cost centers or project codes.Read more or Custom Relation exists, it shows up as an operand anywhere a built-in propertyPropertyA property is one field of an inventory object, such as the URL of a site or the visibility of a Team.Read more does: in the Segment builderSegmentA segment is a saved, rule-based filter over inventory objects, for example every user whose country is the United States.Read more, in Report filters, and in Policy scopes. Use it to scope, group, and exclude by the fields you defined.
Before you begin
- Your Rencore role can create the Segment, Report, Policy or AutomationAutomationAn automation is a workflow Rencore Governance runs on inventory objects when a trigger fires.Read more you want to use the metadata in. Owner, Admin and Contributor can. See Rencore roles.
- Custom Metadata is included in the Enterprise PlanPlanA Plan is the edition of Rencore Governance in your Subscription: Professional, Premium or Enterprise.Read more and available as an add-on to the Premium Plan.
- The Custom Property or Custom Relation exists. See Create a custom property.
Steps
Filter by custom metadata
- Open the Segment builder, a Report filter or a Policy scope.
- Select the Custom Property or Custom Relation as the operand, the same way you select a built-in property.
- Choose an operator. The operators offered match the property’s data type, for example equals and is empty for Text, before and after for Date.
Group and total in a report
- Relate each object to the instance you want to total by, for example each Team to a Cost Center Custom Object.
- In the Report, group by that Custom Relation or by a Custom Property, the same way you group by a built-in field.
For example, this totals storage or license costLicense cost and currencyLicense cost and currency are the values Rencore Governance uses to show Microsoft 365 license costs in the inventory, reports and policies.Read more per cost center.
Exclude objects from a policy
- Add a Yes-No Custom Property, for example Do not touch.
- Set it to Yes on the objects you want to protect.
- Add a condition to the Policy or Segment scope that excludes objects where that property equals Yes.
Objects matching the exclusion produce no violations and trigger no Automation for that Policy.
Set a value from an automation
- In an Automation, add the Set a custom property value action.
- Choose the Custom Property and the value. The action sets it on the object that triggered the Automation.
Use it to keep metadata current without a manual edit, for example marking a workspace after it passes a Review.
Frequently asked questions
Where can I use a custom property or custom relation as a filter?
You can use it as an operand in the Segment builder, in Report filters, and in Policy scopes. You select it the same way you select a built-in property.
How do I total storage or license cost per cost center in a report?
Relate each object to the instance you want to total by, for example each Team to a Cost Center Custom Object. Then group the Report by that Custom Relation or by a Custom Property, the same way you group by a built-in field.
How can I exclude certain objects from a policy?
Add a Yes-No Custom Property, for example Do not touch, and set it to Yes on the objects you want to protect. Then add a condition to the Policy or Segment scope that excludes objects where that property equals Yes.
What happens to objects that match a policy exclusion?
Objects matching the exclusion produce no violations and trigger no Automation for that Policy.
Can an automation set a custom property value?
Yes. Add the Set a custom property value action to the Automation, then choose the Custom Property and the value. The action sets the value on the object that triggered the Automation.
Was this page helpful?
Thanks for the feedback.
Thanks. What was wrong?