Versionen im Vergleich

Alte Version 71

changes.mady.by.user Former user

Gespeichert am

verglichen mit

Neue Version 72

changes.mady.by.user Former user

Gespeichert am

Schlüssel

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

...

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:

Inhalt
maxLevel2
minLevel2
exclude(Metadaten)|(Bausteintypen)|(Steckbrief und Attributgruppen)|(Attribute bzw. Attribut-Werte)

/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 bzw. XML-Tags ist weiter unten 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.

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

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

...

locationtop
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.

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

Formatierter Text

Verzeichnisbereich
locationtop
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="picture.attribute.std#ErgebnisAbspracheVereinbarung+01description" dataType="textrichtext" name="Ergebnis der Absprache/VereinbarungBeschreibung">
  <value>kurzer<value>&lt;![CDATA[Formatierter 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.

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 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;strongu&gt;Fettunterstrichen&lt;/strongu&gt;&lt;/li&gt;&lt;li/ul&gt;&lt;embr /&gt;kursivAufz&lt;/em&gt;amp;auml;hlungen:&lt;/liul&gt;&lt;li&gt;Mit eindem oder mehreren&lt;u/li&gt;unterstrichen&lt;/uli&gt;Stichpunkten&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;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="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

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

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>
      <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 ("&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

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

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

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