Histórico da Página

Requisito

Nenhum.

Descrição

Repassa o parâmetro do tipo de evento recebido pela API de comunicação (cdp/supplyDocuments) para a API de documentos (hubapi/apiDocuments) chamando o método pi-metadata-v1. Existem duas apis de comunicação:

• cdp/api/v1/supplyDocuments  : api que envia os eventos "list" ou "edit".
• cdp/api/v1

• /supplyDocumentsView: api que envia o evento "view".

Retorna o metadados com os campos e ações ativos referentes a tela de Listagem (list), Consulta (view) ou Edição (edit), dependendo de qual tipo foi enviado pela requisição, para a montagem dinâmica da tabela tela com as informações vindas do backend.

Parâmetros

Tipo

Descrição

oInput

JsonObject

  {
    "keepfiltersliterals": false,
    "literals": {{},
    "validateFields": [],
    "title": "DocumentosAnexos de documentos",
    "fields": [
        {
            "visible": false,
            "property": "documentId",
            "label": "Código",
            "type": "number",
            "key": true,
            "order": 1
        },
        {
            "propertyvisible": "processTypeDescription"false,
            "widthproperty": "15%processType",
            "labeloptions": [
  "Tipo Processo",
            "type": "string", {
            "order": 2
        }"label": "Ordem de Compra",
        {
            "propertyvalue": "processKey",1
            "width": "15%",
   },
         "label": "Chave Processo",
     {
        "type            "label": "stringCotação de Materiais",
            "order        "value": 32
        },
        {}
            "property": "documentName"],
            "widthlabel": "20%Tipo Processo",
            "labeltype": "Documentolabel",
            "typeorder": "string"2,
            "orderlabels": 4[
        },
        {
            "property": "documentSize",
            "widthlabel": "5%Ordem de Compra",
            "label": "Tamanho",
            "typevalue": "string",
1
               "order": 5 },
        },
        {
            "property": "documentDescription",
            "widthlabel": "25%Cotação de Materiais",
            "label": "Descrição",
            "typevalue": "string",2
            "order": 6    }
        }
    ],
      "tableCustomActions": []  },
     "actions":   {
            "newvisible": "/new"false,
            "removeAllproperty": true"processKey",
            "removelabel": true
 "Chave Processo",
       },
     "pageCustomActionstype": []
}                                                                                 

  {
    "defaultFields": [
        {"string",
            "order": 3
        },
        {
            "property": "documentName",
            "width": "20%",
            "label": "Documento",
            "type": "string",
            "order": 4
        },
        {
            "property": "documentSize",
            "width": "10%",
            "label": "Tamanho",
            "type": "string",
            "order": 5
        },
        {
            "property": "documentDescription",
            "width": "30%",
            "label": "Descrição",
            "type": "string",
            "gridColumnsorder": 46
        },
        {
            "dividervisible": "Processo"false,
            "labelallowColumnsManager": "Tipo Processo"true,
            "property": "processTypecreationUser",
            "disabledwidth": true"5%",
            "optionslabel": ["Criador",
                {"type": "string",
            "order": 7
       "value": 1},
        {
            "labelvisible": "Ordem de Compra"false,
                }"allowColumnsManager": true,
            ]
        }"property": "creationUserName",
        {
            "gridColumnswidth": 4"15%",
            "label": "ChaveNome Criador",
            "propertytype": "processKeystring",
            "disabledorder": true8
        },
        {
            "autoUploadvisible": truefalse,
            "gridColumnsallowColumnsManager": 4true,
            "dividerproperty": "Anexar DocumentocreationDatetime",
            "labelwidth": "Selecione o documento20%",
            "propertylabel": "documentUploadData",
            "requiredtype": true"dateTime",
            "typeorder": "upload"9
        },
        {],
            "maxLength"tableCustomActions": 200[],
            "gridColumns"actions": 4,{
            "labelnew": "Descrição/new",
            "propertyremoveAll": "documentDescription"true,
            "rowsremove": 4true
        }
    ],
    "titlepageCustomActions": "Novo Documento",
    "breadcrumb": {
        "items": [
            {
                "link": "/",
                "label": "Documentos"
            },
            {
                "link": "/new",
                "label": "Novo Documento"[]
}                                                                      

  {
    "defaultFields": [
        {
            "gridColumns": 4,
            "divider": "Processo",
            "label": "Tipo Processo",
            "property": "processType",
            "disabled": true,
            "options": [
                {
                    "value": 1,
                    "label": "Ordem de Compra"
                }
            ]
        },
        {
            "gridColumns": 4,
            "label": "Chave",
            "property": "processKey",
            "disabled": true
        },
        {
            "autoUpload": true,
            "gridColumns": 4,
            "divider": "Anexar Documento",
            "label": "Selecione o documento",
            "property": "documentUpload",
            "required": true,
            "type": "upload"
        },
        {
            "maxLength": 200,
            "gridColumns": 8,
            "label": "Descrição",
            "property": "documentDescription",
            "rows": 4
        }
    ],
    "title": "Novo anexo",
    "breadcrumb": {
        "items": [
            {
                "link": "/",
                "label": "Anexos de documentos"
            },
            {
                "link": "/new",
                "label": "Novo anexo"
            }
        ]
    }
}                                                                              

• Metadados View:

{
    "keepfilters": false,
    "literals": {},
    "validateFields": [],
    "title": "Consulta de Anexos de Documentos",
    "fields": [
        {
            "visible": false,
            "property": "documentId",
            "label": "Código",
            "type": "number",
            "key": true,
            "order": 1
        },
        {
            "property": "processTypeDescription",
            "width": "15%",
            "label": "Tipo Processo",
            "type": "string",
            "order": 2
        },
        {
            "property": "processKey",
            "width": "15%",
            "label": "Chave Processo",
            "type": "string",
            "order": 3
        },
        {
            "property": "documentName",
            "width": "20%",
            "label": "Documento",
            "type": "string",
            "order": 4
        },
        {
            "property": "documentSize",
            "width": "10%",
            "label": "Tamanho",
            "type": "string",
            "order": 5
        },
        {
            "property": "documentDescription",
            "width": "35%",
            "label": "Descrição",
            "type": "string",
            "order": 6
        },
        {
            "visible": false,
            "allowColumnsManager": true,
            "property": "creationUser",
            "width": "5%",
            "label": "Criador",
            "type": "string",
            "order": 7
        },
        {
            "visible": false,
            "property": "creationUserName",
            "width": "20%",
            "label": "Nome Criador",
            "type": "string",
            "order": 8
        },
        

{
            

"visible": false,
            "allowColumnsManager": true,
            "property": "creationDatetime",
            "width": "15%",
            "label": "Data",
            "type": "dateTime",
            "order": 9
        }
    ],
    "tableCustomActions": [],
    "pageCustomActions": []
}

Possui os mesmos campos de retorno do metadados "List", sendo que a diferença é que se trata de uma tela de Consulta apenas, então, neste caso, não estão disponíveis as ações ("actions" no json), ou seja, os botões "Novo" e "Excluir" não são carregados na tela.

A requisição é igual ao do metadados List (passando no queryparams o type = list) da api supplyDocuments, apenas alterando a api de origem que é a supplyDocumentsView. No método pi-metadata da supplyDocumentsView é feito o tratamento onde, ao receber o tipo "list" ele envia o tipo "view" para a apiDocuments fazer o tratamento e omitir os campos referente as ações da tela e exibe seu respectivo título da página

.

Retorno

Retorna informações do metadados ou erros ocorridos durante a busca

Requisito

Nenhum.

Descrição

Repassa

o parâmetro do tipo de evento recebido pela API de comunicação

para a API de documentos (hubapi/apiDocuments)

chamando o método pi-query-v1. Existem duas apis de comunicação:

• cdp/api/v1/supplyDocuments  : api de comunicação para a tela de anexos com as opções de criar/excluir documentos.
• cdp/api/v1/supplyDocumentsView: api de comunicação para a tela de anexos de consulta apenas, onde somente é permitido o download dos documentos.

Retorna a lista de anexos relacionados a um documento.

Parâmetros

Tipo

Descrição

oInput

JsonObject

queryParams: →

•   processType

• : Tipo do processo vinculado ao documento, sendo "1" a Ordem de Compra, com base na include uninc/i01un403.i.

•   processKey

• : Código da chave do processo, identifica o processo ao qual o anexo pertence. A chave pode ou não ser composta. Caso seja, será separada por pipe "|" e deve ser enviada no formato encode. No exemplo abaixo, a chave "1234%7CABC" está no formato encode e corresponde a chave composta: "1234|ABC".

{
    "queryParams": {
       "processType": "1",
       "processKey": "1234%7CABC"
  }
}

Outros parâmetros que podem ser usados em conjunto com os queryParams de consulta dos anexos:

• search: pesquisa por campos. Os parâmetros são os mesmos utilizados na queryParams de busca, sendo apenas adicionando o "search" na requisição juntamente com o critério de filtro que pode ser: nome do anexo, descrição do anexo ou usuário criador. No exemplo abaixo está sendo solicitada uma consulta utilizando  um filtro para mostrar apenas os documentos anexados pelo usuário "super".

{
    "queryParams": {
       "processType": "1",
       "processKey": "1234%7CABC",
	   "search":"super"	
  }
}
       "processKey": "1234%7CABC",
	   "search":"super"	
  }
}

