Auf dieser Informationsportalseite wird beschrieben, um welche “Extension Elements“ der BPMN-2.0-Standard in der PICTURE-Prozessplattform erweitert wird. Im Detail wird hier auf die Abbildung dieser “Extension Elements“ in BPMN-2.0-XML-Dateien eingegangen. Die hier aufgeführten Informationen können verwendet werden, um die Zusatzinformationen in aus der Prozessplattform exportierten BPMN-2.0-XML-Dateien in Drittsystemen sinnvoll nachzunutzen.

Das vorliegende Dokument richtet sich an Entwickler solcher Drittsysteme, die die bereitgestellten Daten (als Ganzes oder auszugsweise) in ihren eigenen Anwendungen weiterverwenden möchten.

Inhaltsverzeichnis

Fachliche Hintergründe der BPMN-2.0-Standarderweiterungen in der PICTURE-Prozessplattform

In der Prozessplattform besteht die Möglichkeit Prozesse mit Hilfe von BPMN-Modellen in der Notation “PICTURE-BPMN“ zu modellieren. PICTURE-BPMN versteht sich als "Fachschale" um die BPMN, die speziell zugeschnitten ist für die Dokumentation und Analyse von Prozessen im Umfeld der (öffentlichen) Verwaltung sowie Prozessen mit administrativem Charakter. Die Fachschale macht die BPMN beherrschbar, indem sie einen Rahmen für deren Anwendung vorgibt und die BPMN zielgerichtet erweitert.

Explizit erweitert PICTURE-BPMN den BPMN-Standard um typisierte Tasks, die sogenannten PICTURE-Bausteine. Jeder PICTURE-Baustein stellt eine in vielen Verwaltungsprozessen wiederkehrende Tätigkeit dar, wie z.B. "Daten in die EDV übernehmen" oder "Formell prüfen". An jedem Baustein können stichpunktartig Bausteintypspezifische Informationen in einem “Steckbrief“ hinterlegt werden. Ein solcher Steckbrief besteht aus mehreren Attributen, an denen spezielle Informationen hinterlegt werden können. Weiterhin bestitz jedes Attribut einen bestimmten Datentypen. Die Datentypen unterscheiden sich je nachdem welche Informationen (z.B. Text oder Zahl) an diesen hinterlegt werden können. Die oben beschrieben Steckbriefe stehen nicht nur an PICTURE-Bausteinen sondern auch an allen anderen Modell-Elementen zur Verfügung.

Neben den Prozessen einer Organisation kann in der PICTURE-Prozessplattform das organisatorische und technische Umfeld beschrieben werden, in welches die Prozesse eingebettet sind. Die Modellierung dieses Umfeldes erfolgt mittels Prozesskontexten. Ein Prozesskontext besteht aus einer hierarchisch strukturierten Menge von Prozesskontextelementen. Mögliche Typen sind z.B. Organisationseinheiten (inkl. Stellen), Dokumente oder Software. Auch Prozesskontext-Elemente können mittels eines Steckbriefs (s. oben) ausführlich beschrieben werden.

Das Metamodell, welches der Modellierung von Prozessen und Prozesskontexten in der PICTURE-Prozessplattform zu Grunde liegt, ist in einem gewissen Rahmen für jeden Arbeitsbereich der Prozessplattform konfigurierbar. So kann zur Laufzeit festgelegt werden, welche Attribute in den einzelnen Informationsobjekten (z.B. Prozessbausteine, Prozesskontext-Elemente) ausgefüllt werden können. Für die Definition von Attributen stehen verschiedene Datentypen zur Verfügung, die eine passgenaue Abbildung der zu erhebenden Informationen erlauben. Die unterstützten Datentypen reichen von einfachen textuellen und numerischen Attributen über Einfach- und Mehrfachauswahl aus vordefinierten Listen bis hin zu Verweisen auf andere Informationsobjekte (Prozesse, Prozesskontext-Elemente) innerhalb der PICTURE-Prozessplattform sowie Dateianhänge und Verweise (Hyperlinks) auf externe Informationen in Drittsystemen.

Grundsätzlicher Aufbau der “Extension Elements“ innerhalb des XML-Dokumentes

Innerhalb der Extension-Elemente von aus der PICTURE-Prozessplattform exportieren BPMN-2.0-XML Dateien können unterschiedliche XML-Elemente vorkommen. Dazu gehören Metadaten, Bausteintypen und Attribute bzw. Attributgruppen.

Metadaten

