Serviço de Equipes
Serviço que permite internalizar a estrutura de equipes da sua organização.
Exportar Equipes - Exemplo de Implementação CSV
Para exportar o as equipes cadastradas no fSense no formato CSV, podemos fazer da seguinte maneira.
Configuração do Arquivo Properties.
Definição do Serviço
No arquivo fsense.properties, defina o serviço a ser executado ajustando a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para EXPORT_TEAMS através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=EXPORT_TEAMS
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Parâmetros de Exportação
É possível definir parâmetros opcionais na exportação de equipes como nome da equipe, código externo, identificador único. É possível definir através das respectivas propriedades team.name, team.external.code e team.id.
#PARÂMETROS PARA SERVIÇO DE BUSCA DE EQUIPES
#Exemplo:[Equipe Tecnologia da Informação]
team.name=
#Exemplo:[3b45fc4e-0ce6-42b5-acag-f35b6nmd0088]
team.external.code=
#PARÂMETRO PARA DEMAIS SERVIÇOES DE EQUIPES
#Exemplo:[4056]
team.id=
Execução da Aplicação
Após configurar o arquivo fsense.properties, execute a aplicação. A aplicação realizará requisições HTTP à API fSense para obter os dados de equipes e gerará um arquivo CSV como nome teams.csv.
======================================================
SELECTED SERVICE [TEAM_SERVICE]
======================================================
OPERATION TYPE: CSV
======================================================
SELECTED METHOD [EXPORT_TEAMS]
Export teams
checking if token is valid?: false
======================================================
Starting authentication process
Getting access token
Token received.
8255196a-cec5-4843-b1f4-ca7cd6e28de8
======================================================
AUTHENTICATION SUCCESS
======================================================
TEAM DATA
======================================================
Nº teams found: 5
Nº pages found: 1
======================================================
GENERATING CSV
======================================================
Generated file: teams.csv
Status: save successfully.
File saved in path: ./src/main/resources/files/export/teams.csv
======================================================
EXPORT TEAMS FINISHED SUCCESSFULLY
======================================================
Os arquivos são armazenados no diretório src/main/resources/files/export
Verificação da Operação
Após a execução da aplicação, abra o arquivo gerado para verificar as equipes exportadas. O arquivo exportado terá uma estrutura semelhante à do exemplo abaixo:
'id','name','workdayId','teamParentId','teamParentName'
'4079','Tecnologia da Informação','2657','',''
'5799','fSense DEV','','4077','Tecnologia da Informação'
'18187','Comercial','2544','',''
'18960','Service Desk','3407','',''
'19482','Recursos Humanos','2757','',''
Exportar Equipes - Exemplo de Implementação de Banco de Dados
Para exportar as equipes no fSense fazendo a persistência no banco de dados, podemos fazer da seguinte maneira.
Configuração do Arquivo Properties.
Definição do Serviço
No arquivo fsense.properties, defina o serviço a ser executado ajustando a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para EXPORT_TEAMS através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=EXPORT_TEAMS
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina DATABASE.
# TIPO DE OPERAÇÃO
operation.type=DATABASE
Parâmetros de Exportação
É possível definir parâmetros opcionais na exportação de equipes como nome da equipe, código externo, identificador único. É possível definir através das respectivas propriedades team.name, team.external.code e team.id.
#PARÂMETROS PARA SERVIÇO DE BUSCA DE EQUIPES
#Exemplo:[Equipe Tecnologia da Informação]
team.name=
#Exemplo:[3b45fc4e-0ce6-42b5-acag-f35b6nmd0088]
team.external.code=
#PARÂMETRO PARA DEMAIS SERVIÇOES DE EQUIPES
#Exemplo:[4056]
team.id=
Execução da Aplicação
Após a configuração dos parâmetros, execute a aplicação.
======================================================
SELECTED SERVICE [TEAM_SERVICE]
======================================================
OPERATION TYPE: DATABASE
======================================================
SELECTED METHOD [EXPORT_TEAMS]
Export teams
checking if token is valid?: false
======================================================
Starting authentication process
Getting access token
Token received.
8255196a-cec5-4843-b1f4-ca7cd6e28de8
======================================================
AUTHENTICATION SUCCESS
======================================================
TEAM DATA
======================================================
Nº teams found: 5
Nº pages found: 1
======================================================
SAVING ON DATABASE
======================================================
Open database connection
Saving on tb_team
Update Count: 5
Database connection close
======================================================
SAVING DATABASE TEAMS FINISHED SUCCESSFULLY
======================================================
Verificação da Operação
Após a execução da aplicação, abra a ferramenta de banco de dados de sua preferência e faça uma consulta na tabela tb_team.
SELECT * FROM tb_team;
A tabela terá uma estrutura semelhante à esta:
| id | name | workdayId | teamParentId | teamParentName |
|---|---|---|---|---|
| 4079 | Tecnologia da Informação | 2657 | ||
| 5799 | fSense DEV | 4077 | Tecnologia da Informação | |
| 18187 | Comercial | 2544 | ||
| 18960 | Service Desk | 3407 | ||
| 19482 | Recursos Humanos | 2757 |
Importar Equipes
Para importar equipes para o fSense a partir de um arquivo CSV, podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para IMPORT_TEAM através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=IMPORT_TEAM
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Informar o Caminho do Arquivo
É necessário especificar o caminho do arquivo CSV contendo as informações das equipes a serem importadas através da propriedade file.name. Se não houver nenhum arquivo pronto, há um modelo disponível no diretório src/main/resources/files/import/team_service_import_team.csv. Preencha as informações conforme as colunas indicadas no modelo.
Configure o caminho para o diretório onde o arquivo CSV está localizado.
#CAMINHO PARA IMPORTAR O ARQUIVO [O CAMINHO DEVE ESTAR PREVIAMENTE CRIADO]
path.import = ./src/main/resources/files/import
Defina o nome do arquivo CSV que contém as informações das equipes a serem importadas.
#NOME DO ARQUIVO A SER IMPORTADO [file.name=team_import.csv]
file.name = team_service_import_team.csv
Configure o delimitador e o qualificador de texto utilizados no arquivo CSV.
#CONFIGURAÇÕES DO CSV
#UTILIZE [VIRGULA] [PONTO E VIRGULA] OU [VAZIO] PARA O PARÂMETRO csv.delimiter
csv.delimiter = ,
#UTILIZE [VAZIO] [ASPAS SIMPLES] OU [ASPAS DUPLAS] PARA O PARÂMETRO csv.text.qualifier
csv.text.qualifier = '
Certifique-se que o arquivo CSV esteja no formato correto e que os parâmetros de configurações correspondam ao formato do arquivo.
Exemplo de Arquivo de Importação de Equipe
'id','name','workdayId','teamParentId','teamParentName'
'','Nova Equipe 1','2751','',''
'','Nova Equipe 2','','',''
Execução da Aplicação
Após a configuração dos parâmetros, execute a aplicação.
===========================================================
SELECTED SERVICE [TEAM_SERVICE]
===========================================================
SELECTED METHOD [IMPORT_TEAM]
===========================================================
OPERATION TYPE: CSV
===========================================================
checking if token is valid?: false
===========================================================
Starting authentication process
Getting access token
Token received.
1b7749ad-2cbf-44c3-9138-766b101f9979
===========================================================
AUTHENTICATION SUCCESS
===========================================================
Team Data:
Team name: Teste Nova Equipe 38
Trying insert a new Team
team imported successfully
Team : Teste Nova Equipe 38 imported successfully
===========================================================
Team Data:
Team name: Teste Nova Equipe 39
Trying insert a new Team
team imported successfully
Team : Teste Nova Equipe 39 imported successfully
===========================================================
Team Data:
Team name: Teste Nova Equipe 40
Trying insert a new Team
team imported successfully
Team : Teste Nova Equipe 40 imported successfully
===========================================================
RESULT OF IMPORT OPERATION
===========================================================
Total of requests made 3
Total of requests successfully: 3
Total of requests failed: 0
===========================================================
End of execution.
A aplicação realizará as requisições Http para a API fSense e internalizar as informações das equipes para o fSense.
Verificação da Operação
Após a execução da aplicação, abra o Painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipes para verificar se as equipes foram inseridas corretamente.
Caso haja algum erro durante a importação, uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.
Atualizar Equipes por ID
Para atualizar equipes cadastradas no fSense a partir de um arquivo CSV, podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para UPDATE_TEAM_BY_ID através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=UPDATE_TEAM_BY_ID
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Informar o Caminho do Arquivo
Para atualizar uma equipes no fSense,o processo é semelhante ao de inserir.
É necessário especificar o caminho do arquivo CSV contendo as informações das equipes a serem importadas através da propriedade file.name. Se não houver nenhum arquivo pronto, há um modelo disponível no diretório src/main/resources/files/import/team_service_update_team.csv. Preencha as informações conforme as colunas indicadas no modelo.
Configure o caminho para o diretório onde o arquivo CSV está localizado.
#CAMINHO PARA IMPORTAR O ARQUIVO [O CAMINHO DEVE ESTAR PREVIAMENTE CRIADO]
path.import = ./src/main/resources/files/import
Defina o nome do arquivo CSV que contém as informações dos calendários a serem importados.
#NOME DO ARQUIVO A SER IMPORTADO [file.name=team_import.csv]
file.name = team_service_update_team.csv
Configure o delimitador e o qualificador de texto utilizados no arquivo CSV.
#CONFIGURAÇÕES DO CSV
#UTILIZE [VIRGULA] [PONTO E VIRGULA] OU [VAZIO] PARA O PARÂMETRO csv.delimiter
csv.delimiter = ,
#UTILIZE [VAZIO] [ASPAS SIMPLES] OU [ASPAS DUPLAS] PARA O PARÂMETRO csv.text.qualifier
csv.text.qualifier = '
Certifique-se que o arquivo CSV esteja no formato correto e que os parâmetros de configurações correspondam ao formato do arquivo.
Execução da Aplicação
Após a configuração dos parâmetros, execute a aplicação.
===========================================================
SELECTED SERVICE [TEAM_SERVICE]
===========================================================
SELECTED METHOD [IMPORT_TEAM]
===========================================================
OPERATION TYPE: CSV
===========================================================
checking if token is valid?: false
===========================================================
Starting authentication process
Getting access token
Token received.
1b7749ad-2cbf-44c3-9138-766b101f9979
===========================================================
AUTHENTICATION SUCCESS
===========================================================
[Teste Nova Equipe 38 Atualizada, Teste Nova Equipe 39 Atualizada, Teste Nova Equipe 40 Atualizada]
===========================================================
Team Data:
Team name: Teste Nova Equipe 38 Atualizada
Team id: 19448 updated successfully
Team : Teste Nova Equipe 38 Atualizada updated successfully
===========================================================
Team Data:
Team name: Teste Nova Equipe 39 Atualizada
Team id: 19449 updated successfully
Team : Teste Nova Equipe 39 Atualizada updated successfully
===========================================================
Team Data:
Team name: Teste Nova Equipe 40 Atualizada
Team id: 19450 updated successfully
Team : Teste Nova Equipe 40 Atualizada updated successfully
===========================================================
RESULT OF UPDATE OPERATION
===========================================================
Total of requests made 3
Total of requests successfully: 3
Total of requests failed: 0
===========================================================
End of execution.
A aplicação realizará as requisições Http para a API fSense para atualizar as informações das equipes no fSense.
Verificação da Operação
Após a execução da aplicação, abra o Painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipes para verificar se as equipes foram atualizadas corretamente.
Caso haja algum erro durante a importação, uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.
Deletar Equipes por ID
Para remover uma equipe previamente cadastrada no fSense, podemos fazer os seguintes passos:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço serviço para DELETE_TEAM_BY_ID através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=DELETE_TEAM_BY_ID
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Definição de Parâmetros de Remoção
Para remover uma ou mais equipes, é necessário informar o identificador único da equipe que deseja remover através da propriedade team.ids. É possível informar um ou mais ids, basta informá-los separados por vírgula.
##ID DAS EQUIPES PARA REMOVER/EXPORTAR DETALHES
team.ids=19448, 19449, 19450
Execução da Aplicação
Após definido os parâmetros, execute a aplicação.
=================================================
SELECTED SERVICE [TEAM_SERVICE]
=================================================
OPERATION TYPE: CSV
=================================================
SELECTED METHOD [DELETE_TEAM_BY_ID]
=================================================
checking if token is valid?: false
==================================================
Starting authentication process
Getting access token
Token received.
f109f26d-0f50-4e32-a33c-7772e1ee5014
==================================================
AUTHENTICATION SUCCESS
==================================================
Teams selected to delete:
[19448, 19449, 19450]
TEAM ID TO BE REMOVED: 19448 - 1/3
Team id 19448 delete successfully
==================================================
TEAM ID TO BE REMOVED: 19449 - 2/3
Team id 19449 delete successfully
==================================================
TEAM ID TO BE REMOVED: 19450 - 3/3
Team id 19450 delete successfully
==================================================
RESULT OF DELETE OPERATION
==================================================
Total of requests made 3
Total of requests successfully: 3
Total of requests failed: 0
==================================================
End of execution.
Verificação da Operação
Após a execução da aplicação, abra o Painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipes para verificar se as equipes foram removidas corretamente.
Caso haja algum erro durante a operação. uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.
Exportar Detalhes de Equipes
Para exportar informações detalhadas com informações de líderes e membros de uma equipe cadastrada no fSense podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
- Definir o método EXPORT_TEAM_DETAILS_BY_ID
Método do Serviço
Configure o método do serviço para UPDATE_TEAM_BY_ID através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=EXPORT_TEAM_DETAILS_BY_ID
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Parâmetros de Exportação
Para exportar equipes com informações detalhadas no fSense, é necessário informar o identificador que deseja remover através da propriedade team.ids. É possível informar um ou mais ids, basta informá-los separados por vírgula.
# ID DAS EQUIPES PARA REMOVER/EXPORTAR DETALHES
team.ids=19446
Execução da Aplicação
Após definido os parâmetros, execute a aplicação.
=================================================
SELECTED SERVICE [TEAM_SERVICE]
=================================================
OPERATION TYPE: CSV
=================================================
SELECTED METHOD [EXPORT_TEAM_DETAILS_BY_ID]
==================================================
checking if token is valid?: false
==================================================
Starting authentication process
Getting access token
Token received.
f109f26d-0f50-4e32-a33c-7772e1ee5014
==================================================
AUTHENTICATION SUCCESS
==================================================
GENERATING CSV
==================================================
Generated file: team_details_id_19146.csv
Status: save successfully.
File saved in path: ./src/main/resources/files/export/team_details_id_19146.csv
==================================================
EXPORT TEAM DETAILS BY ID FINISHED SUCCESSFULLY
==================================================
A aplicação fará requisições para a API fSense para obter as informações detalhadas das Equipes informadas. Posteriormente, serão gerados arquivos CSV.
Verificação da Operação
Após a execução da aplicação, abra o arquivo gerado para verificar a exportação das equipes com informações detalhadas. O arquivo exportado terá uma estrutura semelhante à do exemplo abaixo:
'teamId','teamName','id','name','email','deviceIdentifier','isLeader'
'19146','Tecnologia da Informação','6755523','usuario','usuario@fsense.com','usuario@fsense.com','false'
'19146','Tecnologia da Informação','6702343','maria_silva','maria.silva@fsense','','false'
'19146','','6665143','ROOT','root@fsense.com','','true'
Adicionar Membros
Para adicionar membros em uma equipe, podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para MEMBERSHIP_ADDITION através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=MEMBERSHIP_ADDITION
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Parâmetros de Exportação
É necessário definir o id da Equipe que deseja adicionar membros, através da propriedade team.id, em seguida é necessário definir o id dos pessoas que deseja adicionar à equipe. Se necessário, execute antes o serviço PERSON_SERVICE junto com o método EXPORT_PERSONS, para obter os ids das pessoas que deseja adicionar na equipe.
Como exemplo, vamos utilizar esta equipe
#PARÂMETRO PARA DEMAIS SERVIÇOS DE EQUIPES
team.id=18787
#ID MEMBROS PARA ADICIONAR/REMOVER DA EQUIPE
team.member.ids=6757359, 6757360, 6757361, 6757362, 6757363
Execução da Aplicação
Após definido os parâmetros, execute a aplicação.
=========================================================
SELECTED SERVICE [TEAM_SERVICE]
=========================================================
OPERATION TYPE: CSV
=========================================================
SELECTED METHOD [MEMBERSHIP_ADDITION]
=========================================================
checking if token is valid?: false
=========================================================
Starting authentication process
Getting access token
Token received.
f109f26d-0f50-4e32-a33c-7772e1ee5014
=========================================================
AUTHENTICATION SUCCESS
=========================================================
ADD MEMBERSHIP ON TEAM ID: 18187
ID OF MEMBERS SELECTED TO ADD INTO TEAM:
=========================================================
[6757359, 6757360, 6757361, 6757362, 6757363]
=========================================================
Member added into team successfully
=========================================================
End of execution.
A aplicação realizará requisições Http para a API fSense e adicionar os membros à equipe no sistema.
Verificação da Operação
Após a execução da aplicação, abra o painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipe para verificar se as pessoas foram adicionadas à equipe corretamente.
Caso haja algum erro durante a operação, uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.
Remover Membros
Para remover membros de uma equipe, podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para MEMBERSHIP_REMOVAL através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=MEMBERSHIP_REMOVAL
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Parâmetros de Exportação
É necessário definir o id da Equipe que deseja adicionar membros, através da propriedade team.id, em seguida é necessário definir o id dos pessoas que deseja adicionar à equipe. Se necessário, execute antes o serviço PERSON_SERVICE junto com o método EXPORT_PERSONS, para obter os ids das pessoas que deseja adicionar na equipe.
Como exemplo, vamos utilizar esta equipe
#PARÂMETRO PARA DEMAIS SERVIÇOS DE EQUIPES
team.id=18787
#ID MEMBROS PARA ADICIONAR/REMOVER DA EQUIPE
team.member.ids=6757359, 6757360, 6757361, 6757362, 6757363
Execução da Aplicação
Após definido os parâmetros, execute a aplicação.
=========================================================
SELECTED SERVICE [TEAM_SERVICE]
=========================================================
OPERATION TYPE: CSV
=========================================================
SELECTED METHOD [MEMBERSHIP_REMOVAL]
=========================================================
checking if token is valid?: false
=========================================================
Starting authentication process
Getting access token
Token received.
f109f26d-0f50-4e32-a33c-7772e1ee5014
=========================================================
AUTHENTICATION SUCCESS
=========================================================
REMOVE MEMBERSHIPS ON TEAM ID: 18187
ID OF MEMBERS SELECTED TO REMOVE INTO TEAM:
=========================================================
[6757359, 6757360, 6757361, 6757362, 6757363]
=========================================================
Members removed from team successfully
=========================================================
End of execution.
A aplicação realizará requisições Http para a API fSense e remover os membros à equipe no sistema.
Verificação da Operação
Após a execução da aplicação, abra o painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipe para verificar se as pessoas foram removidas à equipe corretamente.
Caso haja algum erro durante a operação, uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.
Adicionar Líderes
Para adicionar líderes em uma equipe, podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para LEADER_ADDITION através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=LEADER_ADDITION
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Parâmetros de Exportação
É necessário definir o id da Equipe que deseja adicionar líderes, através da propriedade team.id, em seguida é necessário definir o id dos pessoas que deseja adicionar à equipe como líder. Se necessário, execute antes o serviço PERSON_SERVICE junto com o método EXPORT_PERSONS, para obter os ids das pessoas que deseja adicionar como líder na equipe.
Como exemplo, vamos utilizar esta equipe
#PARÂMETRO PARA DEMAIS SERVIÇOS DE EQUIPES
team.id=18787
#ID MEMBROS PARA ADICIONAR/REMOVER DA EQUIPE
team.leader.ids=6757359, 6757360, 6757361, 6757362, 6757363
Execução da Aplicação
Após definido os parâmetros, execute a aplicação.
=========================================================
SELECTED SERVICE [TEAM_SERVICE]
=========================================================
OPERATION TYPE: CSV
=========================================================
SELECTED METHOD [LEADER_ADDITION]
=========================================================
checking if token is valid?: false
=========================================================
Starting authentication process
Getting access token
Token received.
f109f26d-0f50-4e32-a33c-7772e1ee5014
=========================================================
AUTHENTICATION SUCCESS
=========================================================
ADD LEADER ON TEAM ID: 18187
ID OF LEADERS SELECTED TO ADD INTO TEAM:
=========================================================
[6757359, 6757360, 6757361, 6757362, 6757363]
=========================================================
Leaders added into team successfully
=========================================================
End of execution.
A aplicação realizará requisições Http para a API fSense e adicionar os líderes à equipe no sistema.
Verificação da Operação
Após a execução da aplicação, abra o painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipe para verificar se as pessoas foram adicionadas à equipe como líderes corretamente.
Caso haja algum erro durante a operação, uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.
Remover Líderes
Para remover líderes de uma equipe, podemos fazer da seguinte maneira:
Configuração do Arquivo Properties
Definição do Serviço
No arquivo fsense.properties, configure o serviço que será executado definindo a propriedade service.name para TEAM_SERVICE.
# SERVICO A SER EXECUTADO
service.name=TEAM_SERVICE
Método do Serviço
Configure o método do serviço para LEADER_REMOVAL através da propriedade service.method.
# METODO DO SERVIÇO A SER EXECUTADO
service.method=LEADER_REMOVAL
Tipo de Operação
Especifique o tipo de operação desejado através da propriedade operation.type. Defina o como CSV para exportar para um arquivo CSV ou como DATABASE para exportar para um banco de dados. Para esta implementação, defina CSV.
# TIPO DE OPERAÇÃO
operation.type=csv
Parâmetros de Exportação
É necessário definir o id da Equipe que deseja remover líderes, através da propriedade team.id, em seguida é necessário definir o id dos líderes que deseja remover da equipe. Se necessário, execute antes o serviço PERSON_SERVICE junto com o método EXPORT_PERSONS, para obter os ids dos líderes que deseja remover da equipe.
Como exemplo, vamos utilizar esta equipe
#PARÂMETRO PARA DEMAIS SERVIÇOS DE EQUIPES
team.id=18787
#ID MEMBROS PARA ADICIONAR/REMOVER DA EQUIPE
team.member.ids=6757359, 6757360, 6757361, 6757362, 6757363
Execução da Aplicação
Após definido os parâmetros, execute a aplicação.
=========================================================
SELECTED SERVICE [TEAM_SERVICE]
=========================================================
OPERATION TYPE: CSV
=========================================================
SELECTED METHOD [LEADER_REMOVAL]
=========================================================
checking if token is valid?: false
=========================================================
Starting authentication process
Getting access token
Token received.
f109f26d-0f50-4e32-a33c-7772e1ee5014
=========================================================
AUTHENTICATION SUCCESS
=========================================================
REMOVE LEADERS ON TEAM ID: 18187
ID OF LEADERS SELECTED TO ADD INTO TEAM:
=========================================================
[6757359, 6757360, 6757361, 6757362, 6757363]
=========================================================
Leaders removed into team successfully
=========================================================
End of execution.
A aplicação realizará requisições Http para a API fSense e remover os líderes à equipe no sistema.
Verificação da Operação
Após a execução da aplicação, abra o painel de Gestão Online fSense no seu navegador e faça login. Navegue até a seção Monitorados > Equipe para verificar se os líderes foram removidos da equipe corretamente.
Caso haja algum erro durante a operação, uma mensagem de erro será exibida no console da aplicação. Verifique as mensagens de erro para solucionar possíveis problemas.