• order: Ordenação dos campos, podendo ser ascendente ou descendente ("-" sinal negativo).
  • Exemplo:
    • ordem por data ascendente: order=-createDatetime.
    • ordem por data descendente: order=-createDatetime.

• pageSize: Tamanho da página (número de registros retornados). Se não informado será considerado: 10.

Retorno

 Retorna a lista de arquivos relacionados a um documento ou erros ocorridos durante a busca.

Requisito

Nenhum.

Descrição

Repassa os parâmetros recebidos pela API de comunicação (cdpcdp/api/v1/supplyDocuments) para a API de documentos (hubapi/apiDocuments) chamando o método pi-upload-v1.

Retorna informações do arquivo em que o upload está sendo efetuado.

Parâmetros

Tipo

Descrição

oInput

JsonObject

Retorno

Retorna informações do nome do arquivo e seu conteúdo em base64 ou erros ocorridos durante o processo.

Requisito

Nenhum.

Descrição

Repassa os parâmetros recebidos pela API de comunicação (cdp/supplyDocuments) para a API de documentos (hubapi/apiDocuments) chamando o método pi-download-download-v1. Também realiza validações de restrição dos usuários em relação a menu e processosv1. Também realiza validações de restrição dos usuários em relação a menu e processos. Existem duas apis de comunicação:

