{"title":"Decompress Files","nodeType":"Other","id":"*Idv4NOkow3wYGr_Z","factoryName":"org.knime.filehandling.utility.nodes.decompress.DecompressNodeFactory","factoryId":"org.knime.filehandling.utility.nodes.decompress.DecompressNodeFactory","path":["IO","File Folder Utility","Archive (zip, tar, ...)"],"owner":"knime","ownerAccountId":"account:team:b5f0848f-496d-4e6a-b869-fa3532248db7","description":"<p>This node unpacks and decompresses files from an archive file. The paths to the extracted files are provided in the output table using a <a href=\"https://docs.knime.com/2021-06/analytics_platform_file_handling_guide/index.html#path\" rel=\"ugc nofollow noopener noreferrer\">path column.</a></p>\n             \n            <p>Supported archive formats are:</p><ul><li>.zip</li><li>.jar</li><li>.tar</li><li>.tar.gz</li><li>.tar.bz2</li><li>.cpio</li><li>.ar</li><li>.gz / .gzip</li></ul>\n                 \n            \n             \n            <p><b>Note:</b> This node cannot decompress KNIME artifacts such as workflows. In order to decompress workflows please use a combination of <a href=\"https://hub.knime.com/knime/extensions/org.knime.features.buildworkflows/latest/%20%20%20%20%20org.knime.buildworkflows.reader.WorkflowReaderNodeFactory\" rel=\"ugc nofollow noopener noreferrer\"> <i>Workflow Reader</i> </a> and <a href=\"https://kni.me/n/ouYgT_6spFNuvnv_\" rel=\"ugc nofollow noopener noreferrer\"> <i>Workflow Writer</i> </a> instead.</p>\n                \n            <p><i>This node can access a variety of different</i> <a href=\"https://docs.knime.com/2021-06/analytics_platform_file_handling_guide/%20%20%20%20%20index.html#analytics-platform-file-systems\" rel=\"ugc nofollow noopener noreferrer\"> <i>file systems.</i> </a> <i>More information about file handling in KNIME can be found in the official</i> <a href=\"https://docs.knime.com/latest/analytics_platform_file_handling_guide/index.html\" rel=\"ugc nofollow noopener noreferrer\"> <i>File Handling Guide.</i> </a></p>\n            \n        \n        ","shortDescription":"Unpacks and decompresses files from an archive.","keywords":[],"deprecated":false,"streamable":false,"tags":["IO","File Folder Utility","Archive (zip, tar, ...)"],"icon":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAA3BpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuNi1jMDY3IDc5LjE1Nzc0NywgMjAxNS8wMy8zMC0yMzo0MDo0MiAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtcE1NOk9yaWdpbmFsRG9jdW1lbnRJRD0ieG1wLmRpZDowYjM2YWM5Ny01ZWJhLTQwZTctOTE4OS1iYmU4ZDdkMGYyNGUiIHhtcE1NOkRvY3VtZW50SUQ9InhtcC5kaWQ6QURBQUE4NDY4RkFCMTFFNTg1NzhENEEzQzA5OUQ0MUMiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6OEU5OTVDMUE4RkE5MTFFNTg1NzhENEEzQzA5OUQ0MUMiIHhtcDpDcmVhdG9yVG9vbD0iQWRvYmUgUGhvdG9zaG9wIENDIDIwMTUgKE1hY2ludG9zaCkiPiA8eG1wTU06RGVyaXZlZEZyb20gc3RSZWY6aW5zdGFuY2VJRD0ieG1wLmlpZDpDRDgzOUNEMjJFMzAxMUU1OUMzRUMzQkRFMzNFNTk1RiIgc3RSZWY6ZG9jdW1lbnRJRD0ieG1wLmRpZDpDRDgzOUNEMzJFMzAxMUU1OUMzRUMzQkRFMzNFNTk1RiIvPiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/PqlAMtsAAADDSURBVHjaYvz//z8DKYCRkRGmgRGkl5EUA5A0I4SINQCLZoQzeqatxpAsyQoF6mHEpgfuBTDRPXUVTieADMEXBiCCBZ+zsbkMxSlA14MNSE4KggsKcSLMfPf9D4qGufPWgTShuIoJ3VQZWTkGHl5eomMGwwuXbt2DuwTmGnSX4DUA2QtkuYCPn5/h379/DF8+f8ZrM04DHrx4S5kX7MyNGH79+k2+F65cuoQzGrEBjGgEaYJpRPYGXheAEgg+gE8eIMAA9JNSrLBW7BgAAAAASUVORK5CYII=","views":[],"inPorts":[],"outPorts":[{"objectClass":"org.knime.core.node.BufferedDataTable","color":"000000","dataType":"Table","optional":false,"name":"Output table","description":"Table containing the list of files and folders that have been extracted."}],"dynInPorts":[{"groupName":"Source File System Connection","groupDescription":"The file system connection.","types":[{"objectClass":"org.knime.filehandling.core.port.FileSystemPortObject","color":"178ba5","dataType":"File System"}]},{"groupName":"Destination File System Connection","groupDescription":"The file system connection.","types":[{"objectClass":"org.knime.filehandling.core.port.FileSystemPortObject","color":"178ba5","dataType":"File System"}]}],"dynOutPorts":[],"additionalSiteInformation":{"url":"https://update.knime.com/analytics-platform/5.12","trusted":true,"enabledByDefault":true,"name":"KNIME Analytics Platform 5.12 Update Site","version":"5.12.0"},"dialog":[{"sectionName":"Options","fields":[{"name":"File","description":"Enter a path to an archive file to be decompressed. The required syntax of a path depends on the chosen file system, such as &#34;C:\\path\\to\\file&#34; (Local File System on Windows) or &#34;/path/to/file&#34; (Local File System on Linux/MacOS and Mountpoint). For file systems connected via input port, the node description of the respective connector node describes the required path format. You can also choose a previously selected file from the drop-down list, or select a file from the &#34;Browse...&#34; dialog. Note that browsing is disabled in some cases.","optional":false},{"name":"Folder","description":"Enter a valid directory path where the files should be extracted to. The required syntax of a path depends on the chosen file system, such as &#34;C:\\path\\to\\folder&#34; (Local File System on Windows) or &#34;/path/to/folder&#34; (Local File System on Linux/MacOS and Mountpoint). For file systems connected via input port, the node description of the respective connector node describes the required path format. You can also choose a previously selected folder from the drop-down list, or select a location from the &#34;Browse...&#34; dialog.","optional":false},{"name":"Create missing folders","description":"If enabled, missing folders in the specified path will be created automatically.","optional":false},{"name":"If exists","description":"Specify the behavior of the node in case the output file already exists.\n<ul><li><b>Overwrite</b> : Will replace any existing file.</li><li><b>Ignore</b> : Will ignore if a file already exists and continues the copying process.</li><li><b>Fail</b> : Will issue an error during the node&#39;s execution (to prevent unintentional overwrite).</li></ul>","optional":false},{"name":"Guess file name encoding from archive file extension","description":"If selected, tries to guess the encoding for the names of the files to decompress based on file extension of the archive file. For example, it will use UTF-8 for .zip files, <a href=\"https://en.wikipedia.org/wiki/Code_page_437\" rel=\"ugc nofollow noopener noreferrer\">CP437</a> for .arj, and <a href=\"https://en.wikipedia.org/wiki/ASCII\" rel=\"ugc nofollow noopener noreferrer\">US-ASCII</a> for .cpio. Unfortunately, the encoding cannot always be correctly guessed. If you notice that the names of decompressed files contain &#39;?&#39; characters, then the encoding was wrongly guessed. In this case, uncheck the box and pick the correct encoding.","optional":false},{"name":"File encoding","description":"Defines the character set which is used to read files that contain characters in a different encoding. You can choose from a list of character encodings (UTF-8, UTF-16, etc.), or specify any other encoding supported by your Java Virtual Machine (VM). The default value uses the default encoding of the Java VM, which may depend on the locale or the Java property &#34;file.encoding&#34;.\n<ul><li><b>OS default</b> : Uses the default decoding set by the operating system.</li><li><b>ISO-8859-1</b> : ISO Latin Alphabet No. 1, a.k.a. ISO-LATIN-1.</li><li><b>US-ASCII</b> : Seven-bit ASCII, also referred to as US-ASCII.</li><li><b>UTF-8</b> : Eight-bit UCS Transformation Format.</li><li><b>UTF-16</b> : Sixteen-bit UCS Transformation Format, byte order identified by an optional byte-order mark in the file.</li><li><b>UTF-16BE</b> : Sixteen-bit UCS Transformation Format, big-endian byte order.</li><li><b>UTF-16LE</b> : Sixteen-bit UCS Transformation Format, little-endian byte order.</li><li><b>Other</b> : Enter a valid charset name supported by the Java Virtual Machine.</li></ul>","optional":false},{"name":"Custom encoding","description":"A custom character set used to read a CSV file.","optional":false}]}],"links":[],"kudos":[],"kudosCount":0,"bundleInformation":{"bundleVersion":"5.12.0.v202605041104","bundleName":"KNIME Filehandling Nodes","bundleSymbolicName":"org.knime.filehandling.utility.nodes","bundleVendor":"KNIME AG, Zurich, Switzerland","featureSymbolicName":"org.knime.features.base","featureName":"KNIME Base nodes","featureVersion":"5.12.0.v202606261225","featureVendor":"KNIME AG, Zurich, Switzerland","extensionId":"*bjR3r1yWOznPIEXS"},"frequentSuccessors":[]}
