ARBUT WebGuia d'instal·lació del programari Connect

ARBUT WebConnectar el programari

Copyright

Copyright © 2023 Arbutus Software Inc. Tots els drets reservats.
Aquest manual pot contenir informació datada. L'ús d'aquests materials es basa en la comprensió que aquest manual pot no contenir tota la informació, o la informació més actual, rellevant per a l'aplicació prevista. Els serveis d'assistència i actualització estan disponibles mitjançant un acord escrit separat.
Publicat el desembre de 2023 per:

Arbutus Software Inc.
270 – 6450 Roberts Street Burnaby, Colúmbia Britànica Canadà V5G 4E1
Telèfon: +1-604-437-7873
Fax: +1-604-437-7872
Correu electrònic: Info@ArbutusSoftware.com
Web: www.ArbutusSoftware.com

"Arbutus", Analitzador, "ConnectPlus", "Smart Link per a SAP" i "WebConnect” són marques registrades d'Arbutus, o d'una de les seves filials o llicenciants. L'ús d'un terme en aquest manual no s'ha de considerar que afecti la validesa de cap marca comercial o de servei.

Sobre aquesta guia

Aquesta guia es proporciona als usuaris amb llicència d'Arbutus WebConnecteu-vos per proporcionar instruccions ràpides sobre la seva instal·lació i configuració.
Per obtenir més informació sobre els nostres productes i serveis, visiteu el nostre web lloc a: www.ArbutusSoftware.com

Necessites ajuda?
Contactant amb nosaltres
Si teniu suggeriments de millora o si no trobeu una solució a un problema, podeu contactar amb l'assistència tècnica per obtenir ajuda. Si us plau, inclou:

• El teu número de sèrie.
• Una descripció del que estàveu fent quan es va produir el problema.
• El missatge d'error, si s'ha trobat.

Centre de suport

• Taulell d'ajuda global
  • Telèfon: +1-604-437-7873 or +1-877-333-6336 ext. 333
  • Fax: +1-604-437-7872
  • Correu electrònic: support@ArbutusSoftware.com
• O escriu-nos a: 
  • Arbutus Software Inc. 270 – 6450 Roberts Street Burnaby, BC Canadà V5G 4E1

INSTAL·LACIÓ ARBUTUS WEB CONNECTA

Aquesta secció descriu com instal·lar i actualitzar Arbutus WebConnecta't. WebCon-nect requereix la instal·lació de la versió corresponent del servidor Arbutus Hub.

WebInstal·lació de connexió (Windows)
Actualment, Arbutus no utilitza un instal·lador basat en MSI, sinó un zip file de totes les peces necessàries, que al seu torn s'"instal·len" i es configuren mitjançant un simple lot de DOS file. Si cal, aquest lot de DOS file i el corresponent httpd.conf file es pot editar abans d'executar install.bat per garantir la màxima compatibilitat amb el vostre sistema i entorn de xarxa. Cal tenir en compte que si no hi ha Web Servidor que s'executa al port 80 a la mateixa màquina utilitzada per instal·lar WebConnecteu-vos i esteu d'acord amb la ubicació d'instal·lació predeterminada, encara se us demanarà que editeu l'adreça IP i el nom d'amfitrió del Web Servidor a httpd.conf. Si us plau, demaneu al vostre administrador de xarxa la informació adequada. Per garantir la instal·lació més eficient, es recomana que WebConnect està instal·lat en una màquina que encara no n'executa una altra web servidor.

Instal·lació
Per instal·lar WebConnecteu-vos, feu els següents passos senzills:

1. Descarregar WebConnecteu-vos des de la pàgina de descàrregues d'Arbutus: https://www.arbutussoftware.com/en/download-software
2. Creeu una carpeta i copieu EMandWCInstaller.zip a aquesta carpeta
3. Descomprimiu EMandWCInstaller.zip
4. Navegueu a …\EMandWCInstaller\InstallFiles
5. Feu clic amb el botó dret a install.bat i seleccioneu "Executar com a administrador"
   Nota: També podeu obrir un indicador d'ordres de l'administrador i un CD a la ubicació install.bat i executar-lo des de l'indicador d'ordres.
   Nota: Python 3.5 (32 bits) només s'instal·larà si no està al vostre sistema. ("Python 3.12 - 32 bits"

