Analysts can use the Photo Uploader widget to upload images from an iPhone or iPad with MicroStrategy Mobile. A user can choose to take a new image, use an existing image on their mobile device, or delete images. For steps to use the Photo Uploader widget to create, use, or delete images, see the MicroStrategy Mobile Analyst Guide.
By default, images are uploaded and stored in the SavedImages folder on the Mobile server, while the location of each image is stored in the user's data source. Your administrator can change the location in which images are uploaded and stored. For steps, see the Mobile Design and Administration Guide.
You must have the Transaction Services product.
You must have the Web Configure Transaction privilege.
This procedure
assumes you have already created attributes and metrics to place on the
widget's Grid/Graph. This Grid/Graph is used to store information about
the images before they are uploaded. The following attributes and metrics
must be created:
Note: You must include a row of data for each image you want
to allow users to upload at one time. For example, to allow users to upload
ten images at one time, you must provide ten rows of data.
One attribute that contains the following attribute forms:
The first attribute form contains the location in which each image is saved. This value is automatically updated when the user uploads an image.
The second attribute form contains a description of each image. The user can specify the description for each image when the widget is viewed on an iPhone or iPad.
The third attribute form contains the ID of each image. You must provide a unique ID for each row of data in the widget's Grid/Graph.
Two metrics, as follows:
The first metric is used to indicate whether or not the image has been uploaded.
The second metric (optional) contains the sum of the values in the first metric, and is used to display the number of images the user has uploaded.
You can provide additional information about an uploaded image by placing additional attributes and metrics on the widget's Grid/Graph. For example, you can add the Store attribute to the widget's Grid/Graph, and then add a prompt to the document to allow users to select a store. A user runs the document, then selects the store in which they are taking a picture with their mobile device. When the image is uploaded, the name of the store is stored in the user's data source, along with the description of the image and the location in which the image is stored. For an overview of iPhone and iPad prompts, see About iPhone and iPad prompts.
This procedure assumes you have already created a Transaction Services report to link to the widget's Grid/Graph. There must be an attribute form or metric displayed in the widget's Grid/Graph (described above) for each input object in the Transaction Services report. For steps to create a Transaction Services report, see the Advanced Reporting Guide. For full steps to create a Transaction Services-enabled document, see the Report Services Document Creation Guide.
Open the document in Design or Editable Mode.
From the Insert menu, point to Widgets, then point to iPhone/iPad. Select Photo Uploader.
Click a location on your document in which to place the widget. If desired, resize the widget by clicking and dragging its handles.
From the Dataset Objects panel on the left, select attributes and metrics, and drag them on top of the widget, as described below:
Place at
least one attribute on the Grid/Graph's
rows. At least three attribute forms must be visible on the Grid/Graph,
as described below:
Note: To include the value of an attribute form in the data
stored in the user's data source, the attribute form must be visible on
the widget's Grid/Graph. To choose the attribute forms displayed for an
attribute in the Grid/Graph, right-click the header of the attribute,
point to Attribute Forms, then
select the attribute forms you want to display.
The first attribute form contains the location in which each image is saved. This value is automatically updated when the user uploads an image.
The second attribute form contains a description of each image. A user can specify the description for each image when the widget is viewed on an iPhone or iPad.
The third attribute form contains the ID of each image. You must provide a unique ID for each row of data in the widget's Grid/Graph.
Place at least two metrics on the Grid/Graph's columns:
The first metric is used to indicate whether or not the image has been uploaded.
The second metric (optional) contains the sum of the values in the first metric, and is used to display the number of images the user has uploaded.
To provide additional information about each uploaded image, place additional attributes and metrics on the widget's Grid/Graph. For example, you can add the Store attribute to the widget's Grid/Graph, and then add a prompt to the document to allow users to select a store. A user runs the document, then selects the store in which they are taking a picture with their mobile device. When the image is uploaded, the name of the store is stored in the user's data source, along with the description of the image and the location in which the image is stored. For an overview of iPhone and iPad prompts, see About iPhone and iPad prompts.
To link the widget's Grid/Graph to the Transaction Services report, right-click the widget's Grid/Graph, then select Configure Transaction. The Configure Transactions dialog box opens.
Click Browse (...), then navigate to and select the Transaction Services report you want to link to.
A list of each input object in the Transaction Services report is displayed in the Transaction Input column. Perform the following steps for each input object:
From the Grid Object drop-down list, select the attribute form or metric you want to link to the input object.
You can choose whether users can edit the value of each input object. You must define the first metric on the columns of the widget's Grid/Graph to be editable. Do one of the following:
To allow the user to edit the value of the input object, select the Editable check box.
To prevent the user from editing the value of the input object, clear the Editable check box.
Repeat the appropriate steps above to define and format the control you want to display for each input object.
Click OK to save your changes and return to the document.
From the Insert menu, point to Selector, then select Action Selector Button.
Click the section of the Layout area in which you want to place the selector. Right-click the selector, then select Properties and Formatting. The Properties and Formatting dialog box opens.
From the left, click General, then type the text you want to display on the button or link in the Display Text field.
By default, a descriptive title bar is displayed for the selector. You can determine whether to display the title bar. Do one of the following:
To display the title bar, select the Show Title Bar check box and type the title you want to display in the field.
To display the selector button or link without the title bar, clear the Show Title Bar check box.
From the left, click Selector. From the Action Type drop-down list, select Submit.
By default, the selector button or link targets each Grid/Graph and panel stack in the section in which it is placed. You can choose the targets of the selector manually instead. To do so, select Click here, then use the right arrow to move the Grid/Graph or panel stack you want to target from the Available list to the Selected list. For detailed steps, see Choosing targets for a selector.
Select the appropriate options to define the selector. For full steps to define an action selector button, see the Report Services Document Creation Guide.
Click OK to save your changes and return to the document.