Noções Básicas Sobre Grupos de Entidades

Os Grupos de Entidades são usados para definir grupos de entidades, como dispositivos (incluindo medidores ou itens, bem como dispositivos controláveis usados com o Serviço de Nuvem de Ativo Digital e o Gerenciamento de Ativos Digitais) ou pontos de serviço.

Uma entidade poderá pertencer a mais de um grupo se tiver Categorias de Grupo diferentes. Por exemplo, um dispositivo controlável associado a um programa e tarifa específicos pode pertencer a uma categoria de grupo com base no programa específico, bem como a uma categoria de grupo com base na tarifa específica.

O processamento de grupo de entidades usa consultas SQL dinâmicas para identificar entidades que pertencem a um grupo de entidades. Essas consultas dinâmicas se baseiam na configuração da Categoria do Grupo (que define o Modelo SQL que contém tokens) e dos Valores de Critérios (que definem valores específicos para os tokens no Modelo SQL). Essas consultas são usadas pelas zonas de "<Entidade>s Elegíveis para este Grupo" que identificam as entidades elegíveis não atribuídas a um grupo, bem como pelos processos em batch de Avaliação do Grupo de Entidades (consulte Processamento em Batch em Configurando Grupos de Entidades para obter mais informações).

Os Grupos de Entidades são definidos pelas seguintes opções:

  • Status: o status atual do grupo de entidades
  • Categoria do Grupo: a categoria à qual o grupo de entidades pertence. As categorias de grupo são definidas usando a busca extensível Categoria do Grupo de Entidades (D1-EntityGrpCodeCategoryLookup). Mais detalhes abaixo.
  • Opção de Desativação do Grupo: um flag que define o que acontece com o relacionamento (capturado na tabela Grupo de Entidades do Dispositivo ou Grupo de Entidades do Ponto de Serviço, conforme apropriado) entre o grupo e as entidades pertencentes ao grupo se ou quando o grupo for desativado. As opções são "Expirar" e "Não Expirar".
  • Opção de Atribuição de Grupo: um flag que indica a maneira pela qual os grupos são atribuídos às entidades. As opções incluem Sistema (via processo em batch), Usuário (manualmente), Sistema e Usuário (um dos dois).
  • Valor de Critérios: um ou mais valores de critérios usados para selecionar entidades para o grupo, com base em uma Fonte de Critérios e Valor de Critérios.
    • Fonte de Critérios: define a fonte dos critérios usados para selecionar entidades para o grupo (como uma Especificação, Tarifa ou Programa). As fontes de critérios são definidas usando a busca extensível Fonte de Critérios do Grupo de Entidades (D1-EntityGrpCriteriaSrcLookup). Mais detalhes abaixo.
    • Valor de Critérios: define valores específicos para os critérios usados ao selecionar entidades para o grupo. Por exemplo, valores para uma Fonte de Critérios de "Tarifa" podem ser tarifas definidas em uma busca extensível.

Dados do Sistema

Os Grupos de Entidades se baseiam nos seguintes dados do sistema:

Tipo de Dados Descrição
Objeto de Manutenção Grupo de Entidades (D1-ENTGRP)
Objetos de Negócios Grupo de Entidades (D1-EntityGroup)

Busca Extensível da Categoria do Grupo de Entidades

A busca extensível da Categoria do Grupo de Entidades (D1-EntityGrpCodeCategoryLookup) define categorias de grupos de entidades. Elas são usadas para definir grupos de entidades (dispositivos ou pontos de serviço) que compartilham os critérios e o modelo SQL para identificar e recuperar entidades, mas que podem ter valores de critérios diferentes. Por exemplo, dois grupos de entidades de dispositivos, "Grupo de Dispositivos A" e "Grupo de Dispositivos B", podem fazer referência à mesma categoria "Especificação e Tarifa", que usa os critérios de Especificação e Tabela de Tarifas para identificar e recuperar dispositivos (os dispositivos do grupo A são aqueles com uma combinação exclusiva de Especificação e Tabela de Tarifas, enquanto os do grupo B têm uma combinação exclusiva diferente de Especificação e Tarifas). A categoria também define o modelo SQL que usa os critérios "Especificação" e "Tarifa" ao identificar e recuperar dispositivos. O SQL do Modelo de Categoria do Grupo de Entidades contém tokens e os Valores de Critérios dos Grupos de Entidades definem valores específicos para os tokens no Modelo SQL.

