Caricamento di un documento

Nota

Devi essere uno sviluppatore di software per completare i passaggi descritti in questa sezione. Per informazioni sull'utilizzo per WorkDocs caricare file, consulta Caricamento di file nella Guida per l'WorkDocs utente.

Per caricare un documento in WorkDocs, usa la procedura seguente.

Per caricare un documento

1. Creare un'istanza della classe AmazonWorkDocsClient come segue:

   Se utilizzi le credenziali utente IAM, consulta. Connect to WorkDocs with IAM: credenziali utente e query per gli utenti Se assumi un ruolo IAM, consulta Connettersi a WorkDocs assumendo un ruolo per ulteriori informazioni.

   Nota

   Per una maggiore sicurezza, crea utenti federati anziché utenti IAM quando possibile.

   AWSCredentials longTermCredentials =
     new BasicAWSCredentials("accessKey", "secretKey");
   AWSStaticCredentialsProvider staticCredentialProvider =
     new AWSStaticCredentialsProvider(longTermCredentials);
   
   // Use the region specific to your WorkDocs site.
   AmazonWorkDocs amazonWorkDocsClient =
     AmazonWorkDocsClient.builder().withCredentials(staticCredentialProvider)
       .withRegion(Regions.US_WEST_2).build();

2. Ottenere l'URL firmato per il caricamento come segue:

   InitiateDocumentVersionUploadRequest request = new InitiateDocumentVersionUploadRequest();
   request.setParentFolderId("parent-folder-id");
   request.setName("my-document-name");
   request.setContentType("application/octet-stream");
   InitiateDocumentVersionUploadResult result = amazonWorkDocsClient.initiateDocumentVersionUpload(request);
   UploadMetadata uploadMetadata = result.getUploadMetadata();
   String documentId = result.getMetadata().getId();
   String documentVersionId = result.getMetadata().getLatestVersionMetadata().getId();
   String uploadUrl = uploadMetadata.getUploadUrl();

3. Caricare il documento utilizzando l'URL firmato come segue:

   URL url = new URL(uploadUrl);
   HttpURLConnection connection = (HttpURLConnection) url.openConnection();
   connection.setDoOutput(true);
   connection.setRequestMethod("PUT");
   // Content-Type supplied here should match with the Content-Type set 
   // in the InitiateDocumentVersionUpload request.
   connection.setRequestProperty("Content-Type","application/octet-stream");
   connection.setRequestProperty("x-amz-server-side-encryption", "AES256");
   File file = new File("/path/to/file.txt");
   FileInputStream fileInputStream = new FileInputStream(file);
   OutputStream outputStream = connection.getOutputStream();
   com.amazonaws.util.IOUtils.copy(fileInputStream, outputStream);
   connection.getResponseCode();

4. Completare il processo di caricamento modificando l stato del documento in ACTIVE come segue:

   UpdateDocumentVersionRequest request = new UpdateDocumentVersionRequest();
   request.setDocumentId("document-id");
   request.setVersionId("document-version-id");
   request.setVersionStatus(DocumentVersionStatus.ACTIVE);
   amazonWorkDocsClient.updateDocumentVersion(request);