Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jonasaacampos/sportexperience

Desenvolvimento rotinas de uma empresa especializada em eventos esportivos. Foram consumidas 2 APIs, aberta 1 API para outros sistemas, criadas tabelas, páginas, com validação de campos e interação com o usuário. A aplicação foi escrita em inglês e possui tradução para o português do Brasil.
https://github.com/jonasaacampos/sportexperience

application-language business-central erp microsoft

Last synced: 4 months ago
JSON representation

Desenvolvimento rotinas de uma empresa especializada em eventos esportivos. Foram consumidas 2 APIs, aberta 1 API para outros sistemas, criadas tabelas, páginas, com validação de campos e interação com o usuário. A aplicação foi escrita em inglês e possui tradução para o português do Brasil.

Awesome Lists containing this project

README 

          


   

      

      

      

      

      

      

      




![Alt text](img/cover-repo.png)



Sport Experience



> Desenvolvimento de algumas rotinas de uma empresa especializada em eventos esportivos.

Foram consumidas 2 APIs, aberta 1 API para outros sistemas, criadas tabelas, páginas, com validação de campos e interação com o usuário. A aplicação foi escrita em inglês e possui tradução para o portiguês do Brasil.



BC_logo



[![](https://img.shields.io/badge/feito%20com%20%E2%9D%A4%20por-jaac-cyan)](https://github.com/jonasaacampos)

[![LinkedIn Badge](https://img.shields.io/badge/LinkedIn-Profile-informational?style=flat&logo=linkedin&logoColor=white&color=0D76A8)](https://www.linkedin.com/in/jonasaacampos)



![](https://img.shields.io/badge/dynamics365-informational?style=flat&logo=dynamics365&logoColor=white&color=gold)

![](https://img.shields.io/badge/vscode-informational?style=flat&logo=visualstudiocode&logoColor=white&color=magenta)



----

Índice



- [Demo](#demo)

- [Iniciar Projeto](#iniciar-projeto)

- [Retorno das APIs](#retorno-das-apis)

- [Documentação (descritivo) do projeto](#documentação-descritivo-do-projeto)

- [Utilidades e Referências](#utilidades-e-referências)

- [Cont(r)ate-me](#contrate-me)

- [Agradecimentos](#agradecimentos)



## Demo 



  Influencers API



![Alt text](img/Influencers_API.gif)



  Marketing Campaigns



![Alt text](img/marketingCampaigns.gif)



  Reginal Runs (API Expose)



![Alt text](img/ReginalRuns.gif)



[Slides utilizados para a apresentação do TCC](img/Sport%20Experience_TCC_Jonas_Campos.pdf)



## Iniciar Projeto



 - [ ] Abra a paleta de comandos (`ctrl + shift + p`)

 - [ ] Digite `AL:Go!`

 - [ ] Insira o caminho do diretório (e crie um diretório vazio para o projeto)

 - [ ] Escolha a opção do servidor. No meu caso escolhi `Your own server`

 - [ ] Na opção de login, ignore esta etapa, apertando `esc`

 - [ ] Abra o arquivo `.vscode > launch.json` e edite os parâmetros:

   - [ ] `server` alterar para `http://NOME_OU_IP_SEU_SERVIDOR`

   - [ ] `serverInstance` insira o nome da sua máquina virtual no lugar do padão `BC130`

   - [ ] `name` o nome do seu servidor. Pode ser qualquer coisa

   - [ ] ` "startupObjectId"` insira o objeto que iniciará por padrão após a compilação.

 - [ ] Após publicar o projeto pela primeira vez, insira o parâmetro `"schemaUpdateMode": "Recreate",`

 - [ ] Apague o arquivo `HelloWord.al` e inicie o desenvolvimento

 - [ ] Abra a paleta de comandos (`ctrl + shift + p`)

 - [ ] Digite `AL: Download Symbols`

 - [ ] Aparecerão os módulos baixados do diretório `.alpackages` na seção explorer do projeto

 - [ ] Compile o projeto, `F5` para depuração ou `ctrl + F5` para publicação direta



## Retorno das APIs



  Sport Influencers (exemplo de retorno da requisição) 



```json



[

  {

    "id": 1,

    "name": "Cristiano Ronaldo",

    "username": "CR7",

    "email": "cristiano@ronaldo.com",

    "address": {

      "street": "Avenida dos Campeões",

      "suite": "Apt. 7",

      "city": "Madri",

      "zipcode": "28001",

      "geo": {

        "lat": "40.4167",

        "lng": "-3.7033"

      }

    },

    "phone": "+34 123456789",

    "website": "cristianoronaldo.com",

    "company": {

      "name": "CR7 Empreendimentos Esportivos",

      "catchPhrase": "Transformando sonhos em realidade",

      "bs": "Gerenciamento de carreiras esportivas"

    }

  },

  {

    "id": 2,

    "name": "Neymar Jr.",

    "username": "Neymar",

    "email": "neymar@jr.com",

    "address": {

      "street": "Rua dos Craques",

      "suite": "Apt. 10",

      "city": "São Paulo",

      "zipcode": "04578-910",

      "geo": {

        "lat": "-23.5644",

        "lng": "-46.6517"

      }

    },

    "phone": "+55 11 987654321",

    "website": "neymarjr.com",

    "company": {

      "name": "NJ Sports",

      "catchPhrase": "Paixão e dedicação pelo futebol",

      "bs": "Marketing esportivo"

    }

  },



```



  



  

  Go Weather (exemplo de retorno da requisição) 



```json



{

  "temperature": "16 °C",

  "wind": "28 km/h",

  "description": "Rain, mist",

  "forecast": [

    {

      "day": "1",

      "temperature": "20 °C",

      "wind": "13 km/h"

    },

    {

      "day": "2",

      "temperature": "+14 °C",

      "wind": "12 km/h"

    },

    {

      "day": "3",

      "temperature": "18 °C",

      "wind": "9 km/h"

    }

  ]

}



```



  



## Documentação (descritivo) do projeto



> Aqui vou descrever a finalidade de adicionar cada componente, bem como o papel de cada um dentro do projeto.



  👓 1 - Tabelas e Páginas 



  Ao criar uma **tabela**, definimos quais dados desejamos capturar na aplicação. As propriedades de cada campo são definidos na tabela.



  Para que sejam exibido os dados, precisamos de criar **páginas**. Estas permitem que o usuário interaja com nosso aplicativo. Uma **página de lista** é a primeira página que o usuário acessará. A partir desta lista, é possível inserir, alterar e excluir dados. Quando informações mais detalhadas são necessárias, o usuário pode acessar a **página de cartão**.



  



  ⛔ 2 - Validação de campos e tratamento de erros 



  Gatilhos (triggers) são funções que acontessem como resultado de uma ação. Estes podem ser ignorados a depender da regra de negócios. No nosso caso, o gatilho sempre será disparado para validar o campo data da última exibição.



  Cada objeto AL possui um conjunto de gatilhos própiros.



  Foi adicionado um tratamento de erro para que exiba uma mensagem para o usuário, utilizando rótulos (Label Data).



  👮🏾‍♀️ 3 - Classificação dos dados 



  Com a constante coleta e manipulação de dados em massa, é preciso se atentar para as legislações de proteção à dados pessoais. No Business Central, os dados podem ser classificados de maneira simples, adicionando o parâmetro `DataClassification` com o seu devido valor.



  Para ver a documentação com os valores possível, acesse [DataClassification Property](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-dataclassification-property).



  📋 4 - Permissões de acesso



  > Nada é pior do que testar, validar e entregar o aplicativo que o cliente não consegue acessar.



  Para gerar automaticamente o arquivo de permissões, abra a paleta de comandos (`ctrl + shift + p`) e digite `AL: Generate permission set containing current extension objects`. Será criado um arquivo de permissões. Após publicar o projeto, o administrador pode acessar a política abra a página de política de permissões (`Tell me > permissions sets`).



  - **Atenção:** A criação da política de permissões sempre subescreverá o arquivo existente. Par amanter ambos, renomeie o arquivo `extensionsPermissionSet.xml`. 

  - É possível criar mais de uma política de permissões, por exemplo, uma rotina administrativa, uma de leitura e escrita, e outra de somente leitura.

  



  🧾 5 - Relatórios



  Usando o snippet `report` foi criada a estutura básica do relatório. Como layout padrão, foi inserido o padrão RDLC.



  - após a criação, o projeto foi compilado com `ctrl + shift + b`. Feito isso, o arquivo de layout foi criado automaticamente.

  - o arquivo `.rdl` foi aberto e editado no Microsoft Report Buider

    - No painel do Report Builder, selecionar: DataSet_Result > Insert > Table > Table Wizard > Chose an existing dataset > Next > Movido o campo `code` para o row group > movidos demais campos para a seção valores > Desmarcar todos as caixas > Next > Finish > SAVE.



  Um relatório é composto por duas partes:



  1. Conjunto de dados (Dataset): é um arquivo `.al` que define as tabelas, campos, filtrose lógica do relatório

  2. Layout: Arquivo RDLC, Word ou Excel que mostrará o relatório quando for gerado no BC.



  Depois de instalado no BC, o cliente pode alterar ou criar novos layouts com o recurso *Custom Report Layouts*.



  🧾 6 - Link de Ajuda 



  Inserido link (fictítio) para que no canto superior direito da página de lista, seja possível abrir documentação externa. O parâmetro de link de ajuda é inserido na Page List.






## Utilidades e Referências



- [Tables Overview](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-tables-overview)

- [Pages Overview](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-pages-overview)

- [Retaining table data after publishing](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-retaining-data-after-publishing)

- [Triggers Overview](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/triggers-auto/devenv-triggers)

- [Label Data Type](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/label/label-data-type)

- [Classifying Data Sensitivity](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-classifying-data-sensitivity)

- [Classifying Data in Dynamics 365](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-classifying-data)

- [Create Users According to Licenses](https://learn.microsoft.com/en-us/dynamics365/business-central/ui-how-users-permissions)

- [Microsoft® Report Builder](https://www.microsoft.com/en-us/download/details.aspx?id=53613)

- [Reports Overview](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-reports)

- [Report and Document Layouts Overview](https://learn.microsoft.com/en-us/dynamics365/business-central/ui-manage-report-layouts)

- [Adding Help Links from Pages, Reports, and XMLports](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-adding-help-links-from-pages-tables-xmlports)

- [Table Extension Object](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-table-ext-object)

- [Page Extension Object](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-page-ext-object)

- [Subscribing to events](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-subscribing-to-events)



## Cont(r)ate-me



**Author:** Jonas Araujo de Avila Campos



![Alt text](https://github.com/jonasaacampos/jonasaacampos/raw/master/img/banner2.png)





  

    

  

  

    

  




## Agradecimentos



- Julio Chaves, por preparar e conduzir o treinamento

- Colegas que seguiram até o final

- Equipe de infra e RH da Alfa People