Utilização de tabelas de mapeamento

As tabelas de mapeamento nos permitem armazenar dados como preços ou outras informações, que podem mudar regularmente. A vantagem da utilização de tabelas é que os dados geralmente podem ser modificados por sistemas externos utilizando os APIs do SAP Convergent Charging, sem necessariamente ter que modificar planos de preços de taxas.

Se você estiver familiarizado com bancos de dados relacionais e suas tabelas, provavelmente assumirá que as tabelas no SAP Convergent Charging funcionam da mesma forma. No entanto, existem algumas diferenças significativas:

1. As tabelas de mapeamento no SAP Convergent Charging têm três colunas obrigatórias:
   1. Identificador
   2. Data de início
   3. Data final
2. É possível declarar de uma a 40 colunas de entrada. As colunas de entrada contêm os dados que são usados para encontrar uma entrada na tabela. Em um banco de dados, essas colunas seriam consideradas parte da "chave". As colunas de entrada podem ter o tipo de dados Cadeia ou Moeda. O tipo de dados de moeda é uma cadeia, que consiste em todos os códigos de moeda ISO/SAP possíveis conhecidos no dicionário de moeda correspondente.
3. É possível declarar de uma a 30 colunas de saída. As colunas de saída contêm os dados associados aos dados nas colunas-chave.

No SAP Convergent Charging Core Tool, uma tabela de mapeamento típica pode ter o seguinte aspecto:

Esta tabela prevê um valor do acordo de nível de serviços (coluna ANS) e um valor de código da moeda (coluna CURRENCY) como critérios de pesquisa ou entradas. Para uma determinada combinação desses valores, ele associa um preço (coluna AMOUNT).

A coluna de identificador faz sempre parte de uma tabela de mapeamento. Ele serve como uma chave primária para abordar uma única linha de uma tabela usando os APIs, mas não pode ser usado como critério de pesquisa ao ler a partir de uma tabela dentro de uma árvore de planejamento de preços.

O intervalo para o qual a linha da tabela é válida está contido nas colunas de validade. Ao pesquisar uma tabela com um conjunto de critérios de pesquisa, deve ser fornecida uma data de referência. Um resultado só contém as linhas que correspondem aos critérios de pesquisa e são válidas na data de referência indicada.

As colunas de saída podem ter o tipo de dados string ou número. Dessa forma, você pode armazenar valores numéricos, como preços, bem como valores alfanuméricos, como nomes de países, cores, etc.

No SAP Convergent Charging, a estrutura de uma tabela de mapeamento é definida separadamente dos dados que uma ou várias tabelas contêm. A separação é efetuada definindo a estrutura de uma tabela como uma "Classe de tabela de mapeamento". Assim que a classe for definida, você pode criar várias tabelas de mapeamento da mesma estrutura referenciando a classe. Você não pode criar uma tabela de mapeamento sem fazer referência a uma classe de tabela de mapeamento. A classe é obrigatória durante o design.

A classe de tabela de mapeamento para a tabela descrita tem o seguinte aspecto:

Novas tabelas de mapeamento podem ser criadas selecionando Arquivo→Nova→classe de tabela de mapeamento no Core Tool. Cada classe de tabela de mapeamento deve receber um nome. Você deve fornecer pelo menos uma coluna de entrada e uma coluna de saída para a classe. Uma coluna deve ter um nome e um texto descritivo, bem como um tipo. A guia de informações adicionais contém informações opcionais. As informações adicionadas a esta guia não podem ser acessadas no planejamento de preços. No entanto, ele pode ser utilizado para restringir o acesso a tabelas para diferentes grupos de usuários por meio do SAP Convergent Charging Cockpit.

Assim que uma classe de tabela de mapeamento tiver sido definida e gravada no banco de dados do SAP Convergent Charging, as colunas de entrada e de saída são fixadas. Não é possível adicionar ou remover colunas assim que a classe de tabela de mapeamento for salva. No entanto, é possível abrir a classe de tabela de mapeamento como cópia e, em seguida, adicionar ou remover colunas, conforme necessário. Em seguida, a nova classe de tabela pode ser gravada utilizando um nome diferente.

Assim que a classe de tabela de mapeamento for definida e salva no banco de dados, uma tabela de mapeamento pode ser criada com referência à classe de tabela de mapeamento existente. Todas as tabelas criadas com referência à mesma classe de tabela de mapeamento compartilham as mesmas colunas de entrada e de saída. Para criar uma nova tabela de mapeamento, você precisa selecionar Arquivo→Nova→tabela de mapeamento. Forneça um nome para a nova tabela de mapeamento e selecione a classe de tabela de mapeamento na qual sua nova tabela se baseia. Quando você modifica a classe de tabela de mapeamento a ser usada, as colunas de tabela serão modificadas de modo correspondente.

Na guia Instância de tabela, você pode atualizar o conteúdo da tabela. Você pode adicionar e atualizar manualmente linha por linha ou importar o conteúdo da tabela do arquivo de valores separados por vírgulas (arquivo CSV). A importação de conteúdo de tabela usando um arquivo CSV facilita a importação de milhares de linhas de tabela em uma etapa.

