Linha Microsiga Protheus - Espanhol

Atalhos

Árvore de páginas

Configuración para acceso al portal del vendedor

Producto:

Protheus
Entorno:Facturación (SIGAFAT)

Ocurrencia:

Configuración completa para acceso al portal del vendedor.

Paso a paso:

A continuación indicamos los registros necesarios para acceso al Portal del vendedor:


Para habilitar los Portales Protheus, es necesario que los WebServices estén activos.  Ambos servicios dependen del servicio HTTP del Protheus, que permite que las informaciones se publiquen en la WEB. 

La configuración comienza habilitando el servicio HTTP y configurando el puerto que todos los otros servicios dependientes de este utilizarán para la publicación de las informaciones.


Los servicios deben configurarse por el WIZARD, pues a cada módulo WEB instalado se descomprimen archivos importantes en el directorio informado en la configuración. Estos archivos son de extensión exclusiva de Microsiga, los *.MZP, y que solamente con el Wizard será posible la correcta instalación.

En el ejemplo anterior, la configuración se está realizando para el camino LOCALHOST. Para publicarlo, informe el nombre de la máquina o la dirección IP.

Si su servicio HTTP estuviera configurado para el puerto 80, no debe informarlo en el host. Ejemplo localhost/ws.



A - Acceda al Wizard de configuración de los Servicios.


B - En Servidor Internet (HTTP/FTP), verifique si existe el servicio de HTTP, confirme si está habilitado y para qué puerto está configurada. Pues estas son informaciones indispensables para el correcto funcionamiento de los WebServices y Portales


  • Realice el Download de los Archivos de Portales (web_files) del Portal del cliente.
  • Incluya una carpeta web dentro del Protheus Data del Sistema e incluya los web_files.
  • Incluya también los archivos  web_files en la carpeta systemload.
  • Seleccione la opción: <HTTP> y haga clic en la barra superior <Editar> de acuerdo con el ejemplo.
  • El sistema mostrará la pantalla para Configuración de la sección donde los principales campos son:
    • Flag para habilitar el Protocolo.
    • Path de archivos = Camino de la Carpeta Web.
    • Entorno = Nombre del entorno.
    • Puerto de conexión = Puerta de configuración de los Servicios.


Importante

En la configuración de la Sección, incluimos como ejemplo el puerto 92, sin embargo esta puede modificarse si prefiriera.

Si se definiera el puerto estándar del servicio HTTP que es la 80, no es necesario especificarla en la configuración del WS y Portales.


Basta confirmar y grabar las configuraciones.


D - Configure los Módulos de la Web:

  • Realice las configuraciones básicas, campos importantes:
    • Módulo Web = WS - TOTVS Línea Protheus Web Services.
    • Nombre de la instancia = ws.
    • Directorio Raíz de las imágenes (Web Path) = Directorio de la Carpeta Web donde el sistema creará la carpeta "ws".
    • Seleccione el Environment = Nombre del entorno.
    • Flag para habilitar procesos en la inicialización del Servidor.


  • Realice la Configuración de Host vs. Empresas/Sucursales, campos importantes:
    • Host = Server y puerto de los Web Services (Debe informarse el puerto informado en la Configuración HTTP/FTP).
    • Seleccione la Empresa/Sucursal = Empresa y Sucursal de acceso (Para configuración Multisucursal, consulte la respectiva solapa).
    • Haga clic en "Vincular" y en "Avanzar".


Finalizar y confirmar la configuración.


E - Configure el Portal (Protheus)

  • Realice las configuraciones básicas, campos importantes:
    • Módulo Web = PP - Portal Protheus.
    • Nombre de la instancia = pp.
    • Directorio raíz de las imágenes (Web Path) = Directorio de la Carpeta Web donde el sistema creará la carpeta "pp".
    • Seleccione el Environment = Nombre del entorno.
    • URL do Protheus Web Services = Server y Puerto de configuración de los Web Services.
  • Realice la Configuración de Host vs. Empresas/Sucursales, campos importantes:
    • Host = Server y puerto del Portal (Debe informarse el puerto informado en la Configuración HTTP/FTP).
    • Seleccione la Empresa/Sucursal = Empresa y Sucursal de acceso (Para configuración Multisucursal, consulte la respectiva solapa).
    • Haga clic en "Vincular" y en "Avanzar".
  • Realice la Configuración de usuarios, donde definirá el número mínimo y máximo de usuarios para acceso.

Finalizar y confirmar la configuración.

Incluya en la carpeta pp colocar los archivos de la carpeta web en systemload.


F - Después de las configuraciones anteriores, el sistema incluirá las informaciones de acceso a los Web Services en el archivo AppServer.ini del Protheus, verifique si las informaciones están de acuerdo con el siguiente ejemplo, si no estuvieran realice ajustes (Recordando que el Puerto y el Nombre del entorno serán los que completó durante la configuración):

