deploy: cadd1eb

.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: af73100e0889f28b6e637d5e2e7d0baa
+tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/code/capella2polarion.connectors.rst.txt

@@ -0,0 +1,26 @@
+capella2polarion.connectors package
+===================================
+
+.. automodule:: capella2polarion.connectors
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+capella2polarion.connectors.polarion\_repo module
+-------------------------------------------------
+
+.. automodule:: capella2polarion.connectors.polarion_repo
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.connectors.polarion\_worker module
+---------------------------------------------------
+
+.. automodule:: capella2polarion.connectors.polarion_worker
+   :members:
+   :undoc-members:
+   :show-inheritance:

_sources/code/capella2polarion.converters.rst.txt

@@ -0,0 +1,82 @@
+capella2polarion.converters package
+===================================
+
+.. automodule:: capella2polarion.converters
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+capella2polarion.converters.converter\_config module
+----------------------------------------------------
+
+.. automodule:: capella2polarion.converters.converter_config
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.data\_session module
+------------------------------------------------
+
+.. automodule:: capella2polarion.converters.data_session
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.document\_config module
+---------------------------------------------------
+
+.. automodule:: capella2polarion.converters.document_config
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.document\_renderer module
+-----------------------------------------------------
+
+.. automodule:: capella2polarion.converters.document_renderer
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.element\_converter module
+-----------------------------------------------------
+
+.. automodule:: capella2polarion.converters.element_converter
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.link\_converter module
+--------------------------------------------------
+
+.. automodule:: capella2polarion.converters.link_converter
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.model\_converter module
+---------------------------------------------------
+
+.. automodule:: capella2polarion.converters.model_converter
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.polarion\_html\_helper module
+---------------------------------------------------------
+
+.. automodule:: capella2polarion.converters.polarion_html_helper
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.converters.text\_work\_item\_provider module
+-------------------------------------------------------------
+
+.. automodule:: capella2polarion.converters.text_work_item_provider
+   :members:
+   :undoc-members:
+   :show-inheritance:

_sources/code/capella2polarion.data_model.rst.txt

@@ -0,0 +1,34 @@
+capella2polarion.data\_model package
+====================================
+
+.. automodule:: capella2polarion.data_model
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+capella2polarion.data\_model.document\_data module
+--------------------------------------------------
+
+.. automodule:: capella2polarion.data_model.document_data
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.data\_model.work\_item\_attachments module
+-----------------------------------------------------------
+
+.. automodule:: capella2polarion.data_model.work_item_attachments
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+capella2polarion.data\_model.work\_items module
+-----------------------------------------------
+
+.. automodule:: capella2polarion.data_model.work_items
+   :members:
+   :undoc-members:
+   :show-inheritance:

_sources/code/capella2polarion.rst.txt

@@ -0,0 +1,28 @@
+capella2polarion package
+========================
+
+.. automodule:: capella2polarion
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Subpackages
+-----------
+
+.. toctree::
+   :maxdepth: 4
+
+   capella2polarion.connectors
+   capella2polarion.converters
+   capella2polarion.data_model
+
+Submodules
+----------
+
+capella2polarion.cli module
+---------------------------
+
+.. automodule:: capella2polarion.cli
+   :members:
+   :undoc-members:
+   :show-inheritance:

_sources/code/modules.rst.txt

@@ -0,0 +1,7 @@
+capella-polarion
+================
+
+.. toctree::
+   :maxdepth: 4
+
+   capella2polarion

_sources/configuration/polarion.rst.txt

