Upload Attachment
Applies To: Opalis 6.3
The Upload Attachment object is used to upload a file to an existing Service Manager object.
The following published data elements are specific to Upload Attachment. Additional published data is generated based on the Class that you select when you define the object. For a list of the data elements published by each Class, see Service Manager Published Data.
Upload Attachment Published Data
| Element | Description |
|---|---|
Object GUID |
The unique identifier (GUID) of the single attachment to be updated |
Number of Objects |
The number of files successfully uploaded by Upload Attachment |
Note
Be aware that the procedure to attach file attachments is different than the procedure to attach knowledge articles.
Configuring the Upload Attachment Object Workflow for File Attachments
The Upload Attachment object is dependent on other objects for the data that it requires.
For file attachments, the following objects will usually precede the Upload Attachment object in a workflow:
A parent record must exist. For example, you could use Create Change with Template or Get Object to get the Object Guid of a parent record where the attachment is to be uploaded.
Use Get File Status to get information about the file to be uploaded. This object retrieves the data needed to attach the file to the Service Manager object.
Use Create Related Object to create a File Attachment related to the parent record. This object creates the File Attachment object where the attachment is to be uploaded. There are several critical fields that must be correctly populated in order for the attachment to behave correctly in Service Manager
To configure the file attachment prerequisite objects for the Upload Attachment object
Create (or query for) a parent record where the attachment is to be associated. For example, from the Objects pane, drag a Create Change with Template object to the active policy.
Double-click the Create Change with Template object.
Configure the Create Change with Template object to update the Service Manager object to which you want to attach a file. For more information aboutusing this object, see Configuring the Create Change with Template Object.
From the File Management section of the Objects pane, drag a Get File Status object to the active policy.
Link the Create Change with Template object to the Get File Status object so that you can use data published by the Create Change with Template object later in the workflow.
Double-click the Get File Status object. On the Details tab, click the ellipsis button (...), and then select the file(s) that you want to attach to the Service Manager object. Define the File age filters, and then click Finish.
From the Objects pane, drag a Create Related Object object to the active policy.
Link the Create Related Object object to the Get File Status object so that you can use data published by the Get File Status object later in the workflow.
Double-click the Create Related Object object.
On the Details tab, in the Properties section, click the ellipsis button (...), and then select the Connection to the same Service Manager computer that you used for the previous objects in the workflow.
Click the Source Class ellipsis button (...), and then select Change Request.
Click the Target Class ellipsis button (...), and then select File Attachment.
Click the Relationship Type ellipsis button (...), and then select Has File Attachment.
Right-click the Source Object Guid field, point to Subscribe, and then click Published data. Click Object Guid published data element from the Create Change with Template object, and then click OK.
Click Select Optional Fields. Select all of the optional fields, and then click OK.
In the ID field, subscribe to the Object GUID of the parent incident/change record published data from the Create Change with Template object.
In the Size field, subscribe to the File Size (bytes) published data from the Get File object.
In the Display Name field, subscribe to the File Name published data from the Get File object. Do not specify a file path.
In the Description field, type a description of the attachment.
In the Added Date field, subscribe to the current and time. One way to do this is to subscribe to the Object Start Time published data from the Get File Status object.
In the Extension field, enter a period ( . ) followed by the file name extension of the attachment to be added to the Service Manager object. For example, .txt. Alternatively, you can subscribe to the File Extension published data from the Get File Status object. The File Extension published data element does not include the period so you will need to enter it manually prior to the published data link.
The published data for each object depends on the class that was selected when the object was created. For a list of the data elements published by each class, see Service Manager Published Data. For information about the Common Published Data items, see the "Policy Workflow Rules" chapter of the Opalis Integration Server Client User Guide (https://go.microsoft.com/fwlink/?LinkId=205284).
From the Objects pane, drag an Upload Attachment object to the active policy.
Double-click the Upload Attachment object.
Link the Upload Attachment object to the Create Related Object object.
Right-click the Object Guid field, point to Subscribe, and then click Published data. Click the Object Guid published data element from the Create Related Object object, and then click OK.
In the Content field browse to find the file to upload as an attachment.
For information about the settings on the General and Run Behavior tabs for each object, see Common Configuration Instructions for all Objects.
Click Finish.
Configuring the Upload Attachment Object Workflow for Knowledge Articles
The Upload Attachment object is dependent on other objects for the data that it requires. For knowledge articles, the following objects usually precede the Upload Attachment object in a workflow:
A parent record must exist. For example, you could use Create Change with Template or Get Object to get an Object Guid of a parent record where the article is to be uploaded.
Use Get File Status to get information about the knowledge article to be uploaded. This object retrieves the data needed to attach the knowledge article to the Service Manager object.
Use Create Object to create a knowledge article. This object creates the knowledge article object where the article is to be uploaded.
To configure the knowledge article prerequisite objects for the Upload Attachment object
Create (or query for) a parent record where the attachment is to be associated. For example, from the Objects pane, drag a Create Change with Template object to the active policy.
Double-click the Create Change with Template object.
Configure the Create Change with Template object to update the Service Manager object to which you want to attach a file. For information about using this object, see Configuring the Create Change with Template Object.
From the File Management section of the Objects pane, drag a Get File Status object to the active policy.
Link the Create Change with Template object to the Get File Status object, so that you can use data published by the Create Change with Template object later in the workflow.
Double-click the Get File Status object. On the Details tab, click the ellipsis button (...) and select the file or files that you want to attach to the Service Manager object. Define the File age filters, and then click Finish.
From the Objects pane, drag a Create Object object to the active policy.
Link the Create Object object to the Get File Status object so that you can use data published by the Get File Status object later in the workflow.
Double-click the Create Object object.
On the Details tab, in the Properties section, click the ellipsis button (...), and then select the Connection to the same Service Manager computer that you used for the previous objects in the workflow.
Click Select optional fields and add fields that apply to the knowledge article.
From the Objects pane, drag a Create Relationship object to the active policy.
In the Source Class field, click the source class of the parent object created in step 1 (in this example click Change Request).
In the Target Class field, click Knowledge Article.
In the Relationship Type field, click Links to Knowledge Article.
In the Source Object Guid field, click the object Guid from the source class of the parent object that you created in step 1 (in this example, click Change Request).
In the Target Object Guid field, click the object Guid from the knowledge article created by the Create Object in step 10.
In the Content field browse to find the knowledge article to upload as an attachment.
For information about the settings on the General and Run Behavior tabs for each object, see Common Configuration Instructions for all Objects.
To configure the Upload Attachment object
From the Objects pane, drag an Upload Attachment object to the active policy.
Link the Upload Attachment object to the Create File Attachment object so that you can use data published by the previous objects in the workflow.
On the Details tab, in the Properties section, click the ellipsis button (...), and then select the Connection to the same Service Manager computer that you used for the previous objects in the workflow.
Click the Class ellipsis button (...), and then select File Attachment or Knowledge Article to indicate the upload type.
Right-click the Object Guid field, and then subscribe to the Target Object Guid published data element from the Create File Attachment object.
In the Fields section, right-click the Content field, and then subscribe to the Object Guid published data element from the Create File Attachment object.
For information about the settings on the General and Run Behavior tabs for each object, see Common Configuration Instructions for all Objects.
Click Finish.
Other Objects
The Integration Pack for System Center Service Manager contains the following additional objects: