Operações do Conector
Uma operação de serviço é um conjunto nomeado de funcionalidade que é oferecido por um serviço. Por exemplo, a operação de serviço que cria uma nova ordem de vendas é denominada SalesSalesOrderService.create. Um serviço pode expor múltiplas operações de serviço. As operações de serviço que um serviço expõe podem incluir operações de serviços customizados. A tabela a seguir descreve algumas das operações de serviço comum para serviços de documento.
As operações a seguir seriam executadas pelo conector MS Dynamics AX 2012 R3:
Operação | Descrição |
Criar | Essa operação cria um registro para um novo item no banco de dados. Por exemplo, para o serviço de ordem de vendas, essa operação cria uma nova ordem de vendas. Geralmente, essa operação responde com uma chave de entidade que contém o ID do novo item. O novo registro criado usa os valores de campo do registro na mensagem. Uma porta de integração pode ser configurada para substituir documentos existentes quando essa operação de serviço é chamada. |
Exclusão | Essa operação exclui um registro no banco de dados. Somente registros em tabelas filhas podem ser excluídos |
Procurar | Essa operação procura o registro do banco de dados especificado. |
FindKeys | Essa operação recupera uma lista de chaves de entidade que correspondem aos critérios de procura especificados. Por exemplo, uma solicitação pode conter uma consulta para clientes cujos sobrenomes comecem com a letra T. A resposta a essa consulta contém uma lista de campos-chave e valores que podem ser usados para consultar novamente dados adicionais. Por exemplo, é possível usar os campos-chave para atualizar cada registro do cliente na lista recuperada. |
Leitura | Essa operação recupera os registros especificados do banco de dados. Os registros que devem ser lidos são especificados usando chaves de entidade. A resposta contém os dados para os registros que são retornados. |
Atualizar | Essa operação atualiza um registro no banco de dados. Somente os campos para os quais os valores são fornecidos na mensagem são atualizados. Valores para todos os outros campos do banco de dados não mudam. |
getKeys | Essa operação recupera as chaves para documentos com base em um filtro de documento |
getChangedKeys | Essa operação recupera as chaves para documentos com base em um filtro de documento e uma data que é passada. |