Skip to main content

Assetic Integration API

Project description

Description

assetic is an SDK wrapper for the Assetic REST API’s

Installation (recommended)

To install assetic run:

pip install assetic

Manual Installation

Can be manually but dependencies will also require installing Can optionally use a zip file available from Assetic if pip cannot be used

Quick Start

Once you have installed everything, include the following in your python script:

import assetic

#create an instance and authenticate

asseticsdk = assetic.asseticSDK()

>From there you can use the APIs:

assetapi = assetic.AssetApi()
assetapi.getassets()

Also refer to the Assetic Knowledge Base if you have a login: https://assetic.zendesk.com

Reporting issues

Log issues via Assetic Support

Changelog

Release 2018.7.3.0
  • New API endpoints for new work order module
    • assetic.WorkOrderIntegrationApiApi has multiple endpoints to GET, PUT, POST work orders
    • assetic.WorkOrderConfigurationsApi has multiple endpoints for work order configuration
    • assetic.ConfigurationsApi has the endpoint GET unit_type
  • New API endpoints for Service Criteria, assetic.ServiceCriteriaApi
    • ServiceCriteriaApi.service_criteria_get to get a filtered list of service criteria scores
    • ServiceCriteriaApi.service_criteria_get to get a specific service criteria score
  • Deprecated asseticSDK.client_for_docs in favour of using assetic.DocumentAPI.document_get_document_file_with_http_info
  • Configuration is no longer a singleton. AsseticSDK now sets configuration default values instead so that it may be instantiated without needing to specify client config.
  • TRIM (HP Content Manager) Document integration now supports document tag
Release 2018.2.1.0
  • New API endpoints GET /api/v2/assets/{id}/location and PUT GET /api/v2/assets/{id}/location. PUT creates and updates the spatial definition and address. GET retrieves spatial definition and address
  • For Bulk Export processes add export to file option, and export immediate if search as <10000 rows. Export immediate means the data is downloaded immediately without using the background worker process
Release 2017.15.4.2
  • For Bulk Export process create tmp and target tables with key field as varchar(100) not null and PrimaryKey constraint
  • Allow SMTP settings in ini file for username and password to be omitted if port=25
Release 2017.15.4.1
  • For Bulk Export process, drop tmp table after merge and remove spurious characters from Asset Street Number prior to merge
Release 2017.15.4.0
  • New API enpoints for Asset Configuration:
    • GET /api/v2/assetfinancialclass Get a collection of financial class and financial sub-class
    • GET /api/v2/assetcategory/criticality Get a collection of asset criticality for all asset categories
    • GET /api/v2/assetcategory/{id}/criticality Get a collection of asset criticality for asset category id
  • New process for Bulk Document and Data Exchange uploads via a prompting script
Release 2017.14.2.0
  • New API endpoints for Asset Configuration:
    • GET /api/v2/workgroup Get a collection of work group
    • GET /api/v2/assetcategory Get a collection of asset category
  • New Bulk Upload tool BulkProcesses.bulk_upload_prompter to simplify bulk upload tasks
Release 2017.13.1.1
  • Minor changes to Assessment Form creation to cater for unexpected configurations in CSV file
Release 2017.13.1.0
  • New asset configuration endpoints:
    • GET /api/v2/assettype Get a collection of asset type and asset sub-type
    • GET /api/v2/assetclass Get a collection of asset class and asset sub-class
  • Endpoint user_get_user_image removed as it was deprecated
  • ‘Accepts’ header list includes ‘application/xml+hal’ at the expense of ‘application/xml’
  • New process for Assessment Form creation where user is prompted for form details
Release 2017.11.1.2
  • Fix issue when using column check to test for table existence introduced in 2017.11.1.1
Release 2017.11.1.1
  • Allow username/password connection to DB_Tools and SyncToLocalProcesses classes. Improve error trapping in SyncToLocalProcesses and DB_Tools to assist with debugging issues
Release 2017.11.1.0
  • New AssessmentHelper class to enable creation of assessment form from a csv definition file
  • New AssessmentTools class to simplify and manage interface with assessment APIs
  • Add generic mail message builder and sender in APIHelper class
  • Build against Assetic version 2017.11.1.0
  • ReferenceDate property added to asset component representation
  • Assessment Form POST, UPDATE and DELETE, along with Form Clone POST no longer flagged as “Disabled”. These API’s have been re-enabled and are supported by this SDK.
Release 2017.9.1.0
  • Document API support for Assessments documents
  • Include SDK version number in user_agent header
