Código: FR-SE-009

SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

PROCOLOMBIA.

HU: PLANES SECTORIALES

FECHA: 10 – Octubre - 2022

REALIZADO POR:
Angel Javier SanchezTenjo

Página 1 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

CONTROL DE CAMBIOS 
VERSIÓN  DESCRIPCIÓN DE LA MODIFICACIÓN  FECHA 
0  Emisión Inicial 10-10-2022 

Página 2 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

Tabla de contenido

1. Alcance......................................................................................................................................4
2. Ambientes.................................................................................................................................4
3. Herramientas Utilizadas..........................................................................................................4
4. Desarrollo de Caso de Uso 1: Reglas de Validación...............................................................5
4.1. Descripción del Caso de Uso................................................................................................5
4.2. Reglas de Validación creadas..............................................................................................6
4.2.1. PSE_Industrias_4_0_Sector.............................................................................................6
4.2.2. PSE_Industrias_4_0_Subsector.......................................................................................7
4.2.3. PSE_Cadena_Productiva_Modelo_Negocio...................................................................7
4.2.4. PSE_Sistema_Moda_Subsector.......................................................................................8
4.2.5. PSE_Sistema_Moda_Sector.............................................................................................9
4.2.6. PSE_Sistema_Moda_Modelo_Negocio..........................................................................10
4.2.7. PSE_M_OI_QCV_AGRO_Subsector...........................................................................10
4.2.8. PSE_M_OI_QCV_AGRO_Sector.................................................................................11
4.2.9. PSE_M_OI_QCV_AGRO_Modelo_Negocio................................................................12
5. Caso de Uso 2: Objeto Oportunidades..................................................................................13
5.1. Descripción del Caso de Uso..............................................................................................13

Página 3 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

1. Alcance.

Este Documento es una guía del desarrollo de la implementación de casos de uso: caso de
uso 1: reglas de validación y caso de uso 2: objeto oportunidades en el CRM de la empresa
de ProColombia.

2. Ambientes

El desarrollo de las reglas de validación se realizó en la plataforma de CRM que se llama