@@ -0,0 +1,35 @@
+..
+   Copyright DB InfraGO AG and contributors
+   SPDX-License-Identifier: Apache-2.0
+
+.. _polarion-config:
+
+Polarion
+========
+In general, if an attribute is not configured, it will not be accepted and the
+the Rest API will raise a 400 HTTPError since it expects a plain string
+attribute. As we use rich text instead, you need to configure your Polarion
+project correctly. For that there is the `Capella2Polarion Project Template`_
+which includes icon, custom field and enumeration configuration for a pleasant
+capella2polarion synchronization.
+
+.. _Capella2Polarion Project Template: https://github.com/DSD-DBS/capella-polarion-template#polarion-dbs-project-template
+
+In general it is advised to use a separate Polarion project for the model
+synchronization. In the following are some requirements for the configuration
+if you don't want to use the Project Template:
+
+The matching of diagrams and model elements is done using the ``uuid_capella``
+attribute, which needs to be declared in the ``Custom Fields`` section. Simply
+choose ``All Types`` for this attribute.
+
+To have icons for your model elements, you need to declare the work item type
+in the ``workitem-type-enum.xml`` file in the Polarion administration panel and
+upload a 16x16 picture file.
+
+To generate clickable linked work items, you need to configure the link role
+enumerations in the ``workitem-link-role-enum.xml`` file. Here, the ID should
+match the attributes of the capellambse object (e.g., ``involved_activities``),
+or you can define custom attributes that require custom code implementation
+(e.g., ``description_reference`` links for references to objects in the
+description).

_sources/configuration/render_documents.rst.txt

@@ -0,0 +1,82 @@
+..
+   Copyright DB InfraGO AG and contributors
+   SPDX-License-Identifier: Apache-2.0
+
+.. _render-docs-config:
+
+Live-Docs rendering
+===================
+The high-level functionality and use cases are described in the
+:ref:`feature <render-documents>` documentation page. Here it is described how
+to set up the Live-Docs rendering.
+
+Full Authority Mode
+*******************
+The ``full_authority_config.yaml`` file provides an example configuration for
+rendering documents in full authority mode.
+
+.. literalinclude:: ../../../tests/data/documents/full_authority_config.yaml
+   :language: yaml
+   :lines: 4-
+
+This file describes the Jinja2 template for the rendering, the filename, the
+location, the Polarion project ID. This means it is possible to populate
+Live-Doc spaces of other projects. A status-allow-list handles the statuses on
+which the Live-Doc will be updated on. If the status enum isn't provided in the
+list and the Live-Doc status is changed to it, the service won't update the
+Live-Doc. This facilitates an efficient and streamlined review and release
+process, minimizing disruptions.
+
+Each instance is a Live-Doc, possibly targeting a specific model element.
+With `work_item_layouts` the representational configuration of work items in
+the Live-Doc are managed.
+
+Mixed Authority Mode
+********************
+The `mixed_config.yaml` file describes how to set up mixed authority mode
+Live-Docs for automated rendering.
+
+.. literalinclude:: ../../../tests/data/documents/mixed_config.yaml
+   :language: yaml
+   :lines: 4-
+
+.. _mixed-sections-config:
+
+Under `sections` the individual templates are listed to populate the marked
+sections from the Live-Doc. The following macro is used as dividers:
+
+.. code-block:: html
+
+   <div class="c2pAreaStart" id="IcdContent">
+   #set($statusList = ["draft", "planned", "inReview"])
+   #if ($statusList.contains($document.getStatus().id))
+   <p style="font-weight: bold;background-color: #FFFF00;text-align: center;">
+   DON'T REMOVE THIS<br>
+   ↓↓↓Below this point all content is autogenerated and will be overwritten↓↓↓
+   </p>
+   #end
+   </div>
+
+This looks then like the following in the Live-Doc:
+
+.. image:: ../_static/mixed-authority-live-doc-divider-down.png
+
+Don't forget to do the same for closing the section:
+
+.. image:: ../_static/mixed-authority-live-doc-divider-up.png
+
+Configuration File Templates
+----------------------------
+The `config.yaml.j2` file in the `documents` folder serves as the primary
+configuration template for the Live-Doc rendering service. This Jinja2 template
+defines how data from the Capella model should be structured and rendered into
+Polarion Live-Docs.
+
+.. literalinclude:: ../../../tests/data/documents/config.yaml.j2
+   :language: jinja
+   :lines: 4-
+
+Using this template, the service can populate sections of the Live-Doc with
+content based on the selected rendering mode. When working in Mixed authority
+mode, the marked sections in the document will be populated, leaving the
+unmarked sections untouched.