Mapeando o nome social na Totvs Carol

 

Um garoto sentado em frente às telas e botões de um computador robótico

🤖🤖🤖

Eis mais um dos meus memorandos técnicos. Ele é indicado para quem já está familiarizado com o meio; no caso com o ERP Protheus e com a plataforma Totvs Carol. Nós usamos aqui na empresa a plataforma Totvs Carol por causa do "Clock in", um sistema que permite o registro do ponto dos funcionários via app no celular ou tablet. Com essas ferramentas é realizado o registro de ponto através de reconhecimento facial.


Caso você não tenha familiaridade com essas plataformas, seus termos e não tenha acesso à mesma para editar a configuração, contate a equipe técnica responsável (ao persistir os sintomas procure um médico... kkk, brincadeira).

Enfim, vamos ao memorando: Vou fazer um lembrete de como alterar o mapeamento de campos na plataforma Totvs Carol; neste caso em específico para exibir o nome social (campo RA_NSOCIAL) ao invés do nome (RA_NOME), quando o primeiro não está vazio (esta foi uma solicitação do RH daqui da empresa, para atender aos funcionários que usam o nome social em lugar do seu nome de registro).

Primeiramente, acesse a plataforma Carol e, no menu à esquerda, passe o mouse sobre a opção Connectors. Após o menu se expandir, escolha a opção TOTVS Protheus (conforme imagem abaixo).

Tela do passo a passo do tutorial


Em seguida, você deve escolher as tabelas desejadas para alterar o mapeamento dos campos.
No meu caso, em que quero alterar o mapeamento do campo nome, devo escolher duas tabelas: sra_employee e sra_user.

Vou começar com a tabel sra_employee. Após passar o mouse sobre o nome da tabela, é só clicar no botão Map para editar o mapeamento.


Tela do passo a passo do tutorial


Na sequência, é só buscar pelo campo desejado. No meu caso é o campo nome (exibido como Name). Após localizar o campo, é só passar o mouse sobre o mesmo e depois clicar no botão de edição (que possui, na atual versão da plataforma, a aparência de um lápis). Segue abaixo o print:


Tela do passo a passo do tutorial


Em seguida você pode criar o mapeamento desejado. No meu caso, vou editar o mapeamento de modo que quando o campo RA_NSOCIAL estiver preenchido, a plataforma escolha o mesmo ao invés do campo RA_NOME, porém caso o campo RA_NSOCIAL esteja vazio, a plataforma escolherá o campo RA_NOME.

Vamos por partes. No meu caso a configuração já está feita. Mas vamos fingir que não e começar excluindo a configuração que está lá (conforme o print abaixo):

Tela do passo a passo do tutorial

Após passar o Mouse pelo nome da regra (no exemplo acima a regra numero 1), aparece um botão no formato de uma pequena lixeira. Clicando na lixeira a regra é eliminada.

Após excluir todas as regras, teremos apenas um botão de mais para incluir as regras que desejamos (conforme o print):


Tela do passo a passo do tutorial


Além disso, para iniciar o mapeamento, devemos nos certificar de que os campos do banco de dados desejados estejam selecionados na linha "Select one or more sources".
Para remover os campos que já estão nesta linha (caso não sejam desejados) é só clicar no "x" que há em cada um deles (conforme o print abaixo):

Tela do passo a passo do tutorial

No meu caso estes campos estão corretos. Porém vou excluir os mesmos apenas para demonstrar como vai ficar e depois como incluímos esses campos (processo bem simples).

Após apagar tudo (regras e campos) teremos uma tela completamente vazia para o mapeamento do campo Name (confore print abaixo):

Tela do passo a passo do tutorial


Agora que está tudo vazio, vamos começar.

Primeiramente vamos escolher os campos desejados em "Select one or more Sources". Para isso, basta clicar na linha e digitar o nome do campo e, após o mesmo aparecer em uma lista suspensa, é só clicar sobre ele (conforme o print abaixo):

Tela do passo a passo do tutorial


