Personalize seus planos de procedimento com ganchos do Apex

Você está aqui:

Personalize seus planos de procedimento com ganchos do Apex

Para oferecer suporte a cenários de precificação exclusivos, adicione lógica do Apex personalizada aos seus planos de procedimento de precificação. Você pode usar ganchos do Apex para aplicar lógica de negócios personalizada que modifica o contexto de precificação após a configuração de uma linha de cotação. Use um prehook do Apex para ajustar a precificação com base nos atributos do produto antes de ele ser precificado e um posthook do Apex para lidar com alterações de precificação para grupos e outros elementos do objeto Cotação após a precificação. Quando um representante de vendas configura um produto ou altera um grupo de itens de linha de cotação, o plano de procedimento de precificação altera a precificação com base nas instruções no Apex.

Edições obrigatórias

Disponível em: Lightning Experience

Disponível em: Edições Enterprise, Unlimited e Developer do Revenue Cloud em que a Precificação do Salesforce está habilitada

Permissões de usuário necessárias
Para criar, atualizar e excluir procedimentos de precificação e planos de procedimento:	Acesso ao plano de procedimento ou usuário de tempo de design de precificação do Salesforce
Para usar procedimentos de precificação:	Usuário do tempo de execução de precificação do Salesforce
Para definir, editar, excluir e definir a segurança e definir as configurações de versão para classes do Apex:	Criar Apex

Importante

Ao usar o tipo de processo Revenue Cloud, qualquer lógica do Apex adicionada deve ser o primeiro ou o último elemento na sequência de execução do Plano de procedimento.
As chamadas externas de um gancho do Apex são suportadas apenas quando a solicitação Fazer transação de vendas é acionada por meio da interface do usuário do Salesforce ou da API de Fazer transação de vendas. Eles não são suportados quando a solicitação é acionada do Apex ou do Fluxo.
Não há suporte para chamadas externas em ganchos do Apex quando o modo Persistir duplo está habilitado. Para obter orientação adicional, entre em contato com o Suporte ao cliente da Salesforce.
Chamadas externas em ganchos do Apex podem afetar o desempenho. Portanto, objetivos de nível de serviço (SLOs) previsíveis não podem ser garantidos.

Certifique-se de que a Orquestração do plano de procedimento para precificação esteja ativada.
1. Em Configuração, na caixa Busca rápida, insira Configurações de receita e selecione Configurações de receita.
2. Localize e, se necessário, habilite a configuração Orquestração do plano de procedimento para precificação.
3. Deixe a configuração Excluir padrão e procedimentos de precificação de tipo de transação de vendas desabilitada.

Defina classes para ganchos do Apex para adicionar aos seus procedimentos de precificação.

Em Configuração, na caixa Busca rápida, insira Apex e selecione Classes do Apex.
Selecione Novo para criar uma nova classe do Apex.

No editor de classe, insira a definição da classe.

Por exemplo, esse prehook (ApexDmAttributePreHook) atualiza os valores de atributos dinâmicos com o nome Display_Size com base no tamanho de exibição. Mais classes de amostra são mostradas em Classes de amostra para ganchos de precificação do Apex no final dessas etapas.