Jede aus der PICTURE-Prozessplattform exportierte BPMN-2.0-XML-Datei enthält einige Metadaten. Diese werden in Form eines “Extension Elements“ entweder am ersten “Collaboration“-Element des XML-Dokumentes oder falls keines dieser Elemente vorhanden ist am ersten “Process“-Element des Dokumentes hinterlegt. Im folgenden sind die Metadaten kurz beschrieben:

<bpmn2:extensionElements>
  <pic:metaData>
    <pic:exportDate>2019-12-16T11:30:20.421+01:00</pic:exportDate>
    <pic:tenant url="https://www.prozessplattform.de/musterhausen/">Musterhausen</pic:tenant>
    <pic:workspace uuid="de20c00c-dc23-4069-a01b-5beb1e70f6a0">Querschnittsprozesse</pic:workspace>
   </pic:metaData>
 </bpmn2:extensionElements>

XML-Tag	Beschreibung	Kommentar/Hinweis
/pic:metaData	Container-Objekt für alle Metadaten
/pic:metaData/pic:exportDate	Datum und Uhrzeit zu welcher die XML-Datei exportiert worden ist	Format: Jahr - Monat - Tag Stunde - Minute - Sekunde - Millisekunde - Zeitzone (Angegeben in Abweichung zur GMT)
/pic:metaData/pic:tenant	Prozessplattform-Mandant aus welcher die XML-Datei exportiert worden ist
/pic:metaData/pic:tenant/@url	Adresse des Prozessplattform-Mandanten aus welcher die XML-Datei exportiert worden ist
/pic:metaData/pic:workspace	Arbeitsbereich aus welchem die XML-Datei exportiert worden ist
/pic:metaData/pic:workspace/@uuid	Eindeutiger Identifikator des Arbeitsbereiches innerhalb der Prozessplattform aus welcher die XML-Datei exportiert worden ist

Bausteintypen

Der (Prozess-) Bausteintyp wird in den Extension-Elements jedes typisierten Tasks auf folgende Art und Weise ausgegeben:

<bpmn2:extensionElements>
 <pic:blockType typeID="picture.blocktype.std#EinzahlungAuszahlungDurchfuehren+01" label="Einzahlung/Auszahlung durchführen"/>
 <!-- An dieser Stelle folgt der Steckbrief des Tasks --> 
</bpmn2:extensionElements>

XML-Tag	Beschreibung	Kommentar/Hinweis
/pic:blockType	Prozessbaussteintyp	Die Prozessbausteintypen werden benutzerdefiniert zur Laufzeit in der Konfiguration eines Arbeitsbereiches konfiguriert.
/pic:blockType/@typeID	Eindeutiger Identifikator des Prozessbausteines innerhalb eines Arbeitsbereiches der PICTURE-Prozessplattform
/pic:blockType/@label	Beschriftung des Prozessbausteins

Steckbrief und Attributgruppen

Die “Extension-Elements“ welche die Steckbriefe der Modell-Elemente beinhalten sind an jedem exportierten Modell-Element vorzufinden und werden wie folgt beschrieben:

<bpmn2:extensionElements>
  <pic:attributes>
    <pic:attributeGroup label="Stammdaten">
    <!-- An dieser Stelle folgen die ausgefüllten Attribute aus der Attribut-Gruppe -->
    </pic:attributeGroup>
    <!-- ggf. weitere Attribut-Gruppen -->
  </pic:attributes>
</bpmn2:extensionElements>

XML-Tag	Beschreibung	Kommentar/Hinweis
/pic:attributes	Container-Objekt für mehrere Attributgruppen.	Enthält den Steckbrief eines Modell-Elements
/pic:attributes/pic:attributeGroup	Container-Objekt für eine bestimmte Menge von Attributen	Attribut-Gruppen werden benutzerdefiniert zur Laufzeit in der Konfiguration eines Arbeitsbereiches festgelegt.
/pic:attributes/pic:attributeGroup/@label	Bezeichnung der Attribut-Gruppe

Attribute bzw. Attribut-Werte

Die Attribute bzw. Attribut-Werte werden innerhalb der Attribut-Gruppen ausgegeben. Es werden nur ausgefüllte Attribute, d.h. Attribute für welche ein Nutzer der Prozessplattform einen Wert hinterlegt hat ausgegeben. Im folgenden Abschnitt dieser Seite finden Sie ausführliche Erklärungen, wie die verschiedenen Attribut-Datentypen gelesen werden müssen. An dieser Stelle ist allgemein beschrieben, wie Attribute bzw. Attribut-Werte innerhalb der Extension-Elements aufgebaut sind