Os campos que desejamos escolher são RA_NOME e RA_NSOCIAL. Após escolher a ambos e clicar neles, a tela ficará assim:
Tela do passo a passo do tutorial


Agora é hora de começar a cadastrar as regras desejadas.
Primeiro vamos criar uma regra que deixa o conteúdo dos campos com letra maiscula. Essa é na verdade a segunda regra, mas vamos inseri-la primeiro para explicar como arrastar as regras a fim de mudar sua ordem.

Para simplificar: primeiro use a regra captalize, depois a regra função javascript, depois arraste a regra captalize para segunda posição. Caso você já queira deixar as coisas na ordem certa, insera primeiro a função JavaScript e depois a função Captalize.

Vamos por partes. Primeiro, vamos clicar no sinal de mais para inserir uma regra.
Tela do passo a passo do tutorial


Na sequência vamos escolher a opção Capitalize text.

Tela do passo a passo do tutorial

Incluindo a regra captalize, teremos o seguinte resultado:

Tela do passo a passo do tutorial


Devemos clicar na linha que está em vermelho (Variable) e escolher qual informação desejamos deixar Captalizado (ou seja, qual variável possui o texto que queremos deixar com a primeira letra Maiúscula). Porém, isso não vai ser possível agora, visto que não queremos deixar nenhuma das variáveis atuais e sim a função que criaremos a seguir. No momento, só estão disponíveis os campos que escolhemos anteriormente (ra_nome e ra_nsocial):

Tela do passo a passo do tutorial


Ainda que você escolha um desses campos agora, não tem problema, pois você pode trocar depois.

Agora vamos para a próxima regra (que será a primeira depois de arrastarmos a mesma para a primeira posição). Essa regra é do tipo função em Java Script. Basta passar o mouse logo abaixo da regra numero 1 clicar no sinal de mais que vai aparecer (conforme o print a seguir):

Tela do passo a passo do tutorial


Note que se você não posicionar o mouse onde está a flexa vermelha no print anterior, o sinal de mais desaparece.

Após clicar no sinal, você deverá digitar o nome do tipo de regra desejado, no meu caso é Generic JavaScript:

Tela do passo a passo do tutorial


Após isso a tela ficará conforme o print abaixo, com um bloco de código que poderemos editar. Mas antes, vamos clicar nos pontinhos que aparecem do lado esquerdo do numero da regra e vamos arrastar para deixar cada regra na devida ordem, ou seja, a função JavaScript deverá ir para cima, onde passará a ser a regra numero 1.


Tela do passo a passo do tutorial


Feito isso, poderemos clicar no campo "Function" e dar um nome para a função JavaScript que vamos criar. No meu caso vou chamar de NomeSocial e depois, no campo "to" vou digitar o mesmo nome, ou seja "NomeSocial". Feito isso, ficara conforme o print abaixo:


Tela do passo a passo do tutorial


Notem no print acima que a regra 1 agora é a função JavaScript, que já está com o nome que eu digitei "NomeSocial".

Agora vamos criar a função propriamente dita, para isso basta clicar na linha 2 e começar a digitar. No meu caso, depois de pronta, a função ficará conforme abaixo:

function NomeSocial() {
if (ra_nsocial != "") // verifica se o campo ra_nsocial é diferente de vazio, isto é, o campo é sim preenchido com alguma informação
return ra_nsocial // Caso seja verdade que o campo ra_nsocial é diferente de vazio, a função retorna o conteúdo do próprio campo ra_nsocial
else
return ra_nome //Mas, se não for verdade que o campo ra_nsocial é vazio, é retornado o conteúdo do campo ra_nome
}

//Desse modo, a plataforma Totvs Carol irá exibir o Nome Social do colaborador sempre que esse campo ra_nsocial for preenchido na tabela SRA. Quando esse campo não estiver preenchido, então a plataforma exibirá o nome informado no campo de costume, isso é: ra_nome.
Podemos ver como ficou no print abaixo:


Tela do passo a passo do tutorial