A forma mais fácil de criar um modelo para o formato de arquivo CSV é adicionar uma linha à tabela, salvá-la e exportar os dados da tabela para um arquivo CSV.

Cada tabela de mapeamento pode ser encontrada no catálogo no grupo Tabelas de mapeamento.

As tabelas de mapeamento podem ser acessadas tecnicamente por qualquer conta de assinante. Por isso, as tabelas de mapeamento são mais adequadas para dados que devem estar disponíveis para todas ou para a maioria das contas de assinante de um sistema.

Quando você quiser armazenar dados em uma tabela de mapeamento que só deve estar acessível a uma conta de assinante específica, deve usar tabelas de mapeamento de assinante. As tabelas de mapeamento de assinante são semelhantes às tabelas de mapeamento. Eles usam as mesmas classes de tabela de mapeamento que as tabelas de mapeamento. No entanto, eles estão atribuídos a uma conta de assinante específica. Somente a conta de assinante à qual a tabela está atribuída pode ler a partir da tabela de mapeamento de assinante.

As tabelas de mapeamento de acordo são como tabelas de mapeamento regulares, uma vez que podem ser acessadas por várias contas de assinante. Cada tabela recebe um ID de acordo. Essas tabelas são utilizadas quando o SAP Subscription Order Management cria contratos básicos. Uma vez que esses contratos básicos são compartilhados por várias contas de assinante, este tipo de tabela é utilizado para armazenar os dados relevantes para classificação que fazem parte do contrato básico. Outra diferença importante é que as tabelas do acordo não são lidas quando o catálogo é exibido. Eles são lidos quando a subpasta com as tabelas de acordo é expandida, o que otimiza a performance e permite a administração de mais tabelas de acordo do que tabelas de mapeamento em um sistema SAP Convergent Charging.

Quando o nome da tabela de mapeamento deve ser lido, o componente de comparador Introdutor de tabela de mapeamento deve ser utilizado.

Ele cria duas filiais de saída no planejamento de preços. A primeira ramificação é executada quando uma entrada foi encontrada na tabela, enquanto a segunda ramificação é executada quando não foi possível encontrar nenhuma entrada.

Quando uma tabela de mapeamento é verificada, o componente introdutor da tabela de mapeamento precisa conhecer a classe de tabela de mapeamento na qual a verificação da tabela de mapeamento se baseia. Esta informação é chave, uma vez que indica ao componente com que colunas de entrada e de saída irá lidar no momento da execução.

O nome da tabela de mapeamento a partir da qual ler pode ser fornecido por um parâmetro do tipo ID da tabela de mapeamento ou selecionando uma tabela de mapeamento específica no tempo de design. A utilização de um parâmetro permite que a instância da tabela de mapeamento seja determinada no momento da execução, o que fornece mais flexibilidade.

O campo Data de referência necessita que seja selecionada uma propriedade da data do tipo de dados, que serve como linha de base para determinar uma linha válida. Somente as linhas válidas na data e hora indicadas pela característica de data de referência são consideradas uma ocorrência.

A coluna para a configuração de correspondência de prefixo mais longa permite não corresponder estritamente o valor da propriedade de entrada ao valor da coluna da tabela, mas sim uma verificação do valor que corresponde ao prefixo mais longo. Isso é importante quando você precisa encontrar a correspondência mais próxima para uma lógica de zona hierárquica. O valor na tabela é considerado o prefixo.

Na seção Mapeamento do contexto de classificação, você deve atribuir uma propriedade compatível com o tipo a cada uma das colunas de entrada. O componente comparador obtém os valores de todas essas propriedades e passa por todas as entradas em tabela de cima para baixo, até encontrar uma correspondência exata para todas elas. Se você tiver selecionado uma coluna para a correspondência de prefixo mais longa, essa coluna não será verificada para uma correspondência exata, mas sim para uma correspondência de prefixo mais longa.

A seção Mapeamento de características geradas contém todas as colunas de saída da tabela. No campo Nome de característica gerado, é indicado o nome da característica de saída que irá conter o respectivo valor do resultado mais abaixo na ramificação Linha encontrada da árvore de planejamento de preços. Você pode renomear esses nomes de característica conforme necessário, clicando duas vezes na célula Nome de característica gerado.

Se o componente de comparador não tiver conseguido encontrar nenhuma linha de tabela que corresponda aos critérios de pesquisa de entrada, é usada a ramificação Linha não encontrada. As propriedades geradas do componente não estarão disponíveis nessa ramificação. Mas não encontrar uma linha é necessariamente um problema: você pode pesquisar várias tabelas - uma após a outra - até encontrar uma entrada. Essa é uma prática comum quando você organiza preços em diferentes níveis hierárquicos (nível de contrato, nível de conta de assinante, nível geral). Nesse caso, você procura do nível mais específico (contrato) até o nível mais geral (geral). Os preços de cada nível podem residir em uma tabela dedicada, o que resulta em uma cascata de comparações de tabelas. Só faz sentido quando a última verificação não retornar nenhum resultado chamando uma função Sem acesso.