Categorias | fSense - Documentação

Serviço de Categorias

Serviço é responsável por fazer a busca de categorias de aplicação por pessoa ou por equipe.

Exportar Categorias - Exemplo de Implementação CSV

Para exportar as categorias da organização no formato 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 CATEGORY_SERVICE.

    # SERVICO A SER EXECUTADO
    service.name=CATEGORY_SERVICE

Método do Serviço

Configure o método do serviço para EXPORT_CATEGORIES através da propriedade service.method.

    # METODO DO SERVIÇO A SER EXECUTADO
    service.method=EXPORT_CATEGORIES

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 utilizar este método, é preciso definir o email da pessoa que será buscada as categorias, o parâmetro a ser definido no arquivo fsense.properties, como no exemplo abaixo:

    #USUARIO PARA SERVIÇO DE BUSCA DE CATEGORIAS
    category.username=usuario@fsense.com

Execução da Aplicação

Após a configuração dos parâmetros, execute a aplicação. Podemos ver que a implementação selecionada é de CSV.

    =========================================================
    SELECTED SERVICE [CATEGORY_SERVICE]
    =========================================================
    OPERATION TYPE: CSV
    =========================================================
    SELECTED METHOD [EXPORT_CATEGORIES]
    =========================================================
    checking if token is valid?: false
    =========================================================
    Starting authentication process
    Getting access token
    Token received.
    5e7b9bee-bddf-40e3-a6be-c3de6af46694
    =========================================================
    AUTHENTICATION SUCCESS
    =========================================================
    Nº categories found: 390
    =========================================================
    GENERATING CSV
    =========================================================
    Generated file categories.csv
    Status: saved successfully
    File saved in path: ./files/export/categories.csv
    =========================================================
    EXPORT CATEGORIES FINISHED SUCCESSFULLY
    =========================================================
    End of execution.

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 se as categorias foram exportadas. O arquivo terá uma estrutura semelhante a do exemplo abaixo:

'applicationName','category','categoryName','username'
'cursos.alura.com.br','B','Business Use','fsense_user'
'Gerenciador de Limpeza de Espaço em Disco para Windows','B','Business Use','fsense_user'
'FortiClient System Tray Controller','B','Business Use','fsense_user'
'login.live.com','B','Business Use','fsense_user'
'bitbucket.org','B','Business Use','fsense_user'
'Adobe Acrobat','A','Personal Use','fsense_user'
'srvseniormdw01.callink.com.br:8080','B','Business Use','fsense_user'
'drive.google.com','A','Personal Use','fsense_user'
'agent.fsense.com','D','Unapproved Personal Use','fsense_user'
'Microsoft Word','B','Business Use','fsense_user'
'Microsoft Excel','B','Business Use','fsense_user'

Exportar Categorias - Exemplo de Implementação de Banco de Dados

Para exportar as categorias da organização, 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, configure o serviço que será executado definindo a propriedade service.name para CATEGORY_SERVICE.

    # SERVICO A SER EXECUTADO
    service.name=CATEGORY_SERVICE

Método do Serviço

Configure o método do serviço para EXPORT_CATEGORIES através da propriedade service.method.

    # METODO DO SERVIÇO A SER EXECUTADO
    service.method=EXPORT_CATEGORIES

Tipo de Operação

    # TIPO DE OPERAÇÃO
    operation.type=database

Parâmetros de Exportação

Para utilizar este método, é preciso definir o email da pessoa que será buscada as categorias, o parâmetro a ser definido no arquivo fsense.properties, como no exemplo abaixo:

    #USUARIO PARA SERVIÇO DE BUSCA DE CATEGORIAS
    category.username=usuario@fsense.com

Execução da Aplicação

Após definido os parâmetros, execute a aplicação.

    ==========================================================
    SELECTED SERVICE [CATEGORY_SERVICE]
    ==========================================================
    OPERATION TYPE: DATABASE
    ==========================================================
    SELECTED METHOD [EXPORT_CATEGORIES]
    ==========================================================
    checking if token is valid?: false
    ==========================================================
    Starting authentication process
    Getting access token
    Token received.
    5e7b9bee-bddf-40e3-a6be-c3de6af46694
    ==========================================================
    AUTHENTICATION SUCCESSFULLY
    ==========================================================
    Nº categories found: 390
    ==========================================================
    SAVING ON DATABASE
    ==========================================================
    Open database Connection
    Saving on tb_categories
    UpdateCount: 390
    Database connection close
    ==========================================================
    SAVING DATABASE CATEGORIES FINISHED SUCCESSFULLY
    ==========================================================
    End of execution.

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_category.

