{"id":31671,"date":"2024-04-15T13:00:40","date_gmt":"2024-04-15T11:00:40","guid":{"rendered":"https:\/\/help.qualiware.it\/qw-help\/?p=31671"},"modified":"2024-05-29T14:57:19","modified_gmt":"2024-05-29T12:57:19","slug":"integrazione-con-google-drive","status":"publish","type":"post","link":"https:\/\/help.qualiware.it\/qw-help\/integrazione-con-google-drive\/","title":{"rendered":"Integrazione con Google Drive"},"content":{"rendered":"

Nelle ultime versioni di QualiWare, a partire dalla 2023.00.17, sono disponibili una serie di funzionalit\u00e0 per l’interfacciamento con Google Drive. Questo interfacciamento permette di importare una serie di documenti da Google Drive (disco o cartella condivisa) a QualiWare, e viceversa.<\/p>\n

Importazione da Google Drive a QualiWare<\/h2>\n

Su QualiWare \u00e8 disponibile un apposito form indipendente che permette di importare documenti da un servizio in cloud (tra cui Google Drive). Si rimanda all’apposita pagina<\/a> della guida per approfondirne il funzionamento.<\/p>\n

\u00c8 bene specificare, comunque, che \u00e8 possibile utilizzare le funzioni elencate nell’apposito paragrafo<\/a> di questa pagina per modificare ulteriormente il form ed aggiungerci determinate funzionalit\u00e0.<\/p>\n

Esportazione da QualiWare a Google Drive<\/h2>\n

Per esportare un gruppo di documenti da QualiWare a Google Drive \u00e8 necessario, da parte dell’amministratore del Drive:<\/p>\n

    \n
  1. creare un account di servizio, e fornire le credenziali all’amministratore di QualiWare<\/li>\n
  2. condividere, con l’account di servizio, l’intero Drive, oppure le cartelle di destinazione dei documenti da esportare<\/li>\n<\/ol>\n

    Entrambi i passaggi saranno spiegati nel dettaglio nei seguenti paragrafi.<\/p>\n

    Creazione dell’account di servizio<\/h3>\n

    L’account di servizio si pu\u00f2 creare e configurare all’interno della Google Cloud Platform (CGP)<\/strong>. Per farlo, bisogna accedere alla console<\/a> e, da qui, procede alla sezione “IAM”. Per aggiungerne uno, bisogna, come indicato nell’immagine, accedere alla sezione “Service accounts” e poi cliccare su “Create Service account”.<\/p>\n

     <\/p>\n

    \"\"<\/a><\/p>\n

     <\/p>\n

    I dati essenziali da specificare per l’account di servizio sono un nome ed un ID.<\/p>\n

     <\/p>\n

    \"\"<\/a><\/p>\n

     <\/p>\n

    Dopo avere creato l’account, \u00e8 necessario creare una chiave di accesso per permetterne l’utilizzo tramite API. Si pu\u00f2 fare premere sull’icona nella colonna “Actions” e poi su scegliere “Manage keys”.<\/p>\n

     <\/p>\n

    \"\"<\/a><\/p>\n

     <\/p>\n

    Dalla schermata delle chiavi, sar\u00e0 poi sufficiente cliccare su “Add Key” e poi su “Create new key”. Si aprir\u00e0 una schermata che consentir\u00e0 di scegliere il modo in cui generare la chiave. La modalit\u00e0 pi\u00f9 semplice \u00e8 quella di utilizzare il formato JSON, naturalmente con le dovute precauzioni. Il contenuto del JSON generato sar\u00e0 ci\u00f2 che bisogner\u00e0 fornire all’amministratore di QualiWare per poter impostare i servizi di esportazione. In particolare, il JSON \u00e8 ci\u00f2 che dovr\u00e0 essere passato alla funzione GDriveGetService<\/code> per effettuare l’autenticazione tra QualiWare e il Drive (per i dettagli, si veda il paragrafo apposito<\/a>).<\/p>\n

    L’ultimo passaggio da effettuare, per completare la configurazione dell’utente di servizio, \u00e8 abilitare l’utilizzo delle API di Google Drive da parte dell’account in questione. Per farlo, andare nella sezione “APIs and services” della console, scegliere “Enabled APIs and services”, poi “Enable APIs and services”. Fatto ci\u00f2, basta proseguire scegliendo di attivare quelle relative a Google Drive.<\/p>\n

     <\/p>\n

    \"\"<\/a><\/p>\n

    Funzioni<\/h2>\n

    Di seguito l’elenco delle funzioni che permettono la gestione dei file su Google Drive. <\/p>\n

      \n
    • QWGoogle.DriveGetService(<Json>)<\/code>: restituisce l’oggetto servizio da passare nelle altre funzioni come parametro service<\/code>. Nel parametro Json<\/code> viene passato il contenuto del file JSON scaricato in fase di creazione della chiave dell’account di servizio.<\/li>\n
    • QWGoogle.GDriveGetFolderIDByName(<service>,<folderName>,<parentFolderId>)<\/code>: restituisce l’ID di una cartella a partire dal nome. Il parametro parentFolderId<\/code> contiene l’Id dell’eventuale cartella all’interno della quale \u00e8 contenuta la cartella di cui \u00e8 stato specificato il nome. Questo parametro va lasciato Nothing<\/code> nel caso si desideri cercare la cartella in tutto lo spazio di archiviazione condiviso. Se la cartella non esiste, la funzione ritorna Nothing<\/code>.
      \nATTENZIONE<\/strong>: se non viene specificato il parametro parentFolderId<\/code>, la funzione cerca in tutto lo spazio di archiviazione condiviso. Si tenga quindi in considerazione che:<\/p>\n
        \n
      • \u00e8 di fondamentale importanza che i nomi delle cartelle di primo livello siano univoci nello spazio di archiviazione stesso<\/li>\n
      • la funzione pu\u00f2 essere estremamente lenta (nell’ordine dei minuti) a ricavare l’ID della cartella, nel caso l’account Google utilizzato abbia un Drive corposo e\/o dei Drive condivisi. Pu\u00f2 quindi essere necessario specificare un parentFolderID<\/code> per ottenere il risultato in una frazione di secondo, <\/li>\n<\/ul>\n<\/li>\n
      • QWGoogle.GDriveGetFolderNameByID(<service>,<folderId>)<\/code>: recupera il nome della cartella a partire dall’ID passato nel parametro folderId<\/code>. Se la cartella non esiste, la funzione ritorna Nothing<\/code>.<\/li>\n
      • QWGoogle.GDriveCreateFolder(<service>,<name>,<parentFolderId>,<errmsg>)<\/code>: crea una cartella con il nome specificato nel parametro name<\/code> all’interno della cartella il cui ID \u00e8 specificato nel parametro parentFolderId<\/code>. Questa funzione ritorna l’ID della cartella se l’operazione \u00e8 andata a buon fine, Nothing<\/code> altrimenti, e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore.
        \nNOTA: se la cartella esiste gi\u00e0, ne viene restituito l’ID.<\/li>\n
      • QWGoogle.GDriveGetFiles(<service>,<folderId>,<optional recurse>,<optional filter>)<\/code>: restituisce un oggetto DBArray con informazioni relative ai file contenuti nella cartella il cui ID \u00e8 specificato nel parametro folderID<\/code>. Ogni elemento dell’array corrisponde ad un file, e consiste a sua volta in un DBArray di 5 elementi. Il primo \u00e8 il nome del file con relativa estensione, il secondo l’ID, il terzo la data di ultima modifica, il quarto la dimensione in byte, e il quinto il path senza nome del file (e la cui radice \u00e8 la cartella specificata nel primo tab del form). Il parametro opzionale recurse<\/code>, se True<\/code>, consente di recuperare i file anche dalle sotto cartelle. Il parametro opzionale filter<\/code> consente di filtrare i file in base a parte del nome. E’ possibile anche usare il carattere *<\/code> come wildcard. Se <folderId><\/code><\/code> \u00e8 Nothing, vengono restituiti i file contenuti nella root.<\/li>\n
      • QWGoogle.GDriveGetFolders(<service>,<folderId>)<\/code>: restituisce un oggetto DBArray con informazioni relative alle sottocartelle contenute nella cartella il cui ID \u00e8 specificato nel parametro folderID<\/code>. Gli elementi dell’array restituito sono a loro volta oggetti DBArray di due elementi. Il primo \u00e8 il nome della sottocartella, il secondo il suo ID. Se <folderId><\/code><\/code> \u00e8 Nothing, vengono restituite le cartelle dipendenti dalla root.<\/code><\/li>\n
      • QWGoogle.GDriveDeleteFileOrFolder(<service>,<name>,<folderId>,<errmsg>)<\/code>*<\/strong>: cancella il file o la sottocartella il cui nome \u00e8 contenuto nel parametro name<\/code> e che si trova nella cartella il cui ID \u00e8 specificato nel parametro folderID<\/code>. Questa funzione ritorna True<\/code> se l’operazione \u00e8 andata a buon fine, False<\/code> altrimenti, e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore. N.B. \u00e8 possibile cancellare solo file caricati tramite script. Se <folderId><\/code><\/code> \u00e8 Nothing, vengono cancellati il file o la cartella contenuti nella root.<\/li>\n
      • QWGoogle.GDriveDeleteFileOrFolderByID(<service>,<ID>,<errmsg>)<\/code>*<\/strong>: cancella il file o la sottocartella il cui ID \u00e8 contenuto nel parametro ID<\/code>. Questa funzione ritorna True<\/code> se l’operazione \u00e8 andata a buon fine, False<\/code> altrimenti, e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore. N.B. \u00e8 possibile cancellare solo file caricati tramite script.<\/li>\n
      • QWGoogle.GDriveGetFile(<service>,<name>,<folderId>,<errmsg>)<\/code>: scarica il file il cui nome \u00e8 contenuto nel parametro name<\/code> e che si trova nella cartella il cui ID \u00e8 specificato nel parametro folderID<\/code>. Ritorna il percorso del file scaricato, oppure Nothing<\/code> se l’operazione non \u00e8 andata a buon fine e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore. Se <folderId><\/code><\/code> \u00e8 Nothing, viene restituito il file contenuto nella root.<\/li>\n
      • QWGoogle.GDriveGetFileByID(<service>,<ID>,<errmsg>)<\/code>: scarica il file il cui ID \u00e8 contenuto nel parametro ID<\/code>. Ritorna il percorso del file scaricato, oppure Nothing<\/code> se l’operazione non \u00e8 andata a buon fine e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore.<\/li>\n
      • QWGoogle.GDriveUploadFile(<service>,<path>,<name>,<folderId>,<errmsg>)<\/code>: carica il file dal percorso specificato nel parametro path<\/code> attribuendogli il nome contenuto nel parametro name<\/code> e mettendolo nella cartella il cui ID \u00e8 specificato nel parametro folderID<\/code>. Questa funzione ritorna True<\/code> se l’operazione \u00e8 andata a buon fine, False<\/code>altrimenti, e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore. Da notare che la data di ultima modifica del file viene assegnata su Google Drive uguale a quella del file caricato, il che consente di verificare eventuali aggiornamenti intervenuti in locale o su GDrive. Si noti che questa funzione non<\/strong> aggiunge automaticamente l’estensione al nome del file.<\/li>\n
      • QWGoogle.GDriveRenameFileOrFolder(<service>,<oldname>,<newname>,<folderId>,<errmsg>)<\/code>: rinomina il file o la sottocartella il cui nome \u00e8 contenuto nel parametro oldname<\/code> e che si trova nella cartella il cui ID \u00e8 specificato nel parametro folderID<\/code>, assegnandogli il nome specificato nel parametro <newname><\/code> . Questa funzione ritorna True<\/code> se l’operazione \u00e8 andata a buon fine, False<\/code> altrimenti, e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore. <\/li>\n
      • QWGoogle.GDriveRenameFileOrFolderByID(<service>,<ID>,<newname>,<errmsg>)<\/code>: rinomina il file o la sottocartella il cui ID \u00e8 contenuto nel parametro ID<\/code>, assegnandogli il nome specificato nel parametro <newname><\/code>. Questa funzione ritorna True<\/code> se l’operazione \u00e8 andata a buon fine, False<\/code> altrimenti, e, in questo caso, nel parametro errmsg<\/code> \u00e8 contenuta la descrizione dell’errore. <\/li>\n<\/ul>\n

        * La cancellazione di un file \u00e8 possibile solo se l’utente di servizio \u00e8 proprietario<\/strong> (owner<\/strong>) del file stesso e, quindi, se l’ha creato lui. Diversamente, l’uso delle funzioni ritorna l’errore “forbidden”.<\/p>\n

        Esempio<\/h2>\n

        Il codice riportato di seguito su Google Drive, in una cartella condivisa chiamata “ActiveDoc”, i file relativi ad una categoria documentale di QualiWare, mettendoli in una sottocartella il cui nome \u00e8 uguale al nome della categoria, e attribuendo ai file un nome composto dal codice, dal titolo e dalla revisione. <\/p>\n

        ' Assegnare alla variabile \"json\" il contenuto del json scaricato in fase di creazione della chiave\r\nDim json As String = \"{\r\n                \"\"type\"\": \"\"sxxxxx\"\",\r\n                \"\"project_id\"\": \"\"sxxxxx\"\",\r\n                \"\"private_key_id\"\": \"\"sxxxxx\"\",\r\n                \"\"private_key\"\": \"\"-----BEGIN PRIVATE KEY-----\r\n\r\n-----END PRIVATE KEY-----\\n\"\",\r\n                \"\"client_email\"\": \"\"sxxxxx\"\",\r\n                \"\"client_id\"\": \"\"sxxxxx\"\",\r\n                \"\"auth_uri\"\": \"\"https:\/\/accounts.google.com\/o\/oauth2\/auth\"\",\r\n                \"\"token_uri\"\": \"\"https:\/\/oauth2.googleapis.com\/token\"\",\r\n                \"\"auth_provider_x509_cert_url\"\": \"\"https:\/\/www.googleapis.com\/oauth2\/v1\/certs\"\",\r\n                \"\"client_x509_cert_url\"\": \"\"https:\/\/www.googleapis.com\/robot\/v1\/metadata\/x509\/xxxxxxxxx\"\",\r\n                \"\"universe_domain\"\": \"\"googleapis.com\"\"\r\n                }\"\r\n\r\n'  Create Drive API service.\r\nDim Service As Google.Apis.Drive.v3.DriveService=QWGoogle.GDriveGetService(json)\r\n\r\nDim tipo as string=\"DM7TEST\" ' codice della categoria da esportare\r\nDim cartella as string=\"ActiveDoc\" ' Nome della sottocartella in cui esportare i documenti\r\n\r\ndim q as new QWTable()\r\nq.database=form.GetDataBase()\r\nq.sql=\"select NOME from TIPI_DOC where TIPO=:TIPO\"\r\nq.params(\"TIPO\")=tipo\r\nq.requestlive=false\r\nq.active=true\r\n\r\ndim nome_categoria as string=q.rowset.fields(1).value\r\n\r\nq.active=false\r\n\r\nDim i as integer\r\ndim errmsg as string\r\ndim ok as boolean\r\ndim id as string=QWGoogle.GDriveGetFolderIDByName(service,cartella,nothing) ' Recupera l'ID della cartella principale in cui inserire i file\r\ndim nome_cartella_categoria as string=Sane_Filename(nome_categoria)\r\ndim id_categoria as string=QWGoogle.GDriveCreateFolder(service,nome_cartella_categoria,id,errmsg)\r\nif not id is nothing\r\n        q.sql=\"select TIPO,TIPO_CONT,NUMERO,IND_REV,TITOLO,_CODDOC from DOCUMENT where TIPO=:TIPO and PUBBLICATO=1\"\r\n        q.params(\"TIPO\")=tipo\r\n        q.requestlive=false\r\n        q.active=true\r\n        \r\n        dim files as DBArray=QWGoogle.GDriveGetFiles(service,id_categoria)\r\n\r\n        ok=true\r\n        while not q.rowset.endofset and ok\r\n                dim path as string=form.GetSession().GetDocumentPath(q.rowset.fields(\"_CODDOC\").value)\r\n                dim nomefile as string=q.rowset.fields(\"TIPO_CONT\").value+\"-\"+q.rowset.fields(\"NUMERO\").value+\" \"+Sane_FIlename(q.rowset.fields(\"TITOLO\").value)+\" rev. \"+ltrim(str(q.rowset.fields(\"IND_REV\").value))+System.IO.Path.GetExtension(path)\r\n\r\n                ' Cerca nei file attuali se \u00e8 presente\r\n                dim upload as boolean=true\r\n\r\n                for i=1 to files.size\r\n                        if files(i)(1)=nomefile\r\n                                dim dtqw as DateTime=files(i)(3)\r\n                                dim dtG as DateTime=System.IO.File.GetLastWriteTime(path)\r\n                                \r\n                                if dtQW.Year=dtG.Year and dtQW.Month=dtG.Month and dtQW.Day=dtG.Day and dtQW.Hour=dtG.Hour and dtQW.Minute=dtG.Minute and dtQW.Second=dtG.Second\r\n                                        upload=false\r\n                                End If\r\n                                files(i).add(true) ' per marcarlo come presente \r\n                                Exit for\r\n                        End If\r\n                next\r\n\r\n                if upload\r\n                        ok=QWGoogle.GDriveUploadFile(Service,path,nomefile,id_categoria,errmsg,q.rowset.fields(\"TITOLO\").value)\r\n                End If\r\n                q.rowset.next()\r\n        End while\r\n        q.active=false\r\n\r\n        if ok\r\n        ' Cancella eventuali file in pi\u00f9 presenti nella cartella di esportazione\r\n                for i=1 to files.size\r\n                        if files(i).Size=3\r\n                                QWGoogle.GDriveDeleteFileOrFolder(service,files(i)(1),id_categoria,errmsg)\r\n                        End If\r\n                next     \r\n        End If   \r\nEnd If<\/pre>\n
         <\/p>\n","protected":false},"excerpt":{"rendered":"
        Nelle ultime versioni di QualiWare, a partire dalla 2023.00.17, sono disponibili una serie di funzionalit\u00e0 per l’interfacciamento con Google Drive. Questo interfacciamento permette di importare una serie di documenti da Google Drive (disco o cartella condivisa) a QualiWare, e viceversa. Importazione da Google Drive a QualiWare Su QualiWare \u00e8 disponibile un apposito form indipendente che…<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ngg_post_thumbnail":0,"footnotes":""},"categories":[4],"tags":[],"acf":[],"_links":{"self":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/31671"}],"collection":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/comments?post=31671"}],"version-history":[{"count":42,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/31671\/revisions"}],"predecessor-version":[{"id":37090,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/31671\/revisions\/37090"}],"wp:attachment":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/media?parent=31671"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/categories?post=31671"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/tags?post=31671"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}