Text Output
A RocketRide target node that writes a pipeline object’s text to an SMB share; choose it when the destination is network storage rather than the engine’s local filesystem.
About SMB
SMB is the network file-sharing protocol used by this node to reach its target. The implementation connects to the configured server and share through Python SMB client libraries.
What it does
The node consumes text, writes non-empty output as UTF-8 .txt files on the configured SMB share, and produces no downstream lane. It retains the source-derived directory structure and skips unchanged objects, making it appropriate for incremental exports to a reachable share. Choose local_text_output instead when the desired destination is the pipeline host’s local filesystem rather than a network server.
Lanes
| Lane in | Lane out | Description |
|---|---|---|
text | — | Text content to write to the SMB share. |
Configuration
Configure the SMB server and destination path first. Authentication is optional for a guest-accessible share; anonymization settings only matter when sensitive content should be masked before export.
SMB destination
The node validates the server name as a hostname or IP address and requires a store path between 3 and 256 characters. The first store-path segment identifies the share; it may be followed by folders. The path cannot be rooted, contain empty or dot folders, or contain <>:"|?*.
At action startup, the node configures SMB credentials only when both username and password are supplied, verifies the share, and checks the full destination path. Use a DOMAIN\\user username when credentials are needed; supplying only one credential fails validation. Choose a share that the running task can reach, because configuration validation deliberately does not make the SMB connection.
Anonymization
With anonymization off (the default), the node writes the incoming text unchanged. Turn it on when the pipeline’s classification output must be masked before the file is written: the node requests classification and applies the anonymize_text filter. The masking character defaults to █; it must be exactly one character when anonymization is enabled.
Enable anonymize all when every classified match should become a fixed three-character mask instead of a character-for-character replacement. Changing the classification policies, masking character, or this setting changes the stored settings key and causes all objects to be transformed again, including objects that would otherwise be unchanged.
Authentication
Credentials are optional. For a protected SMB share, set both username and password; the username must contain a domain-like prefix and the password may be at most 127 characters. For a guest-accessible share, leave both blank. Credentials are registered against the configured server only, so two endpoints pointing at different servers never overwrite each other's credentials.
Configuration validation probes the target, and treats the two failure kinds differently. A rejected or expired credential, a share the account may not enter, or a share name that does not exist fails validation, because each is a configuration mistake to fix. A target that is merely unreachable — no route, refused connection, timeout, dropped transport — is reported as a warning and does not reject the configuration: validation also runs on the Platform host, which often has no network path to the customer's share, and a transient failure such as the share being locked by another process is treated the same way. The store path itself is exempt, since it is created on first write; only the share it lives under has to be reachable and permitted.
Limitations
This node is excluded from SaaS and remote deployments. It opens a direct SMB connection from the running task to the configured server, so the task environment must have network access to that share and the required SMB dependencies; use a deployment located where that share is reachable.
Notes
Incremental writes
For each object, the node derives a target path, hash-truncates over-long path components, and records a transformation key containing object flags, the source change key, and the target file’s modification time and size. An object is skipped when that key still matches and anonymization settings have not changed. Empty text is skipped, while write or SMB errors are stored as the object’s completion error.
Upstream docs
Schema
| Field | Type | Description | Default |
|---|---|---|---|
anonymize | |||
text_output.password | string | Password Password for the SMB user name above. | |
text_output.server | string | Server Name Host name or IP address of the SMB server hosting the share, e.g. files.example.com or 10.0.0.12. | |
text_output.username | string | User Name User name used to authenticate against the SMB share. Leave the user name and password empty to connect with the engine's own credentials. |
Dependencies
cfficryptographypycparserpyspnegosmbprotocolsspilib