Agora, por fim, podemos clicar no campo Variable da regra numero 2 (que está destacado em vermelho, indicando que ainda está vazio) e escolher a variável desejada. No caso, vamos escolher a função NomeSocial, ao invés de uma variável, de modo que o retorno dessa função, seja qual for, é que será capitalizado.


Tela do passo a passo do tutorial


Após feita essa configuração, a nossa regra ficará conforme abaixo:


Tela do passo a passo do tutorial


Mas a função ainda não está pronta. Precisamos indicar para ela a existencia das variáveis ra_nsocial e ra_nome. Para isso, precisamos clicar no botão de mais ao lado do nome da função e incluir esses campos lá, de modo que eles passem a ser parâmetros disponíveis para a função.

Tela do passo a passo do tutorial



Clicando no sinal de mais, os campos que podemos adicionar como parâmetros da função apareceram em uma lista suspensa (conforme o print abaixo):


Tela do passo a passo do tutorial


Agora sim a nossa função está completa:


Tela do passo a passo do tutorial


Por fim, podemos subir a barra de rolagem e clicar no botão "Save & Test" caso desejamos testar o mapeamento realizado. E, após isso, devemos clicar no botão "Back to mapping summary" para publicar o mapeamento na plataforma, de modo que esse mapeamento passe a ser realizado de fato pela plataforma Totvs Carol.


Tela do passo a passo do tutorial


Clicando no botão Save & Test, será exibida uma janela para testarmos o funcionamento da regra. Conforme o print abaixo, veja que preenchendo o campo RA_NOME e deixando o campo RA_NSOCIAL, a plataforma identifica que deve exibir o conteúdo do campo RA_NOME com a primeira letra em maiúsculo:


Tela do passo a passo do tutorial


Agora, se preenchermos o campo ra_nsocial e clicarmos no botão rocho para testar, veremos que conforme a regra criada, será exibido o nome social com a primeira letra em maiúsculo (no caso do exmeplo abaixo o nome Silva será exibido).


Tela do passo a passo do tutorial


Após os testes serem realizados, é só fechar a janela de teste (conforme o print acima) e depois publicar a regra. Para publicar, clique no botão "Back to mapping summary" e depois em "Publish" conforme o print abaixo:


Tela do passo a passo do tutorial


A plataforma irá questionar se você deseja mesmo publicar a regra conforme o próximo print. Clique em "Confirm" e a regra será enfim publicada.


Tela do passo a passo do tutorial


Finalizo dizendo que eu já havia realizado esse mapeamento, mas a plataforma Totvs Carol tem o péssimo hábito de sumir com o mapeamento customizado quando recebe atualizações. Irei registrar um chamado junto a Totvs para saber o que é possível fazer para evitar que isso ocorra no futuro.

Comentários

Minha foto
Éder S.P.V. Gonçalves
Osasco, SP, Brazil
É um ficcionista trevoso; escreve poema, romance e também conto. Mescla tom sério com humor ao falar sobre fantasia, mistério e terror. Mantém um blog onde posta textos por vezes sombrios e temperados com ácido humor.

Postagens mais visitadas deste blog

O Tigre, de William Blake

Filtrando pelo campo TSK_STATUS

Carmilla: a vampira de Karnstein

Hajime no Ippo e o Espírito de Desafiante

Como configurar os níveis de aprovação no app Meu RH da Totvs?

Drácula: é capaz de controlar os lobos?

Ticê: a feiticeira que se tornou a deusa do submundo

Sea Of Thieves: Skin do Kraken Tinto

Testando o MidJourney para criar uma capa para a Rua dos Anhangás

Nomes de gatos pretos: inspirações da literatura fantástica

📮 Formulário de contato

Nome

E-mail *

Mensagem *

👁‍🗨 MARCADORES