[HTTP]

ENABLE=1

PORT=81


[localhost:92/ws]

ENABLE=1

PATH=c:\seuambiente\Protheus_Data\web\ws

ENVIRONMENT=12.1.025

INSTANCENAME=ws

RESPONSEJOB=JOB_WS_9901

DEFAULTPAGE=wsindex.apw

SECURITY=0


[JOB_WS_9901]

TYPE=WEBEX

ENVIRONMENT=12.1.025                                         

INSTANCES=1,1

SIGAWEB=WS

INSTANCENAME=ws

ONSTART=__WSSTART

ONCONNECT=__WSCONNECT

PREPAREIN=99,01

SECURITY=0


[localhost:92/pp]

ENABLE=1

PATH=c:\seuambiente\Protheus_Data\web\pp

ENVIRONMENT=12.1.025                                       

INSTANCENAME=pp

RESPONSEJOB=JOB_PP

SECURITY=0


[JOB_PP]

TYPE=WEBEX

ENVIRONMENT=ENVIRONMENT

INSTANCES=1,1

SIGAWEB=PP

INSTANCENAME=pp

ONSTART=STARTWEBEX

ONCONNECT=CONNECTWEBEX

ONEXIT=FINISHWEBEX

WEBSERVICELOCATION=http://localhost:92/ws

SECURITY=0


Alerta de riesgo

"Quede atento al utilizar el parámetro de configuración con la clave Security=0, pues esto permitirá que las integraciones (API) no exijan autenticación, consecuentemente los datos de su entorno podrán consultarse sin ningún control de autorización."


G - Finalmente, reinicie el Server del Protheus y verifique si el servicio del WebService subió de forma correcta al Browser, basta digitar el camino que configuró en el Wizard y verifique si el sistema indica como Habilitado:

El proceso de configuración para una nueva sucursal es básicamente el mismo, pero es necesario tener un nuevo WebService y Portal.


  • Realice las configuraciones básicas, campos importantes:
    • Módulo Web = WS - TOTVS Línea Protheus Web Services.
    • Nombre de la instancia = ws.
    • Directorio raíz de las imágenes (Web Path) = Directorio de la Carpeta Web donde el sistema creará la carpeta "ws".
    • Seleccione el Environment = Nombre del entorno.
    • Flag para habilitar procesos en la inicialización del Servidor.


  • Realice la Configuración de Host vs. Empresas/Sucursales, campos importantes:
    • Host = Server y puerto de los Web Services (Debe informarse el puerto informado en la Configuración HTTP/FTP).
    • Seleccione la Empresa/Sucursal = Empresa y Sucursal de acceso (Para configuración Multisucursal, consulte la respectiva solapa).
    • Haga clic en "Vincular" y en "Avanzar".


Finalizar y confirmar la configuración.

  • Realize las configuraciones básicas, campos importantes:
    • Módulo Web = PP - Portal Protheus.
    • Nombre de la instancia = pp.
    • Directorio raíz de las imágenes (Web Path) = Directorio de la Carpeta Web donde el sistema creará la carpeta "pp".
    • Seleccione el Environment = Nombre del entorno.
    • URL del Protheus Web Services = Server y Puerto de configuración de los Web Services.


  • Realice la Configuración de Host vs. Empresas/Sucursales, campos importantes:
    • Host = Server y puerto del Portal (Debe informarse el puerto informado en la Configuración HTTP/FTP).
    • Seleccione la Empresa/Sucursal = Empresa y Sucursal de acceso (Para configuración Multisucursal, consulte la respectiva solapa).
    • Haga clic en "Vincular" y en "Avanzar".


Finalizar y confirmar la configuración

Los servicios deben configurarse por el WIZARD, pues a cada módulo WEB instalado se descomprimen archivos importantes en el directorio informado en la configuración. Estos archivos son de extensión exclusiva de Microsiga, los *.MZP, y que solamente con el Wizard será posible la correcta instalación.

En el ejemplo anterior, la configuración se está realizando para el camino LOCALHOST. Para publicarlo, informe el nombre de la máquina o la dirección IP.

Si su servicio HTTP estuviera configurado para el puerto 80, no debe informarlo en el host. Ejemplo localhost/ws.

Para cada sucursal nueva es necesario configurar un nuevo portal.



C - Después de las configuraciones anteriores, el sistema incluirá las informaciones de acceso a los Web Services en el archivo AppServer.ini del Protheus, verifique si las informaciones están de acuerdo con el siguiente ejemplo, si no estuvieran realice ajustes (Recordando que el Puerto y el Nombre del entorno serán los que completó durante la configuración):

[HTTP]
ENABLE=1
PATH=C:\nombre del entorno\Protheus_Data\Web
PORT=91
ENVIRONMENT=nombre del entorno