XML-Tag	Beschreibung	Kommentar/Hinweis
/pic:attributes/pic:attributeGroup/*	Beschreibt ein einzelnes Attribut. Ist das umgebende Element des Attribut-Wertes	Die verschiedenen Attribut-Typen sind ausführlich in den Unter-Kapiteln des folgenden Abschnitts beschrieben. Eine Zuordnung der Attribut-Typen zu den Datentypen und XML-Tags ist am Ende der Seite zu finden.
/pic:attributes/pic:attributeGroup/*/@attributeID	Eindeutiger Identifikator des Attributes innerhalb eines Arbeitsbereiches der PICTURE-Prozessplattform
/pic:attributes/pic:attributeGroup/*/@dataType	Datentyp des an diesem Attribut hinterlegbarem Werts	Attributwerte in der Prozessplattform können folgende Datentypen haben. Eine Zuordnung der Datentypen zu den Attribut-Typen und XML-Tags ist am Ende der Seite zu finden. text richtext number selection multiselection references links fileLinks color distribution intermodelLink
/pic:attributes/pic:attributeGroup/*/@name	Bezeichnung des Attributes
/pic:attributes/pic:attributeGroup//	Attributausprägung in Form eines oder mehrere Tags	Die Attribut-Ausprägungen werden je nach Attribut-Typ in unterschiedlichen Formaten angegeben. Im Nachfolgenden Abschnitt sind diese jeweils ausführlich beschrieben.

Repräsentation der Attributausprägungen für die verschiedenen unterstützten Datentypen

Der Aufbau der XML-Tags zur Repräsentation der konkreten Ausprägungen der ausgefüllten Attribute unterscheidet sich jeweils nach dem Datentyp des ausgeprägten Attributs, sowie dem Grad der Ausfüllung der teilweise optionalen Angaben. Für jeden in der PICTURE-Methodenkonfiguration unterstützen Datentyp ist im Folgenden jeweils ein konkretes, vollständiges XML-Beispiel angegeben, das von allen prinzipiell verfügbaren Abbildungsmöglichkeiten Gebrauch macht. Zu jedem Beispiel sind anschließend die verwendeten XML-Tags sowie deren Attribute erläutert.

Text

<textValue attributeID="picture.attribute.std#ErgebnisAbspracheVereinbarung+01" dataType="text" name="Ergebnis der Absprache/Vereinbarung">
  <value>kurzer Text ohne Formatierung</value>
</textValue>

XML-Tag

Beschreibung

Kommentar/Hinweis

/textValue/value

Attributausprägung als einfacher String

Der Text kann Zeilenumbrüche enthalten. Als Zeilentrenner wird hierbei gemäß Unix-Konvention das Steuerzeichen "\n" (newline) verwendet.

Da die XML-Dokumente grundsätzlich mit UTF-8-Encoding erzeugt werden, sind Sonderzeichen wie deutsche Umlaute etc. ohne weitere Maskierung im Text enthalten.

Zeichen, die in XML-Dokumenten eine besondere Bedeutung haben ("<", ">", "&") sind in Entity-Codierung ("<", ">", "&") repräsentiert.

Formatierter Text

<textValue attributeID="description" dataType="richtext" name="Beschreibung">
  <value>&lt;![CDATA[Formatierter Text ohne L&amp;auml;ngenbegrenzung. Zur Formatierung kann eine sehr einfach Teilmenge von HTML genutzt werden.&lt;br /&gt;&lt;br /&gt;Schrift-Schnitt:&lt;ul&gt;&lt;li&gt;&lt;strong&gt;Fett&lt;/strong&gt;&lt;/li&gt;&lt;li&gt;&lt;em&gt;kursiv&lt;/em&gt;&lt;/li&gt;&lt;li&gt;&lt;u&gt;unterstrichen&lt;/u&gt;&lt;/li&gt;&lt;/ul&gt;&lt;br /&gt;Aufz&amp;auml;hlungen:&lt;ul&gt;&lt;li&gt;Mit eindem oder mehreren&lt;/li&gt;&lt;li&gt;Stichpunkten&lt;/li&gt;&lt;/ul&gt;&amp;nbsp;&lt;ol&gt;&lt;li&gt;oder nummeriert&lt;/li&gt;&lt;li&gt;also mit Zahlen ;-)&lt;/li&gt;&lt;/ol&gt;&amp;nbsp;&lt;ul&gt;&lt;li&gt;Aufz&amp;auml;hlungen k&amp;ouml;nnen&lt;ul&gt;&lt;li&gt;auch&lt;ul&gt;&lt;li&gt;einger&amp;uuml;ckt&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;li&gt;sein.&lt;/li&gt;&lt;/ul&gt;&lt;/li&gt;&lt;/ul&gt;&amp;nbsp;&lt;ol&gt;&lt;li&gt;Das geht auch&lt;ol&gt;&lt;li&gt;mit nummerierten&lt;ol&gt;&lt;li&gt;Aufz&amp;auml;hlungen.&lt;/li&gt;&lt;li&gt;Logisch,&amp;nbsp;oder?&lt;/li&gt;&lt;/ol&gt;&lt;/li&gt;&lt;/ol&gt;&lt;/li&gt;&lt;li&gt;&amp;nbsp;Ja, ist klar... ;-)&amp;nbsp;&lt;/li&gt;&lt;/ol&gt;&lt;br /&gt;&amp;nbsp;]]&gt;</value>