SELECT * FROM tb_category

A tabela terá uma estrutura semelhante à esta:

applicationName	category	categoryName	username
cursos.alura.com.br	B	Business Use	fsense_user
Gerenciador de Limpeza de Espaço em Disco para Windows	B	Business Use	fsense_user
FortiClient System Tray Controller	B	Business Use	fsense_user
login.live.com	B	Business Use	fsense_user
bitbucket.org	B	Business Use	fsense_user
Adobe Acrobat	A	Personal Use	fsense_user
srvseniormdw01.callink.com.br:8080	B	Business Use	fsense_user
drive.google.com	A	Personal Use	fsense_user
agent.fsense.com	D	Unapproved Personal Use	fsense_user
Microsoft Word	B	Business Use	fsense_user
Microsoft Excel	B	Business Use	fsense_user

Exportar Categorias Gerais - Exemplo de Implementação de CSV

Para exportar as categorias gerais da organização no formato 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 CATEGORY_SERVICE.

    # SERVICO A SER EXECUTADO
    service.name=CATEGORY_SERVICE

Método do Serviço

Configure o método do serviço para EXPORT_GENERAL_CATEGORIES através da propriedade service.method.

    # METODO DO SERVIÇO A SER EXECUTADO
    service.method=EXPORT_GENERAL_CATEGORIES

Tipo de Operação

    # TIPO DE OPERAÇÃO
    operation.type=csv

Parâmetros de Exportação

Opcionalmente pode-se definir como parâmetro as opções como:

LastCollectedData - Data mais recente que algum usuário acessou a aplicação/site,
LastModification - Data mais recente que alguma categoria foi alterada no sistema e também
OnlyCategorized - Busca apenas as aplicações já categorizadas.

    #PARAMETROS PARA SERVIÇO DE EXPORTAÇÃO DE CATEGORIAS GERAIS
    #[dd/MM/yyyy] 
    last.collected.date = dd/MM/yyyy
    last.modification.date = dd/MM/yyyy
    #SE ESTE PARAMETRO NAO ESTIVER MARCADO, O PROGRAMA ENTENDERÁ COMO [false]
    #[true/false]
    only.categorized = false

Execução da Aplicação

Após a configuração dos parâmetros, execute a aplicação.

    =========================================================
    SELECTED SERVICE [CATEGORY_SERVICE]
    =========================================================
    OPERATION TYPE: CSV
    =========================================================
    SELECTED METHOD [EXPORT_GENERAL_CATEGORIES]
    =========================================================
    checking if token is valid?: false
    =========================================================
    Starting authentication process
    Getting access token
    Token received.
    5e7b9bee-bddf-40e3-a6be-c3de6af46694
    =========================================================
    AUTHENTICATION SUCCESS
    =========================================================
    Nº categories found: 2600
     Nº of pages found: 53
    Getting general categories page 1/53
    Getting general categories page 2/53
    Getting general categories page 3/53
    ---
    Getting general categories page 53/53
    =========================================================
    GENERATING CSV
    =========================================================
    Generated file general_categories.csv
    Status: saved successfully
    File saved in path: ./files/export/general_categories.csv
    =========================================================
    EXPORT GENERAL CATEGORIES FINISHED SUCCESSFULLY
    =========================================================
    End of execution.

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 se as categorias gerais foram exportadas. O arquivo terá uma estrutura semelhante a do exemplo abaixo:

'applicationName','category','categoryName','username'
'cursos.alura.com.br','B','Business Use','fsense_user'
'Gerenciador de Limpeza de Espaço em Disco para Windows','B','Business Use','fsense_user'
'FortiClient System Tray Controller','B','Business Use','fsense_user'
'login.live.com','B','Business Use','fsense_user'
'bitbucket.org','B','Business Use','fsense_user'
'Adobe Acrobat','A','Personal Use','fsense_user'
'srvseniormdw01.callink.com.br:8080','B','Business Use','fsense_user'
'drive.google.com','A','Personal Use','fsense_user'
'agent.fsense.com','D','Unapproved Personal Use','fsense_user'
'Microsoft Word','B','Business Use','fsense_user'
'Microsoft Excel','B','Business Use','fsense_user'

Exportar Categorias Gerais - Exemplo de Implementação de Banco de Dados

