...
Codeblock | ||
---|---|---|
| ||
<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:
Codeblock | ||
---|---|---|
| ||
<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 |
Methodenkonfiguration 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
...
Codeblock | ||
---|---|---|
| ||
<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 |
Methodenkonfiguration 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.
|
/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
Verzeichnisbereich | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
Formatierter Text
Zahl
Zahl mit Einheit
Einfach-Auswahl
Mehrfach-Auswahl
Referenzen auf andere Informationsobjekte Codeblock | | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Codeblock | ||
---|---|---|
| ||
<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&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:
|
/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) |
Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).
Intermodell-Referenzen
. |
Intermodell-Referenzen
Intermodell-Referenzen sind eine besondere Form von Referenzen auf andere Informationsobjekte. Intermodell-Referenzen zeichnen sich dadurch aus, dass sie nicht nur im Steckbrief (z.B. Dokumenten-Steckbrief, Attributliste eines Prozess-Bausteins), sondern auch direkt im grafischen Prozessmodell einsehbar sind. Beispielsweise wird bei einer Verknüpfung von einer Schwimmbahn mit einer Organisationseinheit die Bezeichnung der Organisationseinheit als Titel der Schwimmbahn gesetzt und ein Link-Symbol daneben angezeigt. Dabei ist zu berücksichtigen, dass der Titel der Schwimmbahn trotzdem unabhängig von der Verknüpfung existiert und durch Nutzer der Prozessplattform unabhängig vom verknüpften Informationsobjekt geändert werden kann. D.h. z.B. dass der Titel der Schwimmbahn “Personalabrechnung“ heißen kann, während die verknüpfte Organisationseinheit “11.2 - Personalabrechnung“ heißt.
Codeblock | ||
---|---|---|
| ||
<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:
|
"ProcessMap" (Prozesslandkarte)
|
|
"Person"
| ||
/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
Codeblock | ||
---|---|---|
| ||
<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
Codeblock | ||
---|---|---|
| ||
<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&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
Codeblock | ||
---|---|---|
| ||
<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
Codeblock | ||
---|---|---|
| ||
<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 |
Methodenkonfiguration 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 Methodenkonfiguration 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 Datentyp (PPP-GUI), Datentyp (XML), XML-Tag
Bezeichnung des Datentyps in der GUI der PPP (Methodenkonfiguration) | Technische Bezeichnung des Datentyps im PicXML-Dateiformat | Name des XML-Tags zur Repräsentation von Attribut-Ausprägungen mit diesem Datentyp in PicXML-Dateien |
---|---|---|
Text | text | /textValue |
Formatierter Text |
richtext | /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 |