Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Sumário

...


Índice
excludeSumário

Objetivo

...

Esse documento tem o objetivo de exemplificar o uso da API utilizando todos os métodos implementados.

Para mais informações sobre consumo de Licença, Veja Aqui.

1 - Método

...

     Foi implementados na API de Perfil somente o método GET.

1.1 - GET

...

1.1.1 - Get All (Recuperar todos os perfis cadastrados na coligada)

...

Informações
iconfalse
title1.1.1 GetAll
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/glb/v1/roles

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles

Informações
iconfalse
titleExemplo Postman

Image Removed

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "Api_coligada"
        },
        {
            "id": "DBA_G"
        },
        {
            "id": "DP_G"
        },
        {
            "id": "Perfil1_G"
        },
        {
            "id": "PerfilApi"
        },
        {
            "id": "Teste_Api"
        }
    ]
}

1.1.2 - Order(Resultado Ordenado)

Informações
titleParâmetros

Order: parâmetro responsável pela ordenação do resultado, podendo ser ascendente ou descendente. O resultado com a ordem descendente deve ser precedida do caractere "-" (menos).

Exemplo 1: ?order=campo1 (Ascendente)

Exemplo 2: ?order=-campo1 (Descendente)

Múltiplos campos de ordenação: ?order=[-]campo1, [-]campo2, [-]campo3 ...

Informações
iconfalse
title1.1.2 Order (Asc)

Padrão scim:

SortBy: define o campo que será ordenado.

SortOrder: parâmetro responsável pela ordenação do resultado, podendo ser ascendente ou descendente.

Exemplo 1: ?sortBy=campo1&sortOrder=ascending (Ascendente)

Exemplo 2: ?sortBy=campo1&sortOrder=descending (Descendente)

expand

Informações
iconfalse
title1.1.2 Order (Asc)
Expandir
Informações
iconfalse
titleConfiguração

Máscara

Configuração

Máscara de Url: http://{domínio}:{porta}/api/glbframework/v1/roles?order={campo}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: id

Tipo de Ordenação: Ascendente

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles?order=id

Informações
iconfalse
titleExemplo Postman

Image Removed

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "Api_coligada"
        },
        {
            "id": "DBA_G"
        },
        {
            "id": "DP_G"
        },
        {
            "id": "Perfil1_G"
        },
        {
            "id": "PerfilApi"
        },
        {
            "id": "Teste_Api"
        }
    ]
}
Informações
iconfalse
title1.1.2 Order (Desc)
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/glbframework/v1/roles?order=[-]{campo}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: id

Tipo de Ordenação: Descendente

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles?order=-id

Informações
iconfalse
titleExemplo Postman

Image Removed

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "Teste_Api"
        },
        {
            "id": "PerfilApi"
        },
        {
            "id": "Perfil1_G"
        },
        {
            "id": "DP_G"
        },
        {
            "id": "DBA_G"
        },
        {
            "id": "Api_coligada"
        }
    ]
}

1.1.3 - Filter (Resultado filtrado)

...

Informações
iconfalse
title1.1.3 Filter
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/glbframework/v1/roles?{campo}={valor}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campo: id

Valor: DBA_G

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles?id=DBA_G

Informações
iconfalse
titleExemplo Postmande Resultado
Image Removed
Expandir
Informações
iconfalse
titleExemplo de Resultado
titleVer resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "DBA_G"
        }
    ]
}

1.1.4 - Paginação

...

Informações
titleParâmetros

Page: Página que será apresentada.

PageSize: Quantidade máxima de registros por página que serão apresentados.

Exemplo: ?page=valor1&pageSize=1

Valores padrão: Caso não sejam preenchidos os parâmetros evidenciados acima serão preenchidos com valores padrão.

Page: 1

PageSize: 20


Padrão scim:

StartIndex: valor inicial do índice do registro que será retornado.

Count: quantidade máxima de registros que serão apresentados.

Exemplo 1: ?startIndex=2&count=2

Informações
iconfalse
title1.1.4 Paginacao
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/glbframework/v1/roles?page={valor1}&pageSize={valor2}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Valor1: 2

Valor2: 2

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles?page=2&pageSize=2

Informações
iconfalse
titleExemplo Postman

Image Removed

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{

    "hasNext": true,
    "items": [
        {
            "id": "DBA_0"
        },
        {
            "id": "DBA_0"
        }
    ]
}

1.1.5 - Fields (Retorno de campos específicos no resultado) 