Para exportar as categorias gerais da organização, 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, configure o serviço que será executado definindo a propriedade service.name para CATEGORY_SERVICE.

    # SERVICO A SER EXECUTADO
    service.name=CATEGORY_SERVICE

Método do Serviço

Configure o método do serviço para EXPORT_GENERAL_CATEGORIES através da propriedade service.method.

    # METODO DO SERVIÇO A SER EXECUTADO
    service.method=EXPORT_GENERAL_CATEGORIES

Tipo de Operação

    # TIPO DE OPERAÇÃO
    operation.type=database

Parâmetros de Exportação

Opcionalmente pode-se definir como parâmetro as opções como:

LastCollectedData - Data mais recente que algum usuário acessou a aplicação/site,
LastModification - Data mais recente que alguma categoria foi alterada no sistema e também
OnlyCategorized - Busca apenas as aplicações já categorizadas.

    #PARAMETROS PARA SERVIÇO DE EXPORTAÇÃO DE CATEGORIAS GERAIS
    #[dd/MM/yyyy] 
    last.collected.date = dd/MM/yyyy
    last.modification.date = dd/MM/yyyy
    #SE ESTE PARAMETRO NAO ESTIVER MARCADO, O PROGRAMA ENTENDERÁ COMO [false]
    #[true/false]
    only.categorized = false

Execução da Aplicação

Após definido os parâmetros, execute a aplicação.

    ==========================================================
    SELECTED SERVICE [CATEGORY_SERVICE]
    ==========================================================
    OPERATION TYPE: DATABASE
    ==========================================================
    SELECTED METHOD [EXPORT_CATEGORIES]
    ==========================================================
    checking if token is valid?: false
    ==========================================================
    Starting authentication process
    Getting access token
    Token received.
    5e7b9bee-bddf-40e3-a6be-c3de6af46694
    ==========================================================
    AUTHENTICATION SUCCESSFULLY
    ==========================================================
    Nº categories found: 2600
    Nº of pages found: 53
    Getting general categories page 1/53
    Getting general categories page 2/53
    Getting general categories page 3/53
    ---
    Getting general categories page 53/53
    ==========================================================
    SAVING ON DATABASE
    ==========================================================
    Open database Connection
    Saving on tb_categories
    UpdateCount: 2600
    Database connection close
    ==========================================================
    SAVING DATABASE GENERAL_CATEGORIES FINISHED SUCCESSFULLY
    ==========================================================
    End of execution.

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_general_category.

SELECT * FROM tb_category

A tabela terá uma estrutura semelhante à esta:

applicationName	category	categoryName	username
cursos.alura.com.br	B	Business Use	fsense_user
Gerenciador de Limpeza de Espaço em Disco para Windows	B	Business Use	fsense_user
FortiClient System Tray Controller	B	Business Use	fsense_user
login.live.com	B	Business Use	fsense_user
bitbucket.org	B	Business Use	fsense_user
Adobe Acrobat	A	Personal Use	fsense_user
srvseniormdw01.callink.com.br:8080	B	Business Use	fsense_user
drive.google.com	A	Personal Use	fsense_user
agent.fsense.com	D	Unapproved Personal Use	fsense_user
Microsoft Word	B	Business Use	fsense_user
Microsoft Excel	B	Business Use	fsense_user

Exportar Categorias por Equipe - Exemplo de Implementação CSV

Para exportar as categorias por Equipe da organização no formato 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 CATEGORY_SERVICE.

    # SERVICO A SER EXECUTADO
    service.name=CATEGORY_SERVICE

Método do Serviço

Configure o método do serviço para EXPORT_CATEGORIES_BY_TEAM através da propriedade service.method.

    # METODO DO SERVIÇO A SER EXECUTADO
    service.method=EXPORT_CATEGORIES_BY_TEAM

Tipo de Operação

    # TIPO DE OPERAÇÃO
    operation.type=csv

Parâmetros de Exportação

Opcionalmente pode-se definir como parâmetro as opções como:

LastCollectedData - Data mais recente que algum usuário acessou a aplicação/site,
LastModification - Data mais recente que alguma categoria foi alterada no sistema e também
OnlyCategorized - Busca apenas as aplicações já categorizadas.

    #PARAMETROS PARA SERVIÇO DE EXPORTAÇÃO DE CATEGORIAS GERAIS
    #[dd/MM/yyyy] 
    last.collected.date = dd/MM/yyyy
    last.modification.date = dd/MM/yyyy
    #SE ESTE PARAMETRO NAO ESTIVER MARCADO, O PROGRAMA ENTENDERÁ COMO [false]
    #[true/false]
    only.categorized = false