</textValue>

XML-Tag

Beschreibung

Kommentar/Hinweis

/textValue/value

Attributausprägung in Form eines HTML-formatierten Texts.

Zur Formatierung des Texts wird in der PICTURE-Prozessplattform folgende Teilmenge von HTML unterstützt:

Zeilenumbrüche ( )
fetter Text ()
kursiver Text ()
unterstrichener Text ()
unsortierte Aufzählungen (<ul><li></li></ul)
sortierte Aufzählungen (<ol><li></li></ol).

Die in der Prozessplattform hinterlegte Attribut-Ausprägung wird in Form eines CDATA-Blocks im PicXML-Dokument ausgegeben. Innerhalb des CDATA-Blocks sind öffnende und schließende Klammern der HTML-Tags ("<", ">") in Form von HTML-Entities dargestellt ("<" bzw. ">"). Das "Kaufmanns-Und" ("&") im HTML-Text ist ebenfalls in HTML-Entity-Darstellung codiert ("&").

Um den Inhalt des CDATA-Blocks in "darstellungsfertiges" HTML umzuwandeln sind folgende Ersetzungen durchzuführen:

"< durch "<" ersetzen
"> durch ">" ersetzen
"& durch "&" ersetzen.

Zahl

<numericValue attributeID="picture.attribute.std#AnzahlGedruckterExemplare+01" dataType="number" name="Anzahl der Exemplare (falls nur ein gedrucktes Dokument)">
  <number>20.0</number>
</numericValue>

XML-Tag

Beschreibung

Kommentar/Hinweis

/numericValue/number

Attributausprägung in Form einer Dezimalzahl.

Als Dezimaltrennzeichen wird der Punkt (".") verwendet, ein Tausendertrennzeichen kommt nicht zum Einsatz. Positive Zahlen (inkl. 0) werden ohne Vorzeichen abgebildet, bei negativen Zahlen ist das Minus ("-") ohne Leerzeichen den Ziffern vorangestellt.

Beispiele:

1123.45

-1123.45

Zahl mit Einheit

<numericValue attributeID="picture.std.attribute#Bearbeitungszeit+01" dataType="number" name="Bearbeitungszeit">
  <number>20.0</number>
  <unit>Minute(n)</unit>
</numericValue>

XML-Tag

Beschreibung

Kommentar/Hinweis

/numericValue/number

Attributausprägung in Form einer Dezimalzahl

vgl. Angaben im Abschnitt "Zahl"

/numericValue/unit

Einheit

Die Einheit(n) sind im Metamodell frei konfigurierbar. Im oben zu sehenden Beispiel wurde als Einheit "Minute" gewählt.

Je nach Konfiguration kann ein Attribut keine, eine bestimmte festgelegte Einheit oder eine Einheit aus einer Auswahl an Möglichkeiten besitzten.
Zum Beispiel wären für ein Zeitattribut sinnvolle Möglichkeiten, die dem Nutzer zur Auswahl stehen könnten:

Sekunde(n)
Minute(n)
Stunde(n)
Tag(e)
Woche(n)
Monat(e)
Jahr(e)

Die Einheit würde dann immer einen dieser Werte annehmen.

Einfach-Auswahl

<singleSelectionValue attributeID="picture.attribute.std#NutzenVerbesserungsvorschlagDurchlaufzeit" dataType="selection" name="Durchlaufzeitverbesserung">
  <selectionItem uuid="picture.attribute.std#AuswahlKeinesGeringMittelHoch_mittel">2 - mittel</selectionItem>
