Get all business rule definitions

get

/fscmRestApi/resources/11.13.18.05/businessRuleDefinitions

Request

Query Parameters
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • Used as a predefined finder to search the collection.

    Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables

    • AltKey Finds all the rule definitions that match the alternate key criteria specified.
      Finder Variables
      • RuleCode; string; Unique code for the rule definition.
    • CallRuleFinder Finds all the published and latest draft rules that can be called from another rule. The calling rule isn't included in this finder results.
      Finder Variables
      • CategoryId; integer; Category unique identifier. This is used to find all rules which belong to the passed category and its subcategories.
      • ExcludeRuleCode; string; Rule code which has to be excluded from the results.
      • Keyword; string; Keyword; string; to search in rule name, rule description and rule code.
    • CodeFinder Finds all the rules that match with the specified rule code.
      Finder Variables
      • CategoryId; integer; Category unique identifier. This is used to find all rules which belong to the passed category.
      • Code; string; Rule definition unique code. This is used to find all rules where code matches the passed value.
      • DataContractId; integer; Data contract unique identifier. This is used to find all rules which use the passed data contract.
      • LogicLevel; string; Logic level code. This is used to find all the rules which are of the passed logic level.
      • RuleType; string; Rule type code.
      • Status; string; Rule status code.
    • ConsumerRuleFinder Finds all the published and latest draft rule versions that can be called by rules consumers. The user can pass none, one or more categories.
      Finder Variables
      • CategoryCodeOrId; string; Category unique code or identifier. This is used to find all rules which belong to the passed category.
      • Keyword; string; Keyword; string; to search in rule name, rule description and rule code.
      • TemplateCodes; string; Template rule codes. This is used to find all rules which belong to the passed comma separated list of template rule codes.
    • KeywordFinder Finds all the rules that match with the specified keyword in rule name, rule code and rule description.
      Finder Variables
      • Keyword; string; Keyword; string; to search in rule name, rule description and rule code.
      • RuleType; string; Rule type code.
      • Status; string; Rule status code.
    • PrimaryKey Finds all the rule definitions that match the primary key criteria specified.
      Finder Variables
      • RuleId; integer; Unique identifier for the rule definition.
    • SubruleFinder Finds all the rules that are used as subrules.
      Finder Variables
      • TemplateFinder Finds all the published templates that can be used by rules, belong to the passed category and logic level.
        Finder Variables
        • CategoryId; integer; Category unique identifier. This is used to find all templates which belongs to the passed category.
        • LogicLevel; string; Logic level code. This is used to find all the templates which are of the passed logic level.
    • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
    • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

      Example:
      self,canonical
    • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
    • The resource item payload will be filtered in order to contain only data (no links section, for example).
    • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
    • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

      Format: ?q=expression1;expression2

      You can use these queryable attributes to filter this collection resource using the q query parameter:
      • ArtifactGroupCode; string; The data group unique code, such as ACADSTRUCTUREPROFILE.
      • ArtifactGroupId; integer; The unique identifier for the data group associated with this rule.
      • ArtifactGroupName; string; The name of the data group.
      • CalledBySeedOnlyFlag; boolean; Indicates whether the rule can only be called by other predefined rules. The default value is N.
      • CategoryCode; string; The category unique code.
      • CategoryId; integer; The category to which this rule belongs to.
      • CategoryName; string; The name of the category.
      • ContractTypeMeaning; string; The meaning of the contract type code, for example, a data contract, data fetch or rule variables. A list of accepted values is defined in the lookup type ORA_HEY_RULE_DATA_OPTION. The default value is Data contract.
      • CurrentVersionNumber; integer; The current version of the rule.
      • Description; string; The description of a rule definition.
      • LastUpdateDate; string; The date and time when the rule was updated.
      • LastUpdatedBy; string; The person who updated the rule.
      • LogicLevelCode; string; The logic level of the rule definition, for example, simple logic or complex logic. A list of accepted values is defined in the lookup type ORA_HEY_LOGIC_LEVEL_CODE. The default value is ORA_HEY_SIMPLE_LOGIC.
      • LogicLevelMeaning; string; The meaning of the logic level code. A list of accepted values is defined in the lookup type ORA_HEY_LOGIC_LEVEL_CODE. The default value is Simple logic.
      • ProcessName; string; The concatenated list of transactions mapped to the rule data contract.
      • RuleCode; string; The rule definition unique code, such as ADMEVAL1.
      • RuleContractOptionCode; string; The type of the contract, for example, a data contract, data fetch or rule variables. A list of accepted values is defined in the lookup type ORA_HEY_RULE_DATA_OPTION. The default value is ORA_HEY_FROM_CONTRACT.
      • RuleId; integer; The unique identifier of a rule definition.
      • RuleName; string; The name of a rule definition.
      • RuleStatusCode; string; The status of the current rule version, for example, published, unpublished or draft. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS.
      • RuleStatusMeaning; string; The meaning of the current rule version status code. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS.
      • RuleTypeCode; string; The type of the rule definition, for example, rule or template. A list of accepted values is defined in the lookup type ORA_HEY_RULE_TYPE_CODE. The default value is ORA_HEY _RULE.
      • RuleTypeMeaning; string; The meaning of the rule type code. A list of accepted values is defined in the lookup type ORA_HEY_RULE_TYPE_CODE. The default value is Rule.
      • SeedDataLock; integer; Indicates whether the record is predefined. The value 0 means the record isn't predefined. The value 1 means the record is predefined and can't be updated. A value greater than 1 means the record is predefined but can be updated. The default value is 0.
      • TemplateRuleCode; string; Template rule unique code.
      • TemplateRuleId; integer; The unique usage reference identifier that identifies the template mapped to the rule.
      • WorkingRuleVersionId; integer; The unique identifier of the rule version which is being worked upon and not yet published.
      • WorkingVersionNumber; integer; The version of the rule which is being worked upon and not yet published.
    • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
    Header Parameters
    • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
    • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

    There's no request body for this operation.

    Back to Top

    Response

    Supported Media Types

    Default Response

    The following table describes the default response for this task.
    Headers
    • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
    • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
    Body ()
    Root Schema : businessRuleDefinitions
    Type: object
    Show Source
    Nested Schema : Items
    Type: array
    Title: Items
    The items in the collection.
    Show Source
    Nested Schema : businessRuleDefinitions-item-response
    Type: object
    Show Source
    • Title: Data Group Code
      Read Only: true
      Maximum Length: 50
      The data group unique code, such as ACADSTRUCTUREPROFILE.
    • Title: Data Group ID
      Read Only: true
      The unique identifier for the data group associated with this rule.
    • Title: Data Group Name
      Read Only: true
      Maximum Length: 50
      The name of the data group.
    • Title: Exclusive to Predefined Rules
      Read Only: true
      Maximum Length: 1
      Default Value: false
      Indicates whether the rule can only be called by other predefined rules. The default value is N.
    • Title: Category Code
      Read Only: true
      Maximum Length: 30
      The category unique code.
    • Title: Category ID
      The category to which this rule belongs to.
    • Title: Category Name
      Maximum Length: 50
      The name of the category.
    • Title: Contract Type
      Read Only: true
      Maximum Length: 80
      The meaning of the contract type code, for example, a data contract, data fetch or rule variables. A list of accepted values is defined in the lookup type ORA_HEY_RULE_DATA_OPTION. The default value is Data contract.
    • Title: Current Version
      The current version of the rule.
    • Title: Description
      Maximum Length: 240
      The description of a rule definition.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the rule was updated.
    • Title: Last Updated By
      Read Only: true
      Maximum Length: 64
      The person who updated the rule.
    • Links
    • Title: Logic Level Code
      Maximum Length: 30
      Default Value: ORA_HEY_MODERATE_LOGIC
      The logic level of the rule definition, for example, simple logic or complex logic. A list of accepted values is defined in the lookup type ORA_HEY_LOGIC_LEVEL_CODE. The default value is ORA_HEY_SIMPLE_LOGIC.
    • Title: Logic Level
      Read Only: true
      Maximum Length: 80
      The meaning of the logic level code. A list of accepted values is defined in the lookup type ORA_HEY_LOGIC_LEVEL_CODE. The default value is Simple logic.
    • Title: Process Names
      Read Only: true
      The concatenated list of transactions mapped to the rule data contract.
    • Title: Code
      Maximum Length: 50
      The rule definition unique code, such as ADMEVAL1.
    • Title: Contract Type Code
      Read Only: true
      Maximum Length: 30
      Default Value: ORA_HEY_FROM_CONTRACT
      The type of the contract, for example, a data contract, data fetch or rule variables. A list of accepted values is defined in the lookup type ORA_HEY_RULE_DATA_OPTION. The default value is ORA_HEY_FROM_CONTRACT.
    • Title: Rule ID
      Read Only: true
      The unique identifier of a rule definition.
    • Title: Rule Name
      Maximum Length: 50
      The name of a rule definition.
    • Title: Status Code
      Read Only: true
      Maximum Length: 30
      The status of the current rule version, for example, published, unpublished or draft. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS.
    • Title: Status
      Read Only: true
      Maximum Length: 80
      The meaning of the current rule version status code. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS.
    • Rule Tag Assignments
      Title: Rule Tag Assignments
      Rule tag assignments represent tags assigned to rules. For example, a tuition fee tag and an admissions application fee tag can be assigned to rules.
    • Rule Test Cases
      Title: Rule Test Cases
      The resource is used to view, create, modify or delete rule test cases.
    • Title: Rule Type Code
      Maximum Length: 30
      Default Value: ORA_HEY_RULE
      The type of the rule definition, for example, rule or template. A list of accepted values is defined in the lookup type ORA_HEY_RULE_TYPE_CODE. The default value is ORA_HEY _RULE.
    • Title: Rule Type
      Read Only: true
      Maximum Length: 80
      The meaning of the rule type code. A list of accepted values is defined in the lookup type ORA_HEY_RULE_TYPE_CODE. The default value is Rule.
    • Rule Versions
      Title: Rule Versions
      The resource is used to view, create, modify, or delete rule versions.
    • Title: Predefined Data
      Default Value: 0
      Indicates whether the record is predefined. The value 0 means the record isn't predefined. The value 1 means the record is predefined and can't be updated. A value greater than 1 means the record is predefined but can be updated. The default value is 0.
    • Title: Base Template Code
      Read Only: true
      Maximum Length: 50
      Template rule unique code.
    • Title: Base Template ID
      Read Only: true
      The unique usage reference identifier that identifies the template mapped to the rule.
    • Title: Working Rule Version ID
      Read Only: true
      The unique identifier of the rule version which is being worked upon and not yet published.
    • Title: Working Rule Version Number
      Read Only: true
      Default Value: 1
      The version of the rule which is being worked upon and not yet published.
    Nested Schema : Rule Tag Assignments
    Type: array
    Title: Rule Tag Assignments
    Rule tag assignments represent tags assigned to rules. For example, a tuition fee tag and an admissions application fee tag can be assigned to rules.
    Show Source
    Nested Schema : Rule Test Cases
    Type: array
    Title: Rule Test Cases
    The resource is used to view, create, modify or delete rule test cases.
    Show Source
    Nested Schema : Rule Versions
    Type: array
    Title: Rule Versions
    The resource is used to view, create, modify, or delete rule versions.
    Show Source
    Nested Schema : businessRuleDefinitions-ruleTagAssignments-item-response
    Type: object
    Show Source
    Nested Schema : businessRuleDefinitions-ruleTestcases-item-response
    Type: object
    Show Source
    Nested Schema : Rule Test Case Runs
    Type: array
    Title: Rule Test Case Runs
    The resource is used to view, create, modify or delete rule version test case run details.
    Show Source
    Nested Schema : businessRuleDefinitions-ruleTestcases-ruleTestcaseRuns-item-response
    Type: object
    Show Source
    Nested Schema : businessRuleDefinitions-ruleVersions-item-response
    Type: object
    Show Source
    • Title: Data Group Code
      Read Only: true
      Maximum Length: 50
      The data group unique code, such as ACADSTRUCTUREPROFILE.
    • Title: Data Group ID
      The unique identifier for a data group.
    • Title: Data Group Name
      Maximum Length: 50
      The name of a data group.
    • Title: Rule Basis
      Read Only: true
      Maximum Length: 80
      The meaning of the base option code, for example, a blank rule or a template. A list of accepted values is defined in the lookup type ORA_HEY_RULE_BASIS_CODE. The default value is blank rule.
    • Title: Comments
      Maximum Length: 900
      The comments entered when creating a new rule version.
    • Title: Contract Type
      Read Only: true
      Maximum Length: 80
      The meaning of the contract type code, for example, a data contract, data fetch or rule variables. A list of accepted values is defined in the lookup type ORA_HEY_RULE_DATA_OPTION. The default value is Data contract.
    • Title: Creation Date
      Read Only: true
      The date and time when the rule version was created.
    • Title: Last Updated Date
      Read Only: true
      The date and time when the rule version was updated.
    • Title: Last Updated By
      Read Only: true
      Maximum Length: 64
      The person who updated the rule version.
    • Links
    • Title: Rule Basis Code
      Maximum Length: 30
      Default Value: ORA_HEY_BLANK_RULE
      The base option code indicates if the rule is created from a template or from a blank rule. A list of accepted values is defined in the lookup type ORA_HEY_RULE_BASIS_CODE. The default value is ORA_HEY_BLANK_RULE.
    • Title: Build Date and Time
      The timestamp when the rule was last compiled.
    • Title: Contract Type Code
      Maximum Length: 30
      Default Value: ORA_HEY_FROM_CONTRACT
      The contract type code, for example, a data contract, data fetch or rule variables. A list of accepted values is defined in the lookup type ORA_HEY_RULE_DATA_OPTION. The default value is ORA_HEY_FROM_CONTRACT.
    • Rule Expressions
      Title: Rule Expressions
      The resource is used to view rule expressions.
    • Title: Rule Definition
      The rule configuration content. This is in a JSON format.
    • Title: Status Code
      Maximum Length: 30
      The status of the current rule version, for example, published, unpublished or draft. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS.
    • Rule Variables
      Title: Rule Variables
      The resource is used to view, create, modify, or delete rule variables.
    • Title: Rule Version ID
      The unique identifier of the rule version.
    • Title: Status
      Read Only: true
      Maximum Length: 80
      The meaning of the current rule version status code. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS.
    • Title: Base Template Code
      Read Only: true
      Maximum Length: 50
      The template definition unique code, such as ADMEVAL1.
    • Title: Base Template ID
      The unique identifier of the template definition.
    • Title: Base Template Name
      Maximum Length: 50
      The name of the template definition.
    • Title: Version Description
      Maximum Length: 240
      The description of the rule definition version.
    • Title: Version Name
      Maximum Length: 50
      The name of the rule definition version.
    • Title: Version Number
      Default Value: 1
      The version number of the rule.
    Nested Schema : Rule Expressions
    Type: array
    Title: Rule Expressions
    The resource is used to view rule expressions.
    Show Source
    Nested Schema : Rule Variables
    Type: array
    Title: Rule Variables
    The resource is used to view, create, modify, or delete rule variables.
    Show Source
    Nested Schema : businessRuleDefinitions-ruleVersions-ruleExpressions-item-response
    Type: object
    Show Source
    Nested Schema : businessRuleDefinitions-ruleVersions-ruleVariables-item-response
    Type: object
    Show Source
    • Title: Code
      Read Only: true
      Maximum Length: 50
      The unique code of the list of values data artifact resource.
    • Title: Name
      Read Only: true
      Maximum Length: 50
      The name of the list of values data artifact resource.
    • Title: Attribute Code
      Maximum Length: 200
      The rule variable attribute unique code, such as STUDENT_GRADE.
    • Title: Attribute Alias
      Maximum Length: 500
      The alias name of the rule variable attribute.
    • Title: Data Type Code
      Maximum Length: 30
      The rule variable attribute data type code, for example, a string, number or date. A list of accepted values is defined in the lookup type ORA_HEY_ATTRIBUTE_TYPE.
    • Title: Attribute Name
      Maximum Length: 50
      The name of a rule variable attribute.
    • Title: Attribute Sequence Number
      Default Value: 1
      The sequence of the attribute in the variable.
    • Title: Data Type
      Read Only: true
      Maximum Length: 80
      The meaning of the rule variable attribute data type code, for example, a string, number or date. A list of accepted values is defined in the lookup type ORA_HEY_ATTRIBUTE_TYPE.
    • Title: Default Value
      Maximum Length: 512
      The default value of a rule variable attribute.
    • Title: Default Value JSON Format
      Default value of the attribute in JSON format. Used by list or multicolumn list variables.
    • Title: Description
      Maximum Length: 240
      The description of a rule variable.
    • Title: Variable Value Usage
      Read Only: true
      Maximum Length: 80
      The meaning of the variable value usage code, for example, the code meaning indicates whether the value is received, provided or both received and provided. A list of accepted values is defined in the lookup type ORA_HEY_VARIABLE_USAGE.
    • Title: Variable Value Usage Code
      Maximum Length: 30
      The code to indicate how the value of rule variable is used, for example, the code indicates whether the value is received, provided or both received and provided. A list of accepted values is defined in the lookup type ORA_HEY_VARIABLE_USAGE.
    • Title: Internal Variable Code
      Maximum Length: 200
      The internally generated code for the variable, such as UNIT_GRADE.
    • Links
    • Title: List of Values Lookup Type
      Maximum Length: 30
      The list of values lookup type of a rule variable attribute.
    • Title: List of Values ID
      The list of values data artifact resource ID of a rule variable attribute.
    • Title: List of Values Display Fields
      Maximum Length: 900
      The comma separated display field names of the list of values resource associated with this attribute. These field names can be displayed on the UI.
    • Title: List of Values Finder Name
      Maximum Length: 900
      The list of values finder of a rule variable attribute.
    • Title: List of Values Source Resource Name
      Maximum Length: 200
      The source resource name for the list of values resource of a rule variable attribute.
    • Title: List of Values Field
      Maximum Length: 900
      The field name of the list of values resource associated with this attribute.
    • Title: Required
      Maximum Length: 1
      Indicates whether a rule variable attribute is required or not.
    • Title: Source Artifact Code
      Read Only: true
      Maximum Length: 50
      The unique code of the source artifact resource.
    • Title: Source Artifact Identifier
      Read Only: true
      The artifact resource identifier of the corresponding variable in the data contract.
    • Title: Source Artifact Name
      Read Only: true
      Maximum Length: 50
      The name of the source artifact resource.
    • Title: Variable Code
      Maximum Length: 50
      The rule variable unique code, such as UNIT_GRADE.
    • Title: Variable ID
      Read Only: true
      The unique identifier of a rule variable.
    • Title: Locked
      Maximum Length: 1
      Default Value: false
      Indicates whether the rule variable is locked for editing or not. The default value is N.
    • Title: Name
      Maximum Length: 50
      The name of a rule variable.
    • Title: Variable Type Code
      Maximum Length: 30
      Default Value: ORA_HEY_SINGLE_VARIABLE
      The rule variable type code, for example, a simple variable, list variable or multicolumn list variable. A list of accepted values is defined in the lookup type ORA_HEY_VARIABLE_TYPE_CODE. The default value is ORA_HEY_SINGLE_VARIABLE.
    • Title: Variable Type
      Read Only: true
      Maximum Length: 80
      The meaning of the rule variable type code, for example, a simple variable, list variable or multicolumn list variable. A list of accepted values is defined in the lookup type ORA_HEY_VARIABLE_TYPE_CODE. The default value is Single variable.
    Back to Top