Também podemos selecionar uma equipe específica para buscar as categorias informando o id da equipe neste parâmetro

    #ID EQUIPE PARA SERVIÇO DE BUSCA DE CATEGORIAS POR EQUIPE
    category.team.id=      

Execução da Aplicação

Após a configuração dos parâmetros, execute a aplicação.

    =========================================================
    SELECTED SERVICE [CATEGORY_SERVICE]
    =========================================================
    OPERATION TYPE: CSV
    =========================================================
    SELECTED METHOD [EXPORT_CATEGORIES_BY_TEAM]
    =========================================================
    checking if token is valid?: false
    =========================================================
    Starting authentication process
    Getting access token
    Token received.
    5e7b9bee-bddf-40e3-a6be-c3de6af46694
    =========================================================
    AUTHENTICATION SUCCESS
    =========================================================
    Nº categories found: 1958
    Nº of pages found: 48
    Getting categories by team page 1/48
    Getting categories by team page 2/48
    Getting categories by team page 3/48
    ---
    Getting categories by team page 48/48
    =========================================================
    GENERATING CSV
    =========================================================
    Generated file categories_team.csv
    Status: saved successfully
    File saved in path: ./files/export/categories_team.csv
    =========================================================
    EXPORT GENERAL CATEGORIES BY TEAM FINISHED SUCCESSFULLY
    =========================================================
    End of execution.

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 se as categorias por equipe foram exportadas. O arquivo terá uma estrutura semelhante a do exemplo abaixo:

'applicationName','category','categoryName','teamId','teamName'
'console.cloud.google.com','','','6499','Comercial'
'revistacrescer.globo.com','','','6499','Comercial'
'www.imovelweb.com.br','','','6499','Comercial'
'globoesporte.globo.com','','','6499','Comercial'
'economia.uol.com.br','','','6499','Comercial'
'www.globo.com','','','6499','Comercial'
'centauro.com.br','','','6499','Comercial'
'revistacasaejardim.globo.com','','','6499','Comercial'
'meet.google.com','','','6499','Comercial'
'gfl.sinclog.com.br','','','6499','Comercial'
'gshow.globo.com','','','6499','Comercial'

Exportar Categorias por Equipe - Exemplo de Implementação de Banco de Dados

Para exportar as categorias por equipe da organização, 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, configure o serviço que será executado definindo a propriedade service.name para CATEGORY_SERVICE.

    # SERVICO A SER EXECUTADO
    service.name=CATEGORY_SERVICE

Método do Serviço

Configure o método do serviço para EXPORT_CATEGORIES_BY_TEAM através da propriedade service.method.

    # METODO DO SERVIÇO A SER EXECUTADO
    service.method=EXPORT_CATEGORIES_BY_TEAM

Tipo de Operação

    # TIPO DE OPERAÇÃO
    operation.type=database

Parâmetros de Exportação

Opcionalmente pode-se definir como parâmetro as opções como:

LastCollectedData - Data mais recente que algum usuário acessou a aplicação/site,
LastModification - Data mais recente que alguma categoria foi alterada no sistema e também
OnlyCategorized - Busca apenas as aplicações já categorizadas.

    #PARAMETROS PARA SERVIÇO DE EXPORTAÇÃO DE CATEGORIAS GERAIS
    #[dd/MM/yyyy] 
    last.collected.date = dd/MM/yyyy
    last.modification.date = dd/MM/yyyy
    #SE ESTE PARAMETRO NAO ESTIVER MARCADO, O PROGRAMA ENTENDERÁ COMO [false]
    #[true/false]
    only.categorized = false

Execução da Aplicação

