|
1 | | -NGSI Browser widget |
2 | | -=================== |
| 1 | +# NGSI Browser widget |
3 | 2 |
|
4 | 3 | The NGSI Browser widget allows you to browser [Orion Context |
5 | 4 | Broker](http://catalogue.fiware.org/enablers/publishsubscribe-context-broker-orion-context-broker) |
@@ -43,65 +42,19 @@ grunt |
43 | 42 |
|
44 | 43 | If everything goes well, you will find a wgt file in the `dist` folder. |
45 | 44 |
|
46 | | -Settings and Usage |
47 | | ------------------- |
48 | | - |
49 | | -### Settings |
50 | | - |
51 | | -- **NGSI server URL:** URL of the Orion Context Broker to use for retrieving |
52 | | - entity information. |
53 | | -- **NGSI proxy URL:** URL of the Orion Context Broker proxy to use for receiving |
54 | | - notifications about changes. |
55 | | -- **Use the FIWARE credentials of the user:** Use the FIWARE credentials of the |
56 | | - user logged into WireCloud. Take into account this option cannot be enabled if |
57 | | - you want to use this widget in a public workspace as anonoymous users doesn't |
58 | | - have a valid FIWARE auth token. As an alternative, you can make use of the |
59 | | - "Use the FIWARE credentials of the workspace owner" preference. |
60 | | -- **Use the FIWARE credentials of the dashboard owner**: Use the FIWARE |
61 | | - credentials of the owner of the workspace. This preference takes preference |
62 | | - over "Use the FIWARE credentials of the user". This feature is available on |
63 | | - WireCloud 0.7.0+ in a experimental basis, future versions of WireCloud can |
64 | | - change the way to use it making this option not funcional and requiring you to |
65 | | - upgrade this operator. |
66 | | -- **NGSI tenant/service**: Tenant/service to use when connecting to the context |
67 | | - broker. Must be a string of alphanumeric characters (lowercase) and the `_` |
68 | | - symbol. Maximum length is 50 characters. If empty, the default tenant will be |
69 | | - used |
70 | | -- **NGSI scope**: Scope/path to use when connecting to the context broker. Must |
71 | | - be a string of alphanumeric characters (lowercase) and the `_` symbol |
72 | | - separated by `/` slashes. Maximum length is 50 characters. If empty, the |
73 | | - default service path will be used: `/` |
74 | | -- **NGSI entity types:** A comma separated list of entity types to use for |
75 | | - filtering entities from the Orion Context broker. This field cannot be empty. |
76 | | -- **Id pattern:** Id pattern for filtering entities. This preference can be |
77 | | - empty, in that case, entities won't be filtered by id. |
78 | | -- **Extra Attributes:** Comma separated list of attributes to be displayed in |
79 | | - the widget as extra columns. |
80 | | - |
81 | | -### Wiring |
82 | | - |
83 | | -##### Input Endpoints |
84 | | - |
85 | | -* This widget has no input endpoint |
86 | | - |
87 | | -##### Output Endpoints |
88 | | - |
89 | | -- **Selection:** This widget sends an event thought this endpoint when the |
90 | | - user clicks on the "Use Button". Entities using this operator uses the flat |
91 | | - option of the WireCloud API. Event data example: |
92 | | - |
93 | | - ```json |
94 | | - { |
95 | | - "id": "van4", |
96 | | - "type": "Van", |
97 | | - "current_position": "43.47173, -3.7967205" |
98 | | - } |
99 | | - ``` |
100 | | - |
101 | | -Copyright and License |
102 | | ---------------------- |
103 | | - |
104 | | -Copyright (c) 2015 CoNWeT Lab., Universidad Politecnica de Madrid |
| 45 | + |
| 46 | +## Documentation |
| 47 | + |
| 48 | +Documentation about how to use this widget is available on the |
| 49 | +[User Guide](src/doc/userguide.md). Anyway, you can find general information |
| 50 | +about how to use widgets on the |
| 51 | +[WireCloud's User Guide](https://wirecloud.readthedocs.io/en/stable/user_guide/) |
| 52 | +available on Read the Docs. |
| 53 | + |
| 54 | + |
| 55 | +## Copyright and License |
| 56 | + |
| 57 | +Copyright (c) 2016 CoNWeT Lab., Universidad Politecnica de Madrid |
105 | 58 |
|
106 | 59 | Licensed under the Apache License, Version 2.0 (the "License"); |
107 | 60 | you may not use this file except in compliance with the License. |
|
0 commit comments