...
|
---|
Bloco de código |
---|
theme | RDark |
---|
title | programa.p |
---|
| USING com.totvs.framework.sec.ProtectedData.
FIND FIRST tabela_negocio EXCLUSIVE-LOCK:
ASSIGN tabela_negocio.nom_cliente = ProtectedData:DefaultAnonymousCharacter
tabela_negocio.cod_rg = ProtectedData:DefaultAnonymousNumber
tabela_negocio.dat_nascimento = ProtectedData:DefaultAnonymousDate. |
|
03. getAnonymizableFieldsByDatabase
Objetivo
Responsável por retornar os campos ativos e passíveis de anonimização, filtrados por uma lista de bancos. São retornados os registros configurados em Gerenciamento dos campos pessoais e/ou sensíveis, não é realizada validação do Metaschema do banco de dados.
MESSAGE STRING(ProtectedData:DefaultAnonymousCharacter)
VIEW-AS ALERT-BOX INFO BUTTONS OK.
MESSAGE STRING(ProtectedData:DefaultAnonymousNumber)
VIEW-AS ALERT-BOX INFO BUTTONS OK.
MESSAGE STRING(ProtectedData:DefaultAnonymousDate)
VIEW-AS ALERT-BOX INFO BUTTONS OK.
|
|
03. isFieldAnonymizable
Objetivo
Responsável por retornar se o campo é anonimizável ou não.Para verificação do campo com validações de consistência no Metaschema do banco de dados utilize o método 06. isFieldAnonymizable.
Parâmetros de entrada
JsonArray | O valor de entrada é um objeto do tipo JsonArray
Bloco de código |
---|
|
[
{
"databaseName":"emsfnd"
},
{
"databaseName":"emsfnd2"
}
] |
CHARACTER | databaseName: Nome do banco de dados; |
CHARACTER | tableName: Nome da tabela. |
CHARACTER | fieldName: Nome do campo; |
databaseName: Nome do banco de dados.
Retorno
JsonArrayFormato de retorno é do tipo JsonArray.O agrupamento dos registros será por banco.O retorno será VERDADEIRO/FALSO, podendo retornar erro que deve ser capturado utilizando a declaração do 'CATCH'. |
O erros serão lançados por meio da classe fwk.utils.CustomError |
Caso não exista registro para o banco informado, será retornado o objeto anonymizableFields sem registroscollapse | true"databaseName": "emsfnd",
anonymizableFields[{
"tableName"tabela_teste"fieldNamecampo_teste",
"defaultRecord": trueCampo pessoal não cadastrado(a)",
" |
|
|
sensitiveFieldtruedocumentTypeId1documentTypeDesCPFCampo pessoal não cadastrado(a).",
" |
|
|
classifiers[ Expandir |
---|
| Será lançado ao informar parâmetros de entrada de um campo inexistente no banco de dados. |
|
id defaultRelationtrue justificativeJustificativa do Campo descriptionExecução de Contrato"
}
]
} ]
},
{
"databaseNameemsfnd2"anonymizableFields": []
}
]Exemplo de programa |
---|
Bloco de código |
---|
theme | RDark |
---|
title | programa.p |
---|
collapse | true |
---|
|
USINGProgress.Json.ObjectModel.*.
USINGcom.totvs.framework.sec.ProtectedData.
DEFINE VARIABLE jObjRequest AS JsonObject NO-UNDO.
DEFINE VARIABLE jArrRequest AS JsonArray NO-UNDO.
DEFINE VARIABLE jArrResponse AS JsonArray NO-UNDO.
jArrRequest = NEW JsonArray().
jObjRequest = NEW JsonObject().
jObjRequest:ADD("databaseName","emsfnd").
jArrRequest:ADD(jObjRequest).
jObjRequest = NEW JsonObject().
jObjRequest:ADD("databaseName","emsfnd2").
jArrRequest:ADD(jObjRequest).
jArrResponse = ProtectedData:getAnonymizableFieldsByDatabase(jArrRequest).
jArrResponse:WriteFile("c:\temp\resultado.json", TRUE). 04. getAnonymizableFieldsByTable
Objetivo
...
"ErrorHelp": "Verifique se existe uma ocorrência para o(a) Campo informado(a) em seu cadastro.",
"ErrorSubType": "ERROR"
}
] |
|
|
...
Tipo | Descrição |
---|
JsonArray | O valor de entrada é um objeto do tipo JsonArray
Para verificação do campo com validações de consistência no Metaschema do banco de dados utilize o método 06. isFieldAnonymizable.
Parâmetros de entrada
collapse | true databaseName"emsfnd"tableName"tabela_teste"
}{
"databaseName":"emsfnd2"
"tableName":"tabela_teste"
}
]databaseName: Nome do banco de dados.
tableName: Nome da tabela.
Retorno
Tipo | Descrição |
---|
JsonArray | - Formato de retorno é do tipo JsonArray.
- O agrupamento dos registros será por banco e tabela.
- Caso não exista registro para o banco e tabela informado, será retornado o objeto anonymizableFields sem registros.
Bloco de código |
---|
|
[
{
"databaseName": "emsfnd",
"ErrorDescription": "Campo pessoal está desativado(a).",
" |
|
|
tableNametabela_teste"anonymizableFields":[
{
"fieldNamecampo_testedefaultRecordtrue,
sensitiveField: truedocumentTypeId 1,
"documentTypeDes": "CPF", "classifiers": [
Expandir |
---|
| Será lançado ao informar parâmetros de entrada nulos ou vazios. |
|
id defaultRelationtrue justificativeJustificativa do Campo descriptionExecução de Contrato }
]
}
]
},
{
databaseNameemsfnd2
"tableName": "tabela_teste",
"anonymizableFields": []
}
]Exemplo de programa |
---|
Bloco de código |
---|
theme | RDark |
---|
title | programa.p |
---|
collapse | true |
---|
|
USING Progress.Json.ObjectModel.*.
USING com.totvs.framework.sec.ProtectedData.
DEFINE VARIABLE jObjRequestASJsonObjectNO-UNDO.
DEFINEVARIABLEjArrRequestAS JsonArray NO-UNDO.
DEFINE VARIABLE jArrResponse AS JsonArray NO-UNDO.
jArrRequest = NEW JsonArray().
jObjRequest = NEW JsonObject().
jObjRequest:ADD("databaseName","emsfnd").
jObjRequest:ADD("tableName","tabela_teste").
jArrRequest:ADD(jObjRequest).
jObjRequest = NEW JsonObject().
jObjRequest:ADD("databaseName","emsfnd2").
jObjRequest:ADD("tableName","tabela_teste").
jArrRequest:ADD(jObjRequest).
jArrResponse = ProtectedData:getAnonymizableFieldsByTable(jArrRequest).
jArrResponse:WriteFile("c:\temp\resultado.json", TRUE).05. getAnonymizableFieldsByRoutine
Objetivo
Responsável por retornar os campos ativos e passíveis de anonimização, filtrados por uma lista de rotinas.
São retornados os registros configurados em Gerenciamento dos campos pessoais e/ou sensíveis e que estejam relacionados aos programas do Datasul por meio da funcionalidade Relacionamento das rotinas com campos pessoais e/ou sensíveis, não é realizada validação do Metaschema do banco de dados.
Para verificação do campo com validações de consistência no Metaschema do banco de dados utilize o método 06. isFieldAnonymizable.
Parâmetros de entrada
...
Tipo
...
Descrição
...
O valor de entrada é um objeto do tipo JsonArray, contendo códigos do programas.
Bloco de código |
---|
|
["programa_teste","programa_teste2"] |
"ErrorSubType": "ERROR"
}
] |
|
Expandir |
---|
| Será lançado ao informar parâmetros de entrada de um campo pessoal anonimizável que faz parte de um índice único |
|
Retorno
Tipo | Descrição |
---|
JsonArray | Formato de retorno é do tipo JsonArray.O agrupamento dos registros será por código e nome do programa.Caso não exista registro relacionado com o programa, será retornado o objeto anonymizableFields sem registroscollapsetrue | programCode"programa_teste"programName"Programa de teste"anonymizableFields[{
"databaseName": "banco_teste",
"tabledName": "tabela_teste",
"Campo pessoal anonimizavel faz parte de um índice único",
|
|
|
fieldNamecampo_teste "defaultRecordtrue sensitiveFieldtrue,
"Campo pessoal configurado como anonimizavel faz parte de um índice único e não poderá ser |
|
|
"documentTypeId": 1 "documentTypeDesCPF, "classifiers": [{
Expandir |
---|
| Será lançado ao informar parâmetros de entrada de um campo pessoal anonimizável que é do tipo lógico. |
|
"id defaultRelationtrue "justificativeJustificativa do ",
pessoal anonimizavel é do |
|
|
"descriptionExecução de Contrato
}
]
}
]
}
{programCodeprograma_teste2programNameProgramade teste2",
"anonymizableFields": [{
"databaseName": "banco_teste2",
"tabledName": "tabela_teste2",
pessoal configurado como anonimizavel é do tipo lógico e não poderá ser anonimizado.",
|
|
|
fieldNamecampo_teste2, Expandir |
---|
| Será lançado ao informar parâmetros de entrada de um campo pessoal anonimizável que é do tipo blob. |
|
defaultRecordtrue sensitiveFieldtrue57269,
"ErrorDescription": "Campo pessoal anonimizavel é do tipo |
|
|
documentTypeId": 1 "documentTypeDesCPF classifiers [{
id: 1 "defaultRelationtrue,
"Campo pessoal configurado como anonimizavel é do tipo blob e não poderá |
|
|
"justificative": "Justificativa do Campo" "descriptionExecução de Contrato"
}
]
}
] Bloco de código |
---|
theme | RDarkExemplo de programa |
---|
Retorno
Tipo | Descrição |
---|
LOGICAL | O retorno será VERDADEIRO/FALSO, podendo retornar erro que deve ser capturado utilizando a declaração do 'CATCH'. |
O erros serão lançados por meio da classe fwk.utils.CustomError
Expandir |
---|
|
Este ERROR será lançado para os campos desativados em Gerenciamento dos campos pessoais e/ou sensíveis.
programa.p | collapse | true |
---|
USING Progress.Json.ObjectModel.*.
USING com.totvs.framework.sec.ProtectedData.
DEFINE VARIABLE jArrRequest AS JsonArray NO-UNDO.
DEFINE VARIABLE jArrResponse AS JsonArray NO-UNDO.
jArrRequest = NEW JsonArray().
jArrRequest:ADD("programa_teste").
jArrRequest:ADD("programa_teste2").
jArrResponse = ProtectedData:getAnonymizableFieldsByRoutine(jArrRequest).
jArrResponse:WriteFile("c:\temp\resultado.json", TRUE). |
06. isFieldAnonymizable
Objetivo
Responsável por retornar se o campo é anonimizável ou não.
Parâmetros de entrada
...
Tipo
...
Descrição
...
databaseName: Nome do banco de dados;
...
tableName: Nome da tabela;
...
fieldName: Nome do campo.
| Será lançado ao informar parâmetros de entrada de um campo pessoal anonimizável que é chave primária. |
|
Bloco de código |
---|
| [
{
"ErrorSequence": 1,
"ErrorNumber": |
|
|
109457360,
"ErrorDescription": "Campo pessoal anonimizavel é |
|
|
está desativado(a)chave primária.",
"ErrorParameters": " |
|
|
Campo pessoal",
"ErrorType": "ERROR",
"ErrorHelp": " |
|
|
\nCampo pessoal configurado como anonimizavel é chave primária e não poderá ser anonimizado.",
"ErrorSubType": "ERROR"
}
] |
|
|
Exemplo de programa |
---|
Bloco de código |
---|
theme | RDark |
---|
title | programa.p |
---|
collapse | true |
---|
| USING com.totvs.framework.sec.ProtectedData.
DEFINE VARIABLE lReturn AS LOGICAL NO-UNDO.
DO ON ERROR UNDO, LEAVE:
ASSIGN lReturn = ProtectedData:isFieldAnonymizable (INPUT "emsfnd", INPUT "tabela_teste", INPUT "campo_teste").
MESSAGE lReturn VIEW-AS ALERT-BOX INFORMATION BUTTONS OK.
CATCH customError AS fwk.utils.CustomError:
MESSAGE STRING(customError:arryaOfErrors:getJsonText()) VIEW-AS ALERT-BOX INFO BUTTONS OK.
END CATCH.
END. |
|
...