[localhost:91/ws]
ENABLE=1
PATH=C:\nombre del entorno\Protheus_Data\web\WS
ENVIRONMENT=nombre del entorno
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_9901 → (Sucursal 01)
DEFAULTPAGE=wsindex.apw

[JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=nombre del entorno
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01 → (Sucursal 01)

[ONSTART]
;JOBS=JOB_WS_9901,JOB_PP,JOB_WS02_9902,JOB_PP02

[localhost:91/pp]
ENABLE=1
PATH=C:\nombre del entorno\Protheus_Data\web\pp
ENVIRONMENT=nombre del entorno
INSTANCENAME=pp
RESPONSEJOB=JOB_PP

[JOB_PP]
TYPE=WEBEX
ENVIRONMENT=nombre del entorno
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=PP
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:91/ws → (URL de la sucursal 01)

[localhost:91/ws02]
ENABLE=1
PATH=C:\nombre del entorno\Protheus_Data\web\WS02
ENVIRONMENT=nombre del entorno
INSTANCENAME=WS02
RESPONSEJOB=JOB_WS02_9902 → (Sucursal 02)
DEFAULTPAGE=wsindex.apw

[JOB_WS02_9902]
TYPE=WEBEX
ENVIRONMENT=nombre del entorno
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=WS02
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,02 → (Sucursal 02)

[localhost:91/pp02]
ENABLE=1
PATH=C:\nombre del entorno\Protheus_Data\web\pp02
ENVIRONMENT= nombre del entorno
INSTANCENAME=pp02
RESPONSEJOB=JOB_PP02

[JOB_PP02]
TYPE=WEBEX
ENVIRONMENT=nombre del entorno
INSTANCES=1,1
SIGAWEB=PP
INSTANCENAME=pp02
ONSTART=STARTWEBEX
ONCONNECT=CONNECTWEBEX
ONEXIT=FINISHWEBEX
WEBSERVICELOCATION=http://localhost:91/ws02 → (URL de la Sucursal 02)


D - Finalmente, reinicie el Server del Protheus y verifique si el servicio del WebService subió de forma correcta al Browser, basta digitar el camino que configuró en el Wizard y verifique si el sistema indica como Habilitado:



Después de la configuración de los Web Services, comenzaremos la configuración del Portal del vendedor. Para ello:

  • Acceda a Faturamento / Actualizaciones / Portal / Web Service y haga clic en Automático.
  • Se cargarán los Web Services.
  • Acceda a Facturación / Actualizaciones / Portal  /Menú de los portales y verifique si los menús están cargados.



Acceda a Facturación / Actualizaciones / Portal / Usuarios e incluya un nuevo usuario.

  • Digite el usuario, el nombre y la contraseña de acceso del usuario.
  • Vincule un usuario interno del sistema que esté vinculado con un vendedor.
  • Después de grabar, visualice el Usuario del portal, se completará automáticamente la línea de vendedor;
  • Haga clic en la solapa derechos, del registro de usuario del Portal, seleccione Acciones relacionadas / Carga derechos y se cargarán los derechos.


Para acceder al Portal del vendedor, verifique si el servicio del WebService <PP> subió de forma correcta al Browser.

Digitando el usuario y contraseña del Portal registrados, es posible visualizar las rutinas en el Portal del vendedor.


Importante

MV_PORTAL1 - permite que se especifique el camino (path) del archivo txt que contiene el fuente html que muestra un texto institucional (u otro deseado) para mostrarse en la Página principal del Portal Protheus.


El texto que se mostrará puede ser libremente editado, utilizando todos los recursos disponibles en html, como formateo del texto, color, indentación, etc. El archivo obligatoriamente debe almacenarse dentro de la Raíz RootPath del Microsiga Protheus Server.

Se recomienda que este se mantenga dentro del directorio web del Portal Protheus, por cuestiones de organización, aunque esta sea una práctica facultativa. Ejemplo:\web\portal_protheus\institucional.txt

Utilizar un camino/directorio equivocado en este parámetro, así como en los otros parámetros MV_PORTAL (2,3 y 4) , puede trabar el acceso a las rutinas por medio del menú y traer falla de comunicación con la base de datos




El lenguaje del Portal se mostrará de acuerdo con la cumplimentación de la clave "RpoLanguage" dentro del appserver.ini del entorno configurado. De acuerdo con el lenguaje que se cargue en esta clave, esta se mostrará en el portal cuando el usuario efectúe el acceso. Ejemplo: RpoLanguage = Portuguese permitirá que el portal se muestre en el lenguaje seleccionado.



Puede ser de su interés:

Inclusión de presupuesto en el Portal del vendedor: https://tdn.totvs.com/x/l3-7I

Inclusión de pedido en el Portal del vendedor: https://tdn.totvs.com/x/PPoDIQ

Invalid Class ARRAYOFUSERFIELD on GRIDLINESEX: https://tdn.totvs.com/x/eh59IQ - solapa posibles inconsistencias