Os valores para essa pesquisa extensível são definidos pelo seguinte:

  • Status: o status atual da categoria do grupo de entidades.
  • Objeto de Manutenção de Destino: o objeto de manutenção das entidades que pertencem aos grupos de entidades desta categoria. As opções válidas incluem Dispositivo (D1-DEVICE) ou Ponto de Serviço - MDM (D1-SP).
  • Modelo SQL: o modelo SQL usado para identificar e recuperar entidades para grupos de entidades desta categoria.
  • Algoritmo do Grupo de Entidades: um algoritmo que executa o modelo SQL, inserindo os valores de critérios do grupo de entidades para identificar e recuperar entidades para grupos de entidades dessa categoria.
  • Fontes de Critérios: As fontes de critérios usadas pelo modelo SQL ao identificar e recuperar entidades para grupos de entidades dessa categoria. As fontes de critérios são definidas usando a busca extensível Fonte de Critérios do Grupo de Entidades (D1-EntityGrpCriteriaSrcLookup). Mais detalhes abaixo. Cada fonte de critérios é definida pelo seguinte:
    • Fonte de Critérios: o nome da fonte de critérios – obtido da busca extensível de Fonte de Critérios do Grupo de Entidades (D1-EntityGrpCriteriaSrcLookup)
    • É Obrigatório: um flag que indica se um valor é obrigatório para a fonte de critérios (Obrigatório ou Opcional)
    • Marcador: o token usado no modelo SQL para a fonte e o valor dos critérios, no formato "#xxx". Por exemplo, o marcador de uma fonte de critérios de Especificação pode ser "#SPEC".
    • Operador da Condição: o operador usado nas cláusulas WHERE no modelo SQL para filtrar dados com base na fonte de critérios. Os valores são definidos na consulta de Operador da Condição (CONDITION_OPR_FLG).

O pacote base inclui um valor de amostra para esta busca extensível.

Busca Extensível Fonte de Critérios

A busca extensível Fonte de Critérios do Grupo de Entidades (D1-EntityGrpCriteriaSrcLookup) define os critérios que podem ser configurados para um grupo de entidades. Cada valor define uma única fonte de critérios, como Especificação, Tarifa ou Programa, bem como a forma como o usuário inserirá valores de critérios para a fonte de critérios e a fonte de valores de critérios para a fonte de critérios. Essa configuração é usada na seção Valor de Critérios de um Grupo de Entidades.

Os valores para essa pesquisa extensível são definidos pelo seguinte:

  • Status: o status atual da fonte de critérios do grupo de entidades
  • Apresentação: a apresentação usada para a fonte dos critérios. As opções incluem:
    • Lista suspensa: o usuário seleciona um valor de critério em uma lista suspensa.
    • Texto de Entrada: o usuário insere o texto.
    • Texto de Entrada com Seletor de Data: o usuário seleciona uma data.
    • Texto de Entrada com Seletor de Data/Hora: o usuário seleciona uma data e hora.
  • Fonte do Valor: a fonte de valores para a fonte de critérios. As opções incluem:
    • Tipo de Característica (Predefinido): os valores são de uma lista de valores predefinidos para um tipo de característica
    • Busca Extensível: os valores são de uma busca extensível
    • Script de Serviço: os valores são recuperados por um script de serviço
    • Pesquisa Padrão: os valores são de uma pesquisa padrão
  • Recuperador de Valor: a fonte do valor específica usada para a fonte de critérios, com base na Fonte do Valor. Por exemplo, se a Fonte do Valor for "Pesquisa Padrão", esse será o código de consulta.

Exemplo: uma fonte de critérios de "Tarifa" em que os valores são derivados da busca extensível Tabela de Tarifas do Cliente (D2-CCBRateScheduleLookup) pode ser definida da seguinte forma:

  • Fonte de Critérios: Tarifa
  • Descrição: Tarifa
  • Status: Ativo
  • Apresentação: Lista suspensa
  • Fonte do Valor: Busca Extensível
  • Recuperador de Valor: D2-CCBRateScheduleLookup