Skip to main content

Filter

Filter group​

A filter groupFilter groupA configurable set of fields used to filter resources and tasks on the planning board. is the base definition for the powerful filtering mechanism of Dime.Scheduler. Filter groups are used to filter on resourcesResourceAn entity that can carry out work - a person, vehicle, tool, or room - that you schedule on the planning board. and tasksTaskA unit of work that belongs to a job. It appears in the open task list until it is scheduled to a resource., but also to set up the data-driven part of the security system.

The following entities are exposed through the API.

Upsert filter group​

Inserts or updates a filter group record.

NameData TypeDefaultRequired
Idint0
GroupNamenvarchar(50)✔️
ColumnNoint0
DataFilterbit0
  • This endpoint is available in the import API endpoint /import via the procedure mboc_upsertFilterGroup.
  • Example body:
    [
    {
    "StoredProcedureName": "mboc_upsertFilterGroup",
    "ParameterNames": ["GroupName"],
    "ParameterValues": ["Skill"]
    }
    ]

Rename filter group​

Renames the filter group.

NameData TypeDefaultRequired
GroupNamenvarchar(50)✔️
NewGroupNamenvarchar(50)✔️
  • This endpoint is available in the import API endpoint /import via the procedure mboc_renameFilterGroup.
  • Example body:
    [
    {
    "StoredProcedureName": "mboc_renameFilterGroup",
    "ParameterNames": ["GroupName", "NewGroupName"],
    "ParameterValues": ["Skill", "Useless skill"]
    }
    ]

Delete filter group​

Removes the filter group.

NameData TypeDefaultRequired
GroupNamenvarchar(50)✔️
  • This endpoint is available in the import API endpoint /import via the procedure mboc_deleteFilterGroup.
  • Example body:
    [
    {
    "StoredProcedureName": "mboc_deleteFilterGroup",
    "ParameterNames": ["GroupName"],
    "ParameterValues": ["Skill"]
    }
    ]

Filter value​

A filter valueFilter valueA single value inside a filter group, used as a qualification on a resource or a requirement on a task. is the child of filter group, and a filter group is required before any filter value can be added.

Upsert filter value​

Inserts or updates a filter value record.

NameData TypeDefaultRequired
FilterGroupNamenvarchar(50)✔️
FilterValuenvarchar(100)✔️
  • This endpoint is available in the import API endpoint /import via the procedure mboc_upsertFilterValue.
  • Example body:
    [
    {
    "StoredProcedureName": "mboc_upsertFilterValue",
    "ParameterNames": ["FilterGroupName", "FilterValue"],
    "ParameterValues": ["Language", "German"]
    }
    ]

Rename filter value​

Renames a filter value record. A filter value is the child of filter group, and a filter group is required before any filter value can be added.

NameData TypeDefaultRequired
FilterGroupNamenvarchar(50)✔️
FilterValuenvarchar(100)✔️
NewFilterValuenvarchar(100)✔️
  • This endpoint is available in the import API endpoint /import via the procedure mboc_renameFilterValue.
  • Example body:
    [
    {
    "StoredProcedureName": "mboc_renameFilterValue",
    "ParameterNames": ["FilterGroupName", "FilterValue", "NewFilterValue"],
    "ParameterValues": ["Language", "German", "Swiss German"]
    }
    ]

Delete filter value​

Removes the filter value.

NameData TypeDefaultRequired
FilterGroupNamenvarchar(50)✔️
FilterValuenvarchar(100)✔️
  • This endpoint is available in the import API endpoint /import via the procedure mboc_deleteFilterValue.
  • Example body:
    [
    {
    "StoredProcedureName": "mboc_deleteFilterValue",
    "ParameterNames": ["FilterGroupName", "FilterValue"],
    "ParameterValues": ["Skill", "Small talk"]
    }
    ]