Salesforce, es una plataforma de gestión de las relaciones con los clientes (CRM) basada en
la nube. ProColombia establece 2 ambientes de Salesforce para el desarrollo y pruebas de
los 2 casos de uso:

 Sanbox de Desarrollo: (https://procolombia--fullcop2.sandbox.my.salesforce.com/ )

 Sanbox de QA: (https://procolombia--profullcop.my.salesforce.com )

3. Herramientas Utilizadas

En el desarrollo de las clases, desencadenadores y test unitarios se utilizaron las siguientes

herramientas.

Instalar VS Code:
https://code.visualstudio.com/download

Página 4 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

Instalar SFDX:

https://developer.salesforce.com/tools/sfdxcli

Instalar salesforce extension pack:

https://marketplace.visualstudio.com/items?itemName=salesforce.salesforcedx-vscode

Comando a usar en VS Code:

sfdx update
sfdx force:org:list

Comando a usar en CMD windows:

sfdx -v

4. Desarrollo de Caso de Uso 1: Reglas de Validación

4.1. Descripción del Caso de Uso

En el aplicativo NEO, se implementan unas reglas de validación para las cadenas

productivas de los proyectos de tipo plan sectorial, estos se pueden generar para los de
inversión y exportación.

Al momento de ingresar a la plataforma de Salesforce se tiene acceso al aplicativo NEO

(CRM), allí nos encontramos en la parte superior, los llamados objetos.

A continuación, se relaciona las reglas de validación descritas anteriormente:

Página 5 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

CADENA PRODUCTIVA TIPO DE CAMPO REGLA DE VALIDACIÓN OBSERVACIONES

Se c to r O b lig a to rio
C a mb io e n la s re g la s d e
Ind ustria s 4.0 Su b se c to r Va c ío (e n b la nc o )
v a lid a c ió n
M o d e lo d e Ne g o c io No O b lig a to rio

Se c to r O b lig a to rio Su je to a lo s sig u ie nte s re g istro s:

*Ning u no
Siste m a Mo d a Su b se c to r O b lig a to rio *M a rc a
M o d e lo d e Ne g o c io O b lig a to rio *Pa q ue te c o mp le to
C a mp o s Se c to r y
Un ifo rme s Su b se c to r (No
Siste m a Mo d a O b lig a to rio s) C a mb io e n la s re g la s d e
(lista d o d e ite m s
C a mp o s Se c to r y v a lid a c ió n
m o d e lo d e ne g o c io )
Dise ña d o re s Su b se c to r (No
O b lig a to rio s)
Se c to r O b lig a to rio
C a mb io e n la s re g la s d e
M&OI – QCV – AGRO Su b se c to r O b lig a to rio
v a lid a c ió n
M o d e lo d e Ne g o c io O b lig a to rio

4.2. Reglas de Validación creadas

Se crearon las siguientes reglas de validación en el Objeto Proyecto__c que cumpla con el
caso de uso 1: Reglas de Validación en Planes Sectoriales de Exportación.

4.2.1. PSE_Industrias_4_0_Sector

Objeto Proyecto__c
Nombre PSE_Industrias_4_0_Sector
Descripción Para los proyectos de Planes Sectoriales Exportación, cuando la
cadena productiva es Industrias 4.0; el Campo Sector debe estar
obligatorio.
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
ISPICKVAL(Cadena_Productiva1__c, "Industrias 4.0") &&
ISPICKVAL( Sector1__c, "")
Mensaje error El Sector es Obligatorio para las Industrias 4.0
Campo Sector
Estado Activo

Página 6 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

4.2.2. PSE_Industrias_4_0_Subsector

Objeto Proyecto__c
Nombre PSE_Industrias_4_0_Subsector
Descripción El Subsector debe estar vacío para las Industrias 4.0 de los Proyectos
de Planes Sectoriales de Exportación.
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
ISPICKVAL(Cadena_Productiva1__c, "Industrias 4.0") &&
NOT(ISPICKVAL( Subsector__c , ""))
Mensaje error El Subsector debe estar vacío para Industrias 4.0
Campo Subsector
Estado No Activo

Nota: En las sesiones de pruebas se solicita el cambio de esta regla, para permitir en el
campo subsector no obligue en todos los casos quede en blanco, sino este campo sea
opcional.

4.2.3. PSE_Cadena_Productiva_Modelo_Negocio

Objeto Proyecto__c
Nombre PSE_Cadena_Productiva_Modelo_Negocio
Descripción Para los planes sectoriales de Exportación, cuando la cadena es
diferente a Sistema Moda, no debe permitir registrar el valor de
Modelo de Negocio.
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
NOT(ISPICKVAL(Cadena_Productiva1__c, "Sistema moda")) &&
NOT(ISPICKVAL( Modelo_de_Negocio__c , ""))
Mensaje error El modelo de negocio no aplica para esta cadena productiva.
Campo Modelo de Negocio
Estado Activo

Página 7 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

4.2.4. PSE_Sistema_Moda_Subsector

Objeto Proyecto__c
Nombre PSE_Sistema_Moda_Subsector
Descripción Para los planes sectoriales de exportación, la cadena productiva
Sistema Moda debe obligar a seleccionar el Sector y Subsector para
los modelos de negocio Ninguno, Marca y Paquete Completo.
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
ISPICKVAL(Cadena_Productiva1__c, "Sistema moda") &&
( ISPICKVAL( Modelo_de_Negocio__c , "Marca") ||
ISPICKVAL( Modelo_de_Negocio__c , "Paquete completo") ||
ISPICKVAL( Modelo_de_Negocio__c , "Ninguno") ) &&
ISPICKVAL( Subsector__c , "" )
Mensaje error El Subsector es obligatorio para la cadena Sistema Moda cuando
seleccione Marca, Ninguno o Paquete completo.
Campo Subsector
Estado Activo

4.2.5. PSE_Sistema_Moda_Sector

Objeto Proyecto__c
Nombre PSE_Sistema_Moda_Sector
Descripción Para los planes sectoriales de exportación, la cadena productiva
Sistema Moda debe obligar a seleccionar el Sector y Subsector para
los modelos de negocio Ninguno, Marca y Paquete Completo.
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
ISPICKVAL(Cadena_Productiva1__c, "Sistema moda") &&
( ISPICKVAL( Modelo_de_Negocio__c , "Marca") ||

Página 8 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

ISPICKVAL( Modelo_de_Negocio__c , "Paquete completo") ||

ISPICKVAL( Modelo_de_Negocio__c , "Ninguno") ) &&
ISPICKVAL( Sector1__c , "" )
Mensaje error El Sector es obligatorio para la cadena Sistema Moda cuando
seleccione Marca, Ninguno o Paquete completo.
Campo Sector
Estado Activo

4.2.6. PSE_Sistema_Moda_Modelo_Negocio

Objeto Proyecto__c
Nombre PSE_Sistema_Moda_Modelo_Negocio
Descripción Para los planes sectoriales de exportación, la cadena productiva
Sistema Moda debe obligar a seleccionar el Modelo de Negocio
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
ISPICKVAL(Cadena_Productiva1__c, "Sistema moda") &&
ISPICKVAL( Modelo_de_Negocio__c , "")
Mensaje error El Modelo de negocio es obligatorio para la cadena Sistema Moda
Campo Modelo de Negocio
Estado Activo

4.2.7. PSE_M_OI_QCV_AGRO_Subsector

Objeto Proyecto__c
Nombre PSE_M_OI_QCV_AGRO_Subsector
Descripción El Subsector es obligatorio para la cadena de valor Metalmecánica y
otras industrias, Químicos y ciencias de la vida, Agroalimentos de los
Proyectos de Planes Sectoriales de Exportación
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&

Página 9 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

( ISPICKVAL(Cadena_Productiva1__c, "Metalmecánica y otras

industrias") || ISPICKVAL(Cadena_Productiva1__c, "Químicos y
ciencias de la vida") || ISPICKVAL(Cadena_Productiva1__c,
"Agroalimentos") ) && ISPICKVAL( Subsector__c , "")
Mensaje error El Subsector es obligatorio
Campo Subsector
Estado Activo

4.2.8. PSE_M_OI_QCV_AGRO_Sector

Objeto Proyecto__c
Nombre PSE_M_OI_QCV_AGRO_Sector
Descripción El Sector es obligatorio para la cadena de valor Metalmecánica y otras
industrias, Químicos y ciencias de la vida, Agroalimentos de los
Proyectos de Planes Sectoriales de Exportación
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
( ISPICKVAL(Cadena_Productiva1__c, "Metalmecánica y otras
industrias") || ISPICKVAL(Cadena_Productiva1__c, "Químicos y
ciencias de la vida") || ISPICKVAL(Cadena_Productiva1__c,
"Agroalimentos") ) && ISPICKVAL( Sector1__c , "")
Mensaje error El Sector es obligatorio
Campo Sector
Estado Activo

4.2.9. PSE_M_OI_QCV_AGRO_Modelo_Negocio

Objeto Proyecto__c
Nombre PSE_M_OI_QCV_AGRO_Modelo_Negocio
Descripción El Modelo de negocio es obligatorio para la cadena de valor

Página 10 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

Metalmecánica y otras industrias, Químicos y ciencias de la vida,

Agroalimentos de los Proyectos de Planes Sectoriales de Exportación
Formula error RecordType.DeveloperName = "Plan_Sectorial_Exportacion" &&
( ISPICKVAL(Cadena_Productiva1__c, "Metalmecánica y otras
industrias") || ISPICKVAL(Cadena_Productiva1__c, "Químicos y
ciencias de la vida") || ISPICKVAL(Cadena_Productiva1__c,
"Agroalimentos") ) && ISPICKVAL( Modelo_de_Negocio__c , "")
Mensaje error El Modelo de negocio es obligatorio para la cadena M&OI – QCV –
AGRO
Campo Modelo de Negocio
Estado No Activo

Nota: Se deshabilita la regla de validación para ajustar un cambio solicitado en las pruebas
de certificación, porque el campo modelo de negocio solo aplica para la cadena productiva
Sistema Moda.

5. Caso de Uso 2: Objeto Oportunidades

5.1. Descripción del Caso de Uso.

En la actualidad se cuenta con la plataforma (CRM Salesforce) aplicativo NEO, el cual, su

función principal es ayudar a sus Stackeholder´s a implementar estrategias para la
comercialización de productos, buscando empresas interesadas en gestionar negociaciones
de tipo exportación. Allí se tienen los proyectos, servicios y oportunidades, donde se
identificó que, dentro de sus funcionalidades, se deben corregir las reglas de validación de
los campos (relacionados a continuación) para dar una mejor experiencia a sus usuarios,
específicamente en planes sectoriales.

Al momento de ingresar a la plataforma de Salesforce se tiene acceso al aplicativo NEO

(CRM), allí nos encontramos en la parte superior, los llamados objetos.

Página 11 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

 Historia de Usuario 1_1: Quiero que, el sistema en el campo list Planes

Sectoriales, me relacione los planes sectoriales registrados en el objeto servicios,
campo oportunidades generadas.
 Historia de Usuario 1_2: Quiero que, el sistema en el campo list Planes
Sectoriales, me permita seleccionar un solo registro (PSE) Plan Sectorial de
Exportación.
 Historia de Usuario 1_3: Quiero que, el sistema en el campo list Planes
Sectoriales, me permita dejar el campo en blanco (vacío) y continuar con el registro
siempre y cuando no cuente con un (PSE) Plan Sectorial de Exportación
relacionado.

5.2. Restricciones:

En el desarrollo del caso de uso 2; en el objeto de Oportunidades, la historia de usuario 1_1,

quiere mostrar solamente los planes sectoriales que están relacionados a los instrumentos-
servicios que tiene asociados.

En el objeto Oportunidades se tiene un campo Plan Sectorial que busca los proyectos
creados con el tipo de registro “Plan de Sectorial Exportación”; para validar cuales son los
planes para mostrar asociado al Instrumento-Servicio que tiene asociado.

5.3. Modelo de Objetos relacionados.

En el sistema de objetos que tiene creados en la plataforma de Salesforce en la Aplicación

NEO, el caso de uso validara los siguientes objetos que están relacionados de acuerdo lo
que describe el caso de uso.

 Plan de sectorial de Exportación (Proyecto__c)

 Instrumento-Servicio (Instrumentos__c)
 Proyectos por Intrumento (proyectos_x_instrumentos__c)

Página 12 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

 Oportunidades: (Oportunidad__c)

5.4. Desarrollo del Trigger (Desencadenador) para validación de Planes

Sectoriales relacionado con el Instrumento-servicio.

Para cumplir con las Historias de Usuario 1_2 y 1_3, se desarrollo un trigger
(desencadenador) llamado OportunidadTrigger.trigger el cual permite gestionar los eventos
sobre el objeto Oporunidad__c, cuando se realizan inserciones y modificaciones.

Para el desarrollo del Trigger se utilizó el Framework Kevin O’hara, para definir el patrón
de diseño mejor utilizado para estructurar las clases que se requieren para el desarrollo de
este tipo de eventos.

Página 13 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

Repositorio github Kevin O’hara framework:

https://github.com/kevinohara80/sfdc-trigger-
framework

Se crearon las siguientes clases para cumplir con el requerimiento.

5.5. Cobertura de Código fuente

En el desarrollo de clases y disparadores en Salesforce, requiere un mínimo del 75% de

cobertura de código probado con la ayuda de Test Unitarios, lo cuales se crearon para poder
tener una cobertura que permita hacer los despliegues en producción.

 OpportunityTriggerHandler_Test: Clase Test para las pruebas unitarias de la

clase OpportunityTriggerHandler

Página 14 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

 TriggerHandler_Test: Clase Test para las pruebas unitarias del trigger

OportunidadTrigger y TriggerHandler.

Desde el ambiente de QA de Salesforce, se realizaron los test unitarios indicando una

cobertura superior de 75%.

Página 15 de 16
 Código: FR-SE-009
SOLUCIONES ESTRATEGICAS
Versión: 0.5
Fecha de vigencia
DOCUMENTACIÓN TÉCNICA 01/09/2022

Se realiza el despliegue de estas clases en el Ambiente de Producción el 28 de Septiembre

de 2022, con la validación de los test unitarios con éxito.

Página 16 de 16