global class ApexDmlAttributePreHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing PREHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        // STEP 1 - Query SalesTransactionItemAttribute and extract Display_Size values
        Map<String, Object> inputQueryItemAttr = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItemAttribute' }
        };
        Map<String, Object> itemAttrQueryOutput = industriesContext.queryTags(inputQueryItemAttr);
        Map<String, Object> itemAttrQueryResult = (Map<String, Object>) itemAttrQueryOutput.get('queryResult');
        List<Object> itemAttrData = (List<Object>) itemAttrQueryResult.get('SalesTransactionItemAttribute');

        Map<String, Decimal> parentCtxIdToDisplaySize = new Map<String, Decimal>();

        for (Object attrObj : itemAttrData) {
            Map<String, Object> attrNode = (Map<String, Object>) attrObj;
            Map<String, Object> tagMap = (Map<String, Object>) attrNode.get('tagValue');

            String attributeName = null;
            String attributeValueStr = null;
            String parentCtxId = null;

            if (tagMap.containsKey('Attribute')) {
                attributeName = (String)((Map<String, Object>) tagMap.get('Attribute')).get('tagValue');
            }
            if (tagMap.containsKey('AttributeValue')) {
                attributeValueStr = (String)((Map<String, Object>) tagMap.get('AttributeValue')).get('tagValue');
            }
            if (tagMap.containsKey('SalesTransactionItemAttrParent')) {
                parentCtxId = (String)((Map<String, Object>) tagMap.get('SalesTransactionItemAttrParent')).get('tagValue');
            }

            if (attributeName == 'Display_Size' && attributeValueStr != null && parentCtxId != null) {
                Decimal sizeValue = Decimal.valueOf(attributeValueStr.split(' ')[0]);
                parentCtxIdToDisplaySize.put(parentCtxId, sizeValue);
                System.debug('DisplaySize=' + sizeValue);
                System.debug('Matched itemCtxId=' + parentCtxId);
            }
        }

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            for (String ctxKey : parentCtxIdToDisplaySize.keySet()) {
                if (dataPath.contains(ctxKey)) {
                    Decimal newPrice = parentCtxIdToDisplaySize.get(ctxKey);
                    System.debug('DisplaySize match found for item ' + ctxKey);
                    dataPath.remove(0); // Remove contextId

                    itemNodeUpdates.add(new Map<String, Object>{
                        'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                        'attributes' => new List<Object>{
                            new Map<String, Object>{
                                'attributeName' => 'UnitPrice',
                                'attributeValue' => newPrice
                            }
                        }
                    });
                    matched = true;
                    break;
                }
            }

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
    
}

Salve a definição de classe.

Em Configuração, na caixa Busca rápida, insira Plano de procedimento e selecione Definições de plano de procedimento.
Na coluna Nomes de definição, selecione uma definição do plano de procedimento para editar.
Na definição do plano de procedimento, em Seções do plano de procedimento, selecione Adicionar para adicionar uma nova seção.
1. Selecione Padrão.
2. Dê um nome à seção, por exemplo, PreApex para um prehaok do Apex.
3. Em Tipo de seção, selecione Apex e depois salve.
4. Expanda a nova seção.
5. Para Fases, selecione Preço e para Tipo de resolução, selecione Padrão.
6. Na caixa de seleção do Apex exibida, insira a classe do Apex definida acima, por exemplo, ApexDmlAttributePreHook e selecione Salvar.
7. Adicione prehooks e posthooks adicionais conforme necessário.
Selecione Gerenciar seções para reorganizar pre-hakes acima da seção Procedimento de precificação e posthakes abaixo dela.
Salve suas alterações na definição do Plano de procedimento.

Exemplo Amostras de classes para ganchos de precificação do Apex

Prehauk: Atualize o percentual de desconto para 2% em todas as linhas no contexto (por exemplo, linhas de cotação).


global class ApexDmlDiscountUpdatePreHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing PREHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        Integer randomDiscountPercentage = 2;

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        System.debug('QLI itemData=' + itemData);

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            dataPath.remove(0); // Remove contextId

            itemNodeUpdates.add(new Map<String, Object>{
                'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                'attributes' => new List<Object>{
                    new Map<String, Object>{
                        'attributeName' => 'Discount',
                        'attributeValue' => randomDiscountPercentage
                    }
                }
            });
            matched = true;

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
}

Prehauk: Chame um recurso externo para buscar um valor de quantidade.


global class ApexDmlQuantityCalloutPreHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing PREHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        // STEP 1 - External Callout Test
        Integer randomNumber = getRandomNumber();
        System.debug(' Random Number from API: ' + randomNumber);

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        System.debug('QLI itemData=' + itemData);

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            dataPath.remove(0); // Remove contextId
    
            itemNodeUpdates.add(new Map<String, Object>{
                'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                'attributes' => new List<Object>{
                    new Map<String, Object>{
                        'attributeName' => 'Quantity',
                        'attributeValue' => randomNumber
                    }
                }
            });
            matched = true;

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
    
    // External callout
    private Integer getRandomNumber() {
        String endpoint = 'https://www.random.org/integers/?num=1&min=1&max=100&col=1&base=10&format=plain&rnd=new';
        Http http = new Http();
        HttpRequest req = new HttpRequest();
        req.setEndpoint(endpoint);
        req.setMethod('GET');
        req.setTimeout(5000);

        try {
            HttpResponse res = http.send(req);
            if (res.getStatusCode() == 200) {
                System.debug('Fetched prices from external service');
                return Integer.valueOf(res.getBody().trim());
            } else {
                System.debug(' Callout failed: ' + res.getStatus());
            }
        } catch (Exception ex) {
            System.debug(' Exception during callout: ' + ex.getMessage());
        }
        return 10;
    }
}

Prehauk: Acione uma atualização do preço de um produto se o Nome do atributo for Exibição e o Valor do atributo for Exibição integrada de 1080p ou se o Nome do atributo for Impressora e o Valor do atributo for Laser.


global class ApexDmlMultiAttributePreHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing PREHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        // STEP 1 - Query SalesTransactionItemAttribute and extract Display_Size values
        Map<String, Object> inputQueryItemAttr = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItemAttribute' }
        };
        Map<String, Object> itemAttrQueryOutput = industriesContext.queryTags(inputQueryItemAttr);
        Map<String, Object> itemAttrQueryResult = (Map<String, Object>) itemAttrQueryOutput.get('queryResult');
        List<Object> itemAttrData = (List<Object>) itemAttrQueryResult.get('SalesTransactionItemAttribute');

        Map<String, Decimal> parentCtxIdToAttribute = new Map<String, Decimal>();

        for (Object attrObj : itemAttrData) {
            Map<String, Object> attrNode = (Map<String, Object>) attrObj;
            Map<String, Object> tagMap = (Map<String, Object>) attrNode.get('tagValue');

            String attributeName = null;
            String attributeValueStr = null;
            String parentCtxId = null;

            System.debug('TagMap ' + tagMap);
            if (tagMap.containsKey('Attribute')) {
                attributeName = (String)((Map<String, Object>) tagMap.get('Attribute')).get('tagValue');
            }
            if (tagMap.containsKey('AttributeValue')) {
                attributeValueStr = (String)((Map<String, Object>) tagMap.get('AttributeValue')).get('tagValue');
            }
            if (tagMap.containsKey('SalesTransactionItemAttrParent')) {
                parentCtxId = (String)((Map<String, Object>) tagMap.get('SalesTransactionItemAttrParent')).get('tagValue');
            }
            
            if (attributeName == 'Display' && attributeValueStr == '1080p Built-in Display' && parentCtxId != null) {
               Decimal defaultDisplayCost = 1000.00;
               parentCtxIdToAttribute.put(parentCtxId, defaultDisplayCost);
               System.debug('Display=' + defaultDisplayCost);
               System.debug('Matched itemCtxId=' + parentCtxId);
            }
            
            if (attributeName == 'Printer' && attributeValueStr == 'Laser' && parentCtxId != null) {
               Decimal defaultLaserPrinterCost = 500.00;
               parentCtxIdToAttribute.put(parentCtxId, defaultLaserPrinterCost);
               System.debug('Printer=' + defaultLaserPrinterCost);
               System.debug('Matched itemCtxId=' + parentCtxId);
            }
        }

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            for (String ctxKey : parentCtxIdToAttribute.keySet()) {
                if (dataPath.contains(ctxKey)) {
                    Decimal newPrice = parentCtxIdToAttribute.get(ctxKey);
                    System.debug('Attribute match found for item ' + ctxKey);
                    System.debug('Attribue with new price ' + newPrice);
                    dataPath.remove(0); // Remove contextId

                    itemNodeUpdates.add(new Map<String, Object>{
                        'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                        'attributes' => new List<Object>{
                            new Map<String, Object>{
                                'attributeName' => 'UnitPrice',
                                'attributeValue' => newPrice
                            }
                        }
                    });
                    matched = true;
                    break;
                }
            }

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
    
}

Prehauk: Aplique um percentual de desconto aleatório a todas as linhas no contexto.


global class ApexDmlRandomDiscountPreHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing PREHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        Integer randomDiscountPercentage = getRandomNumber();

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        System.debug('QLI itemData=' + itemData);

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            dataPath.remove(0); // Remove contextId

            itemNodeUpdates.add(new Map<String, Object>{
                'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                'attributes' => new List<Object>{
                    new Map<String, Object>{
                        'attributeName' => 'Discount',
                        'attributeValue' => randomDiscountPercentage
                    }
                }
            });
            matched = true;

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
        // External callout
    public static Integer getRandomNumber() {
        String endpoint = 'https://www.random.org/integers/?num=1&min=1&max=100&col=1&base=10&format=plain&rnd=new';
        Http http = new Http();
        HttpRequest req = new HttpRequest();
        req.setEndpoint(endpoint);
        req.setMethod('GET');
        req.setTimeout(5000);

        try {
            HttpResponse res = http.send(req);
            if (res.getStatusCode() == 200) {
                System.debug('Fetched prices from external service');
                return Integer.valueOf(res.getBody().trim());
            } else {
                System.debug(' Callout failed: ' + res.getStatus());
            }
        } catch (Exception ex) {
            System.debug(' Exception during callout: ' + ex.getMessage());
        }
        return 10;
    }

}

Prehauk: Atualize um valor de atributo dinâmico com valor aleatório de uma chamada para um recurso externo.


global class ApexDmlAttributeExternalCalloutPreHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing PREHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        // STEP 1 - Query SalesTransactionItemAttribute and extract Display_Size values
        Map<String, Object> inputQueryItemAttr = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItemAttribute' }
        };
        Map<String, Object> itemAttrQueryOutput = industriesContext.queryTags(inputQueryItemAttr);
        Map<String, Object> itemAttrQueryResult = (Map<String, Object>) itemAttrQueryOutput.get('queryResult');
        List<Object> itemAttrData = (List<Object>) itemAttrQueryResult.get('SalesTransactionItemAttribute');

        Map<String, Decimal> parentCtxIdToDisplaySize = new Map<String, Decimal>();

        for (Object attrObj : itemAttrData) {
            Map<String, Object> attrNode = (Map<String, Object>) attrObj;
            Map<String, Object> tagMap = (Map<String, Object>) attrNode.get('tagValue');

            String attributeName = null;
            String attributeValueStr = null;
            String parentCtxId = null;

            if (tagMap.containsKey('Attribute')) {
                attributeName = (String)((Map<String, Object>) tagMap.get('Attribute')).get('tagValue');
            }
            if (tagMap.containsKey('AttributeValue')) {
                attributeValueStr = (String)((Map<String, Object>) tagMap.get('AttributeValue')).get('tagValue');
            }
            if (tagMap.containsKey('SalesTransactionItemAttrParent')) {
                parentCtxId = (String)((Map<String, Object>) tagMap.get('SalesTransactionItemAttrParent')).get('tagValue');
            }

            if (attributeName == 'Display_Size' && attributeValueStr != null && parentCtxId != null) {
                Decimal sizeValue = getRandomNumber();
                parentCtxIdToDisplaySize.put(parentCtxId, sizeValue);
                System.debug('DisplaySize=' + sizeValue);
                System.debug('Matched itemCtxId=' + parentCtxId);
            }
        }

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            for (String ctxKey : parentCtxIdToDisplaySize.keySet()) {
                if (dataPath.contains(ctxKey)) {
                    Decimal newPrice = parentCtxIdToDisplaySize.get(ctxKey);
                    System.debug('DisplaySize match found for item ' + ctxKey);
                    dataPath.remove(0); // Remove contextId

                    itemNodeUpdates.add(new Map<String, Object>{
                        'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                        'attributes' => new List<Object>{
                            new Map<String, Object>{
                                'attributeName' => 'UnitPrice',
                                'attributeValue' => newPrice
                            }
                        }
                    });
                    matched = true;
                    break;
                }
            }

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
    
        // External callout
    private Integer getRandomNumber() {
        String endpoint = 'https://www.random.org/integers/?num=1&min=1&max=100&col=1&base=10&format=plain&rnd=new';
        Http http = new Http();
        HttpRequest req = new HttpRequest();
        req.setEndpoint(endpoint);
        req.setMethod('GET');
        req.setTimeout(5000);

        try {
            HttpResponse res = http.send(req);
            if (res.getStatusCode() == 200) {
                System.debug('Fetched prices from external service');
                return Integer.valueOf(res.getBody().trim());
            } else {
                System.debug(' Callout failed: ' + res.getStatus());
            }
        } catch (Exception ex) {
            System.debug(' Exception during callout: ' + ex.getMessage());
        }
        return 10;
    }
}