Release 2017.3.11.2
  • New log to email option. asseticsdk.setup_log_to_email(). Use to send logger events directly to email. Requires SMTP ,port 465=SSL, port 587=TLS, port 25 no auth. In ini file there is optional new sections titled [smtpserver] and [smtpauth]. See example below:

    [smtpserver]

    host=smtp.myserver.com

    port = 587

    [smtpauth]

    username=user@mysite.com

    password=****

  • When initialising asseticSDK, allow check for assetic.ini file in folder %APPDATA%/Assetic If the ini file is not specified the order of checking for ‘assetic.ini’ is current working folder, then %APPDATA%/Assetic, and then environment variables

  • Support for document integration with HP Content Manager (TRIM/HP Records Manager) via optional Document Adapter. Also support for document integration with local file system Additional content management adapter to be developed in future versions.

Release 2017.3.11.1
  • New document metadata APIs for GET, POST and PUT of document metadata
Release 2017.3.8.2
  • Add support for proxy server definition. In ini file there is an optional new section titled [proxy] and a new setting within titled ‘server’. See example below:

    [proxy]

    server=http://152.187.65.1:3128

  • Add support for older versions of Python 2 that lack SNI support. Refer to the following article: http://urllib3.readthedocs.io/en/latest/user-guide.html#ssl-py2 to upgrade urllib3. The Assetic SDK will implement urllib3.contrib.pyopenssl if installed.

Release 2017.3.8.1
  • Build for new version 2017.3.8
  • New API endpoints GET & POST /api/v2/workrequest/{id}/supportinginfo
  • Ensure special characters are handled by export sync process “SyncToLocalProcesses” in python 2.7
Release 2017.3.1.6
  • Include new column “spacedelimiter” in database table “assetic_sync_manager” This allows the export sync process “SyncToLocalProcesses” to remove the whitepaces in field names and replace with a user defined character such as an underscore. The “SearchProfileRepresentation” has an additional property “spacedelimiter” which can be set to the character(s) to replace spaces. Effective only if “useinternalnames” is False and “replacespaces” is True
  • Replace pypyodbc with pyodbc due to character length limitations found with pypyodbc
  • Cater for “” being used rather than the expected None when initiating assetic.AsseticSDK logfilename parameter
Release 2017.3.1.5
  • Test build and deployment
Release 2017.3.1.4
  • New Data Exchange API POST /api/v2/dataexchangejobnoprofile allows a data exchange job to be created without specifying profile Need to specify Module & Category instead
Release 2017.3.1.3
  • Introduce new api helper class with methods for launching Assetic browser tabs in various contexts such as asset or workorder
Release 2017.3.1.2
  • Introduce new tool AssetTools.get_complete_asset
Release 2017.3.1.1
  • Cater for special characters in asset ID Record error messgaes back to Excel file for bulk upload tool
Release 2017.3.1.0
  • Correct issue with asset tool not picking up not-null fields in update
Release 2017.3.0.0
  • New API’s for Components, including dimensions New API for Asset Spatial GET Complex Asset API now named Asset API. Original name supported via alias
Release 2016.12.1.3
  • Updated Bulk Import business logic for key-photos asset id retrieval and sync preview
Release 2016.12.1.2
  • Include new column “replacespaces” in database table “assetic_sync_manager” This allows the export sync process “SyncToLocalProcesses” to remove the whitepaces in field names to make database querying easier. The “SearchProfileRepresentation” has an additional property “replacespaces” which can be set to True if spaces are to be removed. Effective only if “useinternalnames” is False

Project details


Release history Release notifications

This version
History Node

2018.7.3.1

History Node

2018.7.3.0

History Node

2018.2.1.0

History Node

2017.15.4.2

History Node

2017.15.4.1

History Node

2017.15.4.0

History Node

2017.13.1.0

History Node

2017.11.1.2

History Node

2017.11.1.1

History Node

2017.11.1.0

History Node

2017.3.11.2

History Node

2017.3.11.1

History Node

2017.3.8.2

History Node

2017.3.8.1

History Node

2017.3.1.6

History Node

2017.3.1.5

History Node

2017.3.1.4

History Node

2017.3.1.3

History Node

2017.3.1.2

History Node

2017.3.1.1

History Node

2017.3.1.0

History Node

2017.3.0.0

History Node

2016.12.1.3

History Node

2016.12.1.2

History Node

2016.12.1.1

History Node

2016.12.1.0

History Node

2016.10.7.0

History Node

2016.10.6.7

History Node

2016.10.6.6

History Node

2016.10.6.5

History Node

2016.10.6.4

History Node

2016.10.6.3

History Node

2016.10.6.2

History Node

2016.10.6.1

History Node

2016.10.6.0

History Node

2016.10.1.1

History Node

2016.9.1.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
assetic-2018.7.3.1-py2.py3-none-any.whl (431.4 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Apr 6, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page