agoscript-XML-Beispiele zur Arbeit mit Metadaten

ExtendedAttributes (Metadaten) initial setzen

---

Das folgende Beispiel setzt auf dem Dokument (fileobject) Testdokument.pdf ExtendedAttributes (Firmenname und Datum):

<?xml version="1.0" encoding="ISO-8859-1"?>
<ObjectList>
 <FileObject>
   <Update>Testdokument.pdf</Update>
   <ExtendedAttributesXML><![CDATA[
     <Firma DataType="STRING">agorum Software GmbH</Firma>
     <Datum DataType="DATE" Format="yyyyMMdd">20251105</Datum>
 ]]></ExtendedAttributesXML>
 </FileObject>
</ObjectList>

Weitere ExtendedAttributes hinzufügen

---

Wenn Sie ein Metadatum vergessen haben oder nachträglich auf eine Datei setzen möchten, die bereits Metadaten (ExtendedAttributes) besitzt, verwenden Sie die Funktion UpdateExtendedAttributes. Die vorhandenen Metadaten bleiben unberührt.

Das folgende Beispiel fügt dem Dokument (fileobject) Testdokument.pdf das ExtendedAttribute NochEinMetadatenfeld mit dem Wert Test hinzu:

<?xml version="1.0" encoding="ISO-8859-1"?>
<ObjectList>
 <FileObject>
   <Update>Testdokument.pdf</Update>
   <UpdateExtendedAttributes><![CDATA[
     <NochEinMetadatenfeld DataType="STRING">Test</NochEinMetadatenfeld>
 ]]></UpdateExtendedAttributes>
 </FileObject>
</ObjectList>

ExtendedAttributes vererben

---

Der XML-Parser kann ExtendedAttributes mit Inheritable="true" vererben. Die Vererbung der ExtendedAttributes wirkt sowohl auf Dokumente als auch auf Unterordner. 

Wenn Sie nach per XML angelegten ExtendedAttributes suchen möchten, müssen Sie dafür eine passende Metadatenmaske erstellen. Der interne Name für das entsprechende Feld im Metadatendesigner ist entscheidend und muss mit dem in der XML-Datei verwendeten übereinstimmen:

<ExtendedAttributesXML Inheritable="true">...</ExtendedAttributesXML>

Einen Ordner erstellen

Das folgende Beispiel erstellt den Ordner Testordner mit dem Metadatum (ExtendedAttribute) Geschäftsjahr und dem Wert 2025 und vererbt das Metadatum Geschäftsjahr durch:

<?xml version="1.0" encoding="ISO-8859-1"?>
<ObjectList>
  <FolderObject>
    <Name>Testordner</Name>
    <AddToFolder>/agorum/roi/Files/</AddToFolder>
    <ExtendedAttributesXML Inheritable="true"><![CDATA[
      <Geschäftsjahr DataType="STRING">2025</Geschäftsjahr>
	]]></ExtendedAttributesXML>
  </FolderObject>
</ObjectList>

Einen Ordner aktualisieren

Das folgende Beispiel aktualisiert den Ordner Testordner, setzt das ExtendedAttribute Testmetadatum mit dem Wert Vererbung und vererbt Testmetadatum durch:

<?xml version="1.0" encoding="ISO-8859-1"?>
<ObjectList>
  <FolderObject>
    <Update>Testordner</Update>
    <ExtendedAttributesXML Inheritable="true"><![CDATA[
      <Testmetadatum DataType="STRING">Vererbung</Testmetadatum>
    ]]></ExtendedAttributesXML>
  </FolderObject>
 </ObjectList>

Ein Objekt mithilfe der agorum-ID oder von Platzhaltern aktualisieren

---

Möchten Sie ein bestimmtes Objekt aktualisieren, dessen ID Sie kennen, können Sie ebenfalls agoscript-XML verwenden. Das hat den Vorteil, dass Sie die XML-Datei an einer beliebigen Stelle parsen können und das System trotzdem das richtige Objekt aktualisiert, da die ID eindeutig ist.

Dies kann mithilfe eines Platzhalters, etwa durch den Fileworkflow passieren, oder ein externes Programm liefert eine agoscript-XML-Datei, in der Sie den Platzhalter ${id} durch die tatsächliche ID ersetzen:

<?xml version="1.0" encoding="ISO-8859-1"?>
<ObjectList>
 <GlobalObject>
     <Update RefType="ID" ClassName="GlobalObject">${id}</Update>
       <UpdateExtendedAttributes><![CDATA[
       <JobDMSVorgangsnummer DataType="STRING">offen</JobDMSVorgangsnummer>
       ]]></UpdateExtendedAttributes>
 </GlobalObject>
</ObjectList>