</singleSelectionValue>

XML-Tag

Beschreibung

Kommentar/Hinweis

/singleSelectionValue/selectionItem

Attributausprägung in Form des Namens der gewählten Auswahl-Option

Bei einem Einfachauswahl-Attribut kann genau eine der in der Konfiguration eines Arbeitsbereiches festgelegten, möglichen Ausprägungen ausgewählt werden

Die möglichen Ausprägungen sind benutzerdefiniert zur Laufzeit anpassbar.

Eine Übersicht der konfigurierten Auswahl-Optionen für das jeweilige Attribut kann dem Excel-Export der Konfiguration des Arbeitsbereichs entnommen werden.

Mehrfach-Auswahl

<multiSelectionValue attributeID="picture.attribute.std#ArtRecherche+01" dataType="multiselection" name="Art der Recherche">
  <selectionItem uuid="31a95ddc-1bfb-11e1-ad6b-0026b9a6b961">Intranet</selectionItem>
  <selectionItem uuid="31a96112-1bfb-11e1-ad6b-0026b9a6b961">Aktenbestand</selectionItem>
  <!-- ggf. weitere "selectionItem"-Elemente -->
</multiSelectionValue>

XML-Tag

Beschreibung

Kommentar/Hinweis

/multiSelectionValue/selectionItem

Bestandteil der Attributausprägung in Form des Namens der gewählten Auswahl-Option

Bei einem Mehrfachauswahl-Attribut können beliebig viele der in der Konfiguration eines Arbeitsbereiches festgelegten, möglichen Ausprägungen ausgewählt werden.

Die möglichen Ausprägungen sind benutzerdefiniert zur Laufzeit anpassbar.

Eine Übersicht der konfigurierten Auswahl-Optionen für das jeweilige Attribut kann dem Excel-Export der Konfiguration des Arbeitsbereichs entnommen werden.

Referenzen auf andere Informationsobjekte

<referenceListValue attributeID="picture.attribute.std#VerwendetePapierbasierteDokumente+01" dataType="references" name="Verwendete papierbasierte Dokumente">
  <references>
    <reference>
      <label>Antrag auf Genehmigung von Telearbeit</label>
      <url>https://develop.prozessplattform.de/develop/rest/repository/workspace/de20c00c-dc23-4069-a01b-5beb1e70f6a0/Document/2a9961b8-8680-102f-a894-001aa02a865c/factSheet/representation/xml</url>
      <targetType>Document</targetType>
      <uuid>2a9961b8-8680-102f-a894-001aa02a865c</uuid>
      <context>verpflichtendes Dokument</context>
      <percent>100.0</percent>
        <links>
          <link>
            <fileName>dbdd3c15a9fe03667602c04c253b80eb.docx</fileName>
            <label>Antrag_Telearbeit.docx</label>
            <url>https://develop.prozessplattform.de/develop/rest/files/fileAttachment?file=dbdd3c15a9fe03667602c04c253b80eb.docx&amp;name=Antrag_Telearbeit.docx</url>
          </link>
          <!-- ggf. weitere Links -->
        </links>
      </reference>
      <!-- ggf. weitere Referenzen -->
    </references>
</referenceListValue>

