Versionen im Vergleich

Schlüssel

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

...

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-TagBeschreibungKommentar
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-TagBeschreibungKommentar
attribute -> numberAttributausprägung in Form einer Dezimalzahlvgl. Angaben im Abschnitt "Zahl"
attribute -> unitEinheitBei 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-TagBeschreibungKommentar
attribute -> numberAttributausprägung in Form einer Dezimalzahlvgl. Angaben im Abschnitt "Ganzzahl, Kommazahl"
attribute -> unitWä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-TagBeschreibungKommentar
attribute -> valueAttribut in Form eines binären Wertes (ja/nein)

Mögliche Werte:

  • Ja
  • Nein

...

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.

Tipp

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


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-TagBeschreibungKommentar
attribute -> valueAttributausprägung in Form des Namens der gewählten Auswahl-itemsContainer-Objekt für alle ausgewählten Auswahl-Optionen
attribute -> items -> itemausgewählte Option

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="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&amp;name=Scan</url>
					<fileName>587bd071b4ae233fb61b10df580a6692.jpg</fileName>
				</link>
				<!-- ggf. weitere Links -->
			</links>
		</reference>
		<!-- ggf. weitere Referenzen -->
	</references>
</attribute>

...

XML-TagBeschreibungKommentar
attribute -> referencesContainer-Objekt für alle zur Ausprägung des jeweiligen Attributs erfassten Referenzen
attribute -> references -> referenceReferenz auf ein Prozesskontext-Element / ein Modell
attribute -> references -> reference -> labelBezeichnung des referenzierten ElementsKann 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 -> urlURL, 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 -> targetTypeTyp 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)
attribute -> references -> reference -> uuidUUID des referenzierten Elements (identifiziert ein Prozesskontext-Element bzw. einen Prozess eindeutig innerhalb eines Arbeitsbereichs der PICTURE-Prozessplattform)
attribute -> references -> reference -> contextKontext-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 -> percentKontext-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 -> labelBeschriftung des Hyperlinks zum Dateianhang
attribute -> references -> reference -> links -> link -> urlURL, 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).

...

XML-TagXML-AttributBeschreibungKommentar
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 ("&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).

attribute -> links -> link -> fileNameDateiname, 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 "&amp;" 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>

...