This is an automated email from the ASF dual-hosted git repository. joewitt pushed a commit to branch support/nifi-1.11.x in repository https://gitbox.apache.org/repos/asf/nifi.git
commit 97486956e04e7eb940b9cddbd9301913411f1192 Author: Andy LoPresto <[email protected]> AuthorDate: Fri Feb 21 10:41:41 2020 -0800 NIFI-7175 Fixed core attributes formatting in Developer Guide. (#4066) * NIFI-7175 Fixed core attributes formatting in Developer Guide. * NIFI-7175 Made core attribute names more consistent. --- nifi-docs/src/main/asciidoc/developer-guide.adoc | 30 ++++++++++++++---------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/nifi-docs/src/main/asciidoc/developer-guide.adoc b/nifi-docs/src/main/asciidoc/developer-guide.adoc index 2a2c93c..aca8b69 100644 --- a/nifi-docs/src/main/asciidoc/developer-guide.adoc +++ b/nifi-docs/src/main/asciidoc/developer-guide.adoc @@ -127,30 +127,34 @@ can change, the FlowFile object is immutable. Modifications to a FlowFile are made possible by the ProcessSession. The core attributes for FlowFiles are defined in the `org.apache.nifi.flowfile.attributes.CoreAttributes` enum. -The most common attributes you'll see are filename, path and uuid. The string in quotes is the value of the -attribute within the `CoreAttributes` enum. +The most common attributes you'll see are `filename`, `path` and `uuid`. The string in parentheses is the value of the +attribute within the `CoreAttributes` enum and how it appears in the UI/API. -- Filename ("filename"): The filename of the FlowFile. The filename should not contain any directory structure. +- Filename (`filename`): The filename of the FlowFile. The filename should not contain any directory structure. -- File Size ("fileSize"): The file size of the FlowFile in bytes. +- UUID (`uuid`): A Universally Unique Identifier assigned to this FlowFile that distinguishes the FlowFile from other FlowFiles in the system. -- UUID ("uuid"): A Universally Unique Identifier assigned to this FlowFile that distinguishes the FlowFile from other FlowFiles in the system. +- Path (`path`): The FlowFile's path indicates the relative directory to which a FlowFile belongs and does not contain the filename. -- Path ("path"): The FlowFile's path indicates the relative directory to which a FlowFile belongs and does not contain the filename. +- Absolute Path (`absolute.path`): The FlowFile's absolute path indicates the absolute directory to which a FlowFile belongs and does not contain the filename. -- Absolute Path ("absolute.path"): The FlowFile's absolute path indicates the absolute directory to which a FlowFile belongs and does not contain the filename. +- Priority (`priority`): A numeric value indicating the FlowFile priority. -- Entry Date ("entryDate"): The date and time at which the FlowFile entered the system (i.e., was created). The value of this attribute is a number that represents the number of milliseconds since midnight, Jan. 1, 1970 (UTC). +- MIME Type (`mime.type`): The MIME Type of this FlowFile. -- Lineage Start Date ("lineageStartDate"): Any time that a FlowFile is cloned, merged, or split, this results in a "child" FlowFile being created. As those children are then cloned, merged, or split, a chain of ancestors is built. This value represents the date and time at which the oldest ancestor entered the system. Another way to think about this is that this attribute represents the latency of the FlowFile through the system. The value is a number that represents the number of millis [...] +- Discard Reason (`discard.reason`): Specifies the reason that a FlowFile is being discarded. -- Priority ("priority"): A numeric value indicating the FlowFile priority. +- Alternate Identifier (`alternate.identifier`): Indicates an identifier other than the FlowFile's UUID that is known to refer to this FlowFile. -- MIME Type ("mime.type"): The MIME Type of this FlowFile. +===== Additional Common Attributes -- Discard Reason ("discard.reason"): Specifies the reason that a FlowFile is being discarded. +While these attributes are not members of the `CoreAttributes` enum, they are de facto standards across the system and found on most FlowFiles. -- Alternative Identifier ("alternate.identifier"): Indicates an identifier other than the FlowFile's UUID that is known to refer to this FlowFile. +- File Size (`fileSize`): The size of the FlowFile content in bytes. + +- Entry Date (`entryDate`): The date and time at which the FlowFile entered the system (i.e., was created). The value of this attribute is a number that represents the number of milliseconds since midnight, Jan. 1, 1970 (UTC). + +- Lineage Start Date (`lineageStartDate`): Any time that a FlowFile is cloned, merged, or split, this results in a "child" FlowFile being created. As those children are then cloned, merged, or split, a chain of ancestors is built. This value represents the date and time at which the oldest ancestor entered the system. Another way to think about this is that this attribute represents the latency of the FlowFile through the system. The value is a number that represents the number of millis [...] [[process_session]] ==== ProcessSession
