Last modified by Dennis Segebarth on 2024/10/02 18:38
From version 1.3
edited by Susan Evans
on 2023/07/10 22:16
Change comment: (Autosaved)
To version 1.5
edited by Susan Evans
on 2023/07/10 22:20
Change comment: (Autosaved)

Summary

Details

Page properties
Content
... ... @@ -378,9 +378,143 @@
378 378  Attribute definition saved successfully: cli_Manifest1_definition.json
379 379  {{/code}}
380 380  
381 -Export an attribute template from a given Project using options to provide both the Project Code {{/code}}(-p cli){{/code}} and the Attribute Template Name (-n Manifest1), “cli” and “Manifest1” in this case, respectively:
381 +Export an attribute template from a given Project using options to provide both the Project Code {{code}}(-p cli){{/code}} and the Attribute Template Name {{code}}(-n Manifest1){{/code}}, “cli” and “Manifest1” in this case, respectively:
382 382  
383 +{{code language="none"}}
384 +$ pilotcli file attribute-export -p cli -n Manifest1
383 383  
386 +Manifest1
387 +--------------------------------------------------------------------------
388 +| Attribute Name | Type | Value | Optional |
389 +--------------------------------------------------------------------------
390 +| attr1 | multiple_choice | a1,a2,a3,a4,a5 | False |
391 +--------------------------------------------------------------------------
392 +| attr2 | text | None | False |
393 +--------------------------------------------------------------------------
394 +| attr3 | multiple_choice | t1,t2,t3,t4,t5 | True |
395 +--------------------------------------------------------------------------
396 +Template saved successfully: cli_Manifest1_template.json
397 +Attribute definition saved successfully: cli_Manifest1_definition.json
398 +{{/code}}
399 +
400 +== Command: **list** ==
401 +
402 +* **Options**: -z ~-~-zone
403 +* **Usage**: List files and folders in the specified directory within the Platform. Folders will be displayed in blue and files will be displayed in white (or black, depending on the background of your terminal). If no zone (i.e. Green Room or Core) is specified, Green Room will be used as default.
404 +* (((
405 +**Prerequisite**:
406 +
407 +* User login is required, otherwise an error is returned: "The current login session is invalid. Please login to continue."
408 +* Project must be accessible to the user, otherwise an error is returned: "Project Code not found in list. Please verify and try again."
409 +* Requires the Project code, which can be retrieved via pilotcli project list.
410 +)))
411 +
412 +{{code language="none"}}
413 +$ pilotcli file list --help
414 +Usage: pilotcli file list [OPTIONS] PATHS
415 +
416 + List files and folders inside a given Project/folder.
417 +
418 +Options:
419 + -z, --zone TEXT Target Zone (i.e., core/greenroom) [default:
420 + greenroom] [default: greenroom]
421 +
422 + --page INTEGER The page to be listed [default: 0]
423 + --page-size INTEGER number of objects per page [default: 10]
424 + -d, --detached whether run in detached mode
425 + --help Show this message and exit.
426 +{{/code}}
427 +
428 +=== Examples ===
429 +
430 +List folders in the directory “admin” in the Project with the Project Code “indoctestproject”. Since no zone was specified, the corresponding directory in the Green Room will be queried:
431 +
432 +{{code language="none"}}
433 +$ pilotcli file list indoctestproject/admin
434 +test_folder1 test_folder2 file1 file2 file3
435 +{{/code}}
436 +
437 +To list the corresponding elements in the “indoctestproject/admin” directory in the Projects' Core, the zone needs to be specified {{code}}(-z core){{/code}}:
438 +
439 +{{code language="none"}}
440 +$ pilotcli file list indoctestproject/admin -z core
441 +folder1 folder2 test_folder.zip file.txt sample.txt large-file.json
442 +{{/code}}
443 +
444 +== Command: **upload** ==
445 +
446 +* **Options**: -p ~-~-project, -a ~-~-attribute, -t ~-~-tag, -z ~-~-zone, -m ~-~-upload-message, -s ~-~-source-file, ~-~-zip, -td ~-~-thread, -o ~-~-output path
447 +* **Usage**: Upload files/folders to the given project, with optional tags and attributes, to the target folder.
448 +* (((
449 +**Prerequisite**:
450 +
451 +* User login is required, otherwise an error is returned: "The current login session is invalid. Please login to continue."
452 +* Project must be accessible to the user, otherwise an error is returned: "Project Code not found in list. Please verify and try again."
453 +* When uploading file to the Project Core, the user must have access to the Core (Project Contributors cannot upload files/folders to the Project Core).
454 +)))
455 +
456 +{{code language="none"}}
457 +$ pilotcli file upload --help
458 +Usage: pilotcli file upload [OPTIONS] [PATHS]...
459 +
460 + Upload files/folders to a given Project path.
461 +
462 +Options:
463 + -p, --project-path TEXT Project folder path starting from Project code.
464 + (i.e., indoctestproject/user/folder) [required]
465 +
466 + -a, --attribute TEXT File Attribute Template used for annotating files
467 + during upload.
468 +
469 + -t, --tag TEXT Add a tag to the file. This option could be used
470 + multiple times for adding multiple tags.
471 +
472 + -z, --zone TEXT Target Zone (i.e., core/greenroom) [default:
473 + greenroom] [default: greenroom]
474 +
475 + -m, --upload-message TEXT The message used to comment on the purpose of
476 + uploading your processed file [default: ]
477 +
478 + -s, --source-file TEXT The Project path of the source file of your
479 + processed files.
480 +
481 + --zip Upload folder as a compressed zip file.
482 + -td, --thread INTEGER The number of thread for upload a file [default:
483 + 1]
484 +
485 + -o, --output-path TEXT The output path for the manifest file of
486 + resumable upload [default: ./manifest.json]
487 +
488 + --help Show this message and exit.
489 +{{/code}}
490 +
491 +=== Examples ===
492 +
493 +Upload a file (or folder) to a specified directory of a Project’s Green Room, in this case the file located at {{code}}./sample_folder/sample_file1{{/code}} will be uploaded to the folder “admin” in the Project with the Project Code “cli” {{code}}(-p cli/admin){{/code}}:
494 +
495 +{{code language="none"}}
496 +$ pilotcli file upload ./sample_folder/sample_file1 -p cli/admin
497 +Starting upload of: ./sample_folder/sample_file1
498 +Pre-upload complete.
499 +uploader: admin container_id: 18061 total_size: 1048576 total_chunks: 1 uniq_identifier: e958247c-ce05-48b2-9038-78b774836256-1627498771 resumable_relative_path admin/
500 +
501 +Upload job is finalizing, please wait...
502 +Upload job complete.
503 +All files uploaded successfully.
504 +{{/code}}
505 +
506 +In case the specified destination directory does not exist yet, you will be prompted to confirm its creation by entering “y”, or to abort the command by entering “N”:
507 +
508 +{{code language="none"}}
509 +Target folder does not exist. Would you like to create a new folder? [y/N]: y
510 +{{/code}}
511 +
512 +In order to upload a file (or folder) to a destination directory in a Project's Core, core must be specified as corresponding zone {{code}}(-z core){{/code}} and you will be required to provide a message to that should describe the files` content and why you are uploading it directly into the Core {{code}}(-m "sample message"){{/code}}. Moreover, you will be reminded about the Terms of Use of the Platform and additional considerations regarding the direct upload of data into the Core zone, and are prompted to confirm your intention to proceed with the upload by entering “y” or “Yes”:
513 +
514 +
515 +
516 +
517 +
384 384  ----
385 385  
386 386  -