Programmierschnittstellen (API)

[anchor|#top]
English version of this page: [ApiDocumentation|Workity API]

Auf dieser Seite werden die Programmierschnittstellen (API) von [http://workity.simprove.de|Simprove Workity] beschrieben. Wenn Sie weitere Unterstützung benötigen, um eigene Workity-Zusatzanwendungen (z.B. Desktop- und Mobile-Clients, Widgets, alternative Web-Frontends, etc.) zu entwickeln, wenden Sie sich bitte per [http://www.workity.com/support.aspx?subject=API+Support|Kontaktformular] an unseren Support.

{s:info} Nur Premium-Mitglieder können unter Verwendung der Programmierschnittstellen (API) eigene Workity-Zusatzanwendungen entwickeln.

{s:info} Nur Premium-Mitglieder können unter Verwendung der Programmierschnittstellen (API) entwickelte Workity-Zusatzanwendungen nutzen.

{TOC}

== Einleitung ==
=== Webservice-Schnittstelle ===
Die einzelnen Funktionen der Workity API sind als [http://de.wikipedia.org/wiki/Webservice|Webservice] unter folgender URI verfügbar:

[https://www.workity.com/services/api.asmx|https://www.workity.com/services/api.asmx]

Ein direkter Aufruf dieser Webservice-URI im Browser bietet einen Überblick zu allen verfügbaren Funktionen und der zugehörigen [https://www.workity.com/services/api.asmx?WSDL|WSDL-Dienstbeschreibung]. Durch Auswahl einer bestimmten Funktion wird die SOAP 1.1 und SOAP 1.2 Definition dieser Service-Anfrage und deren Antwort dargestellt.

[#top|nach oben]

[anchor|#authentication]
=== Ticket-Authentisierung ===
Damit nicht bei jedem Aufruf einer API-Funktion die Zugangsdaten (Nutzer-E-Mail-Adresse und Passwort) des aufrufenden Workity-Nutzers übergeben werden müssen, wird ein so genanntes Ticket in Form einer [http://de.wikipedia.org/wiki/Globally_Unique_Identifier|GUID] zur Nutzer-Authentisierung verwendet. Durch einen erfolgreichen Aufruf der [#login|Login]-Funktion mit den gültigen Zugangsdaten eines bestimmten Workity-Nutzers wird ein neues Ticket für diesen Nutzer erstellt und im Header der entsprechenden SOAP-Antwort zurückgeliefert.

Beispiel für eine SOAP-Antwort der [#login|Login]-Funktion mit einer [http://de.wikipedia.org/wiki/Globally_Unique_Identifier|GUID] als Ticket im SOAP-Header:
{{{{
<esc>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <TicketHeader xmlns="http://www.workity.com/services/api">
      <Ticket>f30f74e1-05e0-43bc-8a93-1ac90106a986</Ticket>
    </TicketHeader>
  </soap:Header>
  <soap:Body>
    <LoginResponse xmlns="http://www.workity.com/services/api">
      <LoginResult>0</LoginResult>
    </LoginResponse>
  </soap:Body>
</soap:Envelope>
</esc>
}}}}

Beim jedem Aufruf einer anderen Funktion muss das für den aufrufenden Nutzer durch die [#login|Login]-Funktion erstellte Ticket im Header der entsprechenden SOAP-Anforderung übergeben werden, um eine entsprechende Nutzer-Authentisierung zu ermöglichen.

Beispiel für eine SOAP-Anforderung der [#getuserinfo|GetUserInfo]-Funktion mit einer [http://de.wikipedia.org/wiki/Globally_Unique_Identifier|GUID] als Ticket im SOAP-Header:
{{{{
<esc>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <TicketHeader xmlns="http://www.workity.com/services/api">
      <Ticket>f30f74e1-05e0-43bc-8a93-1ac90106a986</Ticket>
    </TicketHeader>
  </soap:Header>
  <soap:Body>
    <GetUserInfo xmlns="http://www.workity.com/services/api" />
  </soap:Body>
</soap:Envelope>
</esc>
}}}}

{s:info} Durch einen erfolgreichen Aufruf der [#logout|Logout]-Funktion wird das dabei im SOAP-Header übergebene Ticket ungültig und kann somit anschließend nicht mehr zur Authentisierung des aufrufenden Nutzers verwendet werden.

{s:info} Durch Aufruf der [#isauthenticated|IsAuthenticated]-Funktion kann geprüft werden, ob das dabei im SOAP-Header übergebene Ticket noch gültig ist.

{s:warning} Ein Ticket wird automatisch ungültig, wenn dieses länger als 1 Stunde nicht mehr zum Aufruf einer API-Funktion verwendet wurde.

[#top|nach oben]

[anchor|#writewriteconflict]
=== Schreib-Schreib-Konflikt ===
Beim Aufruf der Funktionen [#savefile|SaveFile], [#savenote|SaveNote] oder [#savetask|SaveTask] kann ein so genannter Schreib-Schreib-Konflikt entstehen, wenn 2 oder mehr Mitglieder eines Projektes unabhängig und zeitnah die gleiche Revision ''x'' eines bestimmten Elementes (Aufgabe, Notiz oder Datei) bearbeiten und diese Änderungen mit der gleichen neuen Revision ''x + 1'' speichern.

Im Falle eines Schreib-Schreib-Konfliktes werden vor dem Speichern neuer Inhalte mit der Revision ''x + 1'' zunächst alle aktuellen Inhalte (außer die zugewiesenen Schlagwörter und Personen) der Revision ''x + 1'' des betroffen Elementes in ein neues Element des zugehörigen Projektes kopiert. Im Anschluss werden die alten Inhalte des betroffenen Elementes durch die neuen Inhalte überschrieben. Zusätzlich werden das betroffene Element und dessen Kopie mit dem Schlagwort ''!WRITE-WRITE-CONFLICT!'' getaggt. Dieses Schlagwort hat die Identifikationsnummer 1, welche dem Rückgabewert der Funktionen [#savefile|SaveFile], [#savenote|SaveNote] oder [#savetask|SaveTask] im Falle eines Schreib-Schreib-Konfliktes entspricht. 

{s:info} Wenn ein Datei-Element von einem Schreib-Schreib-Konflikt betroffen ist, wird als Kopie ein Notiz-Element mit dem Dateinamen als Kurzbeschreibung und den Details des Datei-Elementes angelegt. Der binäre Inhalt der betroffenen Datei wird nicht kopiert und kann nach wie vor nur über das originale Datei-Element wieder heruntergeladen werden. 

Nachdem ein Schreib-Schreib-Konflikt aufgetreten ist, kann dieser von den beteiligten Personen aufgelöst werden, indem durch Aufruf der [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch]-Funktion nach allen Elementen mit der Schlagwort-Identifikationsnummer 1 gesucht wird und die Inhalte der gefundenen Elemente wieder zu einem einheitlichen Element zusammengefasst werden. Im Anschluss können die überflüssigen Kopien des betroffenen Elementes durch Aufruf der [#deleteitems|DeleteItems]-Funktion gelöscht werden. Weiterhin kann nach Auflösung des Konfliktes das Schlagwort ''!WRITE-WRITE-CONFLICT!'' durch Aufruf der [#removekeywords|RemoveKeywords]-Funktion wieder von dem betroffenen Element entfernt werden.

Beispiel: Lenny und Carl erarbeiten in einem Notiz-Element die Gästeliste für eine gemeinsame Geburtstagsparty. Dieses Notiz-Element hat aktuell die Revision 10 und wird unabhängig und zeitnah von beiden bearbeitet. Zunächst fügt Lenny noch Homer als neuen Gast hinzu und speichert das Notiz-Element mit der neuen Revision 11. Kurze Zeit später speichert Carl das Notiz-Element ebenfalls mit der Revision 11, weil er Ned noch als neuen Gast hinzugefügt hat. Hierdurch entsteht ein Schreib-Schreib-Konflikt, welcher von Carl durch den Rückgabewert 1 beim Aufruf der [#savenote|SaveNote]-Funktion erkannt wird. Nun lässt sich Carl durch Aufruf der [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch]-Funktion die beiden Notiz-Elemente anzeigen, die mit dem Schlagwort mit der Identifikationsnummer 1 getaggt sind. An der Gästeliste-Kopie erkennt Carl, dass Lenny noch Homer hinzugefügt hat und übernimmt diese Änderung in die originale Gästeliste. Im Anschluss löscht Carl die Kopie durch Aufruf der [#deleteitems|DeleteItems]-Funktion und entfernt durch Aufruf der [#removekeywords|RemoveKeywords]-Funktion das Schlagwort ''!WRITE-WRITE-CONFLICT!'' wieder vom originalen Notiz-Element.

siehe auch: [#deletewriteconflict|Lösch-Schreib-Konflikt], [#savefile|SaveFile], [#savenote|SaveNote], [#savetask|SaveTask]

[#top|nach oben]

[anchor|#deletewriteconflict]
=== Lösch-Schreib-Konflikt ===
Beim Aufruf der Funktionen [#savefile|SaveFile], [#savenote|SaveNote] oder [#savetask|SaveTask] kann ein so genannter Lösch-Schreib-Konflikt entstehen, wenn unabhängig und zeitnah ein Projektmitglied ein bestimmtes Element (Aufgabe, Notiz oder Datei) löscht und kurz darauf ein anderes Projektmitglied versucht, dieses Element zu speichern.

Im Falle eines Lösch-Schreib-Konfliktes werden die neuen Inhalte des bereits gelöschten Elementes in einem neuen Element des zugehörigen Projektes gespeichert. Zusätzlich wird dieses neue Element mit dem Schlagwort ''!DELETE-WRITE-CONFLICT!'' getaggt. Dieses Schlagwort hat die Identifikationsnummer 2, welche dem Rückgabewert der Funktionen [#savefile|SaveFile], [#savenote|SaveNote] oder [#savetask|SaveTask] im Falle eines Lösch-Schreib-Konfliktes entspricht. 

{s:warning} Wenn ein Datei-Element von einem Lösch-Schreib-Konflikt betroffen ist, werden lediglich die neuen Details dieses Datei-Elementes in einem neuen Notiz-Element mit der Kurzbeschreibung ''???'' gespeichert. Der binäre Inhalt der betroffenen Datei geht unwideruflich beim Löschen des originalen Datei-Elementes verloren.

Nachdem ein Lösch-Schreib-Konflikt aufgetreten ist, kann dieser von den beteiligten Personen aufgelöst werden, indem durch Aufruf der [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch]-Funktion nach dem Element mit der Schlagwort-Identifikationsnummer 2 gesucht wird. Abhängig von der inhaltlichen Bedeutung kann dieses Element entweder durch Aufruf der [#deleteitems|DeleteItems]-Funktion erneut gelöscht oder durch Aufruf der Funktionen [#addpersons|AddPersons] bzw. [#addkeywords|AddKeywords] wieder mit gültigen Personen und Schlagwörtern getaggt werden. Zudem kann durch Aufruf der [#removekeywords|RemoveKeywords]-Funktion das Schlagwort ''!DELETE-WRITE-CONFLICT!'' wieder von diesem Element entfernt werden.

Beispiel: Lenny und Carl haben gemeinsam eine Geburtstagsparty veranstaltet. Im Anschluss an die Party möchte Lenny noch die in einem Notiz-Element erstellte Gästeliste um einige Kontakt-Informationen ergänzen und die Liste im nächsten Jahr erneut verwenden. Während Lenny die Liste bearbeitet, löscht Carl jedoch dieses Notiz-Element. Wenn Lenny durch Aufruf der [#savenote|SaveNote]-Funktion versucht, seine Änderungen zu speichern, wird er durch den Rückgabewert 2 auf einen Lösch-Schreib-Konflikt aufmerksam gemacht. Nun lässt sich Lenny durch Aufruf der [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch]-Funktion das Notiz-Element anzeigen, das mit dem Schlagwort mit der Identifikationsnummer 2 getaggt ist. Da Lenny die aktualisierte Gästeliste noch weiter verwenden möchte, taggt er durch Aufruf der [#addpersons|AddPersons]-Funktion das gefundene Notiz-Element wieder mit seiner Person und entfernt durch Aufruf der [#removekeywords|RemoveKeywords]-Funktion das Schlagwort ''!DELETE-WRITE-CONFLICT!''.

siehe auch: [#writewriteconflict|Schreib-Schreib-Konflikt], [#savefile|SaveFile], [#savenote|SaveNote], [#savetask|SaveTask]

[#top|nach oben]

== Daten-Referenz ==
=== Datenfeld (Array) ===
Ein Datenfeld (engl. [http://de.wikipedia.org/wiki/Array|Array]) eines bestimmten Datentyps wird innerhalb dieser Dokumentation durch die Notation ''Datentyp-Array'' beschrieben. Beispielsweise beschreibt die Notation ''long-Array'' ein Datenfeld des Datentyps [#long|long].

[#top|nach oben]

[anchor|#boolean]
=== true/false-Wert (boolean) ===
Datentyp zur Beschreibung eines true/false-Wertes.

[#top|nach oben]

[anchor|#byte]
=== 8-Bit-Ganzzahl (byte) ===
Datentyp zur Beschreibung von Ganzzahlen ohne Vorzeichen im Wertebereich von 0 bis 255.

[#top|nach oben]

[anchor|#int]
=== 32-Bit-Ganzzahl (int) ===
Datentyp zur Beschreibung von Ganzzahlen mit Vorzeichen im Wertebereich von -2.147.483.648 bis 2.147.483.647.

[#top|nach oben]

[anchor|#long]
=== 64-Bit-Ganzzahl (long) ===
Datentyp zur Beschreibung von Ganzzahlen mit Vorzeichen im Wertebereich von -9.223.372.036.854.775.808 bis 9.223.372.036.854.775.807.

[#top|nach oben]

[anchor|#string]
=== Zeichenkette (string) ===
Datentyp zur Beschreibung von Zeichenketten im [http://de.wikipedia.org/wiki/Unicode|Unicode-Format].

[#top|nach oben]

[anchor|#datetime]
=== Zeitpunkt (dateTime) ===
Datentyp zur Beschreibung von Zeitpunkten, die durch Datum und Uhrzeit angegeben werden. Die Notation eines bestimmten Zeitpunktes erfolgt entsprechend dem [http://www.w3.org/TR/NOTE-datetime|ISO 8601 Standard] im Format:

 YYYY-MM-DDThh:mmTZD (z.B. 1989-11-09T22:30 für den 9. November 1989 um 22:30 Uhr)

* YYYY = 4-stellige Jahreszahl (z.B. 1989)
* MM = 2-stellige Monatszahl (01 = Januar, 02 = Februar, etc.)
* DD = 2-stellige Tageszahl im Bereich von 01 bis 31
* hh = 2-stellige Stundenzahl im Bereich von 00 bis 23
* mm = 2-stellige Minutenzahl im Bereich von 00 bis 59
* TZD = optionaler Zeitzonen-Bezeichner (engl. time zone designator) durch Angabe von ''Z'' oder ''+hh:mm'' oder ''-hh:mm''

{s:info} Die zusätzliche Angabe von Sekunden ist möglich, wird jedoch vom System ignoriert. Somit werden bespielweise die Zeitpunkte 1989-11-09T22:30:01 und 1989-11-09T22:30:59 vom System als gleichwertig interpretiert.

{s:warning} Es werden nur Werte im Bereich von 1900-01-01T00:00 bis 2079-06-06T23:59 als gültige Zeitpunkte akzeptiert.

[#top|nach oben]

[anchor|#project]
=== Project ===
Datenstruktur zur Kurzbeschreibung eines Projektes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer
|-
| [#string|string]
| Name
| Projektname
|}

[#top|nach oben]

[anchor|#projectinfo]
=== ProjectInfo ===
Datenstruktur zur ausführlichen Beschreibung eines Projektes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer
|-
| [#string|string]
| Name
| Projektname
|}

{s:info} Diese Datenstruktur entspricht aktuell der [#project|Project]-Datenstruktur, wird aber möglicherweise noch um weitere Projekt-Eigenschaften erweitert.

[#top|nach oben]

[anchor|#person]
=== Person ===
Datenstruktur zur Kurzbeschreibung einer Person mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| PersonID
| Identifikationsnummer
|-
| [#string|string]
| Name
| Name der Person
|}

[#top|nach oben]

[anchor|#personinfo]
=== PersonInfo ===
Datenstruktur zur ausführlichen Beschreibung einer Person mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| PersonID
| Identifikationsnummer
|-
| [#string|string]
| Name
| Name der Person
|-
| [#string|string]
| PictureURL
| URL zum Profil-Bild der Person
|}

[#top|nach oben]

[anchor|#keyword]
=== Keyword ===
Datenstruktur zur Kurzbeschreibung eines Schlagwortes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| KeywordID
| Identifikationsnummer
|-
| [#string|string]
| Name
| Bezeichnung des Schlagwortes
|}

[#top|nach oben]

[anchor|#keywordinfo]
=== KeywordInfo ===
Datenstruktur zur ausführlichen Beschreibung eines Schlagwortes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| KeywordID
| Identifikationsnummer
|-
| [#string|string]
| Name
| Bezeichnung des Schlagwortes
|-
| [#int|int]
| UsageCount
| Anzahl, wie oft das Schlagwort verwendet wird.
|}

{s:info} Die UsageCount-Eigenschaft kann beispielweise verwendet werden, um eine Menge von Schlagwörtern als so genannte 
[http://de.wikipedia.org/wiki/TagCloud|Schlagwortwolke] (engl. tag cloud) darzustellen.

[#top|nach oben]

[anchor|#modification]
=== Modification ===
Datenstruktur zur Beschreibung der Person und des Zeitpunktes in Verbindung mit der Änderung eines Elementes (Aufgabe, Notiz oder Datei):

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#person|Person]
| Person
| Person, die das Element zuletzt geändert hat.
|-
| [#datetime|dateTime]
| Date
| Änderungszeitpunkt
|}

[#top|nach oben]

[anchor|#upload]
=== Upload ===
Datenstruktur zur Beschreibung der Person und des Zeitpunktes in Verbindung mit dem Hochladen einer Datei:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#person|Person]
| Person
| Person, von der die Datei hochgeladen wurde.
|-
| [#datetime|dateTime]
| Date
| Zeitpunkt, zu dem die Datei hochgeladen wurde.
|}

[#top|nach oben]

[anchor|#taskitem]
=== TaskItem ===
Datenstruktur zur Beschreibung eines Aufgaben-Elementes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long] 
| TaskID
| Identifikationsnummer
|-
| [#project|Project] 
| Project
| zugehöriges Projekt
|-
| [#string|string]
| Title
| Kurzbeschreibung des Aufgaben-Elementes
|-
| [#string|string]
| Details
| Details des Aufgaben-Elementes
|-
| [#boolean|boolean]
| IsFinished
| aktueller Bearbeitungszustand der Aufgabe
|-
| [#datetime|dateTime]
| DueDate
| Fälligkeitszeitpunkt der Aufgabe
|-
| [#modification|Modification]
| Modification
| Informationen zur letzten Änderung des Aufgaben-Elementes
|-
| [#person|Person]-Array
| Persons
| Personen, mit denen das Aufgaben-Element getaggt ist.
|-
| [#keyword|Keyword]-Array
| Keywords
| Schlagwörter, mit denen das Aufgaben-Element getaggt ist.
|-
| [#int|int]
| Revision
| Anzahl, wie oft das Aufgaben-Element bereits geändert wurde.
|}

[#top|nach oben]

[anchor|#noteitem]
=== NoteItem ===
Datenstruktur zur Beschreibung eines Notiz-Elementes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long] 
| NoteID
| Identifikationsnummer
|-
| [#project|Project] 
| Project
| zugehöriges Projekt
|-
| [#string|string]
| Title
| Kurzbeschreibung des Notiz-Elementes
|-
| [#string|string]
| Details
| Details des Notiz-Elementes
|-
| [#modification|Modification]
| Modification
| Informationen zur letzten Änderung des Notiz-Elementes
|-
| [#person|Person]-Array
| Persons
| Personen, mit denen das Notiz-Element getaggt ist.
|-
| [#keyword|Keyword]-Array
| Keywords
| Schlagwörter, mit denen das Notiz-Element getaggt ist.
|-
| [#int|int]
| Revision
| Anzahl, wie oft das Notiz-Element bereits geändert wurde.
|}

[#top|nach oben]

[anchor|#fileitem]
=== FileItem ===
Datenstruktur zur Beschreibung eines Datei-Elementes mit folgenden Eigenschaften:

{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long] 
| FileID
| Identifikationsnummer
|-
| [#project|Project] 
| Project
| zugehöriges Projekt
|-
| [#string|string]
| Name
| Dateiname
|-
| [#string|string]
| ContentType
| Inhaltstyp der Datei, z.B. ''text/plain'', ''image/jpeg'', ''application/pdf'', etc.
|-
| [#long|long]
| Size
| Größe der Datei in Bytes
|-
| [#string|string]
| Details
| Details des Datei-Elementes
|-
| [#upload|Upload]
| Upload
| Informationen in Verbindung mit dem Hochladen der Datei
|-
| [#modification|Modification]
| Modification
| Informationen zur letzten Änderung des Datei-Elementes
|-
| [#person|Person]-Array
| Persons
| Personen, mit denen das Datei-Element getaggt ist.
|-
| [#keyword|Keyword]-Array
| Keywords
| Schlagwörter, mit denen das Datei-Element getaggt ist.
|-
| [#int|int]
| Revision
| Anzahl, wie oft das Datei-Element bereits geändert wurde.
|}

[#top|nach oben]

== Funktionen ==
[anchor|#addkeywords]
=== AddKeywords ===
Weist eine Menge von Schlagwörtern einer Menge von Elementen (Aufgaben, Notizen, Dateien) zu.

[https://www.workity.com/services/api.asmx?op=AddKeywords|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array 
| TaskIDs
| Identifikationsnummern der Aufgaben-Elemente, die mit den gegebenen Schlagwörtern getaggt werden sollen.
|-
| [#long|long]-Array 
| NoteIDs
| Identifikationsnummern der Notiz-Elemente, die mit den gegebenen Schlagwörtern getaggt werden sollen.
|-
| [#long|long]-Array 
| FileIDs
| Identifikationsnummern der Datei-Elemente, die mit den gegebenen Schlagwörtern getaggt werden sollen.
|-
| [#long|long]-Array 
| KeywordIDs
| Identifikationsnummern der Schlagwörter, mit denen die gegebenen Elemente getaggt werden sollen.
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem die gegebenen Elemente geändert werden.
|}

{s:info} Ungültige Identifikationsnummern für Elemente und Schlagwörter werden ignoriert.

'''Rückgabe:'''
Diese Funktion liefert keinen Rückgabewert.

siehe auch: [#removekeywords|RemoveKeywords]

[#top|nach oben]

[anchor|#addpersons]
=== AddPersons ===
Weist eine Menge von Personen einer Menge von Elementen (Aufgaben, Notizen, Dateien) zu.

[https://www.workity.com/services/api.asmx?op=AddPersons|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array 
| TaskIDs
| Identifikationsnummern der Aufgaben-Elemente, die mit den gegebenen Personen getaggt werden sollen.
|-
| [#long|long]-Array 
| NoteIDs
| Identifikationsnummern der Notiz-Elemente, die mit den gegebenen Personen getaggt werden sollen.
|-
| [#long|long]-Array 
| FileIDs
| Identifikationsnummern der Datei-Elemente, die mit den gegebenen Personen getaggt werden sollen.
|-
| [#long|long]-Array 
| PersonIDs
| Identifikationsnummern der Personen, mit denen die gegebenen Elemente getaggt werden sollen.
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem die gegebenen Elemente geändert werden.
|}

{s:info} Ungültige Identifikationsnummern für Elemente und Personen werden ignoriert.

'''Rückgabe:'''
Diese Funktion liefert keinen Rückgabewert.

siehe auch: [#removepersons|RemovePersons]

[#top|nach oben]

[anchor|#deleteitems]
=== DeleteItems ===
Löscht eine Menge von Elementen (Aufgaben, Notizen, Dateien).

[https://www.workity.com/services/api.asmx?op=DeleteItems|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array 
| TaskIDs
| Identifikationsnummern der Aufgaben-Elemente, die gelöscht werden sollen.
|-
| [#long|long]-Array 
| NoteIDs
| Identifikationsnummern der Notiz-Elemente, die gelöscht werden sollen.
|-
| [#long|long]-Array 
| FileIDs
| Identifikationsnummern der Datei-Elemente, die gelöscht werden sollen.
|}

{s:info} Ungültige Identifikationsnummern für Elemente werden ignoriert.

'''Rückgabe:'''
Diese Funktion liefert keinen Rückgabewert.

[#top|nach oben]

[anchor|#downloadfile]
=== DownloadFile ===
Herunterladen einer bestimmten Datei.

[https://www.workity.com/services/api.asmx?op=DownloadFile|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| FileID
| Identifikationsnummer der Datei, die heruntergeladen werden soll.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#string|string]
| Name
| Name der heruntergeladenen Datei
|-
| [#string|string]
| ContentType
| Inhaltstyp der heruntergeladenen Datei, z.B. ''text/plain'', ''image/jpeg'', ''application/pdf'', etc.
|-
| [#byte|byte]-Array
| Bytes
| binärer Inhalt der heruntergeladenen Datei
|}

siehe auch: [#newfile|NewFile]

[#top|nach oben]

[anchor|#getitems]
=== GetItems ===
Liefert eine Menge bestimmter Elemente (Aufgaben, Notizen, Dateien) zurück.

[https://www.workity.com/services/api.asmx?op=GetItems|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array
| TaskIDs
| Identifikationsnummern der Aufgaben-Elemente, die zurückgegeben werden sollen.
|-
| [#long|long]-Array
| NoteIDs
| Identifikationsnummern der Notiz-Elemente, die zurückgegeben werden sollen.
|-
| [#long|long]-Array
| FileIDs
| Identifikationsnummern der Datei-Elemente, die zurückgegeben werden sollen.
|-
| [#boolean|boolean]
| IsDetails
| Flag, ob von den angeforderten Elementen auch der Inhalt der Details-Eigenschaft zurückgeliefert werden soll.
|}

{s:info} Ungültige Identifikationsnummern für Elemente werden ignoriert.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#taskitem|TaskItem]-Array
| TaskItems
| Aufgaben-Elemente, die durch den TaskIDs-Parameter angefordert wurden.
|-
| [#noteitem|NoteItem]-Array
| NoteItems
| Notiz-Elemente, die durch den NoteIDs-Parameter angefordert wurden.
|-
| [#fileitem|FileItem]-Array
| FileItems
| Datei-Elemente, die durch den FileIDs-Parameter angefordert wurden.
|}

siehe auch: [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch], [#getitemsbynewssearch|GetItemsByNewsSearch]

[#top|nach oben]

[anchor|#getitemsbyadvancedsearch]
=== GetItemsByAdvancedSearch ===
Liefert auf der Basis bestimmter Suchkriterien eine Menge gefundener Elemente (Aufgaben, Notizen, Dateien) zurück.

[https://www.workity.com/services/api.asmx?op=GetItemsByAdvancedSearch|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#string|string]
| SearchString
| Suchtext, auf dessen Basis bestimmte Elemente gefunden werden sollen.{BR}{s:info} Der Suchtext kann so formuliert werden, wie man es von der Suche im Internet (z.B. Google) gewohnt ist.{BR}{s:info} Ein leerer Suchtext wird als Suchkriterium nach bestimmten Elementen ignoriert.{BR}{s:warning} Ein Wert mit mehr als 50 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]-Array
| ProjectIDs
| Identifikationsnummern von aktiven Projekten des aufrufenden Nutzers, in denen nach bestimmten Elementen gesucht werden soll.{BR}{s:info} Wenn keine Projekte angegeben werden (leeres Array), wird in allen aktiven Projekten des aufrufenden Nutzers gesucht.
|-
| [#long|long]-Array
| PersonIDs
| Identifikationsnummern von Personen, mit denen die zu suchenden Elemente getaggt sein müssen.
|-
| [#long|long]-Array
| KeywordIDs
| Identifikationsnummern von Schlagwörtern, mit denen die zu suchenden Elemente getaggt sein müssen.
|-
| [#boolean|boolean]
| IsUnfinishedTasks
| Flag, ob nach unerledigten Aufgaben-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsFinishedTasks
| Flag, ob nach erledigten Aufgaben-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsMinDueDate
| Flag, ob der Fälligkeitszeitpunkt der zu suchenden Aufgaben größer oder gleich dem Wert des MinDueDate-Parameters sein muss.
|-
| [#datetime|dateTime]
| MinDueDate
| minimaler Fälligkeitszeitpunkt der zu suchenden Aufgaben{BR}{s:info} Dieser Wert wird ignoriert, wenn der IsMinDueDate-Parameter den Wert ''false'' hat.
|-
| [#boolean|boolean]
| IsMaxDueDate
| Flag, ob der Fälligkeitszeitpunkt der zu suchenden Aufgaben kleiner oder gleich dem Wert des MaxDueDate-Parameters sein muss.
|-
| [#datetime|dateTime]
| MaxDueDate
| maximaler Fälligkeitszeitpunkt der zu suchenden Aufgaben{BR}{s:info} Dieser Wert wird ignoriert, wenn der IsMaxDueDate-Parameter den Wert ''false'' hat.
|-
| [#boolean|boolean]
| IsNotes
| Flag, ob nach Notiz-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsFiles
| Flag, ob nach Datei-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsModificationDate
| Flag, ob nach Elementen gesucht werden soll, deren letzter Änderungszeitpunkt größer oder gleich dem Wert des ModificationDate-Parameters sein muss.
|-
| [#datetime|dateTime]
| ModificationDate
| minimaler letzter Änderungszeitpunkt der zu suchenden Elemente{BR}{s:info} Dieser Wert wird ignoriert, wenn der IsModificationDate-Parameter den Wert ''false'' hat.
|-
| [#boolean|boolean]
| IsModificationPerson
| Flag, ob nach Elementen gesucht werden soll, die zuletzt von einer bestimmten Person geändert wurden.
|-
| [#long|long]
| ModificationPersonID
| Identifikationsnummer der Person, die zuletzt die zu suchenden Elemente geändert hat.{BR}{s:info} Dieser Wert wird ignoriert, wenn der IsModificationPerson-Parameter den Wert ''false'' hat.
|-
| [#boolean|boolean]
| IsDetails
| Flag, ob von den gefundenen Elementen auch der Inhalt der Details-Eigenschaft zurückgeliefert werden soll.
|}

{s:warning} Ungültige Identifikationsnummern für Projekte, Personen und Schlagwörter liefern keine Elemente zurück.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#taskitem|TaskItem]-Array
| TaskItems
| Aufgaben-Elemente, die auf Basis der Suchkriterien gefunden wurden.
|-
| [#noteitem|NoteItem]-Array
| NoteItems
| Notiz-Elemente, die auf Basis der Suchkriterien gefunden wurden.
|-
| [#fileitem|FileItem]-Array
| FileItems
| Datei-Elemente, die auf Basis der Suchkriterien gefunden wurden.
|}

siehe auch: [#getitems|GetItems], [#getitemsbynewssearch|GetItemsByNewsSearch]

[#top|nach oben]

[anchor|#getitemsbyfulltextsearch]
=== GetItemsByFullTextSearch ===
Liefert auf der Basis eines bestimmten Suchtextes eine Menge gefundener Elemente (Aufgaben, Notizen, Dateien) zurück.

{s:warning} Diese Funktion ist überflüssig und sollte nicht mehr verwendet werden. Verwenden Sie bitte stattdessen die [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch]-Funktion, um auf der Basis eines bestimmten Suchtextes nach Elementen zu suchen.

[https://www.workity.com/services/api.asmx?op=GetItemsByFullTextSearch|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#string|string]
| SearchString
| Suchtext, auf dessen Basis bestimmte Elemente gefunden werden sollen.{BR}{s:info} Der Suchtext kann so formuliert werden, wie man es von der Suche im Internet (z.B. Google) gewohnt ist.{BR}{s:warning} Ein Wert mit mehr als 50 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]-Array
| ProjectIDs
| Identifikationsnummern von aktiven Projekten des aufrufenden Nutzers, in denen nach bestimmten Elementen gesucht werden soll.{BR}{s:info} Wenn keine Projekte angegeben werden (leeres Array), wird in allen aktiven Projekten des aufrufenden Nutzers gesucht.
|-
| [#boolean|boolean]
| IsUnfinishedTasks
| Flag, ob nach unerledigten Aufgaben-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsFinishedTasks
| Flag, ob nach erledigten Aufgaben-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsNotes
| Flag, ob nach Notiz-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsFiles
| Flag, ob nach Datei-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsDetails
| Flag, ob von den gefundenen Elementen auch der Inhalt der Details-Eigenschaft zurückgeliefert werden soll.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#taskitem|TaskItem]-Array
| TaskItems
| Aufgaben-Elemente, deren Title-Eigenschaft oder Details-Eigenschaft den Suchtext enthalten.
|-
| [#noteitem|NoteItem]-Array
| NoteItems
| Notiz-Elemente, deren Title-Eigenschaft oder Details-Eigenschaft den Suchtext enthalten.
|-
| [#fileitem|FileItem]-Array
| FileItems
| Datei-Elemente, deren Name-Eigenschaft oder Details-Eigenschaft den Suchtext enthalten.
|}

siehe auch: [#getitems|GetItems], [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch], [#getitemsbynewssearch|GetItemsByNewsSearch]

[#top|nach oben]

[anchor|#getitemsbynewssearch]
=== GetItemsByNewsSearch ===
Liefert auf der Basis bestimmter Suchkriterien eine Menge gefundener Elemente (Aufgaben, Notizen, Dateien) zurück, die seit dem letzten Aufruf der [#resetnews|ResetNews]-Funktion von einer anderen Person als dem aufrufenden Nutzer geändert wurden.

[https://www.workity.com/services/api.asmx?op=GetItemsByNewsSearch|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array
| ProjectIDs
| Identifikationsnummern von aktiven Projekten des aufrufenden Nutzers, in denen nach bestimmten Elementen gesucht werden soll.{BR}{s:info} Wenn keine Projekte angegeben werden (leeres Array), wird in allen aktiven Projekten des aufrufenden Nutzers gesucht.
|-
| [#long|long]-Array
| PersonIDs
| Identifikationsnummern von Personen, mit denen die zu suchenden Elemente getaggt sein müssen.
|-
| [#long|long]-Array
| KeywordIDs
| Identifikationsnummern von Schlagwörtern, mit denen die zu suchenden Elemente getaggt sein müssen.
|-
| [#boolean|boolean]
| IsUnfinishedTasks
| Flag, ob nach unerledigten Aufgaben-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsFinishedTasks
| Flag, ob nach erledigten Aufgaben-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsNotes
| Flag, ob nach Notiz-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsFiles
| Flag, ob nach Datei-Elementen gesucht werden soll.
|-
| [#boolean|boolean]
| IsDetails
| Flag, ob von den gefundenen Elementen auch der Inhalt der Details-Eigenschaft zurückgeliefert werden soll.
|}

{s:warning} Ungültige Identifikationsnummern für Projekte, Personen und Schlagwörter liefern keine Elemente zurück.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#taskitem|TaskItem]-Array
| TaskItems
| Aufgaben-Elemente, die auf Basis der Suchkriterien gefunden wurden und die seit dem letzten Aufruf der [#resetnews|ResetNews]-Funktion von einer anderen Person als dem aufrufenden Nutzer geändert wurden.
|-
| [#noteitem|NoteItem]-Array
| NoteItems
| Notiz-Elemente, die auf Basis der Suchkriterien gefunden wurden und die seit dem letzten Aufruf der [#resetnews|ResetNews]-Funktion von einer anderen Person als dem aufrufenden Nutzer geändert wurden.
|-
| [#fileitem|FileItem]-Array
| FileItems
| Datei-Elemente, die auf Basis der Suchkriterien gefunden wurden und die seit dem letzten Aufruf der [#resetnews|ResetNews]-Funktion von einer anderen Person als dem aufrufenden Nutzer geändert wurden.
|}

siehe auch: [#resetnews|ResetNews], [#getitems|GetItems], [#getitemsbyadvancedsearch|GetItemsByAdvancedSearch]

[#top|nach oben]

[anchor|#getkeywordid]

=== GetKeywordID ===
Liefert die Identifikationsnummer eines neuen oder bereits vorhandenen Schlagwortes zurück.

[https://www.workity.com/services/api.asmx?op=GetKeywordID|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#string|string]
| Keyword
| Schlagwort, dessen Identifikationsnummer zurückgegeben werden soll. Der Wert dieses Parameters muss dem folgenden regulären Ausdruck entsprechen: (((^\S{1,20}$)))
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| Identifikationsnummer des übergebenen Schlagwortes
|}

[#top|nach oben]

[anchor|#getprojectkeywords]
=== GetProjectKeywords ===
Liefert alle Schlagwörter zurück, mit denen Elemente (Aufgaben, Notizen, Dateien) eines bestimmten aktiven Projektes des aufrufenden Nutzers getaggt sind.

[https://www.workity.com/services/api.asmx?op=GetProjectKeywords|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des Projektes, dessen Schlagwörter zurückgegeben werden sollen.{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception). 
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#keywordinfo|KeywordInfo]-Array
| Alphabetisch sortierte Liste aller Schlagwörter, mit denen Elemente des gegebenen Projektes getaggt sind.
|}

siehe auch: [#getuserkeywords|GetUserKeywords]

[#top|nach oben]

[anchor|#getprojectteam]
=== GetProjectTeam ===
Liefert alle Personen eines bestimmten aktiven Projektes des aufrufenden Nutzers zurück.

[https://www.workity.com/services/api.asmx?op=GetProjectTeam|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des Projektes, dessen Teammitglieder zurückgegeben werden sollen.{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception). 
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#personinfo|PersonInfo]-Array
| nach Namen alphabetisch sortierte Liste aller Personen des gegebenen Projektes
|}

siehe auch: [#getuserteam|GetUserTeam]

[#top|nach oben]

[anchor|#getuserinfo]
=== GetUserInfo ===
Liefert Informationen zum aufrufenden Nutzer zurück.

[https://www.workity.com/services/api.asmx?op=GetUserInfo|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| UserID
| Identifikationsnummer des aufrufenden Nutzers
|-
| [#string|string]
| Name
| Name des aufrufenden Nutzers
|-
| [#string|string]
| PictureURL
| URL zum Profil-Bild des aufrufenden Nutzers
|-
| [#long|long]
| FreeFileStorage
| Speicherplatz in Bytes, der dem aufrufenden Nutzer noch zum Hochladen von Dateien zur Verfügung steht.
|}


siehe auch: [#getuserkeywords|GetUserKeywords], [#getuserprojects|GetUserProjects], [#getuserteam|GetUserTeam]

[#top|nach oben]

[anchor|#getuserkeywords]
=== GetUserKeywords ===
Liefert alle Schlagwörter zurück, mit denen Elemente (Aufgaben, Notizen, Dateien) aus allen aktiven Projekten des aufrufenden Nutzers getaggt sind. Das Ergebnis umfasst somit alle Schlagwörter, wie sie auf dem klassischen Workity-Dashboard dargestellt werden. 

[https://www.workity.com/services/api.asmx?op=GetUserKeywords|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#keywordinfo|KeywordInfo]-Array
| Alphabetisch sortierte Liste aller Schlagwörter, mit denen Elemente aus allen aktiven Projekten des aufrufenden Nutzers getaggt sind.
|}

siehe auch: [#getprojectkeywords|GetProjectKeywords], [#getuserinfo|GetUserInfo], [#getuserprojects|GetUserProjects], [#getuserteam|GetUserTeam]

[#top|nach oben]

[anchor|#getuserprojects]
=== GetUserProjects ===
Liefert alle aktiven Projekte des aufrufenden Nutzers zurück.

[https://www.workity.com/services/api.asmx?op=GetUserProjects|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#projectinfo|ProjectInfo]-Array
| alphabetisch sortierte Liste aller aktiven Projekte des aufrufenden Nutzers
|}

siehe auch: [#getuserinfo|GetUserInfo], [#getuserkeywords|GetUserKeywords], [#getuserteam|GetUserTeam]

[#top|nach oben]

[anchor|#getuserteam]
=== GetUserTeam ===
Liefert alle Personen aus allen aktiven Projekten des aufrufenden Nutzers zurück. Das Ergebnis umfasst somit das gesamte Team (einschließlich des aufrufenden Nutzers), wie es auf dem klassischen Workity-Dashboard dargestellt wird. 

[https://www.workity.com/services/api.asmx?op=GetUserTeam|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#personinfo|PersonInfo]-Array
| nach Namen alphabetisch sortierte Liste aller Personen aus allen aktiven Projekten des aufrufenden Nutzers
|}

siehe auch: [#getprojectteam|GetProjectTeam], [#getuserinfo|GetUserInfo], [#getuserkeywords|GetUserKeywords], [#getuserprojects|GetUserProjects]

[#top|nach oben]

[anchor|#isauthenticated]
=== IsAuthenticated ===
Gibt zurück, ob die Authentisierung des aufrufenden Nutzers gültig ist.

[https://www.workity.com/services/api.asmx?op=IsAuthenticated|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#boolean|boolean]
| true: Die Authentisierung des aufrufenden Nutzers ist (noch) gültig.{BR} false: Die Authentisierung des aufrufenden Nutzers ist nicht (mehr) gültig.
|}

siehe auch: [#authentication|Ticket-Authentisierung], [#login|Login], [#logout|Logout]

[#top|nach oben]

[anchor|#login]
=== Login ===
Ermöglicht die Authentisierung eines bestimmten Nutzers anhand der zugehörigen Workity-Zugangsdaten. 

{s:warning} Ohne gültige Nutzer-Authentisierung kann keine andere Funktion der Programmierschnittstellen erfolgreich aufgerufen werden.

[https://www.workity.com/services/api.asmx?op=Login|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#string|string]
| Email
| Nutzer-E-Mail-Adresse des Workity-Nutzers, der sich authentisieren möchte.
|-
| [#string|string]
| Password
| Passwort des Workity-Nutzers, der sich authentisieren möchte.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#int|int]
| 0: Die Nutzer-Authentisierung war erfolgreich.{BR}-1: Die Nutzer-Authentisierung war nicht erfolgreich, weil eine ungültige Nutzer-E-Mail-Adresse und/oder ein ungültiges Passwort übergeben wurden.{BR}-2: Die Nutzer-Authentisierung war nicht erfolgreich, weil der Nutzer mit der übergebenen Nutzer-E-Mail-Adresse aufgrund von mehr als 5 ungültigen Authentisierungsversuchen aktuell gesperrt ist.{BR}-3: Die Nutzer-Authentisierung war nicht erfolgreich, weil der Nutzer mit der übergebenen Nutzer-E-Mail-Adresse noch nicht die [http://www.workity.com/tos.aspx|Workity Nutzungsbedingungen und Datenschutzbestimmungen] akzeptiert hat.{BR}-4: Die Nutzer-Authentisierung war nicht erfolgreich, weil der Nutzer mit der übergebenen Nutzer-E-Mail-Adresse aktuell kein Workity Premium-Mitglied ist.
|}

siehe auch: [#authentication|Ticket-Authentisierung], [#logout|Logout], [#isauthenticated|IsAuthenticated]

[#top|nach oben]

[anchor|#logout]
=== Logout ===
Macht die Authentisierung des aufrufenden Nutzers ungültig.

[https://www.workity.com/services/api.asmx?op=Logout|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#boolean|boolean]
| true: Die Authentisierung des aufrufenden Nutzers war zum Aufrufzeitpunkt (noch) gültig.{BR} false: Die Authentisierung des aufrufenden Nutzers war bereits zum Aufrufzeitpunkt nicht (mehr) gültig.
|}

siehe auch: [#authentication|Ticket-Authentisierung], [#login|Login], [#isauthenticated|IsAuthenticated]

[#top|nach oben]

[anchor|#newfile]
=== NewFile ===
Erzeugt ein neues Datei-Element.

[https://www.workity.com/services/api.asmx?op=NewFile|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des Projektes, innerhalb dessen das neue Datei-Element erstellt werden soll.{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]-Array
| PersonIDs
| Identifikationsnummern von Personen, mit denen das neue Datei-Element getaggt sein soll.{BR}{s:info} Ungültige Identifikationsnummern von Personen, die nicht an dem durch den ProjectID-Parameter bestimmten Projekt beteiligt sind, werden ignoriert.{BR} {s:info} Wenn keine gültigen Identifikationsnummern von Personen übergeben werden, wird das neue Datei-Element automatisch mit der Identifikationsnummer des aufrufenden Nutzers getaggt.
|-
| [#long|long]-Array
| KeywordIDs
| Identifikationsnummern von Schlagwörtern, mit denen das neue Datei-Element getaggt sein soll.{BR}{s:info} Ungültige Identifikationsnummern von Schlagwörtern werden ignoriert.
|-
| [#string|string]
| Name
| Dateiname{BR}{s:warning} Eine leere Zeichenkette oder ein Wert mit mehr als 100 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#string|string]
| ContentType
| Inhaltstyp der Datei, z.B. ''text/plain, image/jpeg, application/pdf,'' etc.{BR}{s:warning} Eine leere Zeichenkette oder ein Wert mit mehr als 100 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#string|string]
| Details
| Details des neuen Datei-Elementes
|-
| [#byte|byte]-Array
| Bytes
| binärer Inhalt der Datei{BR}{s:warning} Ein leeres Datenfeld (Array) führt zu einer Fehlerausnahme (Exception).
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das neue Datei-Element erstellt wurde.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| Identifikationsnummer des neuen Datei-Elementes{BR}{s:warning} Wenn für den aufrufenden Nutzer nicht mehr ausreichend Speicherplatz zum Hochladen der Datei zur Verfügung steht, wird -1 zurückgegeben.
|}

siehe auch: [#newnote|NewNote], [#newtask|NewTask]

[#top|nach oben]

[anchor|#newnote]
=== NewNote ===
Erzeugt ein neues Notiz-Element.

[https://www.workity.com/services/api.asmx?op=NewNote|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des Projektes, innerhalb dessen das neue Notiz-Element erstellt werden soll.{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]-Array
| PersonIDs
| Identifikationsnummern von Personen, mit denen das neue Notiz-Element getaggt sein soll.{BR}{s:info} Ungültige Identifikationsnummern von Personen, die nicht an dem durch den ProjectID-Parameter bestimmten Projekt beteiligt sind, werden ignoriert.{BR} {s:info} Wenn keine gültigen Identifikationsnummern von Personen übergeben werden, wird das neue Notiz-Element automatisch mit der Identifikationsnummer des aufrufenden Nutzers getaggt.
|-
| [#long|long]-Array
| KeywordIDs
| Identifikationsnummern von Schlagwörtern, mit denen das neue Notiz-Element getaggt sein soll.{BR}{s:info} Ungültige Identifikationsnummern von Schlagwörtern werden ignoriert.
|-
| [#string|string]
| Title
| Kurzbeschreibung des neuen Notiz-Elementes{BR}{s:warning} Eine leere Zeichenkette oder ein Wert mit mehr als 100 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#string|string]
| Details
| Details des neuen Notiz-Elementes
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das neue Notiz-Element erstellt wurde.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| Identifikationsnummer des neuen Notiz-Elementes
|}

siehe auch: [#newfile|NewFile], [#newtask|NewTask]

[#top|nach oben]

[anchor|#newtask]
=== NewTask ===
Erzeugt ein neues Aufgaben-Element.

[https://www.workity.com/services/api.asmx?op=NewTask|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des Projektes, innerhalb dessen das neue Aufgaben-Element erstellt werden soll.{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]-Array
| PersonIDs
| Identifikationsnummern von Personen, mit denen das neue Aufgaben-Element getaggt sein soll.{BR}{s:info} Ungültige Identifikationsnummern von Personen, die nicht an dem durch den ProjectID-Parameter bestimmten Projekt beteiligt sind, werden ignoriert.{BR} {s:info} Wenn keine gültigen Identifikationsnummern von Personen übergeben werden, wird das neue Aufgaben-Element automatisch mit der Identifikationsnummer des aufrufenden Nutzers getaggt.
|-
| [#long|long]-Array
| KeywordIDs
| Identifikationsnummern von Schlagwörtern, mit denen das neue Aufgaben-Element getaggt sein soll.{BR}{s:info} Ungültige Identifikationsnummern von Schlagwörtern werden ignoriert.
|-
| [#string|string]
| Title
| Kurzbeschreibung des neuen Aufgaben-Elementes{BR}{s:warning} Eine leere Zeichenkette oder ein Wert mit mehr als 100 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#string|string]
| Details
| Details des neuen Aufgaben-Elementes
|-
| [#datetime|dateTime]
| DueDate
| Fälligkeitszeitpunkt der neuen Aufgabe
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das neue Aufgaben-Element erstellt wurde.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| Identifikationsnummer des neuen Aufgaben-Elementes
|}

siehe auch: [#newfile|NewFile], [#newnote|NewNote]

[#top|nach oben]

[anchor|#removekeywords]
=== RemoveKeywords ===
Entfernt eine Menge von Schlagwörtern von einer Menge von Elementen (Aufgaben, Notizen, Dateien).

[https://www.workity.com/services/api.asmx?op=RemoveKeywords|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array 
| TaskIDs
| Identifikationsnummern der Aufgaben-Elemente, die nicht mehr mit den gegebenen Schlagwörtern getaggt sein sollen.
|-
| [#long|long]-Array 
| NoteIDs
| Identifikationsnummern der Notiz-Elemente, die nicht mehr mit den gegebenen Schlagwörtern getaggt sein sollen.
|-
| [#long|long]-Array 
| FileIDs
| Identifikationsnummern der Datei-Elemente, die nicht mehr mit den gegebenen Schlagwörtern getaggt sein sollen.
|-
| [#long|long]-Array 
| KeywordIDs
| Identifikationsnummern der Schlagwörter, mit denen die gegebenen Elemente nicht mehr getaggt sein sollen.
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem die gegebenen Elemente geändert werden.
|}

{s:info} Ungültige Identifikationsnummern für Elemente und Schlagwörter werden ignoriert.

'''Rückgabe:'''
Diese Funktion liefert keinen Rückgabewert.

siehe auch: [#addkeywords|AddKeywords]

[#top|nach oben]

[anchor|#removepersons]
=== RemovePersons ===
Entfernt eine Menge von Personen von einer Menge von Elementen (Aufgaben, Notizen, Dateien).

[https://www.workity.com/services/api.asmx?op=RemovePersons|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]-Array 
| TaskIDs
| Identifikationsnummern der Aufgaben-Elemente, die nicht mehr mit den gegebenen Personen getaggt sein sollen.
|-
| [#long|long]-Array 
| NoteIDs
| Identifikationsnummern der Notiz-Elemente, die nicht mehr mit den gegebenen Personen getaggt sein sollen.
|-
| [#long|long]-Array 
| FileIDs
| Identifikationsnummern der Datei-Elemente, die nicht mehr mit den gegebenen Personen getaggt sein sollen.
|-
| [#long|long]-Array 
| PersonIDs
| Identifikationsnummern der Personen, mit denen die gegebenen Elemente nicht mehr getaggt sein sollen.
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem die gegebenen Elemente geändert werden.
|}

{s:info} Ungültige Identifikationsnummern für Elemente und Personen werden ignoriert.

'''Rückgabe:'''
Diese Funktion liefert keinen Rückgabewert.

siehe auch: [#addpersons|AddPersons]

[#top|nach oben]

[anchor|#resetnews]
=== ResetNews ===
Nach Aufruf dieser Funktion werden durch die [#getitemsbynewssearch|GetItemsByNewsSearch]-Funktion nur Elemente (Aufgaben, Notizen, Dateien) gefunden, die seit diesem Aufrufzeitpunkt von einer anderen Person als dem aufrufenden Nutzer geändert wurden. Ein Aufruf dieser Funktion setzt somit die Menge aller zuletzt durch die [#getitemsbynewssearch|GetItemsByNewsSearch]-Funktion gefundenen Elemente zurück.

[https://www.workity.com/services/api.asmx?op=ResetNews|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:''' Diese Funktion erfordert keine Parameter.

'''Rückgabe:''' Diese Funktion liefert keinen Rückgabewert.

siehe auch: [#getitemsbynewssearch|GetItemsByNewsSearch]

[#top|nach oben]

[anchor|#savefile]
=== SaveFile ===
Speichert ein bestehendes Datei-Element.

[https://www.workity.com/services/api.asmx?op=SaveFile|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des zugehörigen Projektes{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]
| FileID
| Identifikationsnummer des Datei-Elementes
|-
| [#string|string]
| Details
| Details des Datei-Elementes
|-
| [#int|int]
| NewRevision
| neue Revision des Datei-Elementes{BR}{s:info} Die neue Revision sollte stets der aktuellen Revision + 1 entsprechen.{BR}{s:warning} Eine neue Revision kleiner 1 oder größer der aktuellen Revision + 1 führt zu einer Fehlerausnahme (Exception).
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das Datei-Element gespeichert wurde.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| 0: Das Datei-Element wurde erfolgreich gespeichert.{BR}1: Beim Speichern des Datei-Elementes ist ein [#writewriteconflict|Schreib-Schreib-Konflikt] aufgetreten.{BR}2: Beim Speichern des Datei-Elementes ist ein [#deletewriteconflict|Lösch-Schreib-Konflikt] aufgetreten.
|}

siehe auch: [#savenote|SaveNote], [#savetask|SaveTask]

[#top|nach oben]

[anchor|#savenote]
=== SaveNote ===
Speichert ein bestehendes Notiz-Element.

[https://www.workity.com/services/api.asmx?op=SaveNote|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des zugehörigen Projektes{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]
| NoteID
| Identifikationsnummer des Notiz-Elementes
|-
| [#string|string]
| Title
| Kurzbeschreibung des Notiz-Elementes{BR}{s:warning} Eine leere Zeichenkette oder ein Wert mit mehr als 100 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#string|string]
| Details
| Details des Notiz-Elementes
|-
| [#int|int]
| NewRevision
| neue Revision des Notiz-Elementes{BR}{s:info} Die neue Revision sollte stets der aktuellen Revision + 1 entsprechen.{BR}{s:warning} Eine neue Revision kleiner 1 oder größer der aktuellen Revision + 1 führt zu einer Fehlerausnahme (Exception).
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das Notiz-Element gespeichert wurde.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| 0: Das Notiz-Element wurde erfolgreich gespeichert.{BR}1: Beim Speichern des Notiz-Elementes ist ein [#writewriteconflict|Schreib-Schreib-Konflikt] aufgetreten.{BR}2: Beim Speichern des Notiz-Elementes ist ein [#deletewriteconflict|Lösch-Schreib-Konflikt] aufgetreten.
|}

siehe auch: [#savefile|SaveFile], [#savetask|SaveTask]

[#top|nach oben]

[anchor|#savetask]
=== SaveTask ===
Speichert ein bestehendes Aufgaben-Element.

[https://www.workity.com/services/api.asmx?op=SaveTask|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| ProjectID
| Identifikationsnummer des zugehörigen Projektes{BR}{s:warning} Eine ungültige Projekt-Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#long|long]
| TaskID
| Identifikationsnummer des Aufgaben-Elementes
|-
| [#string|string]
| Title
| Kurzbeschreibung des Aufgaben-Elementes{BR}{s:warning} Eine leere Zeichenkette oder ein Wert mit mehr als 100 Zeichen führt zu einer Fehlerausnahme (Exception).
|-
| [#string|string]
| Details
| Details des Aufgaben-Elementes
|-
| [#datetime|dateTime]
| DueDate
| Fälligkeitszeitpunkt der Aufgabe
|-
| [#int|int]
| NewRevision
| neue Revision des Aufgaben-Elementes{BR}{s:info} Die neue Revision sollte stets der aktuellen Revision + 1 entsprechen.{BR}{s:warning} Eine neue Revision kleiner 1 oder größer der aktuellen Revision + 1 führt zu einer Fehlerausnahme (Exception).
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das Aufgaben-Element gespeichert wurde.
|}

'''Rückgabe:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Beschreibung'''
|-
| [#long|long]
| 0: Das Aufgaben-Element wurde erfolgreich gespeichert.{BR}1: Beim Speichern des Aufgaben-Elementes ist ein [#writewriteconflict|Schreib-Schreib-Konflikt] aufgetreten.{BR}2: Beim Speichern des Aufgaben-Elementes ist ein [#deletewriteconflict|Lösch-Schreib-Konflikt] aufgetreten.
|}

siehe auch: [#savefile|SaveFile], [#savenote|SaveNote]

[#top|nach oben]

[anchor|#updatetaskstatus]
=== UpdateTaskStatus ===
Aktualisiert den Bearbeitungsstand einer Aufgabe.

[https://www.workity.com/services/api.asmx?op=UpdateTaskStatus|SOAP 1.1 und SOAP 1.2 Beschreibung dieser Funktion]

'''Parameter:'''
{| border="1" cellspacing="0" cellpadding="3"
| '''Datentyp'''
| '''Name'''
| '''Beschreibung'''
|-
| [#long|long]
| TaskID
| Identifikationsnummer des zugehörigen Aufgaben-Elementes{BR}{s:warning} Eine ungültige Identifikationsnummer führt zu einer Fehlerausnahme (Exception).
|-
| [#boolean|boolean]
| IsFinished
| neuer Bearbeitungsstand der Aufgabe{BR}true: Die Aufgabe ist nun erledigt.{BR}false: Die Aufgabe ist noch nicht erledigt.
|-
| [#datetime|dateTime]
| ModificationDate
| Lokaler Zeitpunkt des aufrufenden Nutzers, zu dem das Aufgaben-Element aktualisiert wurde.
|}

'''Rückgabe:'''
Diese Funktion liefert keinen Rückgabewert.

[#top|nach oben]


== Beispiele ==
=== HTML-Backup-Anwendung ===
Die HTML-Backup-Anwendung ist eine einfache Windows Konsolen-Anwendung, um automatisch regelmäßige Backups aller Projektinhalte im HTML-Format zu erstellen.

Beim Start der Anwendung werden zunächst die Nutzer-E-Mail-Adresse und das Passwort eines Premium-Nutzers abgefragt. Nach erfolgreicher Anmeldung wird im Anwendungsverzeichnis eine HTML-Datei erzeugt, die alle aktuellen Inhalte (Aufgaben, Notizen, Dateien) aus allen aktiven Projekten dieses Workity-Nutzers umfasst.

Dementsprechend fasst diese Konsolen-Anwendung die folgenden Aktionen der Workity Web-Anwendung zusammen:

# Auswahl aller aktiven Projekte auf dem Dashboard
# Ausführung der Aktion "Elemente anzeigen"
# Auswahl aller Elemente auf dem Dashboard
# Ausführung der Aktion "Ausgewählte Elemente als HTML-Datei exportieren"

Download der Anwendung: [http://workity.simprove.de/download/WorkityBackup.zip|WorkityBackup.zip] (20 KB)

Download C# Quellcode der Anwendung als Microsoft Visual Studio Projekt: [http://workity.simprove.de/download/WorkityBackupSource.zip|WorkityBackupSource.zip] (151 KB)

siehe auch: [http://workity.simprove.de/wiki/FragenAntworten.ashx#_Wie_kann_ich_meine_Projektinhalte_exportieren__49|Wie kann ich meine Projektinhalte exportieren?]

[#top|nach oben]

English version of this page: [ApiDocumentation|Workity API]
Simprove Workity Wiki

Navigation

Search

Programmierschnittstellen (API)