Una vegada WebConnect està instal·lat, hauríeu de poder navegar a tots dos: http:// :port//webconnectar i http:// :port//admin

Se us demanarà la configuració WebConnecteu-vos mitjançant el port d'administració abans que el vostre usuari pugui utilitzar-lo. Si us plau, tornaview la "Configuració d'Arbutus WebConnecteu-vos” a la pàgina 7 per obtenir més detalls.

Actualització d'una instal·lació existent
Quan actualitzeu una instal·lació existent, primer heu d'executar el fitxer uninstall.bat L'execució del fitxer uninstall.bat crearà una còpia de seguretat de la vostra configuració existent i la configuració de la base de dades. L'execució del fitxer install.bat restaurarà aquests paràmetres un cop finalitzada la instal·lació.

Configuració
Si feu les modificacions necessàries, el files que pot ser editat per l'administrador de WebConnectar són:

• install.bat
• httpd.conf
• uninstall.bat
• settings.py

Install.bat

La ubicació d'instal·lació predeterminada al servidor es defineix a la variable WEBAPPS_ BASE al file install.bat i té un valor predeterminat establert en "C:\Arbutus". Podeu canviar aquest camí, però si ho feu, heu d'utilitzar un camí que NO tingui espais. Això al seu torn ajudarà a definir la variable WEBAPPS_HOME (és a dir WEBAPPS_HOME=%WEBAPPS_BASE%\WEBAPPS). Per exampLI: WEBAPPS_HOME -> "C:\Arbutus\WEBAPLICACIONS”

Sistemes operatius Windows 10
Si el sistema operatiu de la màquina és Windows 10 natiu o superior, aquestes màquines ja no contenen un "Programa Files (x86) (tret que el sistema operatiu s'hagi actualitzat de Windows 7 o 8 a Windows 10).
Com a resultat, haureu d'editar el fitxer install.bat per comentar la ruta (x86) de Python i descomentar el programa alternatiu de Windows 10 Fileruta s per a Python: el resultat final hauria de ser així:

establiu PYTHON_PATH="C:\Program Files\Python312-32″
:: defineix PYTHON_PATH="C:\Program Files (x86)\Python312-32"

Res més hauria de requerir modificacions a install.bat. Hi ha diversos comentaris al llarg del file per determinar què fa cada un dels passos.
Nota: El valor de la WEBLa variable APPS_HOME a httpd.conf i el valor de WEBLa variable APPS_ BASE a uninstall.bat s'ha de canviar perquè coincideixi amb el que s'especifica a install.bat

Httpd.conf

La majoria de les seccions de httpd.conf que poden requerir modificacions inclouen una línia de comentari que comença amb:
'# ARBUTUS NOTE -'

