Re: Usage Documentation for Custom Processors

2023-04-05 Thread Mark Bean
If the expected documentation is not showing up in the UI - particularly if an older version of the documentation is present - you may have to clear your browser cache and reload the documentation page. -Mark On Wed, Apr 5, 2023 at 11:52 AM Matthew Baine wrote: > Hi Russell and Bryan, > > Yes,

Re: Usage Documentation for Custom Processors

2023-04-05 Thread Matthew Baine
Hi Russell and Bryan, Yes, we are currently making use of the @CapabilityDescription annotations etc, it's the additionalDetails.html file I am trying to implement. The feedback is much appreciated, I'll proceed as advised. Kind Regards, Matthew On Tue, 4 Apr 2023 at 17:54, Russell Bateman wro

Re: Usage Documentation for Custom Processors

2023-04-04 Thread Russell Bateman
Matthew, If you feel that the documentation generated from the annotations at the top of your custom processor class (@CapabilityDescription, etc., of which Bryan spoke) is insufficient, it's also possible to supplement it with /src/main/resources/docs/.CustomProcessorClass/additionalDeta

Re: Usage Documentation for Custom Processors

2023-04-04 Thread Bryan Bende
Hello, Documentation for a component is generated automatically from the component itself by using available API methods and the annotations on the class [1]. For example, documentation on a processor will use the getPropertyDescriptors and getRelationship methods of the component, as well as anno

Usage Documentation for Custom Processors

2023-04-04 Thread Matthew Baine
Hi Bryan, Sorry, on a separate note, what would be the best way to set up Usage Documentation for a custom processor? [image: image.png] We can't seem to get this right with the information online and on the Nifi developer guide ( https://nifi.apache.org/docs/nifi-docs/html/developer-guide.html)

Re: How to generate usage documentation for custom Processors

2019-08-28 Thread David Perkins
27;ll give it a try. > > > > > > > > > > > > > > > > > > > > David P. > > > > > > > > > > > > > > > > > > > > On 2019/08/26 15:21:12, Bryan Bende > > > > > > > > >

Re: How to generate usage documentation for custom Processors

2019-08-27 Thread Bryan Bende
> > On 2019/08/26 15:21:12, Bryan Bende wrote: > > > > > > > > > > Hello, > > > > > > > > > > > > > > > > > > > > The documentation for a processor is generated > > > > &g

Re: How to generate usage documentation for custom Processors

2019-08-27 Thread David Perkins
tation for a processor is generated automatically > > > > > > > > > from the > > > > > > > > > annotations on the processors. If you used the Maven > > > > > > > > > Archetype to > > > > > > >

Re: How to generate usage documentation for custom Processors

2019-08-27 Thread Bryan Bende
; > > > > > to > > > > > > > > generate your NAR then you should already have a starting point > > > > > > > > for > > > > > > > > this with the example MyProcessor which has the following > > > > > > > &

Re: How to generate usage documentation for custom Processors

2019-08-27 Thread David Perkins
example MyProcessor which has the following > > > > > > > annotations: > > > > > > > > > > > > > > @Tags({"example"}) > > > > > > > @CapabilityDescription("Provide a descript

Re: How to generate usage documentation for custom Processors

2019-08-27 Thread Bryan Bende
s({@WritesAttribute(attribute="", description="")}) > > > > > > > > > > > > For the additionalDetails.html, it may help you to look at how it is > > > > > > setup in the existing NARs: > > > > > >

Re: How to generate usage documentation for custom Processors

2019-08-27 Thread David Perkins
it is > > > > > setup in the existing NARs: > > > > > > > > > > https://github.com/apache/nifi/tree/master/nifi-nar-bundles/nifi-kafka-bundle/nifi-kafka-2-0-processors/src/main/resources/docs > > > > > > > > > > In the

Re: How to generate usage documentation for custom Processors

2019-08-26 Thread Bryan Bende
gt; > > > setup in the existing NARs: > > > > > > > > https://github.com/apache/nifi/tree/master/nifi-nar-bundles/nifi-kafka-bundle/nifi-kafka-2-0-processors/src/main/resources/docs > > > > > > > > In the processors Maven module, the locat

Re: How to generate usage documentation for custom Processors

2019-08-26 Thread David Perkins
> In the processors Maven module, the location would be > > > "src/main/resources/docs/{fully-qualified-component-name}/additionalDetails.html" > > > > > > On Fri, Aug 23, 2019 at 3:43 PM David Perkins > > > wrote: > > > > > > > >

Re: How to generate usage documentation for custom Processors

2019-08-26 Thread Bryan Bende
t-name}/additionalDetails.html" > > > > On Fri, Aug 23, 2019 at 3:43 PM David Perkins > > wrote: > > > > > > Hello, > > > I'm having trouble generating documentation for a set of custom NiFi > > > processors. I posted a question with all the

Re: How to generate usage documentation for custom Processors

2019-08-26 Thread David Perkins
le, the location would be > "src/main/resources/docs/{fully-qualified-component-name}/additionalDetails.html" > > On Fri, Aug 23, 2019 at 3:43 PM David Perkins > wrote: > > > > Hello, > > I'm having trouble generating documentation for a set of custom

Re: How to generate usage documentation for custom Processors

2019-08-26 Thread David Perkins
s> > > In the processors Maven module, the location would be> > "src/main/resources/docs/{fully-qualified-component-name}/additionalDetails.html"> > > On Fri, Aug 23, 2019 at 3:43 PM David Perkins wrote:> > >> > > Hello,> > > I'm

Re: How to generate usage documentation for custom Processors

2019-08-26 Thread Bryan Bende
nt-name}/additionalDetails.html" On Fri, Aug 23, 2019 at 3:43 PM David Perkins wrote: > > Hello, > I'm having trouble generating documentation for a set of custom NiFi > processors. I posted a question with all the details here on Stack > Overflow. > https://stackoverfl

How to generate usage documentation for custom Processors

2019-08-23 Thread David Perkins
Hello, I'm having trouble generating documentation for a set of custom NiFi processors. I posted a question with all the details here on Stack Overflow. https://stackoverflow.com/questions/57530465/how-to-generate-usage-documentation-for-custom-processors Below is a copy of what I p