Vai al contenuto principale

Configurazione dell'accesso all'API di ShareFile

 

 

1. Visita l'Amministrazione di ShareFile

Per consentire a LogicalDOC di accedere al tuo account ShareFile devi prima preparare un API Key, pertanto accedi alla tua console API DocuSign nell'amministrazione https://api.sharefile.com e fai clic sul collegamento Get an API key.

Questo ti porterà all'API Key Generator:

ShareFile key gen

2. Genera la chiave API

Compila il campo Application Name con qualsiasi nome, ad es. logicaldoc

Nel campo Redirect URL inserisci un URL nel formato https://tuodominio.com/sharefile-callback dove tuodominio.com è il dominio che ShareFile utilizzerà per contattare la tua installazione di LogicalDOC.

ShareFile key gen

Fai clic su Generate API Key e vedrai la tua nuova chiave nell'elenco seguente, ogni chiave definisce un ID client e un segreto client, quindi utilizzerai quei codici in LogicalDOC.

ShareFile api key

HTTPS è obbligatorio

ShareFiles deve comunicare con LogicalDOC tramite il protocollo HTTPS, questa è una scelta progettuale di ShareFile adottata per massimizzare la sicurezza. Di conseguenza è obbligatorio rendere LogicalDOC accessibile su Internet tramite HTTPS con un certificato valido.

3. Torna a LogicalDOC e inserisci le informazioni

Apri il menu Strumenti > StareFile > Autorizza e incolla le informazioni dalla chiave appena creata.

Report Parameter

Quindi premere su Autorizza e seguire la completa autenticazione in ShareFile.

Callback URL

Assicurati che l'URL di richiamata che hai configurato nella chiave API, corrisponda all'URL del server che vedi in Amministrazione > Impostazioni > Parametri > server.url

 

Configurazione di OnlyOffice

Puoi creare una connessione tra OnlyOffice e LogicalDOC. In questo modo, sarai in grado di usare OnlyOffice per modificare e creare documenti archiviati all'interno di LogicalDOC. OnlyOffice può essere usato in diversi modi online e in locale, ma al momento della stesura di questo articolo LogicalDOC è stato testato su OnlyOffice Document Server per Docker e questa guida si basa sul tutorial ufficiale.

1

Esecuzione dell'immagine Docker

In una macchina di dimensioni minime con Docker versione 1.9.0 o successiva, utilizzare questo comando per installare OnlyOffice Document Server:

sudo docker run -i -t -d -p 8084:80 --restart=always -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Questo comando avvia il contenitore Docker con le impostazioni standard e imposta la porta di lavoro su 8084. Puoi modificarla a tuo piacimento.

2

Collegare LogicalDOC con OnlyOffice

L'integrazione con OnlyOffice è implementata da un apposito convertitore di formato che deve essere opportunamente abilitato e configurato.

Vai su Amministrazione > Importa ed Esporta > Convertitori di formato e qui individua il convertitore denominato OnlyOfficeConverter, abilitalo ed espandi la sua configurazione per adattarla ai parametri di connessione:

  • url:  l'indirizzo per comunicare con il tuo OnlyOffice Document Server
  • security.key: in caso di configurazione standard, puoi usare my_jwt_secret
  • callback: l'indirizzo che OnlyOffice Document Server utilizzerà per chiamare il tuo LogicalDOC

Poi premi su Salva e hai fatto.

Configurazione dell'API di ChatGPT

Prima di poter iniziare a integrare LogicalDOC con l'API di ChatGPT, è necessario ottenere una chiave API per accedervi.

1

Creare un account

Puoi creare un account gratuito registrandoti qui. 

2

Generare un'API key

Una volta effettuato l'accesso, vai al sito web della piattaforma: https://platform.openai.com

Qui crea un nuovo progetto e chiamalo LogicalDOC:

Quindi passa al progetto creato, clicca su Generate new secret key e inserisci un nome per la tua chiave nella finestra pop-up. Dopo aver inserito un nome, clicca su Create secret key.

Create ChatGPT key

Nella schermata successiva, copia la tua API Key e conservala in un posto sicuro. Non potrai più visualizzarla.

Save ChatGPT key

3

Imposta la fatturazione

OpenAI implementa un modello pay-per-use per i suoi servizi API. Pertanto, è essenziale stabilire un metodo di pagamento per scopi di fatturazione. Senza questa configurazione, la nuova chiave API creata sarà inattiva.

Per la configurazione della fatturazione, vai alla sezione del tuo profilo e seleziona Billing dal menu a sinistra, quindi scegli Add payment details.

ChatGPT billing

4

Imposta la chiave in LogicalDOC

Apri LogicalDOC, seleziona una cartella qualsiasi nell'albero delle cartelle e apri il menu Strumenti > ChatGPT > Impostazioni

Qui, inserisci la chiave che hai salvato al passo 2 e specifica il modello ChatGPT che vuoi utilizzare (al momento di scrivere questo manuale, il modello predefinito è gpt-4o).

Quindi premi su Ok e il gioco è fatto.

Addin per PowerPoint

È possibile modificare un documento PowerPoint semplicemente selezionando il documento e quindi facendo clic sull'icona [Modifica con Office]. Dopo di che, il documento viene visualizzato in Microsoft PowerPoint.

edit-with-office
 

Quando la modifica è completata, è necessario selezionare la scheda [LogicalDOC] e quindi fare clic sul pulsante [Save in LogicalDOC].

Il nuovo file del documento viene salvato nel sistema e una nuova versione del documento è conservato nell'archivio documenti.

Addin per Microsof Office

Il LogicalDOC Microsoft Office Add-in integra le applicazioni Microsoft Office con il sistema di gestione documentale LogicalDOC, consentendo agli utenti di lavorare con i documenti archiviati nel repository direttamente dal familiare ambiente di Microsoft Office.

Una volta installato e collegato a un server LogicalDOC, l'Add-in consente di esplorare e cercare nel repository documentale, aprire e modificare i documenti, gestirne le proprietà e i tag e salvare file nuovi o modificati direttamente in LogicalDOC. Il versioning e il blocco dei documenti sono gestiti da LogicalDOC, permettendo agli utenti di collaborare in modo sicuro e mantenendo al tempo stesso la cronologia completa dei documenti.

L'Add-in si integra con Microsoft Word, Excel, PowerPoint, Visio e Project, offrendo un accesso pratico a LogicalDOC senza dover passare continuamente tra Microsoft Office e l'interfaccia web.

L'Office Add-in può essere avviato anche direttamente dall'interfaccia web di LogicalDOC utilizzando il comando Edit with Office disponibile nel menu contestuale di un documento. Quando viene selezionato questo comando, LogicalDOC apre automaticamente l'applicazione Microsoft Office appropriata in base all'estensione del file, mentre l'Add-in gestisce automaticamente il flusso di modifica del documento.

In questa modalità, l'Add-in esegue automaticamente il check-out del documento prima della modifica e il check-in quando il documento viene salvato, creando e gestendo la nuova versione del documento in LogicalDOC. In questo modo, gli utenti possono modificare i documenti con la relativa applicazione Microsoft Office nativa, mentre LogicalDOC gestisce in modo trasparente il blocco e il versionamento del documento.

Menu della barra multifunzione di LogicalDOC Microsoft Office Add-in

Panoramica video

Prerequisiti

Microsoft Office deve essere installato sul PC Windows.

Installa l'ultima versione disponibile di LogicalDOC Office Add-in dalla pagina di download di LogicalDOC.