ProjectWiseWSGConnector
一个ccesses ProjectWise through a Bentley Web Services Gateway (WSG).一个 WSG is a server-side application that opens a communication channel between an app, in this case FME and the ProjectWiseWSGConnector, and Bentley's project information management system, which in this case is ProjectWise.
一个 WSG is comprised of two main components.The first component is the WSG framework which uses a REST web services API to communicate with apps to authenticate, send data, and receive data.The second component is a set of providers that communicate directly with individual management systems.The provider of interest to the ProjectWiseWSGConnector is the ProjectWise provider, which allows access to ProjectWise data sources.
Typical Uses
- Manage datasets on ProjectWise by uploading, downloading, and deleting documents and projects.
- Transfer a file's contents (such as XML, point cloud, or raster) into or out of an attribute in FME.
- Read downloaded ProjectWise data using theFeatureReader, or upload data written by theFeatureWriterto ProjectWise.
- Retrieve document and project names, paths, IDs and other information from ProjectWise to use elsewhere in a workspace.
How does it work?
The ProjectWiseWSGConnector uses your ProjectWise account credentials (either via a previously defined FME web connection, or by setting up a new FME web connection right from the transformer) to access the ProjectWise service.
Depending on your choice of actions, it will upload files, folders, and attributes;download documents and projects;list information of objects;or delete objects from the service.
In this example, the ProjectWiseWSGConnector is used to download a Bentley MicroStation Design document from ProjectWise.We start by creating a valid web connection to a WSG deployment (which can be done right in the ProjectWise Account parameter) and browsing to the Design document, which retrieves the Object ID for the document.Finally, we choose to download as a File and select a destination for the download.
一个FeatureReaderis added to read the newly downloaded dataset.Here, the A-H1-G-Pave feature type will be further processed elsewhere in the workspace.
By executing the download here in the workspace, the Design document will be refreshed every time the workspace is run.
In this example, the ProjectWiseWSGConnector is used to download a raster from ProjectWise into an attribute.
The document is read from ProjectWise and the contents stored as a blob attribute.Then aRasterReplaceris used to interpret the blob into a usable raster format.
The combination of these two transformers avoids having to download the image to local storage and re-read it.一个 similar technique can be used for point cloud files, using thePointCloudReplacertransformer.
Usage Notes
- This transformer cannot be used to directly move or copy files between different ProjectWise locations.However, multiple ProjectWiseWSGConnectors can be used to accomplish these tasks.
- TheFeatureReadercan access ProjectWise directly (without using the ProjectWiseWSGConnector), however, a local copy of the dataset will not be created.
- The minimum supported versions for the ProjectWiseWSGConnector are Bentley Web Services Gateway 2.00 with Server Version 2.00.
Configuration
Input Ports
This transformer accepts any feature.
Output Ports
这台变压器的输出将取决于ProjectWise的行动进行改变。
- 后上传上载的对象的动作,实例ID和对象ID将被设定为在输出特征的属性。
- 一个下载动作可以保存到一个文件,文件夹,或属性。
- 一个删除行动将输出输入功能不变。
- 一个名单行动将输出为指定的对象ID找到的每个文件/项目的新功能。每一个的这些新功能将具有属性列出各种条关于对象的信息。
Parameters
ProjectWise的行动 | 的操作类型来执行。选项包括:
|
ProjectWise的账户 | 通过宾利Web服务网关执行上的ProjectWise操作需要使用使用Web连接基本身份验证。要创建一个ProjectWise的连接,点击“ProjectWise的帐户”下拉框,选择“添加网络连接...”。 连接参数:
随后,连接将可以通过管理工具 - > FME选项...- >网络连接。 |
The remaining parameters available depend on the value of the Request > ProjectWise Action parameter.Parameters for each ProjectWise Action are detailed below.
ProjectWise的路径
对象ID |
在ProjectWise的文档或项目的对象ID删除。如果有效凭证已作为Web连接提供了,你可以浏览到某个位置。 |
ProjectWise的来源
对象ID |
文件/项目的对象ID下载。如果有效凭证已作为Web连接提供了,你可以浏览到某个位置。 |
目的地
下载为 | 选择是否下载的数据存储在一个文件,文件夹或属性。
|
下载到文件夹 | 指定的路径将存储下载文件的文件夹。有效期为下载文件或文件夹。 |
包含子文件夹 | 选择是否下载ProjectWise的来源与否的子项目。适用于下载作为唯一的文件夹。 |
下载到属性 | 指定存储下载的文件的内容的属性。适用于下载作为唯一的属性。 注意:FME会尝试将属性的内容转换为UTF-8字符串。如果失败,则该属性的内容将作为原始二进制来创建。为了确保原字节总是保留并不会转换为UTF-8,使用下载的文件来代替。 |
ProjectWise的路径
ProjectWise的对象ID |
对象ID列表中的内容。如果有效凭证已作为Web连接提供了,你可以浏览到某个位置。 |
输出属性
提供默认的属性名称,并且可能会被覆盖。
班级名称 |
指定要挺住ProjectWise的对象的名称属性。 |
实例ID |
指定要举行ProjectWise的对象的实例ID的属性。 |
对象ID |
指定要举行ProjectWise的一个对象的对象ID的属性。 |
类类型 |
指定要举行ProjectWise的对象的类型的属性。 |
描述 |
指定要举行ProjectWise的一个对象的描述的属性。 |
创建时间 |
指定要挺住ProjectWise的对象的创建时间属性。 |
更新时间 |
指定要挺住ProjectWise的对象的最后更新时间属性。 |
相对路径 |
指定属性来保持相对路径上的ProjectWise的对象。 |
文档名称 |
指定属性举行的ProjectWise文档的文档名称。只有增加了对文档类型对象。 |
文件大小 |
指定要举行的ProjectWise文档的大小属性。只有增加了对文档类型对象。 |
文件最后修改 |
指定要举行的ProjectWise文档的最后修改时间的属性。只有增加了对文档类型对象。 |
文档的MIME类型 |
指定要保持MIME类型上的ProjectWise文档的属性。只有增加了对文档类型对象。 |
资源
上传 |
类型数据的上载。
当使用大型对象,文件比属性更适合作为数据将直接从磁盘流,而不是需要将对象完全存储在内存中的一项功能。 ProjectWise的不会覆盖同名文件。如果要上传具有相同名称作为一个现有的文档文件,现有文件的ID将被退回。 当想从一个文件夹上传内容,最好是上载的文件夹,而不是设置一个固定的路径和发送多个特征到所述连接器上载为一个文件。 |
文件上传 |
如果上传设置为文件的文件上传到ProjectWise的。 |
文件夹,上传 |
如果上传设置为文件夹中的文件夹上传到ProjectWise的。 |
包含子文件夹 |
选择是否将文件夹子文件夹上传到上传或不。 |
属性上传为文件 |
数据被上载,从属性供给如果上传被设置为属性。 |
ProjectWise的目的地
项目对象ID | 该项目的对象ID将数据上传到。如果有效凭证已作为Web连接提供了,你可以浏览到某个位置。 |
上传与文件名 | 在属性提供给上传数据创建的文件的名称为文件。名称必须包括文件扩展名(例如,txt文件,.JPG,.DOC)。 |
输出属性
实例ID | 指定存储刚上传的文件/文件夹的实例ID输出属性。 |
对象ID | 指定存储刚上传的文件/文件夹的对象ID的输出属性。 |
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace.More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers.To access a menu of these options, clickbeside the applicable parameter.For more information, seeTransformer Parameter Menu Options。
Defining Values
There are several ways to define a value for use in a Transformer.The simplest is to simply type in a value or string, which can include functions of various types such as attribute references, math and string functions, and workspace parameters.There are a number of tools and shortcuts that can assist in constructing values, generally available from the drop-down context menu adjacent to the value field.
使用文本编辑器
文本编辑器提供了一个方便的方法来构造从各种数据源,如属性,参数和常量,其中该结果被直接使用的参数中的文本字符串(包括正则表达式)。
使用算术编辑器
算术编辑器提供了一个方便的方法来构造从各种数据源,如属性,参数和特征函数,其中结果被直接使用的参数内的数学表达式。
条件值
根据一个或多个测试条件,要么通过或失败的设定值。
内容
表达式和字符串可以包括多个功能,字符,参数等。
当设定值 - 无论是直接在参数输入或使用的编辑之一构造 - 字符串和表达式包含字符串,数学,日期/时间或FME特征函数将具有评价这些功能。因此,这些功能的名称(在形式@ <FUNCTION_NAME>)不应该被用作文字字符串值。
Reference
加工行为 |
|
特点控股 |
没有 |
依赖 | 宾利的ProjectWise CONNECT版,宾利Web服务网关,宾利WSG ProjectWise的插件 |
FME许可级别 | FME基础版及以上 |
别名 | |
历史 | 发布FME 2018.0 |
分类 |
FME Community
The FME Community is the place for demos, how-tos, articles, FAQs, and more.Get answers to your questions, learn from other users, and suggest, vote, and comment on new features.
Search forall results about the ProjectWiseWSGConnectoron the FME Community.
Examples may contain information licensed under the Open Government Licence – Vancouver