Guia do desenvolvedor de API aberta de pedido de produto

Use a API Product Order Open para criar, atualizar e recuperar informações do pedido do produto.

Este guia do desenvolvedor fornece informações sobre como estender o API aberta de pedido de produto para fazer várias personalizações.

Estendendo a API de abertura de pedido de produto

A API Product Order Open pode ser estendida editando as inclusões de script.

Esses script includes só devem ser editados com uma compreensão das consequências das mudanças.

• TMFProductOrderAPIUtil: contém funções para lidar com solicitações POST.
• TMFProductOrderGetAPIUtil: contém funções para lidar com solicitações GET.
• ProductOrderExtensionOOB: contém funções de ajuda que oferecem suporte a funções em TMFProductOrderAPIUtil e TMFProductOrderGetAPIUtil.
• ProductOrderProcessor: um arquivo de inclusão de script vazio. Use este arquivo para definir as funções que você deseja substituir de ProductOrderExtensionOOB.

Estenda a API de abertura de pedido de produto para fazer as personalizações a seguir.

Parâmetros obrigatórios

Para mudar quais parâmetros do corpo da solicitação são necessários ou não para criar um pedido de produto, substitua a função getProductOrderSchema() contida na inclusão de script ProductOrderExtensionOOB.

A função getProductOrderSchema() lê o esquema da inclusão de script TMFOrderAPIConstants. TMFOrderAPIConstants está protegido e não pode ser editado, portanto, você não pode simplesmente atualizar o esquema. Em vez disso, um novo esquema deve ser lido de um arquivo diferente. Você pode substituir getProductOrderSchema() para ler um novo esquema. Para substituir getProductOrderSchema(), grave uma função com o mesmo nome na inclusão de script ProductOrderProcessor. A nova função em ProductOrderProcessor será chamada por TMFProductOrderAPIUtil para substituir a função getProductOrderSchema() padrão em ProductOrderExtensionOOB.

Neste exemplo, getProductOrderSchema() retorna um esquema personalizado que é definido em um novo arquivo de constante.

// ProductOrderProcessor

var ProductOrderProcessor = Class.create();
ProductOrderProcessor.prototype = Object.extendsObject(ProductOrderExtensionOOB, {
   // Define overriding functions here
   // Function name and parameters must be identical to the function it overrides

   getProductOrderSchema: function() {
      //Define your own custom schema in a new constant file
      return JSON.parse(Constants.SCHEMA.CREATE_PRODUCT_ORDER);
   },

   type: 'ProductOrderProcessor'
});

Validação do corpo da solicitação

Para executar uma validação adicional no corpo da solicitação, substitua as funções ProductOrderExtensionOOB. ProductOrderExtensionOOB contém as quatro funções de ajuda a seguir que retornam verdadeiro por padrão.

• validaçãoPostRequest() — Chamado por processCreateOrder() em TMFProductOrderAPIUtil.
• identifyProductObj() — Chamado por processCreateOrder() em TMFProductOrderAPIUtil.
• executionRelatedPartyObj() : chamado por processCreateOrder() em TMFProductOrderAPIUtil.
• validGetRequest() — Chamado por processGetOrder() em TMFProductOrderGetAPIUtil.

Se uma função auxiliar retornar falso, ela interromperá a operação da API. Para aplicar a validação personalizada, substitua as funções de ajuda ProductOrderExtensionOOB criando funções com nomes e parâmetros idênticos em ProductOrderProcessor. Essas novas funções ProductOrderProcessor serão chamadas por TMFProductOrderAPIUtil e TMFProductOrderGetAPIUtil para substituir as funções de ajuda ProductOrderExtensionOOB padrão.

Neste exemplo, uma função em ProductOrderProcessor substitui uma função padrão em ProductOrderExtensionOOB para executar a validação no atributo productOrderItem.

// ProductOrderProcessor

var ProductOrderProcessor = Class.create();
ProductOrderProcessor.prototype = Object.extendsObject(ProductOrderExtensionOOB, {
    // Define overriding functions here
    // Function name and parameters must be identical to the function it overrides

    validatePostRequest: function(orderObject, details) {
        // Returning false terminates the POST request
        // Make sure to push error message in details array in case of error
        if (gs.nil(orderObject.productOrderItem)) {
            details.push(new TMFCommonOrderAPIUtil().getErrorDetailsObj(TMFOrderAPIConstants.MESSAGES.MISSING_ORDER_ITEM, '/'));
            return false;
        }
        return true;
    },

    type: 'ProductOrderProcessor'
});

Operações REST adicionais

Para criar operações adicionais além das operações GET e POST existentes, crie recursos REST de script adicionais para a API aberta do pedido de produto. A lógica dos novos recursos REST de script deve ser consistente com as operações existentes. Defina funções para as novas operações em uma nova inclusão de script.

Mapeamento de campo

Ao criar registros, a API mapeia os parâmetros do corpo da solicitação para os campos de registro. Ao recuperar registros, a API mapeia campos de registro para atributos de objeto de resposta.

ProductOrderExtensionOOB contém as seguintes funções para mapear um corpo de solicitação POST para um GlideRecord.

• transformOrderGr()
• transformOrdLineItemGr()
• getLineItemPrice()
• transformPriceOrderTypeAndState()
• transformCustLineItmContact()
• transformOrderItemChar()

ProductOrderExtensionOOB contém as seguintes funções para mapear um GlideRecord para um objeto de resposta para solicitações GET ou POST.

• transformPostOrderResponse()
• transformGetOrderResponse()
• transformProductObj()
• transformRelatedPartyCustomerLineItem()
• transformOrderItemRelationship()
• transformGetOrdLineItmResponse()
• transformProductCharacteristics()
• transformProductSpecification()

Personalize os mapeamentos de campo para adicionar e recuperar dados de campos adicionais ou para alterar os mapeamentos padrão dos campos. Para personalizar os mapeamentos de campo, substitua as funções de mapeamento ProductOrderExtensionOOB criando funções com nomes e parâmetros idênticos em ProductOrderProcessor. Essas novas funções ProductOrderProcessor serão usadas por TMFProductOrderAPIUtil e TMFProductOrderGetAPIUtil para substituir as funções de mapeamento ProductOrderExtensionOOB padrão.

Neste exemplo, duas funções em ProductOrderProcessor substituem as funções padrão em ProductOrderExtensionOOB para criar mapeamentos para os campos external_id e sys_id.

// ProductOrderProcessor

var ProductOrderProcessor = Class.create();
ProductOrderProcessor.prototype = Object.extendsObject(ProductOrderExtensionOOB, {
    // Define overriding functions here
    // Function name and parameters must be identical to the function it overrides

    transformOrderGr: function(requestObject, orderGr) {
        orderGr.external_id = requestObject.externalId;
        return orderGr;
    },

    transformPostOrderResponse: function(orderObject, orderGr) {
        orderObject.id = orderGr.getValue('sys_id');
        return orderObject;
    },

    type: 'ProductOrderProcessor'
});