bvstone

GreenTools for Microsoft Apps (G4MS) Updated to Allow Downloads, Deletes, and Sharing of Files

Posted:

GreenTools for Microsoft Apps (G4MS) Updated to Allow Downloads, Deletes, and Sharing of Files

GreenTools for Microsoft Apps (G4MS) has been updated to v7.30 which includes new OneDrive functionality.  This update allows you to delete, download, create sharing links, and send sharing invitations for items in your OneDrive.

The following functions are now included in the F.G4MSOD (One Drive) service program:

  • #g4msod_getItemID() - Retrieve the unique ID for an item on the drive.
  • #g4msod_delteItem() - Delete (move to recycle) an item from the drive.
  • #g4msod_downloadItem() - Download an item from the drive.
  • #g4msod_getShareableLink() - Get a shareable link for a drive item.
  • #g4msod_removePermissions() - Remove permissions granted by the get shareable link function.
  • #g4msod_addRecipient() - Add recipient to list of people who will receive a sharing invitation from the following function.
  •  #g4msod_sendItemInvite() - Send a sharing invite to a list of recipients.

Some examples are as follows:

H DFTACTGRP(*NO) ACTGRP('G4MS') BNDDIR('BVSTOOLS')                         
 ****************************************************************          
 * Imports                                                                 
 ****************************************************************          
 /COPY QCOPYSRC,P.G4MSOD                                                   
 ****************************************************************          
D CRLF            C                   CONST(X'0D25')                       
 *                                                                         
D rc              S             10i 0                                      
D itemID          S            256                                         
D errorMsg        S            256  
D shareLink       S          65535    Varying 
D shareID         S          65535    Varying                                        

 /free

  // Get an item ID
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');    
  rc = #g4msod_setValue('path':'/Attachments/myfile.pdf');                      
  itemID = #g4msod_getItemID(errorMsg);                           

  // Delete an item by name
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');    
  rc = #g4msod_setValue('path':'/Attachments/myfile.pdf');     
  rc = #g4msod_deleteItem(errorMsg); 
                                   
  // Delete an item by ID
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');    
  rc = #g4msod_setValue('item_id':itemID);     
  rc = #g4msod_deleteItem(errorMsg); 

  // Download an item by name
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');           
  rc = #g4msod_setValue('path':'/Attachments/myfile.pdf');            
  rc = #g4msod_setValue('download_to_filename':'/tmp/myfile.pdf');    
  rc = #g4msod_downloadItem(errorMsg);   

  // Get a link to share an item
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');            
  rc = #g4msod_setValue('path':'/Attachments/myfile.pdf');                            
  rc = #g4msod_setValue('link_type':'edit');                                 
  rc = #g4msod_setValue('link_scope':'anonymous');                           
  rc = #g4msod_getShareableLink(shareLink:shareID:errorMsg);  
               
  // Remove the permissions from the created link                                                                           
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');            
  rc = #g4msod_setValue('path':'/Attachments/myfile.pdf');                            
  rc = #g4msod_setValue('permission_id':shareID);                            
  rc = #g4msod_removePermissions(errorMsg);                                  
                                   
  // Send a sharing invite to a group of email addresses
  rc = #g4msod_setValue('id':'bvstone@bvstools.com');             
  rc = #g4msod_setValue('path':'/Attachments/myfile.pdf');                             
  rc = #g4msod_setValue('message':'Here is the file!');  
  // Add recipients... up to 200 allowed                     
  rc = #g4msod_addRecipient('jim@yahoo.com');                             
  rc = #g4msod_addRecipient('mary@yahoo.com');                             
  rc = #g4msod_setValue('send_invite':'*YES');                                
  rc = #g4msod_setValue('require_signon':'*YES');                             
  rc = #g4msod_setValue('roles':'read');                                      
  rc = #g4msod_sendItemInvite(errorMsg);                                      


One issue I found (probably a bug on Microsoft's side) is when you are sending a sharing invite and specify require_signon as *NO, the message you send with the invite defaults to one of Microsoft's default messages.  I have opened a ticket with Microsoft on this issue.

Documentation can be found at in the G4MS section of our online documentation.


Last edited 12/17/2021 at 10:04:25




Reply




Copyright 1983-2024 BVSTools
GreenBoard(v3) Powered by the eRPG SDK, MAILTOOL Plus!, GreenTools for Google Apps, jQuery, jQuery UI, BlockUI, CKEditor and running on the IBM i (AKA AS/400, iSeries, System i).