Bug 53999 - Add documentation about OX Connector app
Add documentation about OX Connector app
Status: CLOSED MOVED
Product: UCS manual
Classification: Unclassified
Component: General
unspecified
Other Linux
: P5 normal (vote)
: ---
Assigned To: Nico Gulden
Dirk Wiesenthal
https://git.knut.univention.de/univen...
:
: 54554 (view as bug list)
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2021-10-30 00:23 CEST by Nico Gulden
Modified: 2022-08-19 15:29 CEST (History)
3 users (show)

See Also:
What kind of report is it?: Bug Report
What type of bug is this?: 5: Major Usability: Impairs usability in key scenarios
Who will be affected by this bug?: 2: Will only affect a few installed domains
How will those affected feel about the bug?: 3: A User would likely not purchase the product
User Pain: 0.171
Enterprise Customer affected?:
School Customer affected?: Yes
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Nico Gulden univentionstaff 2021-10-30 00:23:26 CEST
Bug #53419 just mentions the app in the manual. To provide benefit to the reader the OX Connector documentation should be enhanced more and cover the following aspects.

1. What are the requirements for installation and deployment?

2. What are the steps to check for the correct functionality of the app on the system?

3. Where are relevant logfiles?

4. How are the relevant UCR variables called and what's their purpose? What values are allowed?

5. How and where can the app be debugged?

6. What information is needed for the configuration and where can be obtained?

7. What system roles are recommended for the installation?


The transfer point is the OX App Suite SOAP API.

8. Where is the documentation of the SOAP API? Provide a link in the documentation.

9. What does the Connector do?

10. What are the intended scenarios? What scenarios are supported and how are the configured?
Comment 2 Nico Gulden univentionstaff 2022-01-14 12:33:05 CET
Need for the documentation was emphasized today in a conversation with professional services.
Comment 3 Nico Gulden univentionstaff 2022-03-15 20:33:05 CET
*** Bug 54554 has been marked as a duplicate of this bug. ***
Comment 4 Nico Gulden univentionstaff 2022-07-20 12:31:06 CEST
Documentation is written. Waiting for review.
Comment 5 Nico Gulden univentionstaff 2022-08-19 15:27:34 CEST
QA was done by Dirk.
Comment 6 Nico Gulden univentionstaff 2022-08-19 15:29:03 CEST
The document is built and deployed to public.

It can be reached at https://docs.software-univention.de/ox-connector-app/2.0.0/

The latest version of the document can be reached at https://docs.software-univention.de/ox-connector-app/latest/

Furthermore, the documentation page about apps now has an entry for OX Connector, see https://docs.software-univention.de/apps_5.0.html.en.