Activation du regroupement de tables

For large deployments where the number of processes and queues in production approaches the per tenant limit, the number of tables created in the Insights data cube can impact performance. To manage the custom tables Insights creates for a tenant the Insights Admin Custom Table Management tool can be used to remove unneeded tables.

Table Grouping can be used to combine data from multiple Queues or Processes into a single custom table. A grouped custom table only counts as a single table against the custom table limit, regardless of how many Queues or Process are included in the group. If grouping is used on a Queue or Process which already has a custom table enabled, then the previous custom table can be cleaned up via the Clean Up Tables Tab after the grouping is applied. If the previous table is not cleaned up it will still count towards the table limit.

1. Using the UiPath.InsightsAdminTool first used to enable the tenant(s), select the Group Data Tables feature.
2. Sélectionnez le(s) locataire(s) pour lequel/lesquels vous souhaitez activer le regroupement de tables.
3. Provide the Grouping Definition File.

Fichier de définition de regroupement

Vous devez fournir un fichier .json avec les regroupements de tables souhaités lors de l'exécution du UiPath.InsightsAdminTool à l'aide de la définition de schéma suivante :

{
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://example.com/root.json",
  "type": "object",
  "title": "The Root Schema",
  "required": [
    "groups"
  ],
  "properties": {
    "groups": {
      "$id": "#/properties/groups",
      "type": "array",
      "title": "The Groups Schema",
      "items": {
        "$id": "#/properties/groups/items",
        "type": "object",
        "title": "The Items Schema",
        "required": [
          "tenantId",
          "elasticubeNameTemplate",
          "groupName",
          "dataSource"
        ],
        "properties": {
          "tenantId": {
            "$id": "#/properties/groups/items/properties/tenantId",
            "type": "integer",
            "title": "The Tenantid Schema",
            "default": 0,
            "examples": [
              3
            ]
          },
          "elasticubeNameTemplate": {
            "$id": "#/properties/groups/items/properties/elasticubeNameTemplate",
            "type": "string",
            "title": "The Elasticubenametemplate Schema",
            "default": "",
            "examples": [
              "{TENANT}-Cube"
            ],
            "pattern": "^{TENANT}-(.<em>)$"
          },
          "groupName": {
            "$id": "#/properties/groups/items/properties/groupName",
            "type": "string",
            "title": "The Groupname Schema",
            "default": "",
            "examples": [
              "Group_1"
            ],
            "pattern": "^(.</em>)$"
          },
          "dataSource": {
            "$id": "#/properties/groups/items/properties/dataSource",
            "type": "string",
            "title": "The Datasource Schema",
            "default": "",
            "enum": [
              "Process",
              "Queue"
            ],
            "pattern": "^(.<em>)$"
          },
          "likeGrouping": {
            "$id": "#/properties/groups/items/properties/likeGrouping",
            "type": "object",
            "title": "The Likegrouping Schema",
            "required": [
              "likeClause"
            ],
            "properties": {
              "likeClause": {
                "$id": "#/properties/groups/items/properties/likeGrouping/properties/likeClause",
                "type": "string",
                "title": "The Likeclause Schema",
                "default": "",
                "examples": [
                  "%1",
                  "test",
                  "%"
                ],
                "pattern": "^(.</em>)$"
              },
              "excludeLikeClause": {
                "$id": "#/properties/groups/items/properties/likeGrouping/properties/excludeLikeClause",
                "type": "string",
                "title": "The Excludelikeclause Schema",
                "default": "",
                "examples": [
                  "%1",
                  "test",
                  "%"
                ],
                "pattern": "^(.<em>)$"
              }
            }
          },
          "inGrouping": {
            "$id": "#/properties/groups/items/properties/likeGrouping",
            "type": "object",
            "title": "The Ingrouping Schema",
            "required": [
              "elements"
            ],
            "properties": {
              "elements": {
                "$id": "#/properties/groups/items/properties/likeGrouping/properties/likeClause",
                "type": "array",
                "title": "The Elements Schema",
                "default": "",
                "pattern": "^(.</em>)$"
              }
            }
          }
        }
      }
    }
  }
}

Où :

• groupName - Le nom que la table aura dans le cube Insights. Un maximum de 75 groupes peuvent être créés.
• tenantId – l'ID du locataire auquel le regroupement est appliqué.
• dataSource – si la source de données est un Process ou un Queue.
• Facultatif : elasticcubeNameTemplate – le nom du cube Insights, par défaut {TENANT}-Cube. Spécifiez-le si les tables regroupées doivent migrer vers un autre cube. Par exemple, {TENANT}-DocCube. Le nom du locataire sera remplacé lors de la création de la table, de sorte que si le locataire Default est en cours de ciblage, la table sera ajoutée à Default-DocCube.

Par exemple :

{
  "groups": [
    {
      "groupName": "Group_1",
      "tenantId": 3,
      "dataSource": "Process",
      "likeGrouping": {
        "likeClause": "%1"
      }
    },
    {
      "groupName": "Group_3",
      "tenantId": 3,
      "dataSource": "Process",
      "likeGrouping": {
        "likeClause": "%3",
        "excludeLikeClause": "%Environment_1%"
      }
    },
    {
      "groupName": "Doc_1+2",
      "tenantId": 3,
      "elasticubeNameTemplate": "{TENANT}-DocCube",
      "dataSource": "Queue",
      "inGrouping": {
        "elements": ["Doc", "Doc2"]
      }
    },
    {
      "groupName": "TestQueues",
      "tenantId": 3,
      "elasticubeNameTemplate": "{TENANT}-Test-Cube",
      "dataSource": "Queue",
      "likeGrouping": {
        "likeClause": "%Test"
      }
    }
  ]
}

Important :

• Le fichier de définition de regroupement ne prend pas en charge plus d’une valeur pour likeClause. Toutefois, vous pouvez saisir plusieurs valeurs séparées par des virgules pour excludeLikeClause.
• Les Insights ne peuvent pas prendre en charge des tables de plus de 40 colonnes, vous ne devez donc pas faire des groupes où le nombre de champs personnalisés par table sera supérieur à ce chiffre.
• Lorsqu’un nouveau processus ou une nouvelle file d’attente est ajouté dans Orchestrator et exécuté, s’il correspond à un nom de groupe existant, le processus ou la file d’attente sera ajouté au groupement et sera automatiquement inclus dans Insights.
• Si un processus ou une file d'attente correspond à plusieurs groupements, il sera inclus dans chaque groupement auquel il correspond.
• Lorsqu’un nouveau fichier de groupement est téléchargé, il supprime les groupements précédents.