Add Attachment

UiPath.ServiceNow.Activities.AddAttachment

Die Aktivität Add Attachment verwendet die ServiceNow Attachment – POST -API, um eine Datei (Attachment) in ein bestimmtes Datensatzobjekt (Object und ObjectSysId) hochzuladen.

Nach dem Hochladen der Datei gibt die Aktivität die sys_id des Anhangs (AttachmentId) und den Status des Uploads (Erfolgs-/Fehlerinformationen) in einem ResponseStatus -Objekt (ServiceNowStatus) aus. Beide Ausgaben können als Eingabevariablen in nachfolgenden Aktivitäten verwendet werden (z. B. AttachmentId in Download Attachment, Delete Attachment und ServiceNowStatus in bedingter Logik).

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität ServiceNow Scope zu Ihrem Projekt hinzu.
3. Fügen Sie die Aktivität Add Attachment innerhalb der Aktivität ServiceNow Scope hinzu.
4. Klicken Sie auf die Schaltfläche Konfigurieren in der Aktivität Anlage hinzufügen (dadurch wird der Objekt-Assistentgeöffnet).
5. Wählen Sie das Objekt aus, dem Sie die Datei hinzufügen möchten, und geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie eine String und eine ResponseStatus -Variable für die Ausgabeeigenschaften ein.
   • Ihre Eingabeeigenschaftswerte werden an die Attachment – POST -API gesendet.
   • Die API gibt die Werte String (sys_id) und ResponseStatus an Ihre Ausgabeeigenschaftsvariablen zurück.
     
     

     

     
     

Im Textkörper der Aktivität

Um Ihre Eigenschaftswerte zum Hinzufügen von Anhang einzugeben, klicken Sie auf die Schaltfläche Konfigurieren , um den Objekt-Assistenten zu öffnen, und wählen Sie ein ServiceNow-Objekt aus (Sie haben auch die Möglichkeit, das Objekt als Stringeinzugeben).

Weitere Informationen zum Objekt-Assistenten finden Sie auf der Seite Frameworks für Geschäftsaktivitäten .

• Object – Der Typ des ServiceNow-Objekts, in das Sie Ihre Datei hochladen möchten. Verwenden Sie den Objektassistenten , um ein Objekt auszuwählen, oder geben Sie eine gültige String - oder String -Variable ein.
• Datei – Die anzuhängende Datei. Dieses Feld unterstützt nur Strings - oder String -Variablen.
• Sys-ID - Die ID des Datensatzes, an den die Datei angehängt werden soll. Dieses Feld unterstützt nur Strings - oder String -Variablen.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings- oder String-Variablen.

Eingabe

• Dateiname – Der vollständige lokale Pfad zu der Datei, die Sie hochladen möchten. Geben Sie eine String - oder String -Variable ein.
• ObjectSysId – Die sys_id des ServiceNow-Datensatzes, in den Sie Ihre Datei hochladen möchten. Geben Sie eine String - oder String -Variable ein. Um den sys_id- Wert abzurufen, können Sie einer der Methoden folgen, die in der Dokumentation zum eindeutigen Datensatzbezeichner (sys_id) von ServiceNow gezeigt werden, oder klicken Sie mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche, und wählen Sie im Popup-Menü die Option sys_id kopieren aus.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• AttachmentId - Die sys_id des Anhangs. Geben Sie eine String a-Variable ein. Die Variable, die Sie für diese Eigenschaft erstellen, kann als Eingabevariable in nachfolgenden Aktivitäten verwendet werden (z. B. Get ServiceNow Record, Download Attachmentusw.).
• ServiceNowStatus – Der Status der Anforderung (Erfolgs-/Fehlerinformationen). Geben Sie eine ResponseStatus -Variable ein (UiPath.BAF.Models.ResponseStatus). Das ResponseStatus -Objekt enthält drei Eigenschaften, die Sie in anderen Aktivitäten verwenden können.
  • Success – Boolean – Gibt an, ob die API-Anforderung erfolgreich war.
  • ErrorCode – String – Der Antwortfehler, wenn die API-Anforderung nicht erfolgreich ist (Success=False).
  • Message – String – Die Fehlermeldung.

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Schritt-für-Schritt-Anweisungen und Beispiele finden Sie in der Schnellstartanleitung .