XML-Tag	Beschreibung	Kommentar/Hinweis
/referenceListValue/references	Container-Objekt für alle zur Ausprägung des jeweiligen Attributs erfassten Referenzen
/referenceListValue/references/reference	Referenz auf ein anderes Informationsobjekt
/referenceListValue/references/reference/label	Bezeichnung des referenzierten Elements	Kann bei der Weiterverarbeitung zur "menschenlesbaren" Visualisierung der Referenz genutzt werden. Soll einfach nur aufgelistet werden, auf welche Elemente im jeweiligen Atribut verwiesen wird, reicht es aus, dieses Tag auszuwerten. Alle anderen Tags der Referenz können in diesem Fall ignoriert werden.
/referenceListValue/references/reference/url	URL, unter welcher in der PICTURE-Prozessplattform der Steckbrief des referenzierten Elements (Dateiformat: PicXML 3.0) abgerufen werden kann	Diese Information kann bei der Weiterverarbeitung genutzt werden, um ggf. in der Prozessplattform erfasste weitergehende Informationen zum referenzierten Informationsobjekt abzurufen. Soll nur dessen volle Bezeichnung genutzt werden, ist ein Abruf des unter der URL erreichbaren Dokuments nicht nötig (s. label). Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).
/referenceListValue/references/reference/targetType	Informationsobjekt-Typ des referenzierten Elements	Mögliche Werte: "Process" (Prozess) "ProcessMap" (Prozesslandkarte) "FilterBundle" (Filterbündel) "OrganisationUnit" (Organisationseinheit) "Product" (Produkt) "Document" (Dokument) "ExternalParticipant" (Externer Beteiligter) "Rule" (Regel/Rechtsgrundlage) "Software" "Hardware" "Position" (Stelle) "Person" "SalaryBracket" (Vergütungsgruppe)
/referenceListValue/references/reference/uuid	UUID des referenzierten Elements (identifiziert ein Informationsobjekt eindeutig innerhalb eines Arbeitsbereichs der PICTURE-Prozessplattform)
/referenceListValue/references/reference/context	Freitext-Anmerkung, welcher zur näheren Beschreibung der Referenz dient	Beispiel: Ein Dokument, welches am Attribut "Benötigte Dokumente" eines Prozess-Steckbriefs hinterlegt ist, wird nur unter bestimmten fachlichen Voraussetzungen benötigt. Hierzu wird an der Zuordnung des Dokuments ein entsprechender Freitext-Kommentar erfasst (z.B. "wird nur gebraucht, wenn der Antragsteller EU-Ausländer ist"). Diese Angabe ist optional. Ist keine Anmerkung in der Prozessplattform hinterlegt, so entfällt dieses Tag im XML-Dokument.
/referenceListValue/references/reference/percent	Prozentwert, welcher zur Quantifizierung der Referenz dient (prozentualer Dezimalwert, vgl. o.g. Abschnitt "Prozentualer Wert")	Beispiel: Zwei Personen, die im Steckbrief des Prozesses im Attribut "Ausführende Stelle" hinterlegt sind, teilen sich die Bearbeitung der Fälle im Verhältnis 50:50. Um dies abzubilden wird an der Zuordnung der Personen jeweils der prozentuale Wert "50 %" hinterlegt. Diese Angabe ist optional. Ist kein Prozentwert in der Prozessplattform hinterlegt, so entfällt dieses Tag im XML-Dokument.
/referenceListValue/references/reference/links	Container-Objekt für Hyperlinks zum Download von Dateianhängen	Sofern am Steckbrief des referenzierten Informationsobjektes Dateianhänge hinterlegt sind, werden die Hyperlinks zum Download dieser Dateien in diesem Abschnitt aufgeführt. Bei der Weiterverarbeitung des XML-Dokuments in Drittsystemen können die entsprechenden Informationen daher bereits genutzt werden, ohne für jede Referenz einzeln jeweils der o.g. URL auf den kompletten Steckbrief des referenzierten Strukturmodell-Elements folgen zu müssen.
/referenceListValue/references/reference/link	Hyperlink auf einen Dateianhang
/referenceListValue/references/reference/fileName	Prozessplattform interner Dateiname des Dateianhangs
/referenceListValue/references/reference/label	Beschriftung des Hyperlinks zum Dateianhang
/referenceListValue/references/reference/link/url	URL, unter welcher der Dateianhang des referenzierten Elements heruntergeladen werden kann	Das "Kaufmanns-Und" ("&"; wird in URLs zur Trennung mehrerer Query-Parameter genutzt) ist im URL-String per Entity-Encoding codiert ("&"). Wenn die URL weiterverarbeitet werden soll, muss diese Codierung zunächst rückgängig gemacht werden (Ersetzung des Strings "&" durch "&"). Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).

Intermodell-Referenzen

<referenceListValue attributeID="executor" dataType="intermodelLink" name="ausgeführt von">
 <references>
  <reference>
   <label>Abteilungsleitung (11 - Personal und Organisation)</label>
   <url>https://develop.prozessplattform.de/develop/rest/repository/workspace/de20c00c-dc23-4069-a01b-5beb1e70f6a0/Position/5eebe4b0-14f0-4c93-b93c-527a8f99e523/factSheet/representation/xml</url>
   <targetType>Position</targetType>
   <uuid>5eebe4b0-14f0-4c93-b93c-527a8f99e523</uuid>
   <links/>
  </reference>
 </references>
</referenceListValue>