1. Canvia el WEBVariable APPS_HOME que coincideixi amb la ruta absoluta completa utilitzada a install.bat: defineix WEBAPPS_HOME “C:/Arbutus/WEBAPLICACIONS”…
2. 2. Canvieu el port d'escolta (això és necessari si existeix un web servidor ja està instal·lat i assignat al port 80): Escolteu 80
3. Canvia la xarxa o WebAdreça de correu electrònic de l'administrador de connexió: ServerAdmin admin@example.com…
4. Si el vostre host local no té un nom DNS registrat, introduïu l'adreça IP de l'amfitrió així com el número de port (tal com s'ha introduït al pas 2 anterior): ServerName localhost:80 …
   Hi ha altres àrees que es poden ajustar a httpd.conf però que no s'han de modificar tret que l'administrador de la xarxa ho aprovi.
   Nota:Per determinar si i què pot estar escoltant al port 80 (HTTP) i/o 443 (HTTPS), podeu obrir un indicador d'ordres com a administrador i introduir netstat –ab o netstat –ao.

HTTPS i certificats
Us recomanem que utilitzeu HTTPS per a comunicacions segures entre els navegadors del vostre usuari i WebConnecta't. WebConnect tindrà tant HTTPS com HTTP habilitats amb Apache Web En el moment de la instal·lació del servidor, però, hauríeu de posar-vos en contacte amb el vostre administrador de xarxa per obtenir ajuda en la configuració i l'ús d'un certificat SSL adequat per evitar avisos del navegador. Editeu Extra\Httpd-ssl.conf en conseqüència.

Nota: Sense utilitzar HTTPS, quan els usuaris inicien sessió WebConnectar la seva contrasenya d'inici de sessió no es xifrarà. Això podria comprometre la seguretat del vostre servidor i/o xarxa de Windows, ja que el nom d'usuari i la contrasenya es transmetran de manera insegura des del navegador de l'usuari al WebConnecta't Web servidor.1

Configuració.py
Això file es pot trobar a: “…\WEBAPPS\App\connectanywhere\connectanywhere\”

El fitxer settings.py file només es pot editar després de la instal·lació, després de fer tots els canvis necessaris a install.bat i httpd.conf files. En el cas que hàgiu modificat el ServerName a httpd.conf a una altra cosa que no sigui 127.0.0.1 o localhost, haureu d'afegir el valor ServerName a la variable ALLOWED_HOSTS afegint el vostre nom de servidor particular a la llista existent, per exemple.ample: ALLOWED_HOSTS = ['127.0.0.1', 'localhost', 'CustomServerNameOrIP', ]

Uninstall.bat
Canvia el WEBLa variable APPS_BASE per coincidir amb el valor utilitzat a install.bat i actualitzar qualsevol altre camí codificat en dur que s'hagi modificat a install.bat. Si install.bat ha instal·lat Python 3.12 (32 bits) i ja no el necessiteu, haureu d'eliminar-lo manualment mitjançant Programes i característiques. Uninstall.bat sempre farà una còpia de seguretat del següent files: Settings.py, httpd.conf i la base de dades file arbutus_db.sqlite3 al fitxer WEBDirectori APPS_BASE.
Nota: Per actualitzar un existent WebConnecteu la instal·lació, primer heu de desinstal·lar la instal·lació existent mitjançant uninstall.bat

Python 3.12 - 32 bits
Python 3.12 (32 bits) és un requisit de la WebInstal·lació de connexió, però si install.bat detecta que ja està instal·lat, no es tornarà a instal·lar. Cal tenir en compte que el sistema Python només tindrà paquets de llocs pip, virtualenv i vir-tualenvwrapper afegits. Tots els WebConnectar biblioteques específiques estaran contingudes al seu propi virtualenv situat a Env\arbutus per alterar la instal·lació del sistema Python el menys possible. De fet, a més de Python, el complet WebLa instal·lació de Connect és autònoma al directori especificat per WEBAPPS_HOME al fitxer Install.bat.

CONFIGURANT ARBUTUS WEBCONNECTA

Inici de sessió
Navegueu fins al nom d'amfitrió/IP del fitxer Webconnectar weblloc amb "administrador" com a sub URL camí. Per example: http://webconnect_demo.com/admin/
Els detalls d'autenticació per a l'administració són per defecte un nom d'usuari "admin" i una contrasenya "adminpassword". Després d'iniciar sessió correctament, se us redirigirà a la secció d'administració de WebConnecteu-vos, on vosaltres, com a administrador de WebConnecteu-vos, proporcioneu les metadades necessàries per a WebConnectar i els seus usuaris per comunicar-se amb èxit amb l'encarregat WebServidor d'aplicacions.

Configuració de taules
Hi ha cinc taules de configuració principals que s'han d'omplir amb dades rellevants:

• Configuracions globals
• Servidor profiles
• Carpetes compartides
• Usuari professionalfiles
• Descripcions de variables

Totes aquestes taules es poden afegir, editar o suprimir. "Configuracions globals" és un cas especial en què només hi ha una instància (registre) que es pot editar.

Configuracions globals
Heu d'afegir un model de configuració global i desar-lo, encara que no necessiteu modificar cap de les opcions predeterminades disponibles.

Prefix prefixat per l'usuari
El primer element que s'ha d'editar a la taula "Configuracions globals" és el prefix prefixat per l'usuari, que especifica un prefix predeterminat opcional que es pot utilitzar com a prefix per defecte per a tots els usuaris. L'avançtagLa part d'aquest prefix és que requereix molt poca configuració específica de l'usuari i fa WebConnecteu-vos ràpidament per als usuaris amb només algunes convencions menors de configuració de carpetes al servidor file sistema. Per exampcom a administrador, si especifiqueu un prefix prefixat de "C:\tmp", tots els usuaris heretaran per defecte un prefix d'usuari de "C:\tmp\". ', on és el nom d'usuari utilitzat per a l'autenticació. L'únic requisit previ és que hàgiu creat prèviament totes les carpetes necessàries amb els permisos adequats al servidor. Per example, utilitzant el nostre exampfitxer d'un prefix d'usuari de "C:\tmp":

• C:\tmp\dewey
• C:\tmp\huey
• C:\tmp\louie

On dewey, huey i louie són noms d'usuari amb els quals s'autenticarà WebConnecta't.

• Logotip corporatiu
  WebConnect permet l'opció de carregar i mostrar el vostre logotip corporatiu centrat WebConnecta's web pàgines. Simplement feu clic a Tria File per seleccionar la imatge del logotip que es mostrarà.
• Mostra les taules de dades
  Aquesta opció mostra taules a la carpeta compartida dels usuaris. De manera predeterminada, està activat. Apagueu si no voleu mostrar taules.
• Mostra les carpetes privades
  Aquesta opció mostra la carpeta compartida privada dels usuaris. De manera predeterminada, està activat. Apagueu si no voleu mostrar la carpeta compartida privada dels usuaris.

Server Profiles
El 'Server profileLa taula s'hauria d'editar a:

• especifica el valor predeterminat 'Webapp Server' per a la comunicació amb WebConnecta't.
• especifica el servidor profiles això WebConnect s'utilitza per comunicar-se amb qualsevol servidor Arbutus als quals es fa referència als vostres procediments.
• permetre el servidor pro necessarifiles per omplir un servidor intern profiles file
  Nota: Actualment, només un "WebServidor d'aplicacions' es pot especificar en aquest moment. En una versió futura, és possible que admetem diversos WebEls servidors d'aplicacions estan disponibles per a WebConnecta't.

Usuaris
La taula Usuaris s'ha d'editar per especificar la llista d'usuaris del directori actiu que accediran al servidor professional especificatfiles i el contingut relacionat (taula i procediments) quan inicieu sessió WebConnecta't.
Si no existeix cap usuari de directori actiu, podeu crear-lo fent clic a la icona "+". L'usuari creat es pot afegir per tenir accés al servidor especificat.files.
Nota: Podeu mantenir premuda la tecla CTRL per seleccionar massivament i associar diversos usuaris al servidor professional especificatfile.

Detalls de l'usuari

• Tipus de servidor - la llista de tipus de servidors Arbutus compatibles. Seleccioneu el tipus de plataforma adequat on està instal·lat el vostre servidor Arbutus.
• Nom - el servidor profile etiqueta de nom per al servidor Arbutus especificat.
• Port - el número de port on el servidor Arbutus especificat està escoltant les connexions
• Temps d'espera - el nombre de segons que Arbutus Server estarà inactiu abans d'esgotar el temps
• Xifratge - el nivell de xifratge de les dades enviades entre WebConnectar i Arbutus Server.
• Compressió - el nivell de compressió de les dades enviades entre WebCon-nect i Arbutus Server.
• WebServidor d'aplicacions - mireu els comentaris anteriors, només un WebEl servidor d'aplicacions es pot designar alhora.

Carpetes compartides
La taula Carpetes compartides enumera totes les carpetes compartides que es troben al WebServidor d'aplicacions al qual estan associats un servidor Arbutus i els seus usuaris. Normalment es tracta d'ubicacions de carpetes comunes compartides entre molts usuaris, o es pot restringir a un subgrup d'usuaris.
Des de la perspectiva dels usuaris, les carpetes compartides dictaran què veurà l'usuari a l'arbre esquerre view quan inicien sessió WebConnecta't. Sempre que tots els usuaris associats a la carpeta compartida tinguin el correcte file permisos, veuran totes les carpetes, taules i procediments continguts a cada carpeta compartida.

Quan es selecciona:

• taules seran viewcapaç en una graella desplaçable view
• Els procediments mostraran una nota explicativa (si n'hi ha) sobre l'execució del procediment i les entrades necessàries, a més de quadres de text per introduir les variables requerides (i per mostrar els valors assignats prèviament). Els usuaris poden acceptar els valors preassignats (si n'hi ha) o introduir els valors rellevants
• els procediments es poden executar ressaltant el nom del procediment i fent clic al botó RUN a la part inferior de l'arbre esquerre view

Detalls de la carpeta compartida

• Usuaris - una llista d'usuaris del directori actiu que veuran aquesta carpeta compartida i el seu contingut en iniciar sessió WebConnecta't. Si no existeix cap usuari de directori actiu, podeu crear-lo fent clic a la icona "+". L'usuari creat es pot afegir per tenir accés al servidor professional especificatfiles.
  Nota: Podeu mantenir premuda la tecla CTRL per seleccionar i associar diversos usuaris a la carpeta compartida especificada.
• Nom - és l'etiqueta que es mostrarà WebConnecta't per a aquesta carpeta compartida
• Camí - és el físic file ruta al servidor Arbutus especificat
• Per defecte - Si se selecciona, tots els usuaris recentment afegits tindran aquesta carpeta compartida associada automàticament amb ells
• Server Profile – mostra el servidor pro seleccionatfile, permet triar el servidor pro-file i permet afegir un nou servidor profile. També permet a l'usuari editar el servidor pro existentfile.

Descripcions de variables
La taula de descripcions de variables enumera tots els noms de variables globals que estan disponibles per a tots els usuaris assignats i es poden fer referència als procediments executats pels usuaris. Es poden afegir variables i editar els valors predeterminats. Quan s'executen un procediment, els usuaris poden canviar el valor d'una variable segons sigui necessari. Les variables mostraran els seus valors anteriors per millorar l'eficiència.

Detalls de la variable

• Nom de la columna - no és editable i s'assigna automàticament per Webconnectar
• Descripció de la columna - és l'etiqueta de la variable i com s'ha de fer referència als procediments
• Títol de la columna - és un títol descriptiu opcional que es mostra en lloc de la descripció de la columna
• Editable per l'usuari - per defecte és ON. Quan s'estableix a ON, l'usuari pot canviar aquest valor quan selecciona el procediment WebConnecta't. Si està desactivat, no poden editar el valor de les variables que va ser assignat per l'administrador
• Usuari viewcapaç - el valor predeterminat és ON. Si està activat, l'usuari ho pot fer view aquest valor quan seleccionen el procediment a WebConnecta't. Si estan desactivats, no poden fer-ho view o editar el valor de les variables que va ser assignat per l'administrador
• Lots: Si la llista està buida, tots els procediments tindran accés a aquesta variable. Si s'introdueix un procediment o una llista de procediments (separats per comes), NOMÉS els procediments especificats tindran accés a aquesta variable

També hi ha una variable interna especial que es pot fer referència als procediments sense afegir-se a les descripcions de variables que es mostren a continuació. S'anomena "prefix_usuari" i s'omple automàticament a partir del valor introduït a l'usuari professionalfile prefix – vegeu “User Profile Detalls” a la pàgina 11 per obtenir més detalls. Això us permet accedir còmodament al valor del prefix de sortida de cada usuari sense haver de configurar-lo de nou en descripcions variables.

La situació habitual en què és possible que vulgueu utilitzar aquesta variable és quan s'utilitza l'ordre Notify en un procediment i heu d'especificar la ruta completa del fitxer adjunt per a una sortida. file, potser un exportat file, que s'ha desat a la carpeta de prefixos de sortida dels usuaris.

ASSIGN attachment_path=prefix_usuari+”\EXCELFILE.XLSX”
NOTIFICAR AL REMITENT “AUser@arbutussoftware.com” Bústia de correu “localhost” PORT 25 ADREÇA “%batch_address%” SUBJECTE “%batch_subject%” MISSATGE “%batch_message%” ANNEX “%attachment_path%”

Usuari professionalfiles
L'usuari ProfileLa taula s enumera tots els usuaris vàlids. Els usuaris es poden afegir a aquesta llista o editar la seva informació. Un usuari s'afegirà automàticament a l'usuari professionalfile taula si s'autentiquen correctament amb el servidor Arbutus. Un cop autenticat, un usuari podrà veure les carpetes compartides predeterminades a les quals l'administrador li hagi concedit accés. L'administrador també pot afegir usuaris manualment abans que iniciïn sessió al WebConnecteu el sistema correctament per primera vegada. Això permetria a l'administrador configurar una carpeta compartida personalitzada i un entorn per a ells abans d'iniciar sessió.

Usuari Profile Detalls

• Nom d'usuari - ha de ser exactament el mateix nom d'usuari que és el seu inici de sessió de Windows Server Active Directory. L'administrador l'introdueix per endavant o s'emplenarà automàticament si l'usuari ja ha iniciat sessió correctament.
• Prefix - la carpeta privada de l'Arbutus Windows Server on es col·locaran per defecte totes les sortides dels procediments executats per l'usuari. Aquest és el sandbox privat de l'usuari.
  Nota:Si l'administrador ha configurat prèviament les configuracions globals amb un prefix prefixat, aquest valor pot romandre en blanc. Tanmateix, si voleu un control més granular sobre les carpetes privades de cada usuari, l'administrador pot especificar aquí un prefix de carpeta privada i s'utilitzarà en el seu lloc.
• Els elements restants són una llista de variables i els seus valors corresponents per als quals l'usuari té permís view i/o editar.

Configuració del servidor Arbutus
Per obtenir informació més detallada sobre com establir Server Profiles per als usuaris i la configuració de carpetes compartides empresarials, consulteu la documentació associada següent:

• Ajuda de l'analitzador
• Guia d'instal·lació de l'analitzador
• Guia d'instal·lació del servidor Arbutus Hub

Configuració de procediments (scripts) per utilitzar-los a WebConnecta't
Hi ha alguns passos bàsics per configurar procediments (scripts) per utilitzar-los Webconnectar.

Afegir variables d'usuari als procediments
Un cop hàgiu establert les entrades de variables que s'han de proporcionar als usuaris (editables o no), aquests noms de variables s'han de fer referència en el procediment perquè els seus valors s'utilitzin. Per tant, l'administrador ha d'editar els procediments que han d'utilitzar aquestes variables i substituir els noms de les variables directament o mitjançant la substitució de macro segons sigui necessari per habilitar-ne l'ús. És important tenir en compte que l'ús d'entrades variables és la millor pràctica prevista per a l'entrada de l'usuari WebConnecta't.

Configuració d'una única comanda de diàleg simple als procediments
Es permet l'ús d'una única comanda de diàleg simplificada WebConnecteu-vos, però no és una bona pràctica. Les variables d'usuari són la millor pràctica recomanada per a l'entrada de l'usuari. Tràmits en Web Connect es tracten com treballs programats, de manera que, tot i que un procediment s'admet una única ordre de diàleg simplificada, l'ordre de diàleg ha d'estar a la part superior del procediment envoltada per les ordres d'inici de programació i de fi de programació; consulteu l'Ajuda de l'analitzador per obtenir-ne més detalls.
Nota: Les ordres d'acceptació i pausa no s'admeten WebConnecteu els scripts. Aquestes ordres s'han d'eliminar de qualsevol script en què vulgueu utilitzar WebConnecta't.