• cdp/api/v1/supplyDocuments  : api de comunicação para a tela de anexos com as opções de criar/excluir documentos.
• cdp/api/v1/supplyDocumentsView: api de comunicação para a tela de anexos de consulta apenas, onde somente é permitido o download dos documentos.

Retorna informações do arquivo em que o download está sendo efetuado.

Parâmetros

Tipo

Descrição

oInput

JsonObject

Retorno

Retorna informações de nome e conteúdo do anexo que está sendo feito download ou erros ocorridos durante o processo.

Requisito

Nenhum.

Descrição

Repassa os parâmetros recebidos pela API de comunicação (cdp/api/v1/supplyDocuments) para a API de documentos (hubapi/apiDocuments) chamando o método pi-delete-v1. Também realiza validações de restrição dos usuários em relação a menu e processos.

Retorna informações relacionadas a exclusão dos anexos.

Parâmetros

Tipo

Descrição

oInput

JsonObject

{
    "pathParams": [
       "1234"
    ],
}

Parâmetros para eliminação de anexo em lote:

Payload: Informar os IDs a relação dos documentId's a serem eliminados:

[
   {"documentId": 552, 
   {"documentId": 553},
   {"documentId": 554}
]

• Caso haja erro na tentativa de excluir um único registro inexistente, serão repassados para a API de comunicação (cdp/api/v1/supplyDocuments) valores na temp-table RowErrors para montagem e retorno do objeto Json. Exemplo do modelo da mensagem utilizando o registro 553:

{
  "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 553.\n",
  "code": "57401",
  "message": "Registro não encontrado.",
  "type": "error"
}

• Caso haja erro na tentativa exclusão de excluir todos os registros inexistentes em lote, serão repassados para a API de comunicação (cdp/api/v1/supplyDocuments) valores na temp-table RowErrors para montagem e retorno do objeto Json. A api cdp/api/v1/supplyDocuments retorna o código 404 exibindo as mensagens de erros enviadas. Exemplo do modelo da mensagem utilizando os registros 552, 553 e 554:

{
    "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 552.\n",
    "code": "57401",
    "details": [
        {
            "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 553.\n",
            "code": "57401",
            "message": "Registro não encontrado.",
            "type": "error"
        },
        {
            "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 554.\n",
            "code": "57401",
            "message": "Registro não encontrado.",
            "type": "error"
        }
    ],
    "message": "Registro não encontrado.",
    "type": "error"
}

• Caso haja erro na eliminação de registros juntamente com sucesso na exclusão de registros em lote, serão repassados para a API de comunicação (cdp/api/v1/supplyDocuments) valores na temp-table RowErrors para montagem e retorno do objeto Json. Exemplo do modelo da mensagem utilizando os registros 637, 404 e 554:

{
    "_messages": [
        {
            "detailedMessage": "Registro não encontrado na tabela anexo_docto - Id: 554.\n",
            "code": 57401,
            "type": "error",
            "message": "Registro não encontrado."
        }
    ],
    "idList": "404,637"
}

Para verificar o que significa cada campo, conferir nas temp-tables no final desta documentação:

• RowErrors: Contém os erros e informações sobre os erros ocorridos durante o processo.
• Outros campos retornado no Json: 
  • detailedMessage: Mensagem detalhada do erro ocorrido.
  • code: Número do código do erro ocorrido.
  • message: Mensagem simplificada do erro.
  • type: Tipo da mensagem.
  • idList: Lista de IDs eliminados com sucesso em uma exclusão em lote com erros.