OneDeclarativeConn (Pré-visualização)

Receba faturas uma a uma na GetMyInvoices. Se executarmos este conector, podemos obter a última fatura do GetMyInvoices. Isto significa que, se executares o nosso conector uma vez, receberemos um dado de fatura e o último ID de fatura será aumentado. De seguida, se voltar a executar este conector, obteremos os dados da próxima fatura de acordo com o último ID da fatura, e o último ID da fatura também será aumentado. Se já não houver ID de fatura, então o conector devolverá o valor vazio.

Este conector está disponível nos seguintes produtos e regiões:

OneDeclarativeFlow

Permite as operações básicas em relação ao nosso software Contract Insight (Adicionar, Inserir, Atualizar) e informações de esquema para uma entidade.

Editora: CobbleStone Software

Pré-requisitos

Requer licença existente para CobbleStone Software (Contact Insight).

Operações suportadas

Get

Pull list de registros para uma determinada entidade com critérios específicos, ordem por tag, grupo por tag e número de registros. Nota: Não há limite para o número de registros a serem extraídos, mas o usuário tem que considerar que resultados maiores serão mais lentos para processar.

Adicionar

Adicione um registro (limitado a um registro por chamada) à entidade especificada. A resposta será o ID gerado pelo sistema.

Update

Atualize o(s) registro(s) para uma entidade/área especificada com critérios específicos e um TriggerWorkflow como sinalizador para executar o fluxo de trabalho após a solicitação de atualização ser bem-sucedida ou não. O número máximo de registros que podem ser atualizados é de 500 por chamada.

Schema

Lista colunas, tipos de dados e quaisquer restrições ou sinalizadores (NULL, Length, Primary Key, etc.) em uma tabela.

Lista de entidades

Retorna a lista de nomes e três propriedades sinalizadas indicando se ela pode ser editada, atualizada ou visualizada/consultada por meio dessa interface.

Obtenção de credenciais

Autorização (OAUTH 2.0)

• CobbleStone Software oferece dois métodos de autorização de acesso:
  • Código de autorização: https://oauth.net/2/grant-types/authorization-code/
  • Subvenção implícita: https://oauth.net/2/grant-types/implicit/

As credenciais podem ser configuradas/geradas através do seu sistema CobbleStone Software.

Introdução

Para criar as credenciais do API Client através do seu sistema CobbleStone Software, use as seguintes etapas:

Dentro do seu sistema CobbleStone Software, um administrador de sistema pode navegar até a seguinte página para configurar/configurar credenciais:

• Para clientes SaaS: https://yourCompanyName.cobblestone.software/core/MyAPI.aspx
• Para clientes implantados (normalmente): https://yourCompanyName/core/MyAPI.aspx

(NOTA: Isto está sob o item de menu superior "Meu" e, em seguida, selecione "Meus clientes API")

Isso permite que um administrador do sistema crie credenciais OAuth 2.0 (ID do Cliente e Segredo do Cliente) para uso com o conector.

Ao fazer login no seu sistema CobbleStone Software:

Para começar, você abrirá o CobbleStone Software e irá em My > My API Clients...

Crie uma nova entrada de API Client clicando em Add API Client e dê a ela um nome exclusivo. O nome é apenas interno e pode ser qualquer coisa significativa para o seu propósito. Recomendamos o uso de uma chave de API diferente para organizar as coisas em tarefas pequenas, gerenciáveis e com propósito.

Isso gerará uma chave e apenas o pessoal administrativo terá acesso à página. Está ligada a pessoa que gerou a chave e ela é a única que pode vê-la. Você pode compartilhar a chave deles, mas apenas o usuário conectado pode vê-lo.

Neste ponto, terminamos de configurar a entrada do API Client. Este ID do Cliente e o Client Securet são usados para que o conector se comunique com o seu sistema CobbleStone Software.

Problemas conhecidos e limitações

Atualmente, o conector não suporta o envio ou recebimento de arquivos binários.

O ponto de extremidade "Atualizar" é limitado a um máximo de 500 linhas afetadas por acerto. Se mais de 500 registros precisarem ser atualizados, eles precisarão ser processados em vários acertos.

Limites de Limitação

Ações

Obter documento de fatura de GetMyInvoices