XML-Tag	Beschreibung	Kommentar/Hinweis
/referenceListValue/references	Container-Objekt für alle zur Ausprägung des jeweiligen Attributs erfassten Referenzen
/referenceListValue/references/reference	Referenz auf ein anderes Informationsobjekt
/referenceListValue/references/reference/label	Bezeichnung des referenzierten Elements	Kann bei der Weiterverarbeitung zur "menschenlesbaren" Visualisierung der Referenz genutzt werden. Soll einfach nur aufgelistet werden, auf welche Elemente im jeweiligen Atribut verwiesen wird, reicht es aus, dieses Tag auszuwerten. Alle anderen Tags der Referenz können in diesem Fall ignoriert werden.
/referenceListValue/references/reference/url	URL, unter welcher in der PICTURE-Prozessplattform der Steckbrief des referenzierten Elements (Dateiformat: PicXML 3.0) abgerufen werden kann	Diese Information kann bei der Weiterverarbeitung genutzt werden, um ggf. in der Prozessplattform erfasste weitergehende Informationen zum referenzierten Informationsobjekt abzurufen. Soll nur dessen volle Bezeichnung genutzt werden, ist ein Abruf des unter der URL erreichbaren Dokuments nicht nötig (s. label). Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).
/referenceListValue/references/reference/targetType	Informationsobjekt-Typ des referenzierten Elements	Mögliche Werte: “SubDiagram” "Process" (Prozess) "ProcessMap" (Prozesslandkarte) "FilterBundle" (Filterbündel) "OrganisationUnit" (Organisationseinheit) "Product" (Produkt) "Document" (Dokument) "ExternalParticipant" (Externer Beteiligter) "Rule" (Regel/Rechtsgrundlage) "Software" "Hardware" "Position" (Stelle) "Person" "SalaryBracket" (Vergütungsgruppe)
/referenceListValue/references/reference/uuid	UUID des referenzierten Elements (identifiziert ein Informationsobjekt eindeutig innerhalb eines Arbeitsbereichs der PICTURE-Prozessplattform)
/referenceListValue/references/reference/links	Container-Objekt für Hyperlinks zum Download von Dateianhängen	Dateianhänge werden bei Intermodell-Referenzen nicht mit ausgegeben

Hyperlinks

<linkListValue attributeID="picture.attribute.std#VerwendeteDokumenteUndInformationenLinks+01" dataType="links" name="Verwendete u. weiterführende Dokumente und Informationen (Links)">
<links>
  <link>
    <label>Heise</label>
    <url>http://www.heise.de</url>
  </link>
  <!-- ggf. weitere Links -->
 </links>
</linkListValue>

XML-Tag	Beschreibung	Kommentar/Hinweis
/linkListValue/links	Container-Objekt für alle erfassten Hyperlinks
/linkListValue/links/link	Hyperlink
/linkListValue/links/link/label	Beschriftung des Hyperlinks	Entspricht sinngemäß dem Text im Body-Element des HTML-Tags "<a>" zur Repräsentation eines Hyperlinks (Bsp: <a href="http://www.heise.de">Heise online</a>).
/linkListValue/links/link/url	Ziel-URL, auf welche der Hyperlink verweist	Entspricht sinngemäß dem Attribut "href" des HTML-Tags "<a>" zur Repräsentation eines Hyperlinks. Achtung: Das "Kaufmanns-Und" ("&"; wird in URLs zur Trennung mehrerer Query-Parameter genutzt) ist im URL-String per Entity-Encoding codiert ("&"). Wenn die URL weiterverarbeitet werden soll, muss diese Codierung zunächst rückgängig gemacht werden (Ersetzung des Strings "&" durch "&").

Dateianhänge

<linkListValue attributeID="picture.attribute.std#VerwendeteDokumenteUndInformationenUpload+01" dataType="fileLinks" name="Verwendete u. weiterführende Dokumente und Informationen (Upload)">
  <links>
    <link>
      <fileName>d10c255821b51c38066e39b1f9f3d371.docx</fileName>
      <label>Urlaubsantrag.docx</label>
      <url>https://develop.prozessplattform.de/develop/rest/files/fileAttachment?file=d10c255821b51c38066e39b1f9f3d371.png&amp;name=Urlaubsantrag.docx</url>
    </link>
    <!-- ggf. weitere Links -->
  </links>
</linkListValue>

XML-Tag	Beschreibung	Kommentar/Hinweis
/linkListValue/links	Container-Objekt für alle erfassten Dateianhänge
/linkListValue/links/link	Hyperlink auf einen Dateianhang
/linkListValue/links/link/fileName	Prozessplattform interner Dateiname des Dateianhangs
/linkListValue/links/link/label	Beschriftung des Hyperlinks zum Dateianhang
/linkListValue/links/link/url	URL, unter welcher der Dateianhang des referenzierten Elements heruntergeladen werden kann	Das "Kaufmanns-Und" ("&"; wird in URLs zur Trennung mehrerer Query-Parameter genutzt) ist im URL-String per Entity-Encoding codiert ("&"). Wenn die URL weiterverarbeitet werden soll, muss diese Codierung zunächst rückgängig gemacht werden (Ersetzung des Strings "&" durch "&"). Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).