Posthook: Atualize a descrição de cada linha no contexto.


global class ApexDmlDescriptionPostHook implements RevSignaling.SignalingApexProcessor {

    public virtual class BaseException extends Exception {}
    public class OtherException extends BaseException {}
    
    public RevSignaling.TransactionResponse execute(RevSignaling.TransactionRequest request) {
        System.debug('Executing POSTHOOK');
        
        String contextId = request.ctxInstanceId;
        Context.IndustriesContext industriesContext = new Context.IndustriesContext();
        
        String randomDescription = 'via Post Apex Pricing Hook';

        // STEP 2 - Query SalesTransactionItem nodes
        Map<String, Object> inputQueryItem = new Map<String, Object>{
            'contextId' => contextId,
            'tags' => new List<String>{ 'SalesTransactionItem' }
        };
        Map<String, Object> itemQueryOutput = industriesContext.queryTags(inputQueryItem);
        Map<String, Object> itemQueryResult = (Map<String, Object>) itemQueryOutput.get('queryResult');
        List<Object> itemData = (List<Object>) itemQueryResult.get('SalesTransactionItem');

        System.debug('QLI itemData=' + itemData);

        // STEP 3 - Build update list
        List<Map<String, Object>> itemNodeUpdates = new List<Map<String, Object>>();

        for (Object itemObj : itemData) {
            Map<String, Object> itemNode = (Map<String, Object>) itemObj;
            List<Object> dataPath = (List<Object>) itemNode.get('dataPath');
            System.debug('Full item dataPath: ' + JSON.serialize(dataPath));

            Boolean matched = false;
            dataPath.remove(0); // Remove contextId

            itemNodeUpdates.add(new Map<String, Object>{
                'nodePath' => new Map<String, Object>{ 'dataPath' => dataPath },
                'attributes' => new List<Object>{
                    new Map<String, Object>{
                        'attributeName' => 'SalesTrxnItemDescription',
                        'attributeValue' => randomDescription
                    }
                }
            });
            matched = true;

            if (!matched) {
                String itemCtxId = dataPath.size() > 1 ? String.valueOf(dataPath[1]) : 'UNKNOWN';
                System.debug('No DisplaySize match found for item ' + itemCtxId);
            }
        }

        // STEP 4 - Submit context update
        if (!itemNodeUpdates.isEmpty()) {
            Map<String, Object> updateInput = new Map<String, Object>{
                'contextId' => contextId,
                'nodePathAndAttributes' => itemNodeUpdates
            };

            System.debug('--- PREHOOK: SUBMITTING CONTEXT UPDATE ---');
            System.debug(JSON.serializePretty(updateInput));
            industriesContext.updateContextAttributes(updateInput);
        }

        RevSignaling.TransactionResponse response = new RevSignaling.TransactionResponse();
        response.status = RevSignaling.TransactionStatus.SUCCESS;
        //response.status = RevSignaling.TransactionStatus.FAILED;
        //response.message = 'An error occurred during the processing...';
        return response;
    }
}

Este artigo resolveu seu problema?

Diga-nos para podermos melhorar!

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.

Personalize seus planos de procedimento com ganchos do Apex

Edições obrigatórias

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.Alternar para inglêsAgora não

Área de produtos

Impacto do recurso

Edição

Experiência

Personalize seus planos de procedimento com ganchos do Apex

Edições obrigatórias

Este texto foi traduzido pelo sistema de tradução automática da Salesforce. Mais detalhes aqui.