Após definido os parâmetros, execute a aplicação.

    ==========================================================
    SELECTED SERVICE [CATEGORY_SERVICE]
    ==========================================================
    OPERATION TYPE: DATABASE
    ==========================================================
    SELECTED METHOD [EXPORT_CATEGORIES_BY_TEAM]
    ==========================================================
    checking if token is valid?: false
    ==========================================================
    Starting authentication process
    Getting access token
    Token received.
    5e7b9bee-bddf-40e3-a6be-c3de6af46694
    ==========================================================
    AUTHENTICATION SUCCESSFULLY
    ==========================================================
    Nº categories found: 1958
    Nº of pages found: 48
    Getting categories by team page 1/48
    Getting categories by team page 2/48
    Getting categories by team page 3/48
    ---
    Getting categories by team page 48/48
    ==========================================================
    SAVING ON DATABASE
    ==========================================================
    Open database Connection
    Saving on tb_categories
    UpdateCount: 1958
    Database connection close
    ==========================================================
    SAVING DATABASE CATEGORIES_BY_TEAM FINISHED SUCCESSFULLY
    ==========================================================
    End of execution.

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_categories_by_team.

SELECT * FROM tb_categories_by_team

A tabela terá uma estrutura semelhante à esta:

applicationName	teamId	teamName
console.cloud.google.com	6499	Comercial
revistacrescer.globo.com	6499	Comercial
www.imovelweb.com.br	6499	Comercial
globoesporte.globo.com	6499	Comercial
economia.uol.com.br	6499	Comercial
www.globo.com	6499	Comercial
centauro.com.br	6499	Comercial
revistacasaejardim.globo.com	6499	Comercial
meet.google.com	6499	Comercial
gfl.sinclog.com.br	6499	Comercial
gshow.globo.com	6499	Comercial

Serviço de Categorias​

Exportar Categorias - Exemplo de Implementação CSV​

Configuração do Arquivo Properties​

Definição do Serviço​

Método do Serviço​

Tipo de Operação​

Parâmetros de Exportação​

Execução da Aplicação​

Verificação da Operação​

Exportar Categorias - Exemplo de Implementação de Banco de Dados​

Configuração do Arquivo Properties​

Definição do Serviço​

Método do Serviço​

Tipo de Operação​

Parâmetros de Exportação​

Execução da Aplicação​

Verificação da Operação​

Exportar Categorias Gerais - Exemplo de Implementação de CSV​

Configuração do Arquivo Properties​

Definição do Serviço​

Método do Serviço​

Tipo de Operação​

Parâmetros de Exportação​

Execução da Aplicação​

Verificação da Operação​

Exportar Categorias Gerais - Exemplo de Implementação de Banco de Dados​

Configuração do Arquivo Properties​

Definição do Serviço​

Método do Serviço​

Tipo de Operação​

Parâmetros de Exportação​

Execução da Aplicação​

Verificação da Operação​

Exportar Categorias por Equipe - Exemplo de Implementação CSV​

Configuração do Arquivo Properties​

Definição do Serviço​

Método do Serviço​

Tipo de Operação​

Parâmetros de Exportação​

Execução da Aplicação​

Verificação da Operação​

Exportar Categorias por Equipe - Exemplo de Implementação de Banco de Dados​

Configuração do Arquivo Properties​

Definição do Serviço​

Método do Serviço​

Tipo de Operação​

Parâmetros de Exportação​

Execução da Aplicação​

Verificação da Operação​

Serviço de Categorias

Exportar Categorias - Exemplo de Implementação CSV

Configuração do Arquivo Properties

Definição do Serviço

Método do Serviço

Tipo de Operação

Parâmetros de Exportação

Execução da Aplicação

Verificação da Operação

Exportar Categorias - Exemplo de Implementação de Banco de Dados

Configuração do Arquivo Properties

Definição do Serviço

Método do Serviço

Tipo de Operação

Parâmetros de Exportação

Execução da Aplicação

Verificação da Operação

Exportar Categorias Gerais - Exemplo de Implementação de CSV

Configuração do Arquivo Properties

Definição do Serviço

Método do Serviço

Tipo de Operação

Parâmetros de Exportação

Execução da Aplicação

Verificação da Operação

Exportar Categorias Gerais - Exemplo de Implementação de Banco de Dados

Configuração do Arquivo Properties

Definição do Serviço

Método do Serviço

Tipo de Operação

Parâmetros de Exportação

Execução da Aplicação

Verificação da Operação

Exportar Categorias por Equipe - Exemplo de Implementação CSV

Configuração do Arquivo Properties

Definição do Serviço

Método do Serviço

Tipo de Operação

Parâmetros de Exportação

Execução da Aplicação

Verificação da Operação

Exportar Categorias por Equipe - Exemplo de Implementação de Banco de Dados

Configuração do Arquivo Properties

Definição do Serviço

Método do Serviço

Tipo de Operação

Parâmetros de Exportação

Execução da Aplicação

Verificação da Operação