...

Informações
titleParâmetros

Fields: parâmetro responsável pela especialização de campos em um resultado, ou seja, o usuário define quais campos serão apresentados no resultado.

Exemplo: ?fields=campo1

Múltiplos campos de ordenação: ?fields=campo1, campo2, campo3 ...


Padrão scim:

Attributes: define quais campos serão apresentados no resultado.

Exemplo 1: ?attributes=campo1

Múltiplos campos de ordenação: ?fields=campo1, campo2, campo3 ...

Informações
iconfalse
title1.1.5 Fields
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/framework/v1/roles?fields={campo}

Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Campos: id

Url Utilizada: http://localhost:8051/api/framework/v1/roles?fields=id

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "Api_coligada"
        },
        {
            "id": "DBA_G"
        },
        {
            "hasNextid": true "DP_G"
        },
      "items": [  {
            "id": "Perfil1_G"
        },
        {
            "id": "DBA_0PerfilApi"
        },
        {
            "id": "DBATeste_0Api"
        }
    ]
}

1.1.

...

6 - Fields &Order (

...

Retornar os campos específicos

...

em ordem)

...

...

Informações
titleParâmetros

FieldsExpand: parâmetro Parâmetro responsável pela especialização e ordenação de campos em um resultado.

Exemplo: ?fields=id&order=-id - Nesse exemplo, serão retornados o campo "id" de perfis e em ordem descendente.


Padrão scim:

Attributes: , ou seja, o usuário define quais campos serão apresentados no resultado.

Exemplo 1: ?fieldsattributes=campo1Múltiplos campos de ordenação: ?fields=campo1, campo2, campo3 ...&sortBy=campo2&sortOrder=descending

Informações
iconfalse
title1.1.5 Fields6 GetOne
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http://{domínio}:{porta}/api/glbframework/v1/roles?fieldsfilelds={{campo}}&Order={{campo}}

Image Removed
Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Valor Campo Fields: id

Valor Campo OrderCampos: id

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles?fields=id

Informações
iconfalse
titleExemplo Postman

&order=-id

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "Teste_Api_coligada"
        },
        {
            "id": "DBA_GPerfilApi"
        },
        {
            "id": "DPPerfil1_G"
        },
        {
            "id": "Perfil1DP_G"
        },
        {
            "id": "PerfilApiDBA_G"
        },
        {
            "id": "TesteApi_Apicoligada"
        }
    ]
}


1.1.

...

7 - Filter by Application and Activation (Retornar os perfis ativos/inativos de uma aplicação(sistema) )

...

Informações
titleParâmetros

Expand: Parâmetro responsável pela especialização e ordenação de campos em um resultado. Parâmetros responsáveis por receber o código da aplicação(sistema) e status de ativação

Exemplo: ?fieldsapplication=idId&orderisActive=1 - id - Nesse exemplo, serão retornados o campo "id" de perfis e em ordem descendenteos perfis da aplicação(sistema) "Id" que estão ativos.


Informações
iconfalse
title1.1.6 GetOne7 Filter by Application and Activation
Expandir
Informações
iconfalse
titleConfiguração

Máscara de Url: http http://{domínio}:{porta}/api/glbframework/v1/roles?fileldsapplication={{campo}códigoAplicação}&OrderisActive={{campo0|1}}

Image Removed
Informações
iconfalse
titleExemplo de Configuração

Domínio: localhost

Porta: 8051

Valor Campo Fieldsapplication:id G

Valor Campo OrderisActive:id 1

Url Utilizada: http://localhost:8051/api/glbframework/v1/roles?fieldsapplication=idG&order=-id

Informações
iconfalse
titleExemplo Postman

isActive=1

Informações
iconfalse
titleExemplo de Resultado
Expandir
titleVer resultado JSON...
Bloco de código
languagejs
firstline1
titleResultado (JSON)
linenumberstrue
{
    "hasNext": false,
    "items": [
        {
            "id": "Teste_Api"
        },
    "hasNext": false,
    "items": [
        {
            "id": "PerfilApiDBA_G",
        },
    "name": "Administrador DB (RM {BIS)"
        },
     "id": "Perfil1_G"
  {
      },
        {"id": "DP_G",
            "idname": "DP_GDepartamento Pessoal (RM BIS)"
        },
        {
            "id": "DBAPerfil1_G"
        },
        {
            "id"name": "Api_coligadaPerfil mestre (RM BIS)"
        }
    ]
}