Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Codeblock
languagexml
<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
languagexml
<bpmn2:extensionElements>
 <pic:blockType typeID="picture.blocktype.std#EinzahlungAuszahlungDurchfuehren+01" label="Einzahlung/Auszahlung durchführen"/>
  <pic:attributes>
    <pic:attributeGroup label="Stammdaten">
      <numericValue attributeID="picture.attribute.std#Zahlungshoehe+01" dataType="number" name="Durchschnittliche Höhe der Zahlung">
        <number>2000.0</number>
        <unit>EUR</unit>
      </numericValue>
      <!-- Weitere Attribute <!-- 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

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

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

Bausteintypen

XML-Tag

Beschreibung

Kommentar/Hinweis

/pic:

blockType

Prozessbaussteintyp

Die Prozessbausteintypen werden benutzerdefiniert zur Laufzeit in der Konfiguration eines Arbeitsbereiches konfiguriert.

attributes

Container-Objekt für mehrere Attributgruppen.

Enthält den Steckbrief eines Modell-Elements

/pic:

blockType

attributes/

@typeID

Eindeutiger Identifikator des Prozessbausteines innerhalb eines Arbeitsbereiches der PICTURE-Prozessplattform

/pic:blockType/@label

Beschriftung des Prozessbausteins

Steckbrief und Attributgruppen

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

pic:attributeGroup

Container-Objekt für eine bestimmte Menge von Attributen

Attribut-Gruppen werden benutzerdefiniert zur Laufzeit in der

Konfiguration

Methodenkonfiguration eines Arbeitsbereiches festgelegt.

/pic:attributes/pic:attributeGroup/@label

Bezeichnung der Attribut-Gruppe

Attribute bzw. Attribut-Werte

...

XML-Tag

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/

numericValue/pic

*

Ein Attribut vom Typ Zahl (“number”).
Im konkreten Fall wird eine Währung abgebildet.

Neben dem Attribut vom Typ Zahl stehen noch weitere Attribut-Typen in der Prozessplattform zur Verfügung. Diese werden im Nachfolgenden Abschnitt dieser Seite ausführlich beschrieben:

Inhalt
maxLevel2
minLevel2

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/

numericValue

*/@attributeID

Eindeutiger Identifikator des Attributes innerhalb eines Arbeitsbereiches der PICTURE-Prozessplattform

/pic:attributes/pic:attributeGroup/

numericValue

