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: ./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:

idnameworkdayIdteamParentIdteamParentName
4079Tecnologia da Informação2657
5799fSense DEV4077Tecnologia da Informação
18187Comercial2544
18960Service Desk3407
19482Recursos Humanos2757

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 = '
NOTA

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 = '
NOTA

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: ./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.