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 and 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. Add the Add Attachment activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Add Attachment activity (this opens the Object Wizard).
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

To enter your Add Attachment property values, click the Configure button to open the Object Wizard and select a ServiceNow object (you also have the option to enter the object as a String).

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

• Object - The type of ServiceNow object that you want to upload your file to. Use the Object Wizard to select an object or enter a valid String or String variable.
• File - The file to attach. This field supports only Strings or String variables.
• Sys ID - The ID of the record to which to attach the file. This field supports only Strings or String variables.

Eigenschaften

Allgemein

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

Eingabe

• FileName - The complete local path to the file that you want to upload. Enter a String or String variable.
• ObjectSysId – Die sys_id des ServiceNow-Datensatzes, in den Sie Ihre Datei hochladen möchten. Geben Sie eine Variable String oder String ein. Um den Wert sys_id abzurufen, können Sie einer der Methoden folgen, die in der Dokumentation zur eindeutigen Datensatzkennung (sys_id) von ServiceNow gezeigt werden, oder Sie klicken mit der rechten Maustaste auf den Datensatz in der ServiceNow-Benutzeroberfläche und wählen 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 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 Attachment usw.).
• ServiceNowStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

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 .