DIA A DIA COM
AZURE DEVOPS
Materiais e Links Úteis de Utilização
2022/ novembro
2
Manual de Uso
Azure DevOps
Esta apresentação tem como objetivo orientar o
TOTVER com informações úteis para o dia a dia sobre
a utilização da plataforma Azure Devops
3
01
LINKS ÚTEIS
4
ACESSOS
Azure
DevOps
https://dev.azure.com/totvstfs
https://totvstfs.visualstudio.com
Passo a Passo
Confira aqui o passo
a passo para o
primeiro acesso ao
Azure DevOps.
Links para
Testes
Acesso ao repositório do
Protheus Se funcionar,
o acesso está ok.
Se o repositório não
exibir, este link valida o
acesso e a licença - Se
funcionar o acesso está
ok, mas a licença não.
Atenção!
Se o link de validação
(último link ao lado) não
funcionar, tentar acesso
somente a ferramenta.
Se funcionar, o acesso ao
Protheus não está liberado.
■https://dev.azure.com/totvstfs
■https://totvstfs.visualstudio.co
m
5
FERRAMENTAS E PLUGINS
Plugins Exclusivos para time de
Desenvolvimento
Microsoft Visual
Studio 2017
Team Explorer
https://tdn.totvs.com/pages/viewpage.action?pageId=706145312
http://kace.totvs.com.br
My CheckIns With Issue
Errors (Jira)
OBS: Fazer login com usuário e senha da rede,
pesquisar em downloads pela ferramenta.
My CheckIns with Lock
(Protheus Patch)
Plugin para tirar lock de fontes.
https://tdn.totvs.com/pages/viewpage.action?pageId=707373601
Plugin que lista check-ins feitos com algum erro
no processo.
Plugin Para Todas as Áreas
Plugin: TOTVS - My Pending
Changes
https://arte.engpro.totvs.com.br/engenharia/plugins_azure_devops/
https://tdn.totvs.com/display/tdi/Plugin%3A+TOTVS+-+My+P
Histórico 2015.
ending+Changes
Plugin de uso OBRIGATÓRIO para efetuar
check-in.
6
GRAVAÇÕES
Kick-off
● Material Apresentado.
● Gravação.
Treinamentos
Desenvolvimento 25/10
Turma I | Turma II
Atendimento 26/10
Turma I | Turma II
Turma Extra 08/11
Material dos
Treinamentos
Acesse aqui, o material
apresentado em todas as
turmas de treinamentos.
7
02
FAQ
Dúvidas Frequentes
8
FAQ DÚVIDAS
FREQUENTES
1. Como baixar o Visual Studio?
2. Porque é obrigatório o Visual Studio 2017 Team Explorer?
3. Como eu configuro o Visual Studio para usar o Azure DevOps?
4. Como devo configurar meu WorkSpace da maneira correta?
5. Como faço a instalação de um plugin (plugin.vsix)?
6. O que é o Plugin "My pending Changes"?
7. Porque preciso utilizar este plugin "My pending Changes"?
8. Posso usar a versão web?
9. Preciso de VPN para usar o Azure DevOps?
10. Como faço para pesquisar uma função ou trecho de fonte?
11. Como faço para visualizar o histórico no Azure DevOps?
12. Como faço para visualizar o histórico no TFS2015?
13. Como faço para comparar um fonte entre AzureDevOps e TFS2015?
14. Sou usuário novo e não tenho acesso, como fazer?
15. Meu check-in aparece no Jira, mas não para o Robô?
16. Como remover o lock de fonte para fazer rollback?
1. COMO BAIXAR O VISUAL STUDIO?
1. Acessar a página http://kace.totvs.com.br.
2. Fazer login com usuário e senha de rede.
3. Localizar na aba downloads, o software Team Explorer for
Microsoft Visual Studio 2017.
9
10
2. PORQUE É
OBRIGATÓRIO O
VISUAL STUDIO 2017
TEAM EXPLORER?
1. A versão Visual Studio
Professional tem um custo
elevado de licenciamento e se
destina principalmente a
desenvolvedores de linguagens
como C# e .Net. No caso do
Protheus (ADVPL/TLPP), somente
utilizamos a ferramenta para leitura
e atualização de fontes.
2. A ferramenta Visual Studio Team
Explorer 2017 não tem
licenciamento requerido.
3. Os Plugins auxiliares foram
desenvolvidos considerando esta
versão de Visual Studio.
3. COMO EU CONFIGURO O VISUAL STUDIO PARA USAR O AZURE DEVOPS?
1. Selecione o ícone semelhante a uma tomada “Gerenciar Conexões” (Print a Direita).
2. Ao selecionar “Gerenciar Conexões”, selecione a opção “Conectar a um Projeto”.
3. A opção de “Conectar a um Projeto” habilita a opção de conectar-se a uma conta
Microsoft.
4. Devemos conectar a conta microsoft após ter feito um primeiro acesso via browser.
5. Em seguida, ao se conectar automaticamente serão carregados os projetos no Azure
DevOps e assim selecione “Protheus_Padrao”.
11
4. COMO DEVO CONFIGURAR MEU WORKSPACE DA MANEIRA CORRETA?
1. É necessário gerenciar o espaço de trabalho, por meio das opções indicadas na imagem
abaixo.
2. Selecione o espaço de trabalho desejado e a opção “Editar”.
3. Em seguida a opção “Avançado” para expandir (print abaixo a direita).
4. Na opção expandida, se atentar as opções:
○ Local = Servidor
○ Horário do Arquivo = Fazer Check-in (esta opção que garante o Get da data do
check-in).
○ Permissões = Espaço de trabalho Privado
12
5. COMO FAÇO A INSTALAÇÃO DE UM PLUGIN (PLUGIN.VSIX) ?
1. Fechar o Visual Studio antes da instalação.
2. Dê um duplo clique no arquivo.
3. Será exibido um wizard de instalação.
4. Avançar até o feedback de instalado.
13
6. O QUE É O PLUGIN "MY PENDING CHANGES"?
1. Plugin de uso obrigatório para fazer check-in.
2. Este plugin substitui a opção padrão de fazer check-in.
14
7. PORQUE PRECISO UTILIZAR ESTE PLUGIN "MY PENDING CHANGES"?
1. Este plugin permite que seja feita uma validação prévia das informações antes da efetivação do check-in.
2. As validações deste plugin são obrigatórias para garantir o compliance do check-in.
15
8. POSSO USAR A VERSÃO WEB?
● Sim, para consultas.
● Não para alterações, neste caso somente via Visual Studio.
16
17
9. PRECISO DE
VPN PARA USAR O
AZURE DEVOPS?
Para o Azure DevOps não.
Entretanto, todos os plugins auxiliares
precisam obrigatoriamente de VPN,
pois utilizam servidores na rede da
TOTVS.
10. COMO FAÇO PARA PESQUISAR UMA FUNÇÃO OU TRECHO DE FONTE?
1. O Campo de Busca na versão web, permite várias combinações e filtros.
2. Buscas por termos isolados, consulta esses termos nos fontes.
3. Buscas com aspas duplas, procura exatamente aquele termo no fonte.
18
11. COMO FAÇO PARA VISUALIZAR O HISTÓRICO NO AZURE DEVOPS?
1. No Azure DevOps via Browser, ao selecionar uma pasta ou arquivo existe a opção “History”.
2. Nesta opção, é exibido apenas os comentários do check-in.
19
12. COMO FAÇO PARA VISUALIZAR O HISTÓRICO NO TFS2015?
1. Instalar o plugin ViewHistoryTFS2015-CDSP.
2. No pop-up do botão direito do mouse em um fonte ou pasta, aparecerá
uma opção nova: ”TOTVS - View History (tfs2015.totvs)”.
3. Se tiver na VPN será exibido o pop-up com o histórico consultado no
servidor do TFS2015.
20
13. COMO FAÇO PARA COMPARAR UM FONTE ENTRE AZUREDEVOPS E
TFS2015?
1. Para esta comparação é necessário ter a
versão do fontes do TFS 2015 previamente
baixado na versão desejada na máquina.
2. Para obter o fonte do TFS 2015, primeiro
troque a conexão com o servidor.
3. Selecione o fonte desejado na data
desejada e faça o Get.
4. Importante ser um mapeamento exclusivo
para TFS2015.
5. Voltar a conexão com servidor do Azure
Devops.
6. Selecione a opção comparar.
7. Selecione o changeset do Azure DevOps
desejado.
8. Selecione o arquivo recém baixado e
conseguirá comparar.
Ao Lado temos um Gif com todo o processo.
21
14. SOU USUÁRIO NOVO E NÃO TENHO ACESSO, COMO FAZER?
1. Inicialmente, fazer processo de solicitação de criação do usuário e acessos aos sistemas padrões.
2. Via fluig, solicitar o licenciamento para o Azure DevOps.
3. No fluig, acessar processos, depois, Iniciar Solicitações.
4. Pesquisar por “Azure” e selecionar a opção TI, Solicitação de Licenças Azure DevOps.
5. Na solicitação incluir os usuários e solicitar licença do tipo “Basic”.
6. Após a liberação da Licença, solicitar no ticket para o GCAD (gcad.sp@totvs.com.br) a inclusão do novo analista no time do TFS para
que seja possível ter acesso aos fontes (Leitura / Alteração).
22
23
15. MEU
CHECK-IN
APARECE NO
JIRA, MAS NÃO
PARA O ROBÔ?
Possíveis Causas:
● Possivelmente o check-in foi feito sem a
utilização do plugin “My Pending
Changes”.
● Existir uma falha momentânea na
integração ROBÔ X TFS que é feita por
um WS diferente do WS que exibe no
JIRA.
● O plugin do Jira considera códigos
informados nos comentários e o Robô
somente vai considerar as issues
informadas no formulário do plugin “My
Pending Changes”.
16. COMO REMOVER O LOCK DE FONTE PARA FAZER ROLLBACK?
● Selecione no Menu, Ferramentas, opção “TOTVS - My Checkins with lock
(Protheus Patch)”
● Na interface selecionar o fonte desejado e a opção “CheckOut For Edit”.
● O fonte voltará com o lock para seu usuário e assim é possível seguir com a opção
desejada:
○ Reverter - Para Rollback.
○ Desfazer Alterações Pendentes - para somente liberar o fonte.
24
OBRIGADO
Engenharia Protheus
GCAD - SP
Abertura de Tickets: gcad.sp@totvs.com.br
• Tecnologia + Conhecimento são nosso DNA.
• O sucesso do cliente é o nosso sucesso.
• Valorizamos gente boa que é boa gente.
totvs.com
totvs.store
@totvs
@totvs
/totvs
company/totvs
#SOMOSTOTVERS
DÍA A DÍA CON
AZURE DEVOPS
Materiales y enlaces útiles para utilización
2022/ noviembre
27
Manual de uso
Azure DevOps
Esta presentación tiene como objetivo orientar al
TOTVER con información útil para el día a día sobre la
utilización de la plataforma Azure Devops
28
01
ENLACES ÚTILES
29
ACCESOS
Azure
DevOps
https://dev.azure.com/totvstfs
https://totvstfs.visualstudio.com
Paso a paso
Vea aquí el paso a
paso para el primer
acceso al Azure
DevOps.
Enlaces para
pruebas
Acceso al repositorio del
Protheus Si funciona, el
acceso está ok.
Si el repositorio no
muestra, este enlace
valida el acceso y la
licencia - Si funciona, el
acceso está ok, pero no
la licencia.
¡Atención!
Si el enlace de validación
(último enlace al lado) no
funciona, intente acceder
solamente a la herramienta.
Si funciona, el acceso al
Protheus no está liberado.
■https://dev.azure.com/totvstfs
■https://totvstfs.visualstudio.com
30
HERRAMIENTAS Y PLUGINS
Plugins exclusivos para el equipo
de Desarrollo
Microsoft Visual
Studio 2017
Team Explorer
https://tdn.totvs.com/pages/viewpage.action?pageId=706145312
http://kace.totvs.com.br
My CheckIns With Issue
Errors (Jira)
OBS: Hacer login con usuario y contraseña de la
red, buscar en downloads por la herramienta.
My CheckIns with Lock
(Protheus Patch)
Plugin para retirar lock de fuentes.
https://tdn.totvs.com/pages/viewpage.action?pageId=707373601
Plugin que lista check-ins realizados con algún
error en el proceso.
Plugin para todas las áreas
Plugin: TOTVS - My Pending
Changes
https://arte.engpro.totvs.com.br/engenharia/plugins_azure_devops/
https://tdn.totvs.com/display/tdi/Plugin%3A+TOTVS+-+My+P
Historial 2015.
ending+Changes
Plugin de uso OBLIGATORIO para realizar
check-in.
31
GRABACIONES
Kick-off
● Material presentado
● Grabación
Capacitaciones
Desarrollo 25/10
Grupo I | Grupo II
Atención 26/10
Grupo I | Grupo II
Grupo extra 08/11
Material de las
capacitaciones
Acceda aquí al material
presentado a todos los grupos
de capacitaciones.
32
02
FAQ
Dudas frecuentes
33
FAQ DUDAS
FRECUENTES
1. ¿Cómo descargar el Visual Studio?
2. ¿Por qué es obligatorio el Visual Studio 2017 Team Explorer?
3. ¿Cómo configuro el Visual Studio para utilizar el Azure DevOps?
4. ¿Cómo debo configurar mi WorkSpace de manera correcta?
5. ¿Cómo hago la instalación de un plugin (plugin.vsix)?
6. ¿Qué es el Plugin "My pending Changes"?
7. ¿Por qué es necesario utilizar el plugin "My pending Changes"?
8. ¿Puedo utilizar la versión web?
9. ¿Necesito de VPN para utilizar el Azure DevOps?
10. ¿Cómo hago para buscar una función o trecho de fuente?
11. ¿Cómo hago para visualizar el historial en el Azure DevOps?
12. ¿Cómo hago para visualizar el historial en el TFS2015?
13. ¿Cómo hago para comparar un fuente entre AzureDevOps y TFS2015?
14. ¿Soy usuario nuevo y no tengo acceso, cómo hago?
15. ¿Mi check-in aparece en el Jira, pero no para el Robot?
16. ¿Cómo eliminar el lock de fuente para realizar el rollback?
1. ¿CÓMO DESCARGAR EL VISUAL STUDIO?
1. Acceda a la página http://kace.totvs.com.br.
2. Haga el login con usuario y contraseña de red.
3. En la solapa de downloads, encuentre el software Team
Explorer for Microsoft Visual Studio 2017.
34
35
2. ¿POR QUÉ ES
OBLIGATORIO EL
VISUAL STUDIO 2017
TEAM EXPLORER?
1. La versión Visual Studio
Professional tiene un costo
elevado de licenciamiento y se
destina principalmente a
desarrolladores de lenguajes
como C# e .Net. En el caso del
Protheus (ADVPL/TLPP), solamente
utilizamos la herramienta para
lectura y actualización de fuentes.
2. La herramienta Visual Studio
Team Explorer 2017 no tiene
licenciamiento solicitado.
3. Los Plugins auxiliares se
desarrollaron considerando esta
versión de Visual Studio.
3. ¿CÓMO CONFIGURO EL VISUAL STUDIO PARA UTILIZAR EL AZURE
DEVOPS?
1. Seleccione el ícono semejante a un enchufe “Administrar conexiones” (Imagen a la
derecha).
2. Al seleccionar “Administrar conexiones”, seleccione la opción “Conectarse a un proyecto”.
3. La opción “Conectarse a un proyecto” habilita la opción de conectarse a una cuenta
Microsoft.
4. Debemos conectarnos a la cuenta microsoft después de haber realizado un primer acceso vía
browser.
5. A continuación, al conectarse automáticamente se cargarán los proyectos en el Azure
DevOps entonces, seleccione “Protheus_Estándar”.
36
4. ¿CÓMO DEBO CONFIGURAR MI WORKSPACE DE MANERA CORRECTA?
1. Es necesario administrar el espacio de trabajo, por medio de las opciones indicadas en la
siguiente imagen.
2. Seleccione el espacio de trabajo deseado y la opción “Editar”.
3. A continuación la opción “Avanzado” para expandir (Imagen abajo a la derecha).
4. En la opción expandida, esté atento a las opciones:
○ Local = Servidor
○ Horario del archivo = Hacer Check-in (esta opción garantiza el Get de la fecha del
check-in).
○ Permisos = Espacio de trabajo privado
37
5. ¿CÓMO HAGO LA INSTALACIÓN DE UN PLUGIN (PLUGIN.VSIX)?
1. Finalice el Visual Studio antes de la instalación.
2. Haga doble clic en el archivo.
3. Se mostrará un wizard de instalación.
4. Avance hasta el feedback de instalado.
38
6. ¿QUÉ ES EL PLUGIN "MY PENDING CHANGES"?
1. Plugin de uso obligatorio para hacer check-in.
2. Este plugin sustituye la opción estándar de hacer check-in.
39
7. ¿POR QUÉ DEBO UTILIZAR EL PLUGIN "MY PENDING CHANGES"?
1. Este plugin permite que se realice una validación previa de las informaciones antes de hacer efectivo el check-in.
2. Las validaciones de este plugin son obligatorias para garantizar el compliance del check-in.
40
8. ¿PUEDO UTILIZAR LA VERSIÓN WEB?
● Sí, para consultas.
● No para modificaciones, en este caso solamente vía Visual Studio.
41
42
9. ¿NECESITO DE
VPN PARA
UTILIZAR EL
AZURE DEVOPS?
Para el Azure DevOps no.
Sin embargo, todos los plugins
auxiliares necesitan obligatoriamente
de VPN, pues utilizan servidores en la
red de TOTVS.
10. ¿CÓMO HAGO PARA BUSCAR UNA FUNCIÓN O TRECHO DE FUENTE?
1. El campo de búsqueda en la versión web, permite varias combinaciones y filtros.
2. Búsquedas por términos aislados, consulta estos términos en los fuentes.
3. Búsquedas con comillas, busca exactamente aquel término en el fuente.
43
11. ¿CÓMO HAGO PARA VISUALIZAR EL HISTORIAL EN EL AZURE DEVOPS?
1. En el Azure DevOps vía Browser, al seleccionar una carpeta o archivo existe la opción “History”.
2. En esta opción, solamente se muestran los comentarios del check-in.
44
12. ¿CÓMO HAGO PARA VISUALIZAR EL HISTORIAL EN EL TFS2015?
1. Instalar el plugin ViewHistoryTFS2015-CDSP.
2. En el pop-up del botón derecho del mouse en un fuente o carpeta,
aparecerá una opción nueva: ”TOTVS - View History
(tfs2015.totvs)”.
3. Si hubiera en la VPN se mostrará el pop-up con el historial consultado
en el servidor del TFS2015.
45
13. ¿CÓMO HAGO PARA COMPARAR UN FUENTE ENTRE AZUREDEVOPS Y
TFS2015?
1. Para esta comparación es necesario tener la
versión del fuente del TFS 2015 previamente
descargado en la versión deseada en la
máquina.
2. Para obtener el fuente del TFS 2015, primero
cambia la conexión con el servidor.
3. Seleccione el fuente deseado en la fecha
deseada y haga el Get.
4. Es importante que sea un mapeo exclusivo
para TFS2015.
5. Volver a la conexión con el servidor del Azure
Devops.
6. Seleccione la opción comparar.
7. Seleccione el changeset del Azure DevOps
deseado.
8. Seleccione el archivo recién descargado y
conseguirá comparar.
Al lado tenemos un Gif con todo el proceso.
46
14. SOY USUARIO NUEVO Y NO TENGO ACCESO, ¿CÓMO HAGO?
1. Inicialmente, haga el proceso de solicitud de creación del usuario y accesos a los sistemas estándares.
2. Vía fluig, solicite el licenciamiento para el Azure DevOps.
3. En el fluig, acceda a procesos, después, Iniciar solicitudes.
4. Busque “Azure” y seleccione la opción TI, Solicitud de licencias Azure DevOps.
5. En la solicitud incluya los usuarios y solicite licencia del tipo “Basic”.
6. Después de la Liberación de la licencia, solicite en el ticket para el GCAD (gcad.sp@totvs.com.br) la inclusión del nuevo analista en el
equipo del TFS para que sea posible tener acceso a los fuentes (Lectura / Modificación).
47
48
15. ¿MI
CHECK-IN
APARECE EN
EL JIRA, PERO
NO PARA EL
ROBOT?
Posibles causas:
● Posiblemente el check-in se realizó sin la
utilización del plugin “My Pending
Changes”.
● Existe una falla momentánea en la
integración ROBOT vs. TFS realizada por
un WS diferente del WS que se muestra
en el JIRA.
● El plugin del Jira considera códigos
informados en los comentarios y el Robot
solamente va a considerar las issues
informadas en el formulario del plugin
“My Pending Changes”.
16. ¿CÓMO ELIMINAR EL LOCK DEL FUENTE PARA REALIZAR EL ROLLBACK?
● En el Menú, seleccione Herramientas, opción “TOTVS - My Checkins with lock
(Protheus Patch)”
● En la interfaz seleccione el fuente deseado y la opción “CheckOut For Edit”.
● El fuente regresará con el lock para su usuario y de esta manera es posible
continuar con la opción deseada:
○ Revertir - Para Rollback.
○ Revertir Modificaciones Pendientes - solamente para liberar el fuente.
49
GRACIAS
Ingeniería Protheus
GCAD - SP
Apertura de tickets: gcad.sp@totvs.com.br
• Tecnología + Conocimiento son nuestro DNA.
• El éxito del cliente es nuestro éxito.
• Valoramos gente buena que es buena gente.
totvs.com
totvs.store
@totvs
@totvs
/totvs
company/totvs
#SOMOSTOTVERS
DAILY ROUTINE
WITH AZURE
DEVOPS
Materials and Useful Websites
2022/ November
52
Azure DevOps
User Manual
This presentation aims to guide the TOTVER with useful
information on the daily routine using the Azure
DevOps platform
53
01
USEFUL WEBSITES
54
ACCESS
Azure
DevOps
https://dev.azure.com/totvstfs
https://totvstfs.visualstudio.com
Step by Step
Check the step by
step for the first
access to Azure
DevOps here.
Links for Tests
Attention!
Access to the Protheus
repository. If this works,
the access is established.
If the validation link (last link
on the left) does not work, try
to access only the tool.
If the repository is not
displayed, this link
validates the access and
the license. If it works,
the access is established,
but not the license.
If this works, the access to
Protheus is not enabled.
■https://dev.azure.com/totvstfs
■https://totvstfs.visualstudio.com
55
TOOLS AND PLUG-INS
Plug-ins Exclusive for
Development Teams
Microsoft Visual
Studio 2017
Team Explorer
https://tdn.totvs.com/pages/viewpage.action?pageId=706145312
http://kace.totvs.com.br
My Check-ins with Issue
Errors (JIRA)
NOTE: Log in with your network username and
password, then search for the tool in Downloads.
My Check-ins with Lock
(Protheus Patch)
Plug-in to unlock source codes.
https://tdn.totvs.com/pages/viewpage.action?pageId=707373601
Plug-in that lists check-ins performed with errors
in the process.
Plug-in for All Areas
Plug-in: TOTVS ‑ My Pending
Changes
https://arte.engpro.totvs.com.br/engenharia/plugins_azure_devops/
https://tdn.totvs.com/display/tdi/Plugin%3A+TOTVS+-+My+P
2015 History
ending+Changes
Plug-in MANDATORY to perform check-in.
56
RECORDINGS
Kick-Off
● Material Presented
● Recording
Training Programs
Development October 25
Group I | Group II
Service October 26
Group I | Group II
Extra Group November 8
Training Materials
Access the material presented
to all training groups here.
57
02
FAQ
Frequently Asked Questions
58
FAQ FREQUENTLY
ASKED QUESTIONS
1. How can I download Visual Studio?
2. Why is it mandatory to use Visual Studio 2017 Team Explorer?
3. How do I set up Visual Studio to use Azure DevOps?
4. How should I set up my WorkSpace?
5. How do I install a plug-in (plugin.vsix)?
6. What is the "My pending Changes" plug-in?
7. Why do I have to use the "My pending Changes" plug-in?
8. Can I use the Web version?
9. Do I need a VPN to use Azure DevOps?
10. How can I search for a function or piece of source code?
11. How do I view the history in Azure DevOps?
12. How do I view the history in TFS2015?
13. How can I compare a source code between Azure DevOps and TFS2015?
14. I am a new user and cannot access, what should I do?
15. My check-in is on Jira, but it does not appear to the Robot.
16. How do I unlock the source to rollback?
1. HOW CAN I DOWNLOAD VISUAL STUDIO?
1. Access http://kace.totvs.com.br.
2. Log in with your network username and password.
3. At the Downloads tab, find the software Team Explorer for
Microsoft Visual Studio 2017.
59
60
2. WHY IS IT
MANDATORY TO USE
VISUAL STUDIO 2017
TEAM EXPLORER?
1. The Visual Studio Professional
version has a high licensing cost
and is mainly intended for
developers of languages such as
C# and .Net. In the case of
Protheus (ADVPL/TLPP), we only use
the tool to read and update source
codes.
2. The Visual Studio Team Explorer
2017 does not require licensing.
3. The auxiliary plug-ins were
developed considering this version
of Visual Studio.
3. HOW DO I SET UP VISUAL STUDIO TO USE AZURE DEVOPS?
1. Select the icon similar to a power plug “Manage Connections” (Print to the right).
2. After you select "Manage Connections", click “Connect to a Project”.
3. The “Connect to a Project” option enables the option to connect to a Microsoft
account.
4. Connect the Microsoft account after accessing it for the first time using a browser.
5. Then, after the automatic connection, the projects will be loaded to Azure DevOps. After
that, select “Protheus_Padrao”.
61
4. HOW SHOULD I SET UP MY WORKSPACE?
1. You must manage the workspace using the options indicated in the bottom image.
2. Select the desired workspace and click “Edit”.
3. Then, select the “Advanced” option to expand (print below to the right).
4. In the expanded option, pay attention to the options:
○ Location = Server
○ File Time = Check-in (this is the option that guarantees the Get of the check-in date).
○ Permissions = Private workspace
62
5. HOW DO I INSTALL A PLUG-IN (PLUGIN.VSIX)?
1. Close the Visual Studio before installing.
2. Double-click the file.
3. An installation wizard will be displayed.
4. Advance up to the installation feedback.
63
6. WHAT IS THE "MY PENDING CHANGES" PLUG-IN?
1. This plug-in is mandatory to perform check-in.
2. It replaces the default check-in option.
64
7. WHY DO I HAVE TO USE THE "MY PENDING CHANGES" PLUG-IN?
1. This plug-in allows a pre-validation of the information before the check-in.
2. The plug-in validations are mandatory to ensure the check-in compliance.
65
8. CAN I USE THE WEB VERSION?
● Yes, for queries.
● Not for changes. In this case, use only Visual Studio.
66
67
9. DO I NEED A
VPN TO USE
AZURE DEVOPS?
Not for Azure DevOps.
However, all auxiliary plug-ins need
VPN because they use servers in TOTVS
network.
10. HOW CAN I SEARCH FOR A FUNCTION OR PIECE OF SOURCE CODE?
1. The Search Field in the Web version allows many combinations and filters.
2. Search for isolated terms, and query these terms in the source codes.
3. Search using double quotes, and search exactly for that term in the source.
68
11. HOW DO I VIEW THE HISTORY IN AZURE DEVOPS?
1. On the Azure DevOps via Browser, when you select a folder or file, the “History” option is available.
2. This option displays only check-in comments.
69
12. HOW DO I VIEW THE HISTORY IN TFS2015?
1. Install the plug-in ViewHistoryTFS2015-CDSP.
2. When you right-click a source or folder, a new option will appear:
”TOTVS - View History (tfs2015.totvs)”.
3. If you are using the VPN, a pop-up with the history queried in the
TFS2015 server will be displayed.
70
13. HOW CAN I COMPARE A SOURCE CODE BETWEEN AZURE DEVOPS AND
TFS2015?
1. To make this comparison, it is necessary to have
the TFS 2015 source codes downloaded at the
desired version.
2. To get the source code of TFS 2015, first
change the connection with the server.
3. Select the desired source at the desired
date and perform the Get.
4. It must be a mapping exclusive for TFS2015.
5. Then, connect back to the Azure DevOps server.
6. Select the Compare option.
7. Select the desired Azure DevOps changeset.
8. Then, select the recently downloaded file to
compare both.
At the side, we have a Gif containing the entire
process.
71
14. I AM A NEW USER AND CANNOT ACCESS, WHAT SHOULD I DO?
1. First, follow the process for requesting the creation of the user and access to the default systems.
2. Via fluig, request the licensing for Azure DevOps.
3. At fluig, access Processes, then Start Requests.
4. Search for “Azure” and select the option IT, Azure DevOps License Request.
5. At the request, add the users and request the “Basic” license.
6. After the license is provided, open a ticket to GCAD (gcad.sp@totvs.com.br) and request that the new analyst be added to the TFS
team, so that they can access the source codes (Read/Edit).
72
73
15. MY
CHECK-IN IS
ON JIRA, BUT
IT DOES NOT
APPEAR TO
THE ROBOT.
Possible Causes:
● The check-in was probably performed
without using the “My Pending
Changes” plug-in.
● A momentary failure exists in the ROBOT
X TFS integration performed by a WS
different from the WS displayed in Jira.
● The Jira plug-in considers codes entered in
the comments, and the Robot will only
consider the issues entered in the form of
the “My Pending Changes” plug-in.
16. HOW DO I UNLOCK THE SOURCE TO ROLL BACK?
● At Menu, Tools, select the option “TOTVS - My Check-ins with lock (Protheus
Patch)”
● At the interface, select the desired source and the “CheckOut For Edit” option.
● The source will return with the lock to your user, so that you can continue with the
desired option:
○ Reverse - To Roll back.
○ Undo Pending Changes - to just release the source.
74
THANK YOU
Protheus Engineering
GCAD - SP
Ticket Opening: gcad.sp@totvs.com.br
• Technology + Knowledge are our DNA.
• The customer’s success is our success.
• We value great professionals who are great people.
totvs.com
totvs.store
@totvs
@totvs
/totvs
company/totvs
#WEARETOTVERS