Curiosidades Leituras crônicas de escritor crônicas de um autor independente O Conde de Monte Cristo Alexandre Dumas filosofia Livros Entretenimento espada e feitiçaria Poemas Memorandos a rua dos anhangás histórias de mistério histórias de terror vampiros Fantasia Sombria folclore literatura gótica Caravana Sombria Contos halloween dicas diário Os Demônios de Ergatan histórias de fantasma lobisomens Bram Stoker Oitocentos Aromas de Devaneio PODCASTS escrita games histórias de aventura sagas Drácula O Leão de Aeris Psicotrápolas lendas lendas urbanas Histórias Sobrenaturais de Rudyard Kipling O Governador das Masmorras Rudyard Kipling Via Sombria conan exiles critica social kettlebell lua cheia micro contos natal sociedade Atividade Física Conan o Bárbaro Exercícios de Criatividade O Ventre de Pedra arqueologia feriado girevoy sport gyria inteligência artificial krampus krampusnacht masmorras paganismo papai noel séries xbox Robert Ervin Howard estrela negra folclore guarani ia liberdade melkor mitologia morte resenha séries de tv Capas Desenvolvimento de Jogos Ilustrações Os Segredos dos Suna Mandís Passeios Space Punkers cultura pagã era hiboriana game designer harpia histórias de horror histórias góticas hq humanidade personagens poema gótico política prisão quadrinhos As Aventuras do Caça-Feitiço Conto Diana Haruki Murakami História J.R.R.Tolkien Joseph Delaney O DIÁRIO DE IZZI Romancista como vocação Sandman V de Vingança Vampiros na literatura Wana anhangás animes aranhas arquivo umbra arte bruxas chatgpt criação de histórias cultura gótica estações do ano facismo fanfic fantasmas festividades gatos pretos godot jogos jurupari mangá mitologia brasileira netflix outono paródia protheus sexta-feira 13 superstições totvs vida vingança A Fênix na Espada Café Holístico Carmilla: a vampira de Karnstein Cristianismo Joseph Conrad Joseph Sheridan Le Fanu O Coração das Trevas O Homem Sem Memória O Mentalista Terry Pratchett age of war animes de esporte anotações bruxaria cadernos capa castlevania ceticismo conto de terror cotia crenças criatividade culto aos mortos demônios dia de todos os santos diabo drama educação engines evernote fantasia farmer walk ficção ciêntifica ficção fantástica folclore indígena fotografias funcom hajime no ippo horror cósmico indicação de séries inverno leitores listas lobos lua azul matrix megafauna mitologia indígena natureza notion objetos amaldiçoados opinião palácio da memória podcast ratos reforma sea of thieves sinopse templo zu lai tigre tutoriais utilidades viagem no tempo vila do mirante vlad tepes wicca Áudio-Drama A Arte da Guerra A Balada dos Dogmas Ancestrais A Cidade dos Sete Planetas A Sede do Viajante A Voz no Broche Age Of Sorcery Anne Rice Arthur C. Clarke As Sombras do Mal Bad and Crazy Barad-dûr Berkely Blog Breve encontro com Dracooh de Beltraam Bushido Canto Mordaz Carta Para um Sábio Engenheiro Cartas Chuck Hogan Daniel Handler Direitos Iguais Rituais Iguais Discworld Divulgação Doctor Who Eiji Yoshikawa Elizabeth Kostova Elric de Melniboné Entrevista com o Vampiro Full Metal Alchemist Gaston Leroux Genghis Khan Grande A'Tuin Guillermo Del Toro Hoje é Sexta-Feira 13 e a Lua está Cheia Johann Wolfgang von Goethe Joseph Smith Katana Zero Lemony Snicket Lestat de Lioncourt Lord Byron Lord Ruthven Louis de Pointe du Lac Mapinguari Michael Moorcock Michelly Mordor Musashi Na Casa de Suddhoo Na toca dos ratos letrados Nergal Novela O Escrínio de Pooree O Fabuloso Maurício e seus Roedores Letrados O Historiador O Hobbit O Jirinquixá Fantasma O Lobo O Lobo das Planícies O Mar O Mundo de Sofia O Ogro Montês O Primeiro Rato Letrado O Rei de Amarelo O Senhor dos Anéis O Sexo Invisível O Sonho de Duncan Parrennes O Tigre O Tigre e o Pescador Obras das minhas filhas Olga Soffer Os Incautos Os Livros da Selva Os Ratos Letrados Outono o Gênioso Oz Oz City Pedra do Teletransporte Polo Noel Atan Red John Rei Ladrão & Lâmina Randômica Robert William Chambers Rotbranch Samhain Sarcosuchusimperator Sobre a Escrita Sociedade Blake Stephen King Stranger From Hell TI Tevildo Thomas Alva Edison Tik Tak Tomas Ward Vida e Morte Wassily Wassilyevich Kandinsky William Blake Wyna daqui a três estrelas Yoshihiro Togashi Yu Yu Hakusho absinto aho aho akemi aleijadinho algoritmos alienígenas aluguel amazônia amor anagramas andarilhos animais de estimação animação anime ano novo aranha marrom aranha suprema arquétipo astronomia atalho atitudes autopublicação azar balabolka baladas banho frio banho gelado bicicleta bienal do livro biografia blogger boxe bugs caderno de lugar comum calçados militares caminhos escuros carlos ruas carnaval carta do chefe Seatle casa nova casas mal assombradas castelos castelos medievais categorias cavaleiro da lua celebrações pagãs chalupa chonchu chrome cidadania cientista civilização ciência condessa G condomínio configuração consciência conto epistolar coragem cordilheira dos andes crianças criaturas lupinas crimes cultura brasileira cultura otaku cárcere cães dark rider democracia deusa da lua e da caça dia das crianças dia de finados dia do saci dia dos mortos distopias doramas ecologia el niño ema encantos esboços escuridão espada espírito de luta espíritos exoplanetas falta de energia elétrica feiticeiras feitiçaria feitiços felicidade felipe ferri fome fonte tipográfica fonógrafo fortuna fundação japão game pass gratidão greve gênero hitória homens humor hábitos saudáveis ia para geração de imagens idealismo identidade igualdade de gênero imaginação imaterialismo inquisição jaci jaterê japão japão feudal jogos 2d jogos de plataforma jornada kami kraken kraken tinto labirintos labirintos 2D lealdade leitor cabuloso lenda guarani leste leviathan licantropia linguagem de programação literatura inglesa live action livros infanto juvenis loop lua de morango lugares mal assombrados lógica de programação malaquias mandalas matemática mawé mazolata mboi-tui meio ambiente melancolia memorização mercado de trabalho meu rh microsoft midjourney mitologia grega mitra mizu moccoletto mochila modelo de linguagem modo escuro molossus monograma monstros montanha morgoth morpheus moto motoqueiro mudança mudanças climáticas mulheres mundos método wim hof músicas neil gaiman noite eterna nomes de gatos pretos nona arte nostalgia o que é vida objetos mágicos ogros oração os sete monstros osamu tezuka patriarcado pena pensamentos perpétuos pesadelos pescador piedade pluto pod cast poderes povo nômade predadores prefácio primavera primeiras impressões problemas profecia pterossauro publicação independente qualidade de vida quarta parede reclamação reflorestamento religião religião de zath rio Pinheiros rio Tietê robôs roda do ano roma antiga romantismo cósmico romênia sacerdotisas de zath samurai de olhos azuis sarcosuchus Imperator saturnalia saturnália saúde segredos seres fantásticos serpente-papagaio sexo frágil sintetizador de voz smilodon sobrevivencialismo solstício solstício de inverno solstício de verão sonhar sophia perennis sorte suna mandís sustentabilidade série de terror tau e kerana teclado telhado telhas de pvc templo de hachiman tempo teoria das cores terror texto em fala ticê tigre dente de sabre totvs carol transilvânia travessão treinamento treino trevas trickster tumba de gallaman tv título um sábado qualquer universidades van helsing varacolaci vendaval verão vida em condomínio vigília da nevasca windows wombo art xamanismo xintoísmo ymir yule zath zoonoses águia ódio
Mostrar mais