turcsanyip commented on code in PR #6355:
URL: https://github.com/apache/nifi/pull/6355#discussion_r968875962


##########
nifi-nar-bundles/nifi-box-bundle/nifi-box-processors/src/main/resources/docs/org.apache.nifi.processors.box.ListBoxFiles/additionalDetails.html:
##########
@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html lang="en">
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+      http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<head>
+    <meta charset="utf-8" />
+    <title>ListBoxFiles</title>
+
+    <link rel="stylesheet" href="../../../../../css/component-usage.css" 
type="text/css" />
+</head>
+<body>
+<p>This processor requires a pre-configured App under the User owning the 
Folder from which files are being listed.</p>
+<p>The App should have the following configuration:</p>

Review Comment:
   It would make sense to mention the URL of the Box developer page where the 
app can be created: `https://developer.box.com`



##########
nifi-nar-bundles/nifi-box-bundle/nifi-box-processors/src/main/resources/docs/org.apache.nifi.processors.box.ListBoxFiles/additionalDetails.html:
##########
@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html lang="en">
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+      http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<head>
+    <meta charset="utf-8" />
+    <title>ListBoxFiles</title>
+
+    <link rel="stylesheet" href="../../../../../css/component-usage.css" 
type="text/css" />
+</head>
+<body>
+<p>This processor requires a pre-configured App under the User owning the 
Folder from which files are being listed.</p>
+<p>The App should have the following configuration:</p>
+<ul>
+    <li>
+        If you create a new App, select 'Server Authentication (with JWT)' 
authentication method.
+        <br/>If you want to use an existing App, chose one with 'OAuth 2.0 
with JSON Web Tokens (Server Authentication)' as Authentication method.
+    </li>
+    <li>Should have a Client ID and Client Secret.</li>
+    <li>App Access Level should be 'App + Enterprise Access'.</li>
+    <li>Application Scopes should have 'Write all files and folders in Box' 
enabled.</li>
+    <li>Advanced Features should have 'Generate user access tokens' and 'Make 
API calls using the as-user header' enabled.</li>
+    <li>
+        Under 'Add and Manage Public Keys' Generate a Public/Private Keypair 
and donwload the configuration JSON file (under App Settings). The full path of 
this file should be set in the 'Box Config File' property.

Review Comment:
   ```suggestion
           Under 'Add and Manage Public Keys', generate a Public/Private 
Keypair and download the configuration JSON file (under App Settings). The full 
path of this file should be set in the 'Box Config File' property.
   ```



##########
nifi-nar-bundles/nifi-box-bundle/nifi-box-processors/src/main/resources/docs/org.apache.nifi.processors.box.ListBoxFiles/additionalDetails.html:
##########
@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html lang="en">
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+      http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<head>
+    <meta charset="utf-8" />
+    <title>ListBoxFiles</title>
+
+    <link rel="stylesheet" href="../../../../../css/component-usage.css" 
type="text/css" />
+</head>
+<body>
+<p>This processor requires a pre-configured App under the User owning the 
Folder from which files are being listed.</p>

Review Comment:
   Could you please add a header and optionally section headers to this page. 
Like in case of `StandardDropboxCredentialService`
   
https://github.com/apache/nifi/blob/6d8dda1c03469a0a9725e7df4604907e0ed6a375/nifi-nar-bundles/nifi-dropbox-bundle/nifi-dropbox-services/src/main/resources/docs/org.apache.nifi.services.dropbox.StandardDropboxCredentialService/additionalDetails.html#L25-L37



##########
nifi-nar-bundles/nifi-box-bundle/nifi-box-processors/src/main/resources/docs/org.apache.nifi.processors.box.ListBoxFiles/additionalDetails.html:
##########
@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html lang="en">
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+      http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<head>
+    <meta charset="utf-8" />
+    <title>ListBoxFiles</title>
+
+    <link rel="stylesheet" href="../../../../../css/component-usage.css" 
type="text/css" />
+</head>
+<body>
+<p>This processor requires a pre-configured App under the User owning the 
Folder from which files are being listed.</p>
+<p>The App should have the following configuration:</p>
+<ul>
+    <li>
+        If you create a new App, select 'Server Authentication (with JWT)' 
authentication method.
+        <br/>If you want to use an existing App, chose one with 'OAuth 2.0 
with JSON Web Tokens (Server Authentication)' as Authentication method.

Review Comment:
   ```suggestion
           <br/>If you want to use an existing App, choose one with 'OAuth 2.0 
with JSON Web Tokens (Server Authentication)' as Authentication method.
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to