...
PicXML 3.0 unterstützt derzeit den Export von Steckbriefen zu Prozessen und Prozesskontext-Elementen. Falls Sie andere Informationsobjekte aus der PICTURE-Prozessplattform (z.B. Detailmodelle oder Prozesskontext-Hierarchien) zur Weiterverarbeitung in Drittsystemen benötigen, verwenden Sie hierzu das PicJSON-Format.
...
XML-Tag | Beschreibung | Kommentar |
---|---|---|
attribute -> 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 |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="numericValue" attributeID="e5467ea7-d817-4ede-8ee1-e4c19c36f8a7" dataType="number"> <number>99.98</number> <unit>%</unit> </attribute> |
...
XML-Tag | Beschreibung | Kommentar |
---|---|---|
attribute -> number | Attributausprägung in Form einer Dezimalzahl | vgl. Angaben im Abschnitt "Zahl" |
attribute -> unit | EinheitBei | Attributen vom Datentyp "Prozentualer Wert" wird in diesem XML-Tag immer immer der Wert "%" benutztDie Einheit(n) sind im Metamodell frei konfigurierbar. Im oben zu sehenden Beispiel wurde als Einheit "%" gewählt. |
Zeit
Codeblock |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="numericValue" attributeID="a0352294-6c10-4bc0-9c7d-c85c24189896" dataType="number"> <number>3.0</number> <unit>Stunde(n)</unit> </attribute> |
...
XML-Tag | Beschreibung | Kommentar |
---|---|---|
attribute -> number | Attributausprägung in Form einer Dezimalzahl | vgl. Angaben im Abschnitt "Ganzzahl, Kommazahl" |
attribute -> unit | Währungseinheit (Kürzel) |
...
Einfach-Auswahl
Codeblock |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="textValue" attributeID="b3b79a605a292f8d-910f9edb-49fa4696-afc1b3d9-80aba1815a8a9bacc6555512" dataType="selection"> <value>Ja<<value>Option 1</value> </attribute> |
XML-Tag | Beschreibung | Kommentar |
---|---|---|
attribute -> value | Attribut in Form eines binären Wertes (ja/nein) | Mögliche Werte:
|
...
Attributausprägung in Form des Namens der gewählten Auswahl-Option | Die möglichen Ausprägungen werden in der PICTURE-Methodenkonfiguration festgelegt und sind benutzerdefiniert zur Laufzeit anpassbar.
|
Mehrfach-Auswahl
Codeblock |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="textValuelistValue" attributeID="5a292f8d93e0bdd7-9edbe5a4-4696401f-b3d99d53-9bacc6555512055acc2fa1f6" dataType="selectionmultiselection"> <value>Option 1</value> </attribute> <items> <item>Option A</item> <item>Option B</item> </items> </attribute> |
XML-Tag | Beschreibung | Kommentar | ||
---|---|---|---|---|
attribute -> valueAttributausprägung in Form des Namens der gewählten Auswahl-items | Container-Objekt für alle ausgewählten Auswahl-Optionen | |||
attribute -> items -> item | ausgewählte Option | Die möglichen Ausprägungen werden in der PICTURE-Methodenkonfiguration festgelegt und sind benutzerdefiniert zur Laufzeit anpassbar.
|
...
Referenzen auf andere Modelle oder Prozesskontext-Elemente
Codeblock |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="listValuereferenceListValue" attributeID="93e0bdd729d314b8-e5a47b39-401f4236-9d53a8bd-055acc2fa1f63d267096b68f" dataType="multiselectionreferences"> <items><references> <item>Option A</item> <reference> <item>Option<label>Passierschein B<38/11</item>label> </items> </attribute> |
...
Die möglichen Ausprägungen werden in der PICTURE-Methodenkonfiguration festgelegt und sind benutzerdefiniert zur Laufzeit anpassbar.
Tipp |
---|
Eine Übersicht der konfigurierten Auswahl-Optionen für das jeweilige Attribut kann dem Excel-Export der Konfiguration des Arbeitsbereichs entnommen werden. |
Referenzen auf andere Modelle oder Prozesskontext-Elemente
Codeblock |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="referenceListValue" attributeID="29d314b8-7b39-4236-a8bd-3d267096b68f" dataType="references"> <references> <reference> <label>Passierschein 38/11</label> <url>http://localhost:8081/primestack/rest/repository/workspace/3066c890-9e0b-48e9-b388-9cedd6f904c3/Document/4424d921-d8e7-4bbe-a100-cc8ce777362e/factSheet/representation <url>http://localhost:8081/primestack/rest/repository/workspace/3066c890-9e0b-48e9-b388-9cedd6f904c3/Document/4424d921-d8e7-4bbe-a100-cc8ce777362e/factSheet/representation/xml</url> <targetType>Document</targetType> <uuid>4424d921-d8e7-4bbe-a100-cc8ce777362e</uuid> <context>verpflichtendes Dokument</context> <percent>100.0</percent> <links> <link> <label>Scan</label> <url>http://localhost:8081/primestack/rest/repository/fileAttachment?file=587bd071b4ae233fb61b10df580a6692.jpg&name=Scan</url> <fileName>587bd071b4ae233fb61b10df580a6692.jpg</fileName> </link> <!-- ggf. weitere Links --> </links> </reference> <!-- ggf. weitere Referenzen --> </references> </attribute> |
...
XML-Tag | Beschreibung | Kommentar |
---|---|---|
attribute -> references | Container-Objekt für alle zur Ausprägung des jeweiligen Attributs erfassten Referenzen | |
attribute -> references -> reference | Referenz auf ein Prozesskontext-Element / ein Modell | |
attribute -> 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. |
attribute -> 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 Prozesskontext-Element 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). |
attribute -> references -> reference -> targetType | Typ des referenzierten Elements | Mögliche Werte:
|
attribute -> references -> reference -> uuid | UUID des referenzierten Elements (identifiziert ein Prozesskontext-Element bzw. einen Prozess eindeutig innerhalb eines Arbeitsbereichs der PICTURE-Prozessplattform) | |
attribute -> references -> reference -> context | Kontext-Information, welche zur näheren Beschreibung der Referenz dient (Freitext) | 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 Kontext-Information in der Prozessplattform hinterlegt, so entfällt dieses Tag im PicXML-3-Dokument. |
attribute -> references -> reference -> percent | Kontext-Information, welche 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 Sachbearbeiter" 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 keine Kontext-Information in der Prozessplattform hinterlegt, so entfällt dieses Tag im PicXML-3-Dokument. |
attribute -> references -> reference -> links | Container-Objekt für Hyperlinks zum Download von Dateianhängen | Sofern am Steckbrief des referenzierten Strukturmodell-Elements Dateianhänge hinterlegt sind, werden die Hyperlinks zum Download dieser Dateien in diesem Abschnitt aufgeführt. Bei der Weiterverarbeitung des PicXML-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. |
attribute -> references -> reference -> links -> link -> label | Beschriftung des Hyperlinks zum Dateianhang | |
attribute -> references -> reference -> 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). |
...
XML-Tag | XML-Attribut | Beschreibung | Kommentar | |||
---|---|---|---|---|---|---|
attribute -> links | Container-Objekt für alle erfassten Dateianhänge | |||||
attribute -> links -> link | Hyperlink zum Zugriff auf eine dem Steckbrief angehängte Datei | |||||
attribute -> links -> link -> label | Beschriftung des Hyperlinks zum Dateianhang | |||||
attribute -> links -> link -> url | URL, unter welcher der Dateianhang 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). | attribute -> links -> link -> fileName | Dateiname, unter welchem die Datei im Anschluss an einen Publikations-Lauf mit der App "WebDAV-Publisher" im Verzeichnis "uploads" der WebDAV-Freigabe gefunden werden kann | Bei einem Publikations-Lauf mit dem WebDAV-Publisher werden neben den Steckbriefen der freigegebenen Prozesse auch die dort hinterlegten Dateianhänge auf die WebDAV-Freigabe geschrieben. Die in diesem XML-Tag gespeicherten Werte ermöglichen bei der Weiterverarbeitung der veröffentlichten Daten das einfache Auffinden der publizierten Dateianhängedie 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). | |
attribute -> links -> link -> fileName | Dateiname, unter welchem die Datei im internen Datenspeicher der Prozessplattform angelegt ist | Deprecated. Dieses Feld ist nur noch aus Gründen der Abwärtskompatibilität vorhanden. Es kann von neuentwickelten externen Client-Anwendungen ignoriert werden. |
Schlagworte
Codeblock |
---|
<attribute xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="listValue" attributeID="picture.std.attribute#Schlagworte+01" dataType="tags"> <items> <item>beispiel</item> <item>datentypen</item> <item>demo</item> <item>test</item> </items> </attribute> |
...