*/@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

  • computed

    • selection

    • multiselection

    • references

    • links

    • fileLinks

    • color

    • distribution

    • intermodelLink

    /pic:attributes/pic:attributeGroup/

    numericValue

    */@name

    Bezeichnung des Attributes

    /pic:attributes/pic:attributeGroup/

    numericValue

    */

    number

    *

    Attributausprägung in Form

    einer Dezimalzahl

    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.

    /pic:attributes/pic:attributeGroup/numericValue/unit

    Währungseinheit (Kürzel)

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

    Inhalt-zone

    ...

    location

    ...

    top

    ...

    typeflat
    separatorpipe

    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

    Codeblock
    languagexml
    <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 ("&lt;", "&gt;", "&amp;") repräsentiert.

    Formatierter Text

    Codeblock
    languagexml
    <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 (<br/>)

    • fetter Text (<strong></strong>)

    • kursiver Text (<em></em>)

    • unterstrichener Text (<u></u>)

    • 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 ("&lt;" bzw. "&gt;"). Das "Kaufmanns-Und" ("&") im HTML-Text ist ebenfalls in HTML-Entity-Darstellung codiert ("&amp;").

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

    • "&lt; durch "<" ersetzen

    • "&gt; durch ">" ersetzen

    • "&amp; durch "&" ersetzen.

    Zahl

    Codeblock
    languagexml
    <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

    Codeblock
    languagexml
    <numericValue attributeID="
    c36e2c8f-fdb9-449d-9180-065a9411a40d
    picture.std.attribute#Bearbeitungszeit+01" dataType="number" name="
    Erfolgschance
    Bearbeitungszeit">
      
    <number>65
    <number>20.0</number>
      
    <unit>%<
    <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 "

    ...

    Codeblock
    languagexml
    <numericValue

    Minute" gewählt.

    Zeit

    Je nach Methodenkonfiguration 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

    Codeblock
    languagexml
    <singleSelectionValue attributeID="picture.
    std
    attribute.
    attribute#Bearbeitungszeit+01
    std#NutzenVerbesserungsvorschlagDurchlaufzeit" dataType="
    number
    selection" name="
    Bearbeitungszeit
    Durchlaufzeitverbesserung">
      
    <number>20.0</number> <unit>Minute(n)</unit> </numericValue>
    <selectionItem uuid="picture.attribute.std#AuswahlKeinesGeringMittelHoch_mittel">2 - mittel</selectionItem>
    </singleSelectionValue>

    XML-Tag

    Beschreibung

    Kommentar/Hinweis

    /

    ...

    singleSelectionValue/

    ...

    selectionItem

    Attributausprägung in Form

    ...

    vgl. Angaben im Abschnitt "Zahl". Negative Werte sind hier nicht zulässig.

    ...

    /numericValue/unit

    ...

    Mögliche Werte:

    • Sekunde(n)

    • Minute(n)

    • Stunde(n)

    • Tag(e)

    • Woche(n)

    • Monat(e)

    • Jahr(e)

    Währung

    des Namens der gewählten Auswahl-Option

    Bei einem Einfachauswahl-Attribut kann genau eine der in der Methodenkonfiguration 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 Methodenkonfiguration des Arbeitsbereichs entnommen werden.

    Mehrfach-Auswahl

    Codeblock
    languagexml
    <numericValue
    <multiSelectionValue attributeID="picture.attribute.
    std#Zahlungshoehe
    std#ArtRecherche+01" dataType="
    number
    multiselection" name="
    Durchschnittliche
    Art 
    Höhe
    der 
    Zahlung
    Recherche">
      
    <number>2000.0</number> <unit>EUR</unit> </numericValue>
    <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

    ...

    vgl. Angaben im Abschnitt "Zahl".

    ...

    /numericValue/unit

    ...

    Währungseinheit (Kürzel)

    Einfach-Auswahl

    Codeblock
    languagexml
    <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

    Codeblock
    languagexml
    <multiSelectionValue

    des Namens der gewählten Auswahl-Option

    Bei einem Mehrfachauswahl-Attribut können beliebig viele der in der Methodenkonfiguration 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 Methodenkonfiguration des Arbeitsbereichs entnommen werden.

    Referenzen auf andere Informationsobjekte

    In der Prozessplattform kann an Steckbrief-Attributen (z.B. Prozess-Steckbrief, Steckbrief von Prozesskontext-Elementen, “Baustein-Steckbrief”) vom Typ “Referenz auf andere Informationsobjekte” (z.B. Prozesskontextelemente) verwiesen werden. An solchen Attributen ist jeweils festgelegt, auf welchen Typ anderer Informationsobjekte verwiesen werden kann (targetType). Es ist also an einem Attribut nur möglich, z.B. auf Organisationseinheiten, aber nicht gleichzeigt auf Leistungen zu verweisen.

    Codeblock
    languagexml
    <referenceListValue attributeID="picture.attribute.
    std#ArtRecherche
    std#VerwendetePapierbasierteDokumente+01" dataType="
    multiselection
    references" name="
    Art
    Verwendete 
    der
    papierbasierte 
    Recherche
    Dokumente">
      
    <selectionItem uuid="31a95ddc-1bfb-11e1-ad6b-0026b9a6b961">Intranet</selectionItem>
    <references>
       
    <selectionItem uuid="31a96112-1bfb-11e1-ad6b-0026b9a6b961">Aktenbestand</selectionItem>
     <reference>
      
    <!--
     
    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

    Codeblock
    languagexml
    <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>
      <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>
          
    <targetType>Document</targetType>
          
    <uuid>2a9961b8-8680-102f-a894-001aa02a865c</uuid>
    <fileName>dbdd3c15a9fe03667602c04c253b80eb.docx</fileName>
         
    <context>verpflichtendes
     
    Dokument</context>
          
    <percent>100.0</percent>
    <label>Antrag_Telearbeit.docx</label>
            
    <links>
        
    <link> <fileName>dbdd3c15a9fe03667602c04c253b80eb.docx</fileName> <label>Antrag_Telearbeit.docx</label> <url>https://develop.prozessplattform.
    <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 ("&amp;"). Wenn die URL weiterverarbeitet werden soll, muss diese Codierung zunächst rückgängig gemacht werden (Ersetzung des Strings "&amp;" durch "&").

    Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).

    Intermodell-Referenzen

    Codeblock
    languagexml
    <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

    ...

    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
    languagexml
    <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)

    ...

    • )

    • "OrganisationUnit" (Organisationseinheit

    ...

    • )

    • "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

    Codeblock
    languagexml
    <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 ("&amp;"). Wenn die URL weiterverarbeitet werden soll, muss diese Codierung zunächst rückgängig gemacht werden (Ersetzung des Strings "&amp;" durch "&").

    Dateianhänge

    Codeblock
    languagexml
    <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 ("&amp;"). Wenn die URL weiterverarbeitet werden soll, muss diese Codierung zunächst rückgängig gemacht werden (Ersetzung des Strings "&amp;" durch "&").

    Zum Zugriff auf diese URL ist ein Login in die PICTURE-Prozessplattform erforderlich (kann programmatisch per REST-API erfolgen).

    Farbe

    Codeblock
    languagexml
    <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
    languagexml
    <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")

    ...

    <!-- 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