Farbe

<colorValue attributeID="#backgroundColor" dataType="color" name="Füllfarbe">
  <value>#b6cce2</value>
</colorValue>

XML-Tag	Beschreibung	Kommentar/Hinweis
/colorValue/value	Festgelegte Farbe des BPMN-Modellelementes in der Hexadezimal-Darstellung

Verteilung

<distributionValue attributeID="picture.attribute.std#UeberschriftKommunikationskanal+01" dataType="distribution" name="Kommunikationskanäle">
  <items>
    <item>
      <label>Persönlich</label>
      <uuid>Persönlich</uuid>
      <percent>50.0</percent>
    </item>
    <item>
      <label>E-Mail</label>
      <uuid>E-Mail</uuid>
      <percent>50.0</percent>
    </item>
    <!-- ggf. weitere Ausprägungen -->
  </items>
</distributionValue>

XML-Tag	Beschreibung	Kommentar/Hinweis
/distributionValue/items/	Container-Objekt für alle mit einem Prozentanteil hinterlegten Attribut-Ausprägungen
/distributionValue/items//item	Eine mit einem Prozentanteil hinterlegte Attribut-Ausprägung	Bei einem Verteilungs-Attribut können beliebig viele der in der Konfiguration eines Arbeitsbereiches festgelegten, möglichen Ausprägungen mit einem Prozentanteil hinterlegt werden. Die möglichen Ausprägungen sind benutzerdefiniert zur Laufzeit anpassbar. Eine Übersicht der konfigurierten Auswahl-Optionen für das jeweilige Attribut kann dem Excel-Export der Konfiguration des Arbeitsbereichs entnommen werden.
/distributionValue/items/item/label	Beschriftung der ausgewählten Attribut-Ausprägung
/distributionValue/items/item/uuid	UUID der Attribut-Ausprägung (identifiziert eine Attribut-Ausprägung eindeutig innerhalb eines Arbeitsbereichs der PICTURE-Prozessplattform)
/distributionValue/items/item/percent	Prozentanteil, der Attribut-Ausprägung an der Gesamtverteilung (prozentualer Dezimalwert, vgl. o.g. Abschnitt "Prozentualer Wert")	Beispiel: Bei einem bestimmten Prozesssschritt findet die dazu notwendige Kommunikation im Verhältnis 50:50 entwender per E-Mail oder im persönlichen Gespräch ab. Um dies abzubilden werden die Attributausprägungen “Persönlich“ und “E-Mail“ jeweils mit dem prozentualen Wert “50 %“ hinterlegt.

Zuordnungstabelle Attribut-Typ, Datentyp, XML-Tag

Attribut-Typ	Datentyp	XML-Tag
Text	text	/textValue
Formatierter Text	text	/textValue
Zahl	number	/numericValue
Zahl mit Einheit	number	/numericValue
Einfach-Auswahl	selection	/singleSelectionValue
Mehrfachauswahl	multiselection	/multiSelectionValue
Referenzen auf andere Informationsobjekte	references	/referenceListValue
Intermodell-Referenz	intermodelLink	/referenceListValue
Hyperlinks	links	/linkListValue
Dateianhänge	fileLinks	/linkListValue
Farbe	color	/colorValue
Verteilung	distribution	/distributionValue

BPMN-2.0-XML mit PICTURE spezifischen "Extension Elements"

Inhaltsverzeichnis

Fachliche Hintergründe der BPMN-2.0-Standarderweiterungen in der PICTURE-Prozessplattform

Grundsätzlicher Aufbau der “Extension Elements“ innerhalb des XML-Dokumentes

Metadaten

Bausteintypen

Steckbrief und Attributgruppen

Attribute bzw. Attribut-Werte

Repräsentation der Attributausprägungen für die verschiedenen unterstützten Datentypen

Text

Formatierter Text

Zahl

Zahl mit Einheit

Einfach-Auswahl

Mehrfach-Auswahl

Referenzen auf andere Informationsobjekte

Intermodell-Referenzen

Hyperlinks

Dateianhänge

Farbe

Verteilung

Zuordnungstabelle Attribut-